요청과 응답 모델

JSON 필드명은 대소문자를 구분합니다. 가격·수량·잔고는 십진수 문자열로 처리하세요.

Time

필드	필수	타입	설명과 제약
`time`	예	integer	format: "int64"

Readiness

필드	필수	타입	설명과 제약
`status`	예	string

Currency

필드	필수	타입
`currencyId`	예	integer
`symbol`	예	string
`status`	예	string
`major`	예	boolean
`maxPrecision`	예	integer
`depositEnabled`	예	boolean
`withdrawalEnabled`	예	boolean
`transferEnabled`	예	boolean
`tradeEnabled`	예	boolean

CurrencyList

필드	필수	타입	설명과 제약
`items`	예	Currency[]

FeedCategory

필드	필수	타입	설명과 제약
`id`	예	string	pattern: "^[0-9]+$"
`slug`	예	string
`name`	예	string
`description`	예	string
`displayOrder`	예	integer	minimum: 0
`creationMicrotime`	예	integer	format: "int64"
`updateMicrotime`	예	integer	format: "int64"

FeedCategoryList

필드	필수	타입	설명과 제약
`items`	예	FeedCategory[]

FeedArticleSummary

필드	필수	타입	설명과 제약
`id`	예	string	pattern: "^[1-9][0-9]*$"
`canonicalKey`	예	string	{id}-{slug}
`canonicalPath`	예	string	/feed/{id}-{slug}
`categoryId`	예	string	pattern: "^[0-9]+$"
`categorySlug`	예	string
`categoryName`	예	string
`lang`	예	string
`slug`	예	string
`title`	예	string
`summary`	예	string
`thumbnailUrl`	예	string
`readingMinutes`	예	integer	Estimated reading time in minutes, stored when the article is saved. minimum: 1
`authorName`	예	string
`viewCount`	예	integer	minimum: 0
`publishedMicrotime`	예	integer	format: "int64"
`creationMicrotime`	예	integer	format: "int64"
`updateMicrotime`	예	integer	format: "int64"

FeedArticleDetail

상속: FeedArticleSummary

필드	필수	타입	설명과 제약
`contentMarkdown`	예	string
FeedArticleSummary + object

FeedArticleList

필드	필수	타입	설명과 제약
`items`	예	FeedArticleSummary[]
`sort`	예	string	허용값: "latest", "popular", "search"
`hasMore`	예	boolean
`nextCursor`	예	string	Empty when hasMore is false.

FeedHome

필드	필수	타입
`featured`	예	FeedArticleSummary / null
`latest`	예	FeedArticleSummary[]
`popular`	예	FeedArticleSummary[]
`categories`	예	FeedCategory[]

FeedViewCount

필드	필수	타입	설명과 제약
`id`	예	string	pattern: "^[1-9][0-9]*$"
`viewCount`	예	integer	minimum: 1

Market

필드	필수	타입
`symbol`	예	string
`baseCurrency`	예	string
`quoteCurrency`	예	string
`baseCurrencyId`	예	integer
`quoteCurrencyId`	예	integer
`status`	예	string
`pricePrecision`	예	integer
`quantityPrecision`	예	integer
`minQuantity`	예	string
`minNotional`	예	string

MarketList

필드	필수	타입	설명과 제약
`items`	예	Market[]

Ticker

필드	필수	타입	설명과 제약
`symbol`	예	string
`baseCurrencyId`	예	integer
`quoteCurrencyId`	예	integer
`lastPrice`	예	string
`priceChange`	예	string
`priceChangeRate`	예	string
`high`	예	string
`low`	예	string
`volume`	예	string
`quoteVolume`	예	string
`time`	예	integer	format: "int64"

TickerList

필드	필수	타입	설명과 제약
`items`	예	Ticker[]

TickerData

Ticker / TickerList

MarketStreamArg

