# 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.<br/>
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`

