HomeGuidesAPI ReferenceAnnouncements
AnnouncementsGuidesAPI ReferenceSupportFAQ
API Reference

λ‚΄ μžμ‚° (MyAsset)

πŸ“˜

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

μˆ˜μ‹ ν•˜κ³  싢은 μ‹œμ„Έ 정보λ₯Ό λ‚˜μ—΄ν•˜λŠ” ν•„λ“œμž…λ‹ˆλ‹€.

ν•„λ“œλͺ…
νƒ€μž…
λ‚΄μš©
ν•„μˆ˜ μ—¬λΆ€
κΈ°λ³Έ κ°’
typeString데이터 νƒ€μž…
-Β myAsset: λ‚΄ μžμ‚°
O

Response

ν•„λ“œλͺ…
μΆ•μ•½ν˜• (format: SIMPLE)
λ‚΄μš©
νƒ€μž…κ°’
typetyνƒ€μž…StringmyAsset : λ‚΄ μžμ‚°
asset_uuidastuidμžμ‚° 고유 아이디String
assetsastμžμ‚° 리슀트List of Objects
assets.currencyast.cu화폐λ₯Ό μ˜λ―Έν•˜λŠ” 영문 λŒ€λ¬Έμž μ½”λ“œString
assets.balanceast.bμ£Όλ¬Έκ°€λŠ₯ μˆ˜λŸ‰Double
assets.lockedast.lμ£Όλ¬Έ 쀑 λ¬Άμ—¬μžˆλŠ” μˆ˜λŸ‰Double
asset_timestampasttmsμžμ‚° νƒ€μž„μŠ€νƒ¬ν”„ (millisecond)Long
timestamptmsνƒ€μž„μŠ€νƒ¬ν”„ (millisecond)Long
stream_typest슀트림 νƒ€μž…StringREALTIME : μ‹€μ‹œκ°„

🚧

졜초 이용 μ‹œ 주의 사항

졜초 이용 μ‹œ 수 λΆ„κ°„ 데이터 전솑이 이뀄지지 μ•Šμ„ 수 μžˆμŠ΅λ‹ˆλ‹€. λ”°λΌμ„œ 개발 μ‹œ 데이터 μˆ˜μ‹ μ„ 1회 κΌ­ ν™•μΈν•˜μ‹œκΈΈ λ°”λžλ‹ˆλ‹€.

예λ₯Ό λ“€μ–΄ 2024λ…„ 5μ›” 1일 00μ‹œ 00λΆ„ 졜초 이용 μ‹œ μžμ‚° 변동이 μžˆλ”λΌλ„ 00μ‹œ 05λΆ„λΆ€ν„° 데이터λ₯Ό 전솑받을 수 μžˆμŠ΅λ‹ˆλ‹€. 이후 00μ‹œ 10뢄에 μž¬μ ‘μ†μ„ ν•  경우 μ΄λŠ” 졜초 이용이 μ•„λ‹ˆλ―€λ‘œ μžμ‚° 변동 μ‹œ λ°”λ‘œ 데이터λ₯Ό μˆ˜μ‹ ν•˜μ‹€ 수 μžˆμŠ΅λ‹ˆλ‹€.

Example

Request

예제 1. λͺ¨λ“  λ§ˆμΌ“ 정보 μˆ˜μ‹ 

*μ£Όμ˜μ‚¬ν•­: codes ν•„λ“œλ₯Ό μš”μ²­ν•˜μ‹€ 수 μ—†μŠ΅λ‹ˆλ‹€. 이 경우 WRONG_FORMAT μ—λŸ¬κ°€ λ‚΄λ €κ°€κ²Œ λ©λ‹ˆλ‹€.

[
  {
    "ticket": "test-myAsset"
  },
  {
    "type": "myAsset"
  }
]

Response

{
  "type": "myAsset",
  "asset_uuid": "e635f223-1609-4969-8fb6-4376937baad6",
  "assets": [
    {
      "currency": "KRW",
      "balance": 1386929.37231066771348207123,
      "locked": 10329.670127489597585685
    }
  ],
  "asset_timestamp": 1710146517259,
  "timestamp": 1710146517267,
  "stream_type": "REALTIME"
}