필드	필수	타입	설명과 제약
`channel`	예	string	허용값: "ticker"
`symbol`	예	string / string

MarketStreamCommand

필드	필수	타입	설명과 제약
`id`	예	string	minLength: 1; maxLength: 64; pattern: "^[A-Za-z0-9._:-]+$"
`op`	예	string	허용값: "subscribe", "unsubscribe"
`args`	예	MarketStreamArg[]	minItems: 1; maxItems: 100

MarketStreamSubscriptionAck

필드	필수	타입	설명과 제약
`event`	예	string	허용값: "subscribed", "unsubscribed"
`id`	예	string
`args`	예	MarketStreamArg[]
`serverTime`	예	integer	format: "int64"

MarketStreamTickerEvent

필드	필수	타입	설명과 제약
`event`	예	string
`sequence`	예	integer	Contiguous sequence across all data channels on this connection. minimum: 1; format: "uint64"
`arg`	예	MarketStreamArg
`data`	예	Ticker
`serverTime`	예	integer	format: "int64"

MarketStreamErrorEvent

필드	필수	타입	설명과 제약
`event`	예	string
`id`	아니요	string	Command id when it could be parsed safely.
`error`	예	Error
`serverTime`	예	integer	format: "int64"

OrderBookLevel

필드	필수	타입	설명과 제약
`price`	예	string
`quantity`	예	string

OrderBook

필드	필수	타입	설명과 제약
`symbol`	예	string
`tick`	예	integer	minimum: 0; maximum: 4
`bids`	예	OrderBookLevel[]
`asks`	예	OrderBookLevel[]
`time`	예	integer	format: "int64"

Trade

필드	필수	타입	설명과 제약
`tradeId`	예	string
`symbol`	예	string
`side`	예	string	허용값: "buy", "sell", "unknown"
`price`	예	string
`quantity`	예	string
`time`	예	integer	format: "int64"
`microtime`	예	integer	format: "int64"

TradeList

필드	필수	타입	설명과 제약
`items`	예	Trade[]

Candle

필드	필수	타입	설명과 제약
`openTime`	예	integer	format: "int64"
`closeTime`	예	integer	format: "int64"
`open`	예	string
`high`	예	string
`low`	예	string
`close`	예	string
`volume`	예	string
`quoteVolume`	예	string

CandleList

필드	필수	타입
`symbol`	예	string
`interval`	예	string
`items`	예	Candle[]
`hasMore`	예	boolean

AccountPermissions

필드	필수	타입
`read`	예	boolean
`trade`	예	boolean
`withdraw`	예	boolean
`write`	예	boolean

Account

필드	필수	타입	설명과 제약
`accountId`	예	integer	format: "uint64"
`apiKeyId`	예	integer	format: "uint64"
`publicKey`	예	string
`permissions`	예	AccountPermissions
`createdAt`	예	integer	format: "int64"

Wallet

필드	필수	타입	설명과 제약
`walletId`	예	integer
`type`	예	string	허용값: "general", "spotTrade", "unknown"
`name`	예	string
`favorite`	예	boolean
`criteriaCurrency`	아니요	string
`criteriaCurrencyId`	예	integer
`incoming`	예	integer
`outgoing`	예	integer
`createdAt`	예	integer	format: "int64"
`updatedAt`	예	integer	format: "int64"

WalletList

필드	필수	타입	설명과 제약
`wallets`	예	Wallet[]

Balance

필드	필수	타입	설명과 제약
`walletId`	예	integer
`currency`	예	string
`currencyId`	예	integer
`available`	예	string
`inUse`	예	string
`total`	예	string
`updatedAt`	예	integer	format: "int64"

BalanceList

필드	필수	타입	설명과 제약
`balances`	예	Balance[]

Fill

