보유 자산의 변동 사항을 실시간으로 수신합니다.

Private v2 응답 스펙입니다. MyAsset의 응답 구조는 v1과 v2가 동일하므로 응답 처리 로직은 그대로 유지하되, 연결 엔드포인트는 wss://ws-api.bithumb.com/websocket/v2/private 로 변경해야 합니다. v1 엔드포인트는 2026년 9월 30일에 종료됩니다.

Request

요청은 ticket, type, format 필드로 구성됩니다. 공통 요청 포맷은 요청 방법 및 포맷 페이지를 확인하세요.

Type Field

필드명	타입	설명	필수	기본값
`type`	String	데이터 타입. `myAsset`: 내 자산	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
   }