تاریخچه سفارشات تکمیل شده

get
https://api.cryptomus.com/v2/user-api/exchange/orders/history
کپی

درخواست

پارامترهای پرس و جو

نامنوع پارامتریتعریف
marketstringفیلتر براساس جفت معاملاتی (به عنوان مثال، «TRX_USDT»)
directionstringفیلتر بر اساس جهتگزینه های موجود:buysell
order_idstringبر اساس شناسه سفارش در دفترچه سفارش فیلتر کنید
client_order_idstringبر اساس شناسه سفارش مشتری فیلتر کنید
limitstringیک پارامتر ویژه که حداکثر تعداد رکوردهایی را که درخواست باز می گردد را تعیین می کند
offsetstringیک پارامتر خاص که تعداد رکوردهایی را که باید رد شوند را نشان می دهد

نوع پارامتری

string

تعریف

فیلتر براساس جفت معاملاتی (به عنوان مثال، «TRX_USDT»)

نوع پارامتری

string

تعریف

فیلتر بر اساس جهتگزینه های موجود:- buy- sell

نوع پارامتری

string

تعریف

بر اساس شناسه سفارش در دفترچه سفارش فیلتر کنید

نوع پارامتری

string

تعریف

بر اساس شناسه سفارش مشتری فیلتر کنید

نوع پارامتری

string

تعریف

یک پارامتر ویژه که حداکثر تعداد رکوردهایی را که درخواست باز می گردد را تعیین می کند

نوع پارامتری

string

تعریف

یک پارامتر خاص که تعداد رکوردهایی را که باید رد شوند را نشان می دهد

واکنش

پارامترهای پاسخ را سفارش دهید

نامتعریف
idشناسه سفارش در دفترچه سفارش
typeنوع سفارشگزینه های موجود:buysell
directionجهت سفارشگزینه های موجود:buysell
symbolفیلتر براساس جفت معاملاتی (به عنوان مثال، «TRX_USDT»)
quantityمقدار درخواستی دارایی پایه
filledQuantityمقدار پر شده دارایی پایه
filledValueمقدار پر شده از دارایی نقل قول
stateوضعیت فعلی سفارش (به عنوان مثال، "تکمیل")
internalStateوضعیت داخلی سفارش (به عنوان مثال، "پر شده")
createdAtزمان ایجاد سفارش
finishedAtزمان تکمیل سفارش
stopLossPriceآستانه قیمت بازار دارایی که پس از رسیدن به آن سفارش به طور خودکار لغو می شود

تعریف

شناسه سفارش در دفترچه سفارش

تعریف

نوع سفارشگزینه های موجود:- buy- sell

تعریف

جهت سفارشگزینه های موجود:- buy- sell

تعریف

فیلتر براساس جفت معاملاتی (به عنوان مثال، «TRX_USDT»)

تعریف

مقدار درخواستی دارایی پایه

تعریف

مقدار پر شده دارایی پایه

تعریف

مقدار پر شده از دارایی نقل قول

تعریف

وضعیت فعلی سفارش (به عنوان مثال، "تکمیل")

تعریف

وضعیت داخلی سفارش (به عنوان مثال، "پر شده")

تعریف

زمان ایجاد سفارش

تعریف

زمان تکمیل سفارش

تعریف

آستانه قیمت بازار دارایی که پس از رسیدن به آن سفارش به طور خودکار لغو می شود

پارامترهای پاسخ معامله

نامتعریف
idشناسه معامله
stateوضعیت تجاری (به عنوان مثال، "تکمیل شده")
createdAtزمانی که تجارت ایجاد شد
completedAtزمانی که معامله به پایان رسید
averageFilledPriceمیانگین قیمت پر شده برای معامله

تعریف

شناسه معامله

تعریف

وضعیت تجاری (به عنوان مثال، "تکمیل شده")

تعریف

زمانی که تجارت ایجاد شد

تعریف

زمانی که معامله به پایان رسید

تعریف

میانگین قیمت پر شده برای معامله

پارامترهای پاسخ معامله معامله

نامتعریف
idشناسه تراکنش
tradeRoleنقش در تجارتگزینه های موجود:takermaker
filledPriceقیمت پر شده برای معامله
filledQuantityمبلغ اجرا شده به ارز پایه
filledValueمبلغ اجرا شده به ارز مظنه
feeکارمزد تراکنش
feeCurrencyارزی که کارمزد در آن محاسبه می شود
committedAtزمان اجرای تراکنش

تعریف

شناسه تراکنش

تعریف

نقش در تجارتگزینه های موجود:- 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سفارش تا حدی پر شد و سپس توسط کاربر لغو شدpartally_filled
canceled_by_stop_lossسفارش تا حدی تکمیل شد و سپس به دلیل رسیدن بازار به قیمت stop_loss به طور خودکار لغو شد.partally_filled

تعریف

سفارش تکمیل و به طور کامل پر شده است

تعریف

سفارش پر نشد و توسط کاربر لغو شد

تعریف

سفارش تکمیل نشد و به دلیل رسیدن بازار به قیمت 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}
کپی