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 | ๋ฐ์ดํฐ ํ์
-ย myAsset : ๋ด ์์ฐ | O |
Response
ํ๋๋ช | ์ถ์ฝํ (format: SIMPLE) | ๋ด์ฉ | ํ์ | ๊ฐ |
---|---|---|---|---|
type | ty | ํ์ | String | myAsset : ๋ด ์์ฐ |
asset_uuid | astuid | ์์ฐ ๊ณ ์ ์์ด๋ | String | |
assets | ast | ์์ฐ ๋ฆฌ์คํธ | List of Objects | |
assets.currency | ast.cu | ํํ๋ฅผ ์๋ฏธํ๋ ์๋ฌธ ๋๋ฌธ์ ์ฝ๋ | String | |
assets.balance | ast.b | ์ฃผ๋ฌธ๊ฐ๋ฅ ์๋ | Double | |
assets.locked | ast.l | ์ฃผ๋ฌธ ์ค ๋ฌถ์ฌ์๋ ์๋ | Double | |
asset_timestamp | asttms | ์์ฐ ํ์์คํฌํ (millisecond) | Long | |
timestamp | tms | ํ์์คํฌํ (millisecond) | Long | |
stream_type | st | ์คํธ๋ฆผ ํ์ | String | REALTIME : ์ค์๊ฐ |
์ต์ด ์ด์ฉ ์ ์ฃผ์ ์ฌํญ
์ต์ด ์ด์ฉ ์ ์ ๋ถ๊ฐ ๋ฐ์ดํฐ ์ ์ก์ด ์ด๋ค์ง์ง ์์ ์ ์์ต๋๋ค. ๋ฐ๋ผ์ ๊ฐ๋ฐ ์ ๋ฐ์ดํฐ ์์ ์ 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"
}