Get account balances

Get trading account balances (excludes bot and earn accounts). Weight: 1.

Add margin to futures grid order

Transfer margin into a futures grid order. Runs the same validation as addMarginCheck, then executes asynchronously. Directly affects available balance and the order's liquidation price — a funds operation, call with care. Does not return a status field (async processing). Weight: 1.

Check futures grid add margin (dry-run)

Validate whether the add-margin amount is valid and return the estimated liquidation prices before and after the change, without executing. Does not accept openPrice; the backend uses the live market price. Weight: 1.

Adjust futures grid (add investment / modify range)

Add investment, modify grid range, or set trigger investment for a futures grid order. Weight: 1.

Check futures grid adjust parameters (dry-run)

Validate adjust params / invest-in parameters and return estimated data without executing. Use this before calling adjustParams to preview the impact. Weight: 1.

Adjust spot grid parameters

Modify grid range (top/bottom/row) or adjust investment for a running spot grid order. Weight: 1.

Cancel futures grid order

Close and cancel a futures grid bot order. Weight: 1.

Cancel smart copy order

Close and cancel a smart copy bot order. Weight: 1.

Cancel spot grid order

Close and cancel a spot grid bot order. Weight: 1.

Check futures grid parameters

Validate futures grid bot creation parameters and estimate investment values without creating an order. Weight: 1.

Pass a positive quote_investment to receive full estimate fields. The current market price is fetched automatically — open_price is not required.

Extra Margin Modes (controlled by extra_margin):

FailedWithData: For errors marked "Yes" below, the response includes a data field even when result=false, containing min_investment, max_investment, and slippage so the client can display the valid investment range.

Validation error messages (returned in message when result is false):

Check smart copy parameters

Validate smart copy bot creation parameters and check the maximum investment limit. Weight: 1.

Requires Bot reading permission.

Returns the maximum allowed investment, maximum leverage, and notional/available limits for the given base/quote/signal combination.

Check spot grid parameters

Validate spot grid bot creation parameters and estimate investment values without creating an order. Weight: 1.

Pass a positive quote_total_investment to receive full estimate fields. The current market price is fetched automatically — open_price is not required.

FailedWithData: For errors marked "Yes" below, the response includes a data field even when result=false, containing min_investment, max_investment, and slippage so the client can display the valid investment range.

Validation error messages (returned in message when result is false):

Create futures grid order

Create a new futures grid bot order. Weight: 1.

Create smart copy order

Create a new smart copy bot order. Weight: 1.

Create spot grid order

Create a new spot grid bot order. Weight: 1.

Create user custom signal

Create a new user-defined signal. Each user can have at most 100 signals. Weight: 1.

Requires Bot trading permission.

Delete user custom signal

Delete a user-defined signal. Weight: 1.

Requires Bot trading permission.

Deletion is rejected if the signal has any non-cancelled orders. Error code SIGNAL_HAS_UNCLOSED_ORDERS is returned with the open order count in data.cnt.

Edit user custom signal

Update the title and/or description of an existing user-defined signal. Weight: 1.

Requires Bot trading permission.

At least one of title or description must be provided.

Get bot order list

Query bot order list with optional filters by order type, status, and trading pair. Supports pagination. Weight: 1.

Get futures grid order

Query a futures grid bot order by ID. Weight: 1.

Get KOL curated copy-trade order list

Query a KOL's curated/pinned copy-trade order list by share code, with optional filters by symbol, trend, and leverage. Supports pagination and sorting. Weight: 1.

Get smart copy order

Query a smart copy bot order by ID. Weight: 1.

Get spot grid AI strategy

Query AI-recommended grid strategy parameters for a trading pair. Weight: 1.

Get spot grid order

Query a spot grid bot order by ID. Weight: 1.

Get user custom signal detail

Return detail of a specific user-defined signal including webhook URL and message template. Weight: 1.

Requires Bot reading permission.

Add investment to spot grid

Add additional investment to a running spot grid order. Weight: 1.

List user custom signals

Return a paginated list of user-defined signals. Weight: 1.

Requires Bot reading permission.

Pause futures grid order

