Riwayat pesanan yang telah selesai

get https://api.cryptomus.com/v2/user-api/exchange/orders/history Menyalin

Meminta

Parameter kueri

NamaJenis parameterDefinisi
marketstringFilter berdasarkan pasangan perdagangan (misalnya, `TRX_USDT`)
directionstringFilter berdasarkan arahPilihan yang tersedia:buysell
order_idstringFilter berdasarkan ID pesanan di buku pesanan
client_order_idstringFilter berdasarkan ID pesanan klien
limitstringParameter khusus yang menetapkan jumlah maksimum rekaman yang akan dikembalikan oleh permintaan
offsetstringParameter khusus yang menunjukkan jumlah rekaman yang akan dilewati

Jenis parameter

string

Definisi

Filter berdasarkan pasangan perdagangan (misalnya, `TRX_USDT`)

Jenis parameter

string

Definisi

Filter berdasarkan arahPilihan yang tersedia:- buy- sell

Jenis parameter

string

Definisi

Filter berdasarkan ID pesanan di buku pesanan

Jenis parameter

string

Definisi

Filter berdasarkan ID pesanan klien

Jenis parameter

string

Definisi

Parameter khusus yang menetapkan jumlah maksimum rekaman yang akan dikembalikan oleh permintaan

Jenis parameter

string

Definisi

Parameter khusus yang menunjukkan jumlah rekaman yang akan dilewati

Tanggapan

Parameter respons pesanan

NamaDefinisi
idID pesanan di buku pesanan
typeJenis pesananPilihan yang tersedia:buysell
directionArah pesananPilihan yang tersedia:buysell
symbolFilter berdasarkan pasangan perdagangan (misalnya, `TRX_USDT`)
quantityJumlah aset dasar yang diminta
filledQuantityJumlah aset dasar yang terisi
filledValueJumlah aset kutipan yang terisi
stateStatus pesanan saat ini (misalnya, 'selesai')
internalStateKeadaan internal pesanan (misalnya, 'terpenuhi')
createdAtWaktu ketika pesanan dibuat
finishedAtWaktu ketika pesanan selesai
stopLossPriceHarga ambang batas pasar aset, yang jika tercapai maka pesanan akan dibatalkan secara otomatis

Definisi

ID pesanan di buku pesanan

Definisi

Jenis pesananPilihan yang tersedia:- buy- sell

Definisi

Arah pesananPilihan yang tersedia:- buy- sell

Definisi

Filter berdasarkan pasangan perdagangan (misalnya, `TRX_USDT`)

Definisi

Jumlah aset dasar yang diminta

Definisi

Jumlah aset dasar yang terisi

Definisi

Jumlah aset kutipan yang terisi

Definisi

Status pesanan saat ini (misalnya, 'selesai')

Definisi

Keadaan internal pesanan (misalnya, 'terpenuhi')

Definisi

Waktu ketika pesanan dibuat

Definisi

Waktu ketika pesanan selesai

Definisi

Harga ambang batas pasar aset, yang jika tercapai maka pesanan akan dibatalkan secara otomatis

Parameter respons transaksi

NamaDefinisi
idID perdagangan
stateStatus perdagangan (misalnya, `selesai`)
createdAtWaktu ketika perdagangan diciptakan
completedAtWaktu ketika perdagangan selesai
averageFilledPriceHarga rata-rata yang terisi untuk perdagangan

Definisi

ID perdagangan

Definisi

Status perdagangan (misalnya, `selesai`)

Definisi

Waktu ketika perdagangan diciptakan

Definisi

Waktu ketika perdagangan selesai

Definisi

Harga rata-rata yang terisi untuk perdagangan

Parameter respons transaksi transaksi

NamaDefinisi
idID transaksi
tradeRolePeran dalam perdaganganPilihan yang tersedia:takermaker
filledPriceHarga terisi untuk transaksi
filledQuantityJumlah yang dieksekusi dalam mata uang dasar
filledValueJumlah yang dieksekusi dalam mata uang kutipan
feeBiaya transaksi
feeCurrencyMata uang yang dikenakan biaya
committedAtWaktu pelaksanaan transaksi

Definisi

ID transaksi

Definisi

Peran dalam perdaganganPilihan yang tersedia:- taker- maker

Definisi

Harga terisi untuk transaksi

Definisi

Jumlah yang dieksekusi dalam mata uang dasar

Definisi

Jumlah yang dieksekusi dalam mata uang kutipan

Definisi

Biaya transaksi

Definisi

Mata uang yang dikenakan biaya

Definisi

Waktu pelaksanaan transaksi

Contoh respons