필드	필수	타입	설명과 제약
`fillId`	예	string
`orderId`	예	string
`symbol`	아니요	string
`walletId`	예	integer
`side`	예	string	허용값: "buy", "sell", "unknown"
`type`	예	string	허용값: "limit", "unknown"
`liquidity`	예	string	허용값: "maker", "taker"
`price`	예	string
`quantity`	예	string
`quoteQuantity`	예	string
`baseCurrencyId`	예	integer
`quoteCurrencyId`	예	integer
`time`	예	integer	format: "int64"
`microtime`	예	integer	format: "int64"

FillList

필드	필수	타입	설명과 제약
`items`	예	Fill[]
`hasMore`	예	boolean

UserStreamSnapshot

필드	필수	타입	설명과 제약
`orders`	예	Order[]	Open spot orders visible to the API key.
`ordersHasMore`	예	boolean	True when more than 1000 open orders were visible at snapshot time.
`balances`	예	Balance[]	Current balances for every wallet visible to the API key.

UserStreamSnapshotEvent

필드	필수	타입	설명과 제약
`event`	예	string
`sequence`	예	integer	A snapshot always starts a new connection at sequence 0. format: "uint64"
`data`	예	UserStreamSnapshot
`serverTime`	예	integer	format: "int64"

UserStreamOrderEvent

필드	필수	타입	설명과 제약
`event`	예	string
`updateType`	예	string	The absolute lifecycle state represented by this update. 허용값: "open", "partiallyFilled", "filled", "canceled", "unknown"
`sequence`	예	integer	Contiguous sequence scoped to this WebSocket connection. minimum: 1; format: "uint64"
`data`	예	Order
`serverTime`	예	integer	format: "int64"

UserStreamFill

필드	필수	타입	설명과 제약
`executionId`	예	string	Opaque realtime deduplication id derived from order id and cumulative filled quantity. It is not the REST fillId.
`orderId`	예	string
`symbol`	아니요	string
`walletId`	예	integer
`side`	예	string	허용값: "buy", "sell", "unknown"
`type`	예	string	허용값: "limit", "unknown"
`liquidity`	예	string	허용값: "maker", "taker"
`price`	예	string	Execution price, or the weighted-average price when aggregated is true.
`quantity`	예	string
`quoteQuantity`	예	string
`cumulativeQuantity`	예	string
`cumulativeQuoteQuantity`	예	string
`cumulativeFee`	예	string	Order-level cumulative fee, not the fee delta for this event.
`aggregated`	예	boolean	True when this realtime event can represent more than one underlying match.
`baseCurrencyId`	예	integer
`quoteCurrencyId`	예	integer
`time`	예	integer	format: "int64"
`microtime`	예	integer	format: "int64"

UserStreamFillEvent

필드	필수	타입	설명과 제약
`event`	예	string
`sequence`	예	integer	Contiguous sequence scoped to this WebSocket connection. minimum: 1; format: "uint64"
`data`	예	UserStreamFill
`serverTime`	예	integer	format: "int64"

UserStreamBalanceEvent

필드	필수	타입	설명과 제약
`event`	예	string
`sequence`	예	integer	Contiguous sequence scoped to this WebSocket connection. minimum: 1; format: "uint64"
`data`	예	Balance
`serverTime`	예	integer	format: "int64"

UserStreamCommandId

Client correlation id. It is not an order idempotency key.

string — minLength: 1; maxLength: 64; pattern: "^[A-Za-z0-9._:-]+$"

UserStreamCreateOrderCommand

필드	필수	타입
`id`	예	UserStreamCommandId
`op`	예	string
`args`	예	CreateOrderRequest

UserStreamCancelOrderArgs

필드	필수	타입	설명과 제약
`orderId`	예	string	pattern: "^[1-9][0-9]*$"

UserStreamCancelOrderCommand

필드	필수	타입
`id`	예	UserStreamCommandId
`op`	예	string
`args`	예	UserStreamCancelOrderArgs

UserStreamAmendOrderArgs

