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

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

درخواست

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

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

نوع پارامتری

string

تعریف

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

نوع پارامتری

string

تعریف

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

نوع پارامتری

string

تعریف

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

نوع پارامتری

string

تعریف

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

نوع پارامتری

string

تعریف

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

نوع پارامتری

string

تعریف

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

واکنش

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

نامنوع پارامتریتعریف
idstringشناسه سفارش در دفترچه سفارش
typestringنوع سفارشگزینه های موجود:• buy• sell
directionstringجهت سفارشگزینه های موجود:• buy• sell
symbolstringفیلتر براساس جفت معاملاتی (به عنوان مثال، «TRX_USDT»)
quantitystring|nullمقدار درخواستی دارایی پایه
filledQuantitystringمقدار پر شده دارایی پایه
filledValuestringمقدار پر شده از دارایی نقل قول
statestringوضعیت فعلی سفارش (به عنوان مثال، "تکمیل")
internalStatestringوضعیت داخلی سفارش (به عنوان مثال، "پر شده")
createdAtstringزمان ایجاد سفارش
finishedAtstringزمان تکمیل سفارش
stopLossPricestring|nullآستانه قیمت بازار دارایی که پس از رسیدن به آن سفارش به طور خودکار لغو می شود

نوع پارامتری

string

تعریف

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

نوع پارامتری

string

تعریف

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

نوع پارامتری

string

تعریف

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

نوع پارامتری

string

تعریف

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

نوع پارامتری

string|null

تعریف

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

نوع پارامتری

string

تعریف

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

نوع پارامتری

string

تعریف

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

نوع پارامتری

string

تعریف

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

نوع پارامتری

string

تعریف

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

نوع پارامتری

string

تعریف

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

نوع پارامتری

string

تعریف

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

نوع پارامتری

string|null

تعریف

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

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

نامنوع پارامتریتعریف
idstringشناسه معامله
statestringوضعیت تجاری (به عنوان مثال، "تکمیل شده")
createdAtstringزمانی که تجارت ایجاد شد
completedAtstringزمانی که معامله به پایان رسید
averageFilledPricestringمیانگین قیمت پر شده برای معامله

نوع پارامتری

string

تعریف

شناسه معامله

نوع پارامتری

string

تعریف

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

نوع پارامتری

string

تعریف

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

نوع پارامتری

string

تعریف

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

نوع پارامتری

string

تعریف

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

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

نامنوع پارامتریتعریف
idstringشناسه تراکنش
tradeRolestringنقش در تجارتگزینه های موجود:• taker• maker
filledPricestringقیمت پر شده برای معامله
filledQuantitystringمبلغ اجرا شده به ارز پایه
filledValuestringمبلغ اجرا شده به ارز مظنه
feestringکارمزد تراکنش
feeCurrencystringارزی که کارمزد در آن محاسبه می شود
committedAtstringزمان اجرای تراکنش

نوع پارامتری

string

تعریف

شناسه تراکنش

نوع پارامتری

string

تعریف

نقش در تجارتگزینه های موجود:- taker- maker

نوع پارامتری

string

تعریف

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

نوع پارامتری

string

تعریف

مبلغ اجرا شده به ارز پایه

نوع پارامتری

string

تعریف

مبلغ اجرا شده به ارز مظنه

نوع پارامتری

string

تعریف

کارمزد تراکنش

نوع پارامتری

string

تعریف

ارزی که کارمزد در آن محاسبه می شود

نوع پارامتری

string

تعریف

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

نمونه پاسخ


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}
کپی کنید