Pause a running futures grid order. Runs the same validation as pauseCheck, then executes asynchronously. Once paused the grid stops auto-refilling orders while the position is retained; immediate mode takes effect at the live market price. Does not return a status field (async processing). Weight: 1.

Check futures grid pause (dry-run)

Validate whether a futures grid order can be paused (immediate or conditional mode) and return current plus post-trigger estimated liquidation prices without executing. Does not accept openPrice; the backend uses the live market price. triggerPausePriceUp / triggerPausePriceDown are independent — set either or both. Weight: 1.

Extract profit from spot grid

Extract accumulated grid profit from a running spot grid order. Weight: 1.

Reduce futures grid position

Reduce position size of a futures grid order. Weight: 1.

Check futures grid reduce (dry-run)

Validate reduce parameters and return estimated data without executing. Use this before calling reduce to preview the impact. Weight: 1.

Reduce margin of futures grid order

Transfer margin out of a futures grid order. Runs the same validation as reduceMarginCheck (including the maxAmount check), then executes asynchronously. Directly reduces the order's available margin and raises liquidation risk — a funds operation, call with care. Does not return a status field (async processing). Weight: 1.

Check futures grid reduce margin (dry-run)

Validate whether the reduce-margin amount is valid (subject to the maxAmount hard limit) and return the estimated liquidation prices before and after the change, without executing. Exceeding maxAmount returns checkResult=false with reason EXCEEDS_MAX_AMOUNT. Weight: 1.

Resume futures grid order

Resume a paused futures grid order. Runs the same validation as resumeCheck, then executes. After resuming the grid restarts auto-refilling and the liquidation price moves with the market. Weight: 1.

Check futures grid resume (dry-run)

Validate whether a paused futures grid order can be resumed and return the estimated liquidation prices after resuming, without executing. Order must be in paused state. Weight: 1.

Push custom trading signal

Push a custom trading signal to drive smart copy orders. Weight: 1.

Requires Enable trading permission.

Set / update / clear take-profit & stop-loss

Set, update, or clear the take-profit and/or stop-loss of an already running futures grid order. Weight: 1.

This does NOT create triggers for a not-yet-started order — use create (fields lossStopType / profitStopType etc.) for that. This endpoint mutates the take-profit / stop-loss of an existing order in place.

Request field naming: unlike the other futuresGrid endpoints (which use camelCase), this endpoint takes snake_case field names, and the trigger settings are passed as a list of items — one item per trigger you want to set. A single call may contain a stop_loss item, a stop_profit item, or both.

type — which trigger the item configures. Only two values are accepted (App-side legacy spellings such as stop-loss and the entry-trigger value condition are rejected here):

stop_type — decides how value (and limit_price) is interpreted. Required; unlike the App, an empty value is NOT accepted (no implicit fallback to price):

Clearing a trigger: pass value as an empty string "" for that item to remove the previously set take-profit / stop-loss.

value validation: when value is non-empty it only needs to be a valid decimal — the endpoint does not enforce a positive value. 0 and negative values are accepted (a stop-loss expressed as a negative profit_ratio / profit_amount is meaningful).

Neutral grid (no_trend) upper stop-loss: for a neutral grid, a stop-loss can additionally set an upper threshold above the grid range using stop_high_price (and limit_high_price when stop_type=price_limit). These two fields apply only to a stop_loss item on a neutral grid and only when stop_type is price or price_limit; they are ignored otherwise.

*_sell_model — settlement currency for the position closed by the trigger. Optional; when empty the order's default is used:

Use loss_stop_sell_model on a stop_loss item and profit_stop_sell_model on a stop_profit item.

Asynchronous write: a successful response only means the request was accepted and forwarded. The take-profit / stop-loss is persisted onto the order record asynchronously — poll GET /futuresGrid/order and read lossStop / profitStop (and related fields) to confirm the update took effect.

Restrictions (return result=false with the message shown):

Examples — request bodies for common combinations:

Set a stop-loss at a fixed price:

{
  "bu_order_id": "1234567890",
  "list": [
    { "type": "stop_loss", "stop_type": "price", "value": "70000" }
  ]
}

Set a take-profit at a fixed price:

{
  "bu_order_id": "1234567890",
  "list": [
    { "type": "stop_profit", "stop_type": "price", "value": "150000" }
  ]
}

Set both take-profit and stop-loss in one call:

{
  "bu_order_id": "1234567890",
  "list": [
    { "type": "stop_loss",   "stop_type": "price", "value": "70000" },
    { "type": "stop_profit", "stop_type": "price", "value": "150000" }
  ]
}

Stop-loss by loss ratio (−20%) and take-profit by profit ratio (+50%):

{
  "bu_order_id": "1234567890",
  "list": [
    { "type": "stop_loss",   "stop_type": "profit_ratio", "value": "-0.2" },
    { "type": "stop_profit", "stop_type": "profit_ratio", "value": "0.5" }
  ]
}

Take-profit by profit amount, settled to USDT:

{
  "bu_order_id": "1234567890",
  "list": [
    { "type": "stop_profit", "stop_type": "profit_amount", "value": "500", "profit_stop_sell_model": "TO_USDT" }
  ]
}

Take-profit as a limit order (place a limit at 149000 when 150000 is hit), with a 30s trigger delay:

{
  "bu_order_id": "1234567890",
  "list": [
    { "type": "stop_profit", "stop_type": "price_limit", "value": "150000", "limit_price": "149000", "stop_delay": 30 }
  ]
}

Neutral grid (no_trend) — lower and upper stop-loss prices:

{
  "bu_order_id": "1234567890",
  "list": [
    { "type": "stop_loss", "stop_type": "price", "value": "70000", "stop_high_price": "160000" }
  ]
}

Clear a previously set stop-loss (empty value):

{
  "bu_order_id": "1234567890",
  "list": [
    { "type": "stop_loss", "stop_type": "price", "value": "" }
  ]
}

List Arbitrage products

Returns the list of Term Arbitrage products currently available. Requires View permission. Weight: 1.

Example request:

GET /api/v1/earn/arbitrage/fetchProducts?timestamp=1774959429596

Get user Arbitrage balances

Returns the authenticated user's Term Arbitrage positions and balances. Requires View permission. Weight: 1.

Example request:

GET /api/v1/earn/arbitrage/fetchUserBalances?timestamp=1774959429596

Stake into an Arbitrage product

Subscribes to a Term Arbitrage product. Requires Earn permission. Weight: 1.

Validation:

• amount must be a valid decimal amount.

• productId must exist in the product list returned by GET /api/v1/earn/arbitrage/fetchProducts.

• coin must be one of USDT or USDC.

Example request body:

{
  "productId": "ARB-USDT-30D",
  "coin": "USDT",
  "amount": "100"
}

Example response:

{
  "result": true,
  "data": {
    "request_id": "req-abcdef",
    "status": "success",
    "txid": "tx-123456"
  },
  "timestamp": 1774959429596
}

Redeem from an Arbitrage product

Redeems from a Term Arbitrage product. Requires Earn permission. Weight: 1.

Validation:

• amount must be a valid decimal amount.

• productId must exist in the product list returned by GET /api/v1/earn/arbitrage/fetchProducts.

• coin must be one of USDT or USDC.

Example request body:

{
  "productId": "ARB-USDT-30D",
  "coin": "USDT",
  "amount": "100"
}

Example response:

{
  "result": true,
  "data": {
    "status": "success"
  },
  "timestamp": 1774959429596
}

Get historical delivery prices

Returns historical settlement delivery prices for a Dual Investment pair. Weight: 1.

The delivery price is the index price recorded at the exact moment of each product's expiry, used to determine the settlement direction (base or quote currency payout).

base is required. quote is optional but recommended to narrow results — use USDXO for BTC/ETH pairs and USDT for all other base currencies.

Example request (BTC/USDXO):

GET /api/v1/earn/dual/deliveryPrices?base=BTC&quote=USDXO

Example request (XRP/USDT):

GET /api/v1/earn/dual/deliveryPrices?base=XRP&quote=USDT

Example response:

{
  "result": true,
  "data": {
    "prices": [
      {
        "delivery": "69142.6",
        "date": "2026-04-01",
        "deliveryTime": 1775030400000
      }
    ]
  },
  "timestamp": 1775026529937
}

