내 자산 (MyAsset)

보유 자산의 변동을 실시간으로 수신합니다(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

필드명타입설명필수기본값
typeString데이터 타입.
  • myAsset: 내 자산
O

잘못된 예시:

[
  {
    "ticket": "test example"
  },
  {
    "type": "MyAsset"
  }
]

위와 같이 요청할 경우 형식 오류가 발생할 수 있습니다.

Response

응답 필드

필드명SIMPLE타입설명
typetyString데이터 타입. myAsset
stream_typestStringREALTIME 고정
assetsastList of Objects자산 목록
assets[].currencyast[].cuString화폐 코드(영문 대문자)
assets[].balanceast[].bDouble주문 가능 수량
assets[].lockedast[].lDouble주문 중 묶여 있는 수량
asset_timestampasttmsLong자산 변경 시각(milliseconds)
timestamptmsLong메시지 송신 시각(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
}