myTrade는myOrder에 포함되어 deprecated 되어 있습니다. 정확한 지원종료 예정일은 공지사항을 통해 다시 안내드릴 예정이며myOrder를 사용해주시길 바랍니다.
Request
요청은 JSON Object를 이용하며 응답 또한 JSON Object 입니다. 요청은 크게 ticket field, type field, format field 로 나누어지며 하나의 요청에 여러 개의 type field 를 명시할 수 있습니다. ticket field 와 format field 에 대해서는 요청 방법 및 포맷을 참고해주시기 바랍니다.
Request format
[{Ticket Field},{Type Field},....,{Type Field},{Format Field}]
Type Field
수신하고 싶은 시세 정보를 나열하는 필드입니다.
필드명 | 타입 | 내용 | 필수 여부 | 기본 값 |
|---|---|---|---|---|
| type | String | 데이터 타입 - myTrade: 내 체결 | O | |
| codes | List | 마켓 코드 리스트 *대문자로 요청해야 합니다. | X | 생략하거나 빈 배열로 요청할 경우 모든 마켓에 대한 정보를 수신합니다. |
Response
| 필드명 | 축약형 (format: SIMPLE) | 내용 | 타입 | 값 |
|---|---|---|---|---|
| type | ty | 타입 | String | myTrade : 내 체결 |
| code | cd | 마켓 코드 (ex. KRW-BTC) | String | |
| ask_bid | ab | 매수/매도 구분 | String | ASK : 매도BID : 매수 |
| price | p | 체결 가격 | Double | |
| volume | v | 체결량 | Double | |
| order_uuid | ouid | 주문의 고유 아이디 | String | |
| order_type | ot | 주문 타입 | String | limit: 지정가 주문 price: 시장가 매수 주문 market: 시장가 매도 주문 |
| trade_uuid | tuid | 체결의 고유 아이디 | String | |
| trade_timestamp | ttms | 체결 타임스탬프 (millisecond) | Long | |
| stream_type | st | 스트림 타입 | String | REALTIME : 실시간 |
Example
Request
예제 1. 모든 마켓 정보 수신 (codes 필드 제외)
[
{
"ticket": "test"
},
{
"type": "myTrade"
}
]
예제 2. 모든 마켓 정보 수신 (codes 에 빈 배열)
[
{
"ticket": "test"
},
{
"type": "myTrade",
"codes": []
}
]
예제 3. 특정 마켓 정보 수신
[
{
"ticket": "test"
},
{
"type": "myTrade",
"codes": ["KRW-BTC"]
}
]
Response
{
"type": "myTrade",
"code": "KRW-BTC",
"ask_bid": "BID",
"price": 55660000,
"volume": 0.5389867,
"order_uuid": "e5cec6f9-6a15-4c95-ae76-6d7dcb3a00e0",
"order_type": "price",
"trade_uuid": "cd955522-c9d8-4f06-b86d-54a09a25e707",
"trade_timestamp": 1677487182655,
"stream_type": "REALTIME"
}