보유 자산의 변동을 실시간으로 수신합니다(Private v2).
보유 자산의 변동 사항을 실시간으로 수신합니다.
Private v2 응답 스펙입니다. MyAsset의 응답 구조는 v1과 v2가 동일하므로 응답 처리 로직은 그대로 유지하되, 연결 엔드포인트는
wss://ws-api.bithumb.com/websocket/v2/private로 변경해야 합니다. v1 엔드포인트는 추후 종료 예정입니다. 종료 일정 변경에 대한 자세한 내용은 Private WebSocket v1 지원 종료 일정 연기 안내 공지를 확인하세요.
Request
요청은 ticket, type, format 필드로 구성됩니다. 공통 요청 포맷은 요청 방법 및 포맷 페이지를 확인하세요.
Type Field
| 필드명 | 타입 | 설명 | 필수 | 기본값 |
|---|---|---|---|---|
type | String | 데이터 타입.
| O |
잘못된 예시:
[
{
"ticket": "test example"
},
{
"type": "MyAsset"
}
]위와 같이 요청할 경우 형식 오류가 발생할 수 있습니다.
Response
응답 필드
| 필드명 | SIMPLE | 타입 | 설명 |
|---|---|---|---|
type | ty | String | 데이터 타입. myAsset |
stream_type | st | String | REALTIME 고정 |
assets | ast | List of Objects | 자산 목록 |
assets[].currency | ast[].cu | String | 화폐 코드(영문 대문자) |
assets[].balance | ast[].b | Double | 주문 가능 수량 |
assets[].locked | ast[].l | Double | 주문 중 묶여 있는 수량 |
asset_timestamp | asttms | Long | 자산 변경 시각(milliseconds) |
timestamp | tms | Long | 메시지 송신 시각(milliseconds) |
Example
Request
[
{ "ticket": "test example" },
{ "type": "myAsset" }
]Response
자산별로 별도 메시지가 도착합니다. 여러 자산이 동시에 변동하면 자산 수만큼 메시지가 차례로 옵니다.
{
"type": "myAsset",
"stream_type": "REALTIME",
"assets": [
{
"currency": "KRW",
"balance": "2061832.35",
"locked": "3824127.3"
}
],
"asset_timestamp": 1727052537592,
"timestamp": 1727052537687
}
{
"type": "myAsset",
"stream_type": "REALTIME",
"assets": [
{
"currency": "BTC",
"balance": "156.70564833",
"locked": "38.81945789"
}
],
"asset_timestamp": 1727052537592,
"timestamp": 1727052537690
}{
"ty": "myAsset",
"st": "REALTIME",
"ast": [
{
"cu": "KRW",
"b": "2061832.35",
"l": "3824127.3"
}
],
"asttms": 1727052537592,
"tms": 1727052537687
}
{
"ty": "myAsset",
"st": "REALTIME",
"ast": [
{
"cu": "BTC",
"b": "156.70564833",
"l": "38.81945789"
}
],
"asttms": 1727052537592,
"tms": 1727052537690
}