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:• buy• sell
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

NamaJenis parameterDefinisi
idstringID pesanan di buku pesanan
typestringJenis pesananPilihan yang tersedia:• buy• sell
directionstringArah pesananPilihan yang tersedia:• buy• sell
symbolstringFilter berdasarkan pasangan perdagangan (misalnya, `TRX_USDT`)
quantitystring|nullJumlah aset dasar yang diminta
filledQuantitystringJumlah aset dasar yang terisi
filledValuestringJumlah aset kutipan yang terisi
statestringStatus pesanan saat ini (misalnya, 'selesai')
internalStatestringKeadaan internal pesanan (misalnya, 'terpenuhi')
createdAtstringWaktu ketika pesanan dibuat
finishedAtstringWaktu ketika pesanan selesai
stopLossPricestring|nullHarga ambang batas pasar aset, yang jika tercapai maka pesanan akan dibatalkan secara otomatis

Jenis parameter

string

Definisi

ID pesanan di buku pesanan

Jenis parameter

string

Definisi

Jenis pesananPilihan yang tersedia:- buy- sell

Jenis parameter

string

Definisi

Arah pesananPilihan yang tersedia:- buy- sell

Jenis parameter

string

Definisi

Filter berdasarkan pasangan perdagangan (misalnya, `TRX_USDT`)

Jenis parameter

string|null

Definisi

Jumlah aset dasar yang diminta

Jenis parameter

string

Definisi

Jumlah aset dasar yang terisi

Jenis parameter

string

Definisi

Jumlah aset kutipan yang terisi

Jenis parameter

string

Definisi

Status pesanan saat ini (misalnya, 'selesai')

Jenis parameter

string

Definisi

Keadaan internal pesanan (misalnya, 'terpenuhi')

Jenis parameter

string

Definisi

Waktu ketika pesanan dibuat

Jenis parameter

string

Definisi

Waktu ketika pesanan selesai

Jenis parameter

string|null

Definisi

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

Parameter respons transaksi

NamaJenis parameterDefinisi
idstringID perdagangan
statestringStatus perdagangan (misalnya, `selesai`)
createdAtstringWaktu ketika perdagangan diciptakan
completedAtstringWaktu ketika perdagangan selesai
averageFilledPricestringHarga rata-rata yang terisi untuk perdagangan

Jenis parameter

string

Definisi

ID perdagangan

Jenis parameter

string

Definisi

Status perdagangan (misalnya, `selesai`)

Jenis parameter

string

Definisi

Waktu ketika perdagangan diciptakan

Jenis parameter

string

Definisi

Waktu ketika perdagangan selesai

Jenis parameter

string

Definisi

Harga rata-rata yang terisi untuk perdagangan

Parameter respons transaksi transaksi

NamaJenis parameterDefinisi
idstringID transaksi
tradeRolestringPeran dalam perdaganganPilihan yang tersedia:• taker• maker
filledPricestringHarga terisi untuk transaksi
filledQuantitystringJumlah yang dieksekusi dalam mata uang dasar
filledValuestringJumlah yang dieksekusi dalam mata uang kutipan
feestringBiaya transaksi
feeCurrencystringMata uang yang dikenakan biaya
committedAtstringWaktu pelaksanaan transaksi

Jenis parameter

string

Definisi

ID transaksi

Jenis parameter

string

Definisi

Peran dalam perdaganganPilihan yang tersedia:- taker- maker

Jenis parameter

string

Definisi

Harga terisi untuk transaksi

Jenis parameter

string

Definisi

Jumlah yang dieksekusi dalam mata uang dasar

Jenis parameter

string

Definisi

Jumlah yang dieksekusi dalam mata uang kutipan

Jenis parameter

string

Definisi

Biaya transaksi

Jenis parameter

string

Definisi

Mata uang yang dikenakan biaya

Jenis parameter

string

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