Get user balances

Returns the authenticated user's Dual Investment account balances. Requires View permission. Weight: 1.

Example request:

GET /api/v1/earn/dual/balances?timestamp=1774959429596

Example response:

{
  "result": true,
  "data": {
    "balances": [
      {
        "base": "BTC",
        "coin": "USDT",
        "free": "100.00",
        "frozen": "50.00",
        "updateTime": 1774959429596
      }
    ]
  },
  "timestamp": 1774959429596
}

Collect settled earnings

Collects settled Dual Investment earnings into the user's spot account. Requires Earn permission. Weight: 1.

Only orders in a settled state can be collected.

Example request body:

{
  "base": "BTC",
  "clientDualId": "my-order-001"
}

Example response:

{
  "result": true,
  "data": {
    "clientDualId": "my-order-001"
  },
  "timestamp": 1774959429596
}

Batch query investment orders

Returns details for a batch of Dual Investment orders by client order ID list. Requires View permission. Weight: 1.

Example request body:

{
  "base": "BTC",
  "clientDualIds": ["my-order-001", "my-order-002"]
}

Get underlying index price

Returns the real-time index price for a Dual Investment underlying asset. Weight: 1.

Both base and quote are required. Works for both USDT and USDXO quoted pairs.

The index price is the reference price used at settlement to determine whether the strike price was hit.

Example request (USDXO pair):

GET /api/v1/earn/dual/index?base=BTC&quote=USDXO

Example request (USDT pair):

GET /api/v1/earn/dual/index?base=LRC&quote=USDT

Example response:

{
  "result": true,
  "data": {
    "index": "69142.6",
    "base": "BTC",
    "quote": "USDXO",
    "updateTime": 1775025942486
  },
  "timestamp": 1775025942754
}

Create investment order

Creates a new Dual Investment order. Requires Earn permission. Weight: 1.

Provide either baseAmount (invest in base currency) or currencyAmount (invest in investment currency), not both.

Workflow: Call GET /api/v1/earn/dual/prices first to obtain the current profit value, then pass it unchanged to this endpoint. The profit field must match the live price — a stale or mismatched value will be rejected.

Example request body:

{
  "base": "BTC",
  "productId": "BTC-USDXO-260402-68000-P-USDT",
  "clientDualId": "my-order-001",
  "currencyAmount": "100",
  "profit": "0.0039"
}

Example response:

{
  "result": true,
  "data": {
    "clientDualId": "my-order-001",
    "state": "CONFIRMED"
  },
  "timestamp": 1775027817297
}

Get investment history

Returns paginated Dual Investment history for the authenticated user. Requires View permission. Weight: 1.

Example request:

GET /api/v1/earn/dual/records?base=BTC&quote=USDXO&limit=10&endTime=1775027817297&timestamp=1775027817297

Get product prices

Returns the latest yield rate and investability status for Dual Investment products. Weight: 1.

All three parameters are required: base, quote, and productIds. Omitting any one of them will return a DUAL_PARAMETER_ERROR.

productIds is a comma-separated list of product IDs. Works for both USDT and USDXO quoted pairs.

When canInvest is false, profit and baseSize will be empty strings.

Workflow note: Always call this endpoint before placing an order. The profit value returned here must be passed as-is to POST /api/v1/earn/dual/invest. Submitting a stale or mismatched profit will be rejected.

Example request (USDT pair):

GET /api/v1/earn/dual/prices?base=LRC&quote=USDT&productIds=LRC-USDT-260410-0.03-C-USDT,LRC-USDT-260410-0.02-C-USDT

Example request (USDXO pair):

GET /api/v1/earn/dual/prices?base=ETH&quote=USDXO&productIds=ETH-USDXO-260410-3000-C-USDT,ETH-USDXO-260410-2900-C-USDT

Example response:

{
  "result": true,
  "data": {
    "products": [
      {
        "productId": "LRC-USDT-260410-0.02-C-USDT",
        "canInvest": true,
        "profit": "0.01242",
        "baseSize": "8000000",
        "updateTime": 1775026225630
      },
      {
        "productId": "LRC-USDT-260410-0.03-C-USDT",
        "canInvest": false,
        "profit": "0",
        "baseSize": "",
        "updateTime": 0
      }
    ]
  },
  "timestamp": 1775026244892
}

