완료된 주문 내역
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}