1{
2    "result": [
3        {
4            "id": "01JEXAPY04JDFBVFC2D23BCKMK",
5            "type": "market",
6            "direction": "sell",
7            "symbol": "TRX_USDT",
8            "quantity": "67.5400000000000000",
9            "filledQuantity": "67.5400000000000000",
10            "filledValue": "20.0053480000000000",
11            "state": "completed",
12            "internalState": "filled",
13            "createdAt": "2024-12-12 11:40:19",
14            "finishedAt": "2024-12-12 11:40:21",
15            "deal": {
16                "id": "01JEXAPZ9C9TWENPFZJASZ1YD2",
17                "state": "completed",
18                "createdAt": "2024-12-12 11:40:21",
19                "completedAt": "2024-12-12 11:40:21",
20                "averageFilledPrice": "0.2962000000000000",
21                "transactions": [
22                    {
23                        "id": "01JEXAPZ9C9TWENPFZJASZ1YD3",
24                        "tradeRole": "taker",
25                        "filledPrice": "0.2962000000000000",
26                        "filledQuantity": "67.5400000000000000",
27                        "filledValue": "20.0053480000000000",
28                        "fee": "0.0000000000000000",
29                        "feeCurrency": "USDT",
30                        "committedAt": "2024-12-12 11:40:21"
31                    }
32                ]
33            }
34        },
35        {
36            "id": "01JEXAJDK51C453Z3395RTAY8Y",
37            "type": "market",
38            "direction": "buy",
39            "symbol": "TRX_USDT",
40            "value": "20.0000000000000000",
41            "filledQuantity": "67.5400000000000000",
42            "filledValue": "19.9985940000000000",
43            "state": "completed",
44            "internalState": "filled",
45            "createdAt": "2024-12-12 11:37:51",
46            "finishedAt": "2024-12-12 11:37:53",
47            "deal": {
48                "id": "01JEXAJF41RJ05Z220F2H01S9Z",
49                "state": "completed",
50                "createdAt": "2024-12-12 11:37:53",
51                "completedAt": "2024-12-12 11:37:53",
52                "averageFilledPrice": "0.2961000000000000",
53                "transactions": [
54                    {
55                        "id": "01JEXAJF4ADPPPVH3NVP2SFX0F",
56                        "tradeRole": "taker",
57                        "filledPrice": "0.2961000000000000",
58                        "filledQuantity": "67.5400000000000000",
59                        "filledValue": "19.9985940000000000",
60                        "fee": "0.0000000000000000",
61                        "feeCurrency": "TRX",
62                        "committedAt": "2024-12-12 11:37:53"
63                    }
64                ]
65            }
66        },
67        {
68            "id": "01JEXAFCCC5ZVJPZAAHHDKQBNG",
69            "type": "limit",
70            "direction": "sell",
71            "symbol": "TRX_USDT",
72            "price": "0.2964000000000000",
73            "quantity": "20.0000000000000000",
74            "value": "5.9280000000000000",
75            "filledQuantity": "20.0000000000000000",
76            "filledValue": "5.9280000000000000",
77            "state": "completed",
78            "internalState": "filled",
79            "createdAt": "2024-12-12 11:36:12",
80            "finishedAt": "2024-12-12 11:36:22",
81            "deal": {
82                "id": "01JEXAFP50QGFS8CGY2YRR5EDV",
83                "state": "completed",
84                "createdAt": "2024-12-12 11:36:22",
85                "completedAt": "2024-12-12 11:36:22",
86                "averageFilledPrice": "0.2964000000000000",
87                "transactions": [
88                    {
89                        "id": "01JEXAFP55H5XHF3SHRVCEQ1G9",
90                        "tradeRole": "taker",
91                        "filledPrice": "0.2964000000000000",
92                        "filledQuantity": "20.0000000000000000",
93                        "filledValue": "5.9280000000000000",
94                        "fee": "0.0000000000000000",
95                        "feeCurrency": "USDT",
96                        "committedAt": "2024-12-12 11:36:22"
97                    }
98                ]
99            }
100        }
101    ]
102}
103      
Menyalin

Kode yang mungkin

404: Pengguna atau sumber daya tidak ditemukan

422: Data masukan tidak valid

500: Kesalahan server internal

Kemungkinan kombinasi

NamaDefinisikeadaan_internal
completedPesanan sudah selesai dan terisi penuhdipenuhi
canceledPesanan tidak terpenuhi dan dibatalkan oleh penggunakosong
canceled_by_stop_lossPesanan tidak terpenuhi dan secara otomatis dibatalkan karena pasar mencapai harga stop_losskosong
canceledPesanan sebagian terpenuhi dan kemudian dibatalkan oleh penggunasebagian_terisi
canceled_by_stop_lossPesanan sebagian terisi dan kemudian dibatalkan secara otomatis karena pasar mencapai harga stop_losssebagian_terisi

Definisi

Pesanan sudah selesai dan terisi penuh

Definisi

Pesanan tidak terpenuhi dan dibatalkan oleh pengguna

Definisi

Pesanan tidak terpenuhi dan secara otomatis dibatalkan karena pasar mencapai harga stop_loss

Definisi

Pesanan sebagian terpenuhi dan kemudian dibatalkan oleh pengguna

Definisi

Pesanan sebagian terisi dan kemudian dibatalkan secara otomatis karena pasar mencapai harga stop_loss

Kemungkinan kesalahan

contoh tanggapan:


1{
2  "state": 0,
3  "message": "Standard validation error"
4}
Menyalin

Contoh respons dengan kesalahan


1{
2  "code": 0,
3  "message": "Validation failed.",
4  "errors": [
5    {
6      "property": "direction",
7      "value": "sells",
8      "message": "The value you selected is not a valid choice."
9    }
10  ]
11}
Menyalin