List open products

Returns currently open Dual Investment products for a specific trading pair and type. Weight: 1.

Type semantics:

• DUAL_BASE: invest in base currency (e.g. BTC); if price rises above strike at expiry, principal + yield are returned in base currency, otherwise converted to quote currency

• DUAL_CURRENCY: invest in quote/investment currency (e.g. USDT); if price falls below strike at expiry, principal + yield are returned in quote currency, otherwise converted to base currency

Quote currency rules:

• base=BTC or base=ETH: use quote=USDXO, currency=USDT or USDC

• All other base currencies: use quote=USDT, currency=USDT

Example request (BTC, DUAL_BASE):

GET /api/v1/earn/dual/openProducts?base=BTC&quote=USDXO&currency=USDT&type=DUAL_BASE

Example request (XRP, DUAL_BASE):

GET /api/v1/earn/dual/openProducts?base=XRP&quote=USDT&currency=USDT&type=DUAL_BASE

Example response:

{
  "result": true,
  "data": {
    "products": [
      {
        "productId": "BTC-USDXO-260401-69000-C-USDT",
        "base": "BTC",
        "quote": "USDXO",
        "currency": "USDT",
        "type": "DUAL_BASE",
        "createTime": 1774686600000,
        "expireTime": 1775030400000,
        "strike": "69000",
        "expired": false
      }
    ]
  },
  "timestamp": 1775025855477
}

Revoke investment order

Revokes a pending Dual Investment order before it is matched. Requires Earn permission. Weight: 1.

Parameters are passed as a JSON request body, not query string. Only orders in a pending/unmatched state can be revoked.

Example request body:

{
  "base": "BTC",
  "productId": "BTC-USDXO-260402-68000-P-USDT",
  "clientDualId": "my-order-001"
}

Example response:

{
  "result": true,
  "data": {
    "clientDualId": "my-order-001"
  },
  "timestamp": 1775027817297
}

List supported trading pairs

Returns all trading pairs supported by Dual Investment, optionally filtered by base currency. Weight: 1.

Supported quote currencies include: USDT, USDC, USD, USDXO.

Example request:

GET /api/v1/earn/dual/symbols?base=BTC

Example response:

{
  "result": true,
  "data": {
    "coins": [
      {
        "base": "BTC",
        "quote": "USDT",
        "currency": "USDT",
        "basePrecision": 8,
        "currencyPrecision": 8,
        "baseMin": "0.00001",
        "currencyMin": "1",
        "baseMax": "80",
        "currencyMax": "2000000"
      }
    ]
  },
  "timestamp": 1774959429596
}

Get book tickers

Get best bid/ask prices. Weight: 1.

Get order book depth

Get order book snapshot. Weight: 1.

Get klines (candlestick data)

Get OHLCV candlestick data. Weight: 1. Maximum 10,000 records.

Get symbols info

Get trading pair information. Weight: 5.

Get 24hr tickers

Get 24-hour price change statistics. Weight: 1.

Get market trades

Get recent trades. Weight: 1.

Cancel all orders

Cancel all open orders for a symbol. Weight: 1.

Cancel order

Cancel an existing order. Weight: 1.

Get all orders

Get all orders (open and closed) for a symbol. Weight: 5.

Get fills

Get trade fills for a symbol. Returns latest 100 fills when exceeding limit. Weight: 5.

Get fills by order ID

Get trade fills for a specific order. Weight: 5.

Get open orders

Get all open orders for a symbol. Maximum 200 open orders per symbol. Weight: 5.

Get order

Get order details by order ID. Weight: 1.

Get order by client order ID

Get order details by client order ID. Weight: 1.

New multiple orders

Place multiple orders at once (up to 20, LIMIT only). Weight: 1.

New order

Place a new order. Weight: 1.

Get full account balances overview

Query all account balances overview including Spot (Bot Account) and Futures (Trader Account) dimensions, with price information for each coin and total USDT/BTC valuations. Weight: 1.