完了した注文の履歴
get
https://api.cryptomus.com/v2/user-api/exchange/orders/history
リクエスト
クエリパラメーター
| 名前 | パラメータータイプ | 意味 |
|---|---|---|
| market | string | 取引ペアによるフィルター (例: `TRX_USDT`) |
| direction | string | 方向でフィルタリングする利用可能なオプション：• buy• sell |
| order_id | string | オーダーブック内のオーダーIDでフィルタリングします |
| client_order_id | string | クライアントの注文 ID によるフィルター |
| limit | string | リクエストが返すレコードの最大数を設定する特別なパラメータ |
| offset | string | スキップするレコードの数を示す特別なパラメータ |
パラメータータイプ
string意味
取引ペアによるフィルター (例: `TRX_USDT`)パラメータータイプ
string意味
方向でフィルタリングする利用可能なオプション：- buy- sellパラメータータイプ
string意味
オーダーブック内のオーダーIDでフィルタリングしますパラメータータイプ
string意味
クライアントの注文 ID によるフィルターパラメータータイプ
string意味
リクエストが返すレコードの最大数を設定する特別なパラメータパラメータータイプ
string意味
スキップするレコードの数を示す特別なパラメータ
応答
注文応答パラメータ
| 名前 | 意味 |
|---|---|
| id | オーダーブックのオーダーID |
| type | 注文タイプ利用可能なオプション：• buy• sell |
| direction | 注文方向利用可能なオプション：• buy• sell |
| symbol | 取引ペアによるフィルター (例: `TRX_USDT`) |
| quantity | 基本資産の要求数量 |
| filledQuantity | 基本資産の充填数量 |
| filledValue | 見積資産の約定数量 |
| state | 注文の現在の状態 (例: 「完了」) |
| internalState | 注文の内部状態 (例: 「約定済み」) |
| createdAt | 注文が作成された時刻 |
| finishedAt | 注文が完了した時刻 |
| stopLossPrice | 資産の市場価格のしきい値。この価格に達すると注文が自動的にキャンセルされます。 |
意味
オーダーブックのオーダーID意味
注文タイプ利用可能なオプション：- buy- sell意味
注文方向利用可能なオプション：- buy- sell意味
取引ペアによるフィルター (例: `TRX_USDT`)意味
基本資産の要求数量意味
基本資産の充填数量意味
見積資産の約定数量意味
注文の現在の状態 (例: 「完了」)意味
注文の内部状態 (例: 「約定済み」)意味
注文が作成された時刻意味
注文が完了した時刻意味
資産の市場価格のしきい値。この価格に達すると注文が自動的にキャンセルされます。
取引応答パラメータ
| 名前 | 意味 |
|---|---|
| id | トレードID |
| state | 取引状態 (例: 「完了」) |
| createdAt | 取引が作成された時刻 |
| completedAt | 取引が完了した時刻 |
| averageFilledPrice | 取引の平均約定価格 |
意味
トレードID意味
取引状態 (例: 「完了」)意味
取引が作成された時刻意味
取引が完了した時刻意味
取引の平均約定価格
取引トランザクション応答パラメータ
| 名前 | 意味 |
|---|---|
| id | トランザクションID |
| tradeRole | 貿易における役割利用可能なオプション：• taker• maker |
| filledPrice | 取引の約定価格 |
| filledQuantity | 基本通貨での約定金額 |
| filledValue | 見積通貨での約定金額 |
| fee | 取引手数料 |
| feeCurrency | 料金が請求される通貨 |
| committedAt | トランザクション実行時刻 |
意味
トランザクションID意味
貿易における役割利用可能なオプション：- taker- maker意味
取引の約定価格意味
基本通貨での約定金額意味
見積通貨での約定金額意味
取引手数料意味
料金が請求される通貨意味
トランザクション実行時刻
応答の例
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 考えられるコード
404: ユーザーまたはリソースが見つかりません
422: 入力データが無効です
500: 内部サーバーエラー
可能な組み合わせ
| 名前 | 意味 | 内部状態 |
|---|---|---|
| completed | 注文は完了し、完全に満たされています | 満たされた |
| canceled | 注文は履行されず、ユーザーによってキャンセルされました | 空の |
| canceled_by_stop_loss | 注文は約定されず、市場が stop_loss 価格に達したため自動的にキャンセルされました | 空の |
| canceled | 注文は部分的に満たされましたが、ユーザーによってキャンセルされました | 部分的に満たされた |
| canceled_by_stop_loss | 注文は部分的に約定されましたが、市場が stop_loss 価格に達したため自動的にキャンセルされました | 部分的に満たされた |
意味
注文は完了し、完全に満たされています意味
注文は履行されず、ユーザーによってキャンセルされました意味
注文は約定されず、市場が stop_loss 価格に達したため自動的にキャンセルされました意味
注文は部分的に満たされましたが、ユーザーによってキャンセルされました意味
注文は部分的に約定されましたが、市場が stop_loss 価格に達したため自動的にキャンセルされました
可能なエラー
回答の例：
1{
2 "state": 0,
3 "message": "Standard validation error"
4}エラーによる応答例
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}