필드	필수	타입	설명과 제약
`orderId`	예	string	pattern: "^[1-9][0-9]*$"
`quantity`	아니요	string
`price`	아니요	string

UserStreamAmendOrderCommand

Reserved native amend command. Current servers return AMEND_NOT_SUPPORTED without canceling the original order.

필드	필수	타입
`id`	예	UserStreamCommandId
`op`	예	string
`args`	예	UserStreamAmendOrderArgs

UserStreamCommandResponse

필드	필수	타입	설명과 제약
`event`	예	string
`id`	예	UserStreamCommandId
`op`	예	string	허용값: "order.create", "order.cancel", "order.amend"
`data`	예	Order
`serverTime`	예	integer	format: "int64"

UserStreamCommandError

필드	필수	타입	설명과 제약
`event`	예	string
`id`	예	string	Echoed command ID when valid; empty when a malformed/throttled packet has no usable ID. pattern: "^[A-Za-z0-9._:-]{0,64}$"
`op`	아니요	string
`error`	예	Error
`serverTime`	예	integer	format: "int64"

CreateOrderRequest

필드	필수	타입	설명과 제약
`symbol`	예	string
`walletId`	예	integer	Required account-local visible spot-trading wallet ID from GET /v1/wallets; not a blockchain address or walletNumber. The server never chooses a default wallet. minimum: 21; maximum: 39
`side`	예	string	허용값: "buy", "sell"
`type`	예	string	허용값: "limit"
`timeInForce`	아니요	string	허용값: "GTC"; default: "GTC"
`quantity`	예	string
`quoteQuantity`	아니요	string	Reserved for future support.
`price`	예	string
`postOnly`	아니요	boolean	Reserved for future support.

Order

필드	필수	타입	설명과 제약
`orderId`	예	string	pattern: "^[1-9][0-9]*$"
`symbol`	아니요	string
`walletId`	예	integer	minimum: 1
`side`	예	string	허용값: "buy", "sell", "unknown"
`type`	예	string	허용값: "limit", "unknown"
`status`	예	string	허용값: "open", "partiallyFilled", "filled", "canceled", "unknown"
`price`	예	string
`quantity`	예	string
`filledQuantity`	예	string
`remainingQuantity`	예	string
`executedValue`	예	string
`fee`	예	string
`createdAt`	예	integer	format: "int64"
`updatedAt`	예	integer	format: "int64"
`baseCurrencyId`	예	integer
`quoteCurrencyId`	예	integer

OrderList

필드	필수	타입	설명과 제약
`items`	예	Order[]
`hasMore`	예	boolean

CancelOrderItem

필드	필수	타입	설명과 제약
`orderId`	예	string	pattern: "^[1-9][0-9]*$"
`status`	예	string	허용값: "canceled", "rejected"
`errorCode`	아니요	string
`symbol`	아니요	string
`walletId`	아니요	integer	minimum: 1

CancelOrderList

필드	필수	타입	설명과 제약
`items`	예	CancelOrderItem[]
`hasMore`	예	boolean

Envelope

필드	필수	타입	설명과 제약
`data`	아니요	object
`error`	아니요	Error
`requestId`	예	string
`serverTime`	예	integer	format: "int64"

Error

필드	필수	타입	설명과 제약
`code`	예	string
`message`	예	string

OrderEnvelope

필드	필수	타입	설명과 제약
`data`	예	Order
`requestId`	예	string
`serverTime`	예	integer	format: "int64"

OrderListEnvelope

필드	필수	타입	설명과 제약
`data`	예	OrderList
`requestId`	예	string
`serverTime`	예	integer	format: "int64"

CancelOrderListEnvelope

필드	필수	타입	설명과 제약
`data`	예	CancelOrderList
`requestId`	예	string
`serverTime`	예	integer	format: "int64"

ErrorEnvelope

필드	필수	타입	설명과 제약
`error`	예	Error
`requestId`	예	string
`serverTime`	예	integer	format: "int64"