Private 타입 endpoint
새롭게 추가된
myOrder와myAsset타입의 경우wss://api.upbit.com/websocket/v1/private으로 요청하셔야 합니다. 자세한 내용은 기본 정보 를 참고해주시기 바랍니다.
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 | 데이터 타입 - myOrder: 내 주문 | O | |
| codes | List | 마켓 코드 리스트 *대문자로 요청해야 합니다. | X | 생략하거나 빈 배열로 요청할 경우 모든 마켓에 대한 정보를 수신합니다. |
Response
| 필드명 | 축약형 (format: SIMPLE) | 내용 | 타입 | 값 |
|---|---|---|---|---|
| type | ty | 타입 | String | myOrder : 내 주문 |
| code | cd | 마켓 코드 (ex. KRW-BTC) | String | |
| uuid | uid | 주문 고유 아이디 | String | |
| ask_bid | ab | 매수/매도 구분 | String | ASK : 매도BID : 매수 |
| order_type | ot | 주문 타입 | String | limit: 지정가 주문price: 시장가 매수 주문market: 시장가 매도 주문best: 최유리 지정가 주문 |
| state | s | 주문 상태 | String | wait: 체결 대기watch: 예약 주문 대기trade: 체결 발생done: 전체 체결 완료cancel: 주문 취소 |
| trade_uuid | tuid | 체결의 고유 아이디 | String | |
| price | p | 주문 가격, 체결 가격 (state: trade 일 때) | Double | |
| avg_price | ap | 평균 체결 가격 | Double | |
| volume | v | 주문량, 체결량 (state: trade 일 때) | Double | |
| remaining_volume | rv | 체결 후 남은 주문 양 | Double | |
| executed_volume | ev | 체결된 양 | Double | |
| trades_count | tc | 해당 주문에 걸린 체결 수 | Integer | |
| reserved_fee | rsf | 수수료로 예약된 비용 | Double | |
| remaining_fee | rmf | 남은 수수료 | Double | |
| paid_fee | pf | 사용된 수수료 | Double | |
| locked | l | 거래에 사용중인 비용 | Double | |
| executed_funds | ef | 체결된 금액 | Double | |
| time_in_force | tif | IOC, FOK 설정 | String | iocfok |
| trade_timestamp | ttms | 체결 타임스탬프 (millisecond) | Long | |
| order_timestamp | otms | 주문 타임스탬프 (millisecond) | Long | |
| timestamp | tms | 타임스탬프 (millisecond) | Long | |
| stream_type | st | 스트림 타입 | String | REALTIME : 실시간 |
best, price 주문 주의사항 (*24/12/4 이후
cancel발행으로 변경예정)best, price 주문일 때 체결이 1개라도 있는 경우
cancel이벤트가 발행되지 않습니다. 이는 체결 후 남은 잔량이 반환되어cancel처리되는 경우를 포함합니다.
Example
Request
예제 1. 모든 마켓 정보 수신 (codes 필드 제외)
[
{
"ticket": "test-myOrder"
},
{
"type": "myOrder"
}
]
예제 2. 모든 마켓 정보 수신 (codes 에 빈 배열)
[
{
"ticket": "test-myOrder"
},
{
"type": "myOrder",
"codes": []
}
]
예제 3. 특정 마켓 정보 수신
[
{
"ticket": "test-myOrder"
},
{
"type": "myOrder",
"codes": ["KRW-BTC"]
}
]
Response
{
"type": "myOrder",
"code": "KRW-BTC",
"uuid": "ac2dc2a3-fce9-40a2-a4f6-5987c25c438f",
"ask_bid": "BID",
"order_type": "limit",
"state": "trade",
"trade_uuid": "68315169-fba4-4175-ade3-aff14a616657",
"price": 0.001453,
"avg_price": 0.00145372,
"volume": 30925891.29839369,
"remaining_volume": 29968038.09235948,
"executed_volume": 30925891.29839369,
"trades_count": 1,
"reserved_fee": 44.23943970238218,
"remaining_fee": 21.77177967409916,
"paid_fee": 22.467660028283017,
"locked": 43565.33112787242,
"executed_funds": 44935.32005656603,
"time_in_force": null,
"trade_timestamp": 1710751590421,
"order_timestamp": 1710751590000,
"timestamp": 1710751597500,
"stream_type": "REALTIME"
}