Copy page

Changelog

May 2026

[May 28, 2026] Added Create Agent Sub-account API; Get Sub-account List: Added agent Type Enum Value

New API:

• /api/v3/user/sub-account/agent-create Create a dedicated sub-account for an AI Agent instance

Interface:

• /api/v3/user/sub-list

Changes:

• Added agent enum value to type response parameter: Agent Sub-account

[May 26, 2026] Added Withdrawal Address Book and Cancel Withdrawal APIs

New APIs:

• /api/v3/account/withdraw-address Query the withdrawal address book bound to the account
• /api/v3/account/cancel-withdrawal Cancel a withdrawal request within the cooling-off period

[May 26, 2026] Fill Channel: Updated category Push Field Enum Values to Lowercase

websocket

Channel:

• fill (UTA)

Changes:

• Updated category push field enum values to lowercase: spot / margin / usdt-futures / coin-futures / usdc-futures

[May 21, 2026] Get Sub-account List: Updated type Field Enum Values

Interface:

• /api/v3/user/sub-list

Changes:

• Updated type response field enum values to lowercase: normal Regular Sub-account / virtual Virtual Sub-account / custodian Custodial Sub-account

[May 19, 2026] UTA Isolated Margin Support: Added marginMode Parameter Across Trade, Position, and WebSocket Interfaces

REST

Interface:

• /api/v3/trade/place-order
• /api/v3/position/current-position
• /api/v3/account/adjust-account-mode

Changes:

• Added marginMode String request parameter to place-order: Margin mode (crossed / isolated). Defaults to crossed if not provided. Available for futures only.
• Updated positionBalance and unrealisedPnl response parameter descriptions in current-position: In isolated margin mode, these fields reflect isolated position-level values.
• Added isolated enum value to mode request parameter in adjust-account-mode: Enables switching to isolated margin mode.

WebSocket

Channels:

• place-order (UTA)
• position (UTA)

Changes:

• Added marginMode String request parameter to place-order channel: Margin mode (crossed / isolated). Defaults to crossed if not provided. Available for futures only.
• Added enum description for marginMode push parameter in position channel: crossed / isolated.

[May 19, 2026] WebSocket Depth Channels: checksum Field Removed

websocket

Channels affected:

• Depth: books / books1 / books5 / books50
• RPI Depth: rpi-books / rpi-books1 / rpi-books5 / rpi-books50

Changes:

• The checksum push parameter has been removed from the above depth channels. Please use seq and pseq for order book consistency verification instead.

[May 19, 2026] SBE Channels: Added sts and category Fields

websocket (SBE)

Interface:

• SBE Depth50 (books50)
• SBE BBO (books1)
• SBE Public Trade (publicTrade)

Changes:

• Added sts uint64 push field: Stream service push timestamp (µs)
• Added category uint8 push field: Product line (spot / usdt-futures / coin-futures / usdc-futures)

Demo trading launch date: April 30, 2026.
Live trading launch date: May 19, 2026.

[May 14, 2026] Added P2P Merchant APIs

New APIs:

• GET /api/v3/p2p/ad-list Get public ad list
• GET /api/v3/p2p/exchange-rate Get exchange rate
• POST /api/v3/p2p/fee-simulate Fee simulate (pre-check fees)
• GET /api/v3/p2p/ad-limit Get ad limit info
• POST /api/v3/p2p/ad-create Create ad
• POST /api/v3/p2p/ad-update Update ad
• POST /api/v3/p2p/ad-operate Operate ad (publish / delist / remove)
• GET /api/v3/p2p/ad-info Get ad info
• GET /api/v3/p2p/my-ads Get my ads
• GET /api/v3/p2p/pending-orders Get pending orders
• GET /api/v3/p2p/all-orders Get all orders
• GET /api/v3/p2p/order-info Get order info
• POST /api/v3/p2p/order-pay Confirm payment
• POST /api/v3/p2p/order-release Release asset
• GET /api/v3/p2p/user-info Get user info
• GET /api/v3/p2p/currencies Get currencies
• GET /api/v3/p2p/pay-method Get pay methods
• GET /api/v3/p2p/balance Get balance

[May 12, 2026] Delta-Neutral Mode: Account Mode Switch and New Delta Info API

Interface:

• /api/v3/account/adjust-account-mode
• /api/v3/account/settings
• /api/v3/account/delta-info (new)

Changes:

• adjust-account-mode: Added delta enum to mode request parameter: Delta-neutral mode
• settings: Added isolated and delta enums to accountLevel response field: Isolated margin mode / Delta-neutral mode
• Added new API /api/v3/account/delta-info: Get delta equity ratio, thresholds, and per-coin net position ratios for Delta-neutral mode accounts

[May 12, 2026] Close All Positions: Added X-CHANNEL-API-CODE Support

Interface:

• /api/v3/trade/close-positions

Changes:

• This interface now supports the X-CHANNEL-API-CODE HTTP request header for broker rebate tracking.

[May 8, 2026] Copy Trading: Added Max Transferable, Transfer, and Transfer Record APIs

New APIs:

• /api/v3/copy/futures/max-transferable Get maximum transferable amount and available balance for the lead account
• /api/v3/copy/futures/transfer Transfer funds into or out of the lead account
• /api/v3/copy/futures/transfer-record Query lead account transfer history

[May 7, 2026] WebSocket: Added connId to subscription and trade operation responses

websocket

Changes:

• All public channels (subscribe/unsubscribe responses): Added top-level connId (Connection ID) field
• All private channels (subscribe/unsubscribe responses): Added top-level connId field
• Trade operation responses (place-order / cancel-order / batch-place / batch-cancel / modify-order / batch-modify): Added connId field
• Note: ping/pong messages and normal data push messages do not carry connId

[May 7, 2026] Order Book Channel: Added maxDepth field to push data

websocket

Changes:

• books channel: Added maxDepth field to push data

[May 6, 2026] Broker Sub-Account API Key: permType Enum Values Updated

Interface:

• POST /api/v3/broker/create-sub-apikey
• POST /api/v3/broker/modify-sub-apikey
• GET /api/v3/broker/query-sub-apikey

Changes:

• permType parameter/response field: enum values changed from Read/Write / Read-only to read_write / read_only