| name | opentrade-cex |
| description | This skill should be used when the user asks to 'place a CEX order', 'trade on centralized exchange', 'buy BTC on CEX', 'sell ETH futures', 'open a long position', 'open a short position', 'close my position', 'set leverage', 'check my CEX balance', 'show my open orders', 'cancel my order', 'check CEX ticker', 'get K-line data', 'set margin mode', 'check my CEX positions', 'view trade history', 'check funding rate', 'get order book', 'check open interest', 'compare funding rates', or mentions CEX trading, futures, contracts, leverage, margin, limit orders, market orders, stop-loss, take-profit, funding rate, order book, open interest. This is for centralized exchange operations only. Do NOT use for DEX swaps (use opentrade-dex-swap), on-chain balances (use opentrade-portfolio), on-chain market data (use opentrade-market), token search (use opentrade-token), custodial wallet (use opentrade-wallet), or transaction broadcasting (use opentrade-gateway). |
| license | MIT |
| metadata | {"author":6551,"version":"1.0.3","homepage":"https://www.newsliquid.com"} |
OpenTrade CEX Trading
39 API endpoints for centralized exchange trading — market data, public metadata, account management, spot & futures orders, positions, and leverage.
IMPORTANT: This is a CEX (centralized exchange) trading skill. All trades are executed server-side with built-in risk controls — no private key management or transaction signing required.
IMPORTANT: Write operations (place order, close position, set leverage) are protected by a 4-layer risk engine: price deviation check, position limit, rate limit, and balance verification.
CRITICAL — Required Parameters for Orders:
type (REQUIRED): Order type must always be specified (market, limit, stop_market, take_profit_market). Each type has different parameter requirements.hedged (REQUIRED): When placing orders (POST /orders) or closing positions (POST /positions/close), the hedged field is required. If the hedged value is unknown or not provided by the user, you MUST first call GET /position/mode to obtain data.hedged. Once obtained, the value can be reused for subsequent requests on the same symbol and exchange without re-fetching. Using an incorrect hedged value may cause order rejection or affect the wrong position.quantity for close position (REQUIRED): When closing a position, you must explicitly provide the quantity to close. 0 is not allowed. Use the actual position size from GET /positions when closing the full position.
CRITICAL — Prefer Contract (Swap) Symbol:
- When
/market/metadata returns multiple markets, default to the perpetual/swap symbol (e.g., BTC/USDT:USDT) rather than the spot symbol (e.g., BTC/USDT).
- Only use the spot symbol when the user explicitly requests spot trading.
- Always use
symbol field, NOT displaySymbol, when making API calls.
Pre-flight Checks
Every time before running any CEX command, always follow these steps in order:
- Find or create a
.env file in the project root to load the API credentials:
OPEN_TOKEN=your_token_here
Get your API token at: https://www.newsliquid.com/mcp
Security warning: Never commit .env to git (add it to .gitignore) and never expose credentials in logs, screenshots, or chat messages.
- Set the base URL and auth header:
BASE_URL="https://ai.6551.io"
AUTH_HEADER="Authorization: Bearer $OPEN_TOKEN"
Skill Routing
- For DEX swaps / on-chain token exchange → use
opentrade-dex-swap
- For on-chain wallet balances / portfolio → use
opentrade-portfolio
- For on-chain market data / smart money signals → use
opentrade-market
- For token search / holders / trending → use
opentrade-token
- For custodial wallet (BSC/Solana) → use
opentrade-wallet
- For transaction broadcasting / gas → use
opentrade-gateway
- For CEX trading (spot, futures, leverage, orders, positions) → use this skill (
opentrade-cex)
Supported Exchanges
| ExchangeID | Name |
|---|
binance | Binance |
bybit | Bybit |
okx | OKX |
hyperliquid | Hyperliquid |
aster | Aster |
Quickstart
curl -s "$BASE_URL/open/trader/newsliquid/v1/market/ticker?symbol=BTC/USDT&exchangeId=binance" \
-H "$AUTH_HEADER"
curl -s "$BASE_URL/open/trader/newsliquid/v1/account/summary?exchangeId=binance&symbol=BTC/USDT:USDT" \
-H "$AUTH_HEADER"
curl -s "$BASE_URL/open/trader/newsliquid/v1/position/mode?symbol=BTC/USDT:USDT&exchangeId=binance" \
-H "$AUTH_HEADER"
curl -s -X POST "$BASE_URL/open/trader/newsliquid/v1/orders" \
-H "$AUTH_HEADER" -H "Content-Type: application/json" \
-d '{"symbol":"BTC/USDT:USDT","side":"buy","type":"limit","quantity":0.001,"price":60000,"exchangeId":"binance","hedged":false}'
curl -s "$BASE_URL/open/trader/newsliquid/v1/orders/open?exchangeId=binance" \
-H "$AUTH_HEADER"
curl -s "$BASE_URL/open/trader/newsliquid/v1/positions?exchangeId=binance" \
-H "$AUTH_HEADER"
curl -s -X POST "$BASE_URL/open/trader/newsliquid/v1/positions/close" \
-H "$AUTH_HEADER" -H "Content-Type: application/json" \
-d '{"symbol":"BTC/USDT:USDT","side":"long","quantity":0.001,"exchangeId":"binance","hedged":false}'
Note: Trading pair format follows CCXT standard:
- Spot:
BTC/USDT (no colon, no leverage)
- Perpetual futures (swap):
BTC/USDT:USDT (with :SETTLE suffix, supports leverage) — default choice for most trading operations
Always use the exact symbol value returned from GET /market/metadata to ensure correct market type. Prefer the contract/swap symbol by default; use spot only when user explicitly requests it.
Command Index
Market Data (no risk control)
| # | Endpoint | Method | Description |
|---|
| 1 | /open/trader/newsliquid/v1/market/metadata | GET | Get market metadata (trading pairs, precision, limits) |
| 2 | /open/trader/newsliquid/v1/market/ticker | GET | Get real-time ticker (last price, 24h change, volume) |
| 3 | /open/trader/newsliquid/v1/market/klines | GET | Get K-line / candlestick data |
| 4 | /open/trader/newsliquid/v1/market/base-currencies | GET | Get base currency list (USDT, BTC, etc.) |
| 5 | /open/trader/newsliquid/v1/market/time | GET | Get server time |
Public Metadata (no risk control)
| # | Endpoint | Method | Description |
|---|
| 6 | /open/trader/newsliquid/v1/public/metadata/orderbook | GET | Get order book depth data |
| 7 | /open/trader/newsliquid/v1/public/metadata/tickers | GET | Get price tickers (multiple symbols) |
| 8 | /open/trader/newsliquid/v1/public/metadata/ohlcv | GET | Get OHLCV candlestick data |
| 9 | /open/trader/newsliquid/v1/public/metadata/trades | GET | Get recent public trades |
| 10 | /open/trader/newsliquid/v1/public/metadata/time | GET | Get exchange server time |
| 11 | /open/trader/newsliquid/v1/public/metadata/status | GET | Get exchange operational status |
| 12 | /open/trader/newsliquid/v1/public/metadata/funding-rate | GET | Get current funding rate (single symbol) |
| 13 | /open/trader/newsliquid/v1/public/metadata/funding-rates | GET | Get funding rates (multiple symbols) |
| 14 | /open/trader/newsliquid/v1/public/metadata/funding-rate/history | GET | Get historical funding rates |
| 15 | /open/trader/newsliquid/v1/public/metadata/funding-rate/exchanges | GET | Get funding rate across exchanges |
| 16 | /open/trader/newsliquid/v1/public/metadata/funding-interval | GET | Get funding interval |
| 17 | /open/trader/newsliquid/v1/public/metadata/open-interest | GET | Get current open interest |
| 18 | /open/trader/newsliquid/v1/public/metadata/open-interest/history | GET | Get historical open interest |
| 19 | /open/trader/newsliquid/v1/public/market/index-constituents | GET | Get contract index price constituents |
| 20 | /open/trader/newsliquid/v1/public/market/smart-money | GET | Get smart money signal overview |
Account (no risk control)
| # | Endpoint | Method | Description |
|---|
| 21 | /open/trader/newsliquid/v1/account/summary | GET | Account summary (balance, leverage, max position) |
| 22 | /open/trader/newsliquid/v1/account/spot | GET | Query specific spot asset |
| 23 | /open/trader/newsliquid/v1/account/spots | GET | Query all spot assets |
Config (no risk control)
| # | Endpoint | Method | Description |
|---|
| 24 | /open/trader/newsliquid/v1/config | GET | Get trading config |
| 25 | /open/trader/newsliquid/v1/config | PUT | Update trading config |
Orders (risk control on create)
| # | Endpoint | Method | Risk | Description |
|---|
| 26 | /open/trader/newsliquid/v1/orders | POST | Yes | Place order (limit/market/stop-loss/take-profit) |
| 27 | /open/trader/newsliquid/v1/orders/:orderId | DELETE | No | Cancel order |
| 28 | /open/trader/newsliquid/v1/orders/open | GET | No | List open orders |
| 29 | /open/trader/newsliquid/v1/orders/closed | GET | No | List closed orders |
Positions (risk control on close)
| # | Endpoint | Method | Risk | Description |
|---|
| 30 | /open/trader/newsliquid/v1/positions | GET | No | List current positions |
| 31 | /open/trader/newsliquid/v1/positions/history | GET | No | List historical positions |
| 32 | /open/trader/newsliquid/v1/positions/close | POST | Yes | Close position (market price) |
Trades (no risk control)
| # | Endpoint | Method | Description |
|---|
| 33 | /open/trader/newsliquid/v1/trades/history | GET | Get trade execution history |
Leverage & Margin (risk control on leverage change)
| # | Endpoint | Method | Risk | Description |
|---|
| 34 | /open/trader/newsliquid/v1/leverage | GET | No | Get available leverage tiers |
| 35 | /open/trader/newsliquid/v1/leverage/current | GET | No | Get current leverage setting |
| 36 | /open/trader/newsliquid/v1/leverage/current | PUT | Yes | Set leverage multiplier |
| 37 | /open/trader/newsliquid/v1/margin/mode | GET | No | Get margin mode |
| 38 | /open/trader/newsliquid/v1/position/mode | GET | No | Get position mode (one-way/hedge) |
| 39 | /open/trader/newsliquid/v1/position/mode | PUT | No | Set position mode |
API Reference
1. Get Market Metadata
获取指定交易对在所有交易所的市场元数据信息（交易对列表、合约类型、杠杆范围、最小下单量等）。
CRITICAL — Symbol Format (CCXT Standard):
Spot trading pairs: BASE/QUOTE format
- Example:
BTC/USDT (spot trading, no leverage)
- Characteristics:
spot: true, swap: false, contract: false, margin: false
Perpetual futures (swap): BASE/QUOTE:SETTLE format
- Example:
BTC/USDT:USDT (USDT-margined perpetual contract)
- Characteristics:
spot: false, swap: true, contract: true, margin: true
- The
:SETTLE suffix indicates the settlement currency (usually matches QUOTE)
How to distinguish in /market/metadata response:
- Check the
symbol field format:
- Contains
: → Perpetual futures (e.g., BTC/USDT:USDT)
- No
: → Spot (e.g., BTC/USDT)
- Check boolean flags:
spot: true → Spot trading pairswap: true → Perpetual futurescontract: true → Any derivative (futures/swap/option)
- Check
type field: "spot", "swap", "future", "option"
IMPORTANT — Use symbol, NOT displaySymbol:
- Always use the
symbol field when calling other endpoints (ticker, orders, positions, etc.)
- The
displaySymbol field is for display purposes only and may not work correctly in API calls
- Example: Use
symbol: "BTC/USDT:USDT" from the response, not displaySymbol
CRITICAL — Prefer Contract (Swap) Symbol by Default:
- When
/market/metadata returns multiple markets for the same ticker (e.g., both spot BTC/USDT and swap BTC/USDT:USDT), prioritize the contract/swap symbol (swap: true or contract: true) unless the user explicitly requests spot trading
- Why: Most CEX trading operations (leverage, open/close positions, futures trading) require the contract symbol. Using the spot symbol for these operations will fail or produce unexpected results
- Selection priority (top to bottom):
- Perpetual futures (
swap: true, symbol has :SETTLE suffix) — default choice
- Futures (
future: true) — if no swap is available
- Spot (
spot: true) — only when user explicitly asks for spot trading (e.g., "buy BTC spot", "spot trade")
- User intent signals for spot: "spot", "现货", "spot trading", "buy and hold"
- User intent signals for contract/swap (default): "long", "short", "leverage", "futures", "perpetual", "做多", "做空", "杠杆", "合约", "open position", "close position"
- When in doubt, ask the user: "Do you want to trade spot or perpetual futures?"
curl -s "$BASE_URL/open/trader/newsliquid/v1/market/metadata?ticker=BTC" \
-H "$AUTH_HEADER"
Parameters:
| Field | Type | Required | Description |
|---|
ticker | String (query) | Yes | Base currency code (e.g., BTC, ETH, SOL) |
Response:
{
"success": true,
"data": {
"ticker": "BTC",
"markets": [
{
"exchangeId": "binance",
"id": "BTCUSDT",
"symbol": "BTC/USDT",
"displaySymbol": "BTC/USDT",
"active": true,
"type": "spot",
"rawType": "spot",
"baseId": "BTC",
"baseCurrency": "BTC",
"quoteId": "USDT",
"quoteCurrency": "USDT",
"costMin": 5,
"amountMin": 0.00001,
"margin": true,
"spot": true,
"swap": false,
"future": false,
"option": false,
"contract": false
},
{
"exchangeId": "binance",
"id": "BTCUSDT",
"symbol": "BTC/USDT:USDT",
"displaySymbol": "BTC/USDT",
"active": true,
"type": "swap",
"rawType": "swap",
"settleCurrency": "USDT",
"baseId": "BTC",
"baseCurrency": "BTC",
"quoteId": "USDT",
"quoteCurrency": "USDT",
"costMin": 50,
"amountMin": 0.001,
"margin": false,
"spot": false,
"swap": true,
"future": false,
"option": false,
"contract": true
},
]
},
"usage": {"cost": 1, "quota": 99}
}
2. Get Ticker
获取指定交易所和交易对的实时行情数据。
curl -s "$BASE_URL/open/trader/newsliquid/v1/market/ticker?symbol=BTC/USDT&exchangeId=binance" \
-H "$AUTH_HEADER"
Parameters:
| Field | Type | Required | Description |
|---|
symbol | String (query) | Yes | Trading pair in CCXT format (e.g., BTC/USDT) |
exchangeId | String (query) | Yes | Exchange ID: binance, bybit, okx, hyperliquid |
Response:
{
"success": true,
"data": {
"symbol": "BTC/USDT",
"last": 67890.50,
"bid": 67889.00,
"ask": 67891.00,
"high": 68500.00,
"low": 66800.00,
"volume": 12345.678,
"timestamp": "2026-03-21T10:30:00Z"
},
"usage": {"cost": 1, "quota": 99}
}
Display to user:
- "BTC/USDT: $67,890.50"
- "Bid: $67,889 | Ask: $67,891"
- "24h High: $68,500 | Low: $66,800 | Volume: 12,345.68 BTC"
3. Get K-Lines
获取 Binance K 线（蜡烛图）数据。
curl -s "$BASE_URL/open/trader/newsliquid/v1/market/klines?symbol=BTCUSDT&interval=1h&limit=100" \
-H "$AUTH_HEADER"
Parameters:
| Field | Type | Required | Description |
|---|
symbol | String (query) | No | Trading pair (default: BTCUSDT) |
interval | String (query) | No | K-line interval (default: 1m): 1m, 5m, 15m, 1h, 4h, 1d, etc. |
limit | Integer (query) | No | Number of candles (default: 100) |
Response:
{
"success": true,
"data": [
{
"openTime": 1679400000000,
"open": "67800.00",
"high": "67900.00",
"low": "67750.00",
"close": "67850.00",
"volume": "123.456",
"closeTime": 1679400059999
}
],
"usage": {"cost": 1, "quota": 99}
}
Display to user:
- Summarize recent price action (e.g., "BTC rose from $67,800 to $67,850 in the last hour")
- Mention support/resistance levels if visible
4. Get Base Currencies
获取所有交易所支持的去重基础币种列表。
curl -s "$BASE_URL/open/trader/newsliquid/v1/market/base-currencies" \
-H "$AUTH_HEADER"
Parameters: None
Response:
{
"success": true,
"data": ["BTC", "ETH", "SOL", "DOGE", "XRP"],
"usage": {"cost": 1, "quota": 99}
}
5. Get Server Time
获取 ai-bots-trading 服务器的当前时间。
curl -s "$BASE_URL/open/trader/newsliquid/v1/market/time" \
-H "$AUTH_HEADER"
Parameters: None
Response:
{
"timestamp": 1679400000000,
"time": "2026-03-21T10:30:00Z",
"usage": {"cost": 1, "quota": 99}
}
6. Get Order Book
获取指定交易对的订单簿深度数据。
curl -s "$BASE_URL/open/trader/newsliquid/v1/public/metadata/orderbook?exchangeId=binance&symbol=BTC/USDT&limit=20" \
-H "$AUTH_HEADER"
Parameters:
| Field | Type | Required | Description |
|---|
exchangeId | String (query) | Yes | Exchange ID |
symbol | String (query) | Yes | Trading pair (e.g., BTC/USDT) |
limit | Integer (query) | No | Order book depth limit (default: 20, e.g., 20, 50, 100) |
Response:
{
"success": true,
"data": {
"symbol": "BTC/USDT",
"bids": [[67889.00, 0.5], [67888.00, 1.2]],
"asks": [[67891.00, 0.3], [67892.00, 0.8]],
"timestamp": 1679400000000,
"datetime": "2026-03-21T10:30:00Z"
}
}
7. Get Price Tickers
获取指定交易所的多个交易对行情数据。
curl -s "$BASE_URL/open/trader/newsliquid/v1/public/metadata/tickers?exchangeId=binance&symbols=BTC/USDT,ETH/USDT" \
-H "$AUTH_HEADER"
Parameters:
| Field | Type | Required | Description |
|---|
exchangeId | String (query) | Yes | Exchange ID |
symbols | String (query) | No | Comma-separated symbols (e.g., BTC/USDT,ETH/USDT). Omit for all symbols. |
Response:
{
"success": true,
"data": {
"BTC/USDT": {
"symbol": "BTC/USDT",
"last": 67890.50,
"bid": 67889.00,
"ask": 67891.00,
"high": 68500.00,
"low": 66800.00,
"volume": 12345.678,
"timestamp": 1679400000000
},
"ETH/USDT": {
"symbol": "ETH/USDT",
"last": 3450.20,
"bid": 3449.50,
"ask": 3450.80,
"high": 3500.00,
"low": 3400.00,
"volume": 98765.432,
"timestamp": 1679400000000
}
}
}
8. Get OHLCV Data
获取指定交易对的 OHLCV（开盘价、最高价、最低价、收盘价、成交量）K线数据。
curl -s "$BASE_URL/open/trader/newsliquid/v1/public/metadata/ohlcv?exchangeId=binance&symbol=BTC/USDT&timeframe=1h&limit=50" \
-H "$AUTH_HEADER"
Parameters:
| Field | Type | Required | Description |
|---|
exchangeId | String (query) | Yes | Exchange ID |
symbol | String (query) | Yes | Trading pair (e.g., BTC/USDT) |
timeframe | String (query) | No | Timeframe (default: 1h): 1m, 5m, 15m, 1h, 4h, 1d |
since | Integer (query) | No | Timestamp in milliseconds to fetch data from |
limit | Integer (query) | No | Number of candles (default: 50) |
Response:
{
"success": true,
"data": [
{
"timestamp": 1679400000000,
"open": 67800.00,
"high": 67900.00,
"low": 67750.00,
"close": 67850.00,
"volume": 123.456
}
]
}
9. Get Public Trades
获取指定交易对的最近公开成交记录。
curl -s "$BASE_URL/open/trader/newsliquid/v1/public/metadata/trades?exchangeId=binance&symbol=BTC/USDT&limit=20" \
-H "$AUTH_HEADER"
Parameters:
| Field | Type | Required | Description |
|---|
exchangeId | String (query) | Yes | Exchange ID |
symbol | String (query) | Yes | Trading pair (e.g., BTC/USDT) |
since | Integer (query) | No | Timestamp in milliseconds to fetch trades from |
limit | Integer (query) | No | Number of trades (default: 20) |
Response:
{
"success": true,
"data": [
{
"id": "123456",
"symbol": "BTC/USDT",
"price": 67890.50,
"amount": 0.01,
"cost": 678.905,
"side": "buy",
"timestamp": 1679400000000,
"datetime": "2026-03-21T10:30:00Z",
"takerOrMaker": "taker"
}
]
}
10. Get Exchange Time
获取指定交易所的服务器时间。
curl -s "$BASE_URL/open/trader/newsliquid/v1/public/metadata/time?exchangeId=binance" \
-H "$AUTH_HEADER"
Parameters:
| Field | Type | Required | Description |
|---|
exchangeId | String (query) | Yes | Exchange ID |
Response:
{
"success": true,
"data": {
"timestamp": 1679400000000
}
}
11. Get Exchange Status
获取指定交易所的运行状态。
curl -s "$BASE_URL/open/trader/newsliquid/v1/public/metadata/status?exchangeId=binance" \
-H "$AUTH_HEADER"
Parameters:
| Field | Type | Required | Description |
|---|
exchangeId | String (query) | Yes | Exchange ID |
Response:
{
"success": true,
"data": {
"status": "ok",
"updated": 1679400000000
}
}
12. Get Funding Rate
获取指定永续合约交易对的当前资金费率。
curl -s "$BASE_URL/open/trader/newsliquid/v1/public/metadata/funding-rate?exchangeId=binance&symbol=BTC/USDT" \
-H "$AUTH_HEADER"
Parameters:
| Field | Type | Required | Description |
|---|
exchangeId | String (query) | Yes | Exchange ID |
symbol | String (query) | Yes | Trading pair (e.g., BTC/USDT) |
Response:
{
"success": true,
"data": {
"symbol": "BTC/USDT",
"fundingRate": 0.0001,
"timestamp": 1679400000000,
"datetime": "2026-03-21T10:30:00Z",
"markPrice": 67890.50,
"indexPrice": 67885.00,
"nextFundingTimestamp": 1679428800000
}
}
13. Get Funding Rates
获取指定交易所多个永续合约交易对的资金费率。
curl -s "$BASE_URL/open/trader/newsliquid/v1/public/metadata/funding-rates?exchangeId=binance&symbols=BTC/USDT,ETH/USDT" \
-H "$AUTH_HEADER"
Parameters:
| Field | Type | Required | Description |
|---|
exchangeId | String (query) | Yes | Exchange ID |
symbols | String (query) | No | Comma-separated symbols. Omit for all symbols. |
Response:
{
"success": true,
"data": {
"BTC/USDT": {
"symbol": "BTC/USDT",
"fundingRate": 0.0001,
"timestamp": 1679400000000,
"datetime": "2026-03-21T10:30:00Z",
"markPrice": 67890.50,
"indexPrice": 67885.00,
"nextFundingTimestamp": 1679428800000
}
}
}
14. Get Funding Rate History
获取指定永续合约交易对的历史资金费率。
curl -s "$BASE_URL/open/trader/newsliquid/v1/public/metadata/funding-rate/history?exchangeId=binance&symbol=BTC/USDT&limit=20" \
-H "$AUTH_HEADER"
Parameters:
| Field | Type | Required | Description |
|---|
exchangeId | String (query) | Yes | Exchange ID |
symbol | String (query) | No | Trading pair (e.g., BTC/USDT) |
since | Integer (query) | No | Timestamp in milliseconds to fetch data from |
limit | Integer (query) | No | Number of records (default: 20) |
Response:
{
"success": true,
"data": [
{
"symbol": "BTC/USDT",
"fundingRate": 0.0001,
"timestamp": 1679400000000,
"datetime": "2026-03-21T10:30:00Z"
}
]
}
15. Get Funding Rate Across Exchanges
获取指定交易对在多个交易所的资金费率对比。
curl -s "$BASE_URL/open/trader/newsliquid/v1/public/metadata/funding-rate/exchanges?exchangeIds=binance,bybit,okx&symbol=BTC/USDT" \
-H "$AUTH_HEADER"
Parameters:
| Field | Type | Required | Description |
|---|
exchangeIds | String (query) | Yes | Comma-separated exchange IDs (e.g., binance,bybit,okx) |
symbol | String (query) | Yes | Trading pair (e.g., BTC/USDT) |
Response:
{
"success": true,
"data": {
"binance": {
"symbol": "BTC/USDT",
"fundingRate": 0.0001,
"timestamp": 1679400000000,
"datetime": "2026-03-21T10:30:00Z",
"markPrice": 67890.50,
"indexPrice": 67885.00,
"nextFundingTimestamp": 1679428800000
},
"bybit": {
"symbol": "BTC/USDT",
"fundingRate": 0.00012,
"timestamp": 1679400000000,
"datetime": "2026-03-21T10:30:00Z",
"markPrice": 67891.00,
"indexPrice": 67886.00,
"nextFundingTimestamp": 1679428800000
}
}
}
16. Get Funding Interval
获取指定永续合约交易对的资金费率结算间隔。
curl -s "$BASE_URL/open/trader/newsliquid/v1/public/metadata/funding-interval?exchangeId=binance&symbol=BTC/USDT" \
-H "$AUTH_HEADER"
Parameters:
| Field | Type | Required | Description |
|---|
exchangeId | String (query) | Yes | Exchange ID |
symbol | String (query) | Yes | Trading pair (e.g., BTC/USDT) |
Response:
{
"success": true,
"data": {
"symbol": "BTC/USDT",
"interval": "8h"
}
}
17. Get Current Open Interest
获取指定永续合约交易对的当前持仓量。
curl -s "$BASE_URL/open/trader/newsliquid/v1/public/metadata/open-interest?exchangeId=binance&symbol=BTC/USDT" \
-H "$AUTH_HEADER"
Parameters:
| Field | Type | Required | Description |
|---|
exchangeId | String (query) | Yes | Exchange ID |
symbol | String (query) | Yes | Trading pair (e.g., BTC/USDT) |
Response:
{
"success": true,
"data": {
"symbol": "BTC/USDT",
"openInterestAmount": 12345.67,
"openInterestValue": 838500000.00,
"timestamp": 1679400000000,
"datetime": "2026-03-21T10:30:00Z"
}
}
18. Get Open Interest History
获取指定永续合约交易对的历史持仓量数据。
curl -s "$BASE_URL/open/trader/newsliquid/v1/public/metadata/open-interest/history?exchangeId=binance&symbol=BTC/USDT&timeframe=1h&limit=50" \
-H "$AUTH_HEADER"
Parameters:
| Field | Type | Required | Description |
|---|
exchangeId | String (query) | Yes | Exchange ID |
symbol | String (query) | Yes | Trading pair (e.g., BTC/USDT) |
timeframe | String (query) | No | Timeframe (default: 1h): 5m, 15m, 1h, 4h |
since | Integer (query) | No | Timestamp in milliseconds to fetch data from |
limit | Integer (query) | No | Number of records |
Response:
{
"success": true,
"data": [
{
"symbol": "BTC/USDT",
"openInterestAmount": 12345.67,
"openInterestValue": 838500000.00,
"timestamp": 1679400000000,
"datetime": "2026-03-21T10:30:00Z"
}
]
}
19. Get Index Constituents
获取永续合约指数价格的成分币种及其权重。
curl -s "$BASE_URL/open/trader/newsliquid/v1/public/market/index-constituents?symbol=BTCUSDT" \
-H "$AUTH_HEADER"
Parameters:
| Field | Type | Required | Description |
|---|
symbol | String (query) | Yes | Perpetual symbol in raw format (e.g., BTCUSDT, ETHUSDT). Case-insensitive, will be uppercased. |
Response:
{
"success": true,
"data": {
"symbol": "BTCUSDT",
"time": 1697007049254,
"constituents": [
{"exchange": "binance", "symbol": "BTCUSDT", "weight": "0.3333"},
{"exchange": "okx", "symbol": "BTC-USDT", "weight": "0.3333"},
{"exchange": "coinbase","symbol": "BTC-USD", "weight": "0.3334"}
]
},
"usage": {"cost": 1, "quota": 99}
}
Display to user:
- List the exchanges contributing to the index and their relative weights
- Useful for understanding where the mark/index price is derived from
20. Get Smart Money Signal
获取永续合约的"聪明钱"信号概览。聪明钱信号反映大资金账户在该合约上的多空倾向与持仓变化。
curl -s "$BASE_URL/open/trader/newsliquid/v1/public/market/smart-money?symbol=BTCUSDT" \
-H "$AUTH_HEADER"
Parameters:
| Field | Type | Required | Description |
|---|
symbol | String (query) | Yes | Perpetual symbol in raw format (e.g., BTCUSDT). Case-insensitive, will be uppercased. |
Response: Upstream JSON structure is returned as-is. Typical fields include the symbol, long/short ratios of top traders, position deltas, and signal timestamp. Structure may evolve with upstream changes — read the raw response before building downstream logic.
{
"success": true,
"data": {
"code": "000000",
"message": null,
"data": { "symbol": "BTCUSDT", "...": "upstream fields" },
"success": true
},
"usage": {"cost": 1, "quota": 99}
}
Display to user:
- Summarize the directional bias (long-heavy vs short-heavy) and any notable shifts
- Pair with
GET /public/metadata/funding-rate and GET /public/metadata/open-interest for a fuller picture
21. Get Account Summary
获取指定交易所的账户余额摘要信息，包括总余额、可用余额、杠杆分析等。
curl -s "$BASE_URL/open/trader/newsliquid/v1/account/summary?exchangeId=binance&symbol=BTC/USDT:USDT&accountType=swap" \
-H "$AUTH_HEADER"
Parameters:
| Field | Type | Required | Description |
|---|
exchangeId | String (query) | Yes | Exchange ID |
symbol | String (query) | No | Trading pair, for determining quote currency |
accountType | String (query) | No | Account type (default: spot): spot, swap, future, margin |
Response:
{
"success": true,
"data": {
"exchangeId": "binance",
"accountType": "swap",
"balance": 10000.00,
"available": 8500.00,
"currency": "USDT",
"leverage": 10,
"maxPosition": 85000.00,
"totals": {
"USDT": 10000.00,
"BTC": 0.05
},
"frees": {
"USDT": 8500.00,
"BTC": 0.05
},
"leverageAnalysis": {
"symbol": "BTC/USDT:USDT",
"exchangeId": "binance",
"availableBalance": 8500.00,
"balanceCurrency": "USDT",
"leverageInfo": {
"exchangeId": "binance",
"symbol": "BTC/USDT:USDT",
"tiers": [],
"supportsDynamicLeverage": true,
"baseCurrency": "BTC",
"quoteCurrency": "USDT",
"settleCurrency": "USDT",
"generatedAt": 1679400000000
},
"marketPrice": 67890.50
}
},
"usage": {"cost": 1, "quota": 99}
}
Display to user:
- "Total Balance: $10,000.00 USDT"
- "Available: $8,500.00 | Leverage: 10x"
- "Max Position: $85,000.00"
22. Get Spot Asset
查询指定交易所和交易对的现货资产持有信息。
curl -s "$BASE_URL/open/trader/newsliquid/v1/account/spot?exchangeId=binance&symbol=BTC/USDT" \
-H "$AUTH_HEADER"
Parameters:
| Field | Type | Required | Description |
|---|
exchangeId | String (query) | Yes | Exchange ID |
symbol | String (query) | Yes | Trading pair (e.g., BTC/USDT) |
Response:
{
"success": true,
"data": {
"exchangeId": "binance",
"symbol": "BTC/USDT",
"baseAsset": "BTC",
"quantity": 0.5,
"free": 0.45,
"locked": 0.05,
"costPrice": 65000.00,
"totalCost": 32500.00
},
"usage": {"cost": 1, "quota": 99}
}
Display to user:
- "BTC: 0.5 (Free: 0.45, Locked: 0.05)"
- "Avg Cost: $65,000 | Total Cost: $32,500"
23. Get All Spot Assets
获取指定交易所的所有现货资产列表。
curl -s "$BASE_URL/open/trader/newsliquid/v1/account/spots?exchangeId=binance" \
-H "$AUTH_HEADER"
Parameters:
| Field | Type | Required | Description |
|---|
exchangeId | String (query) | Yes | Exchange ID |
symbol | String (query) | No | Filter by trading pair |
Response:
{
"success": true,
"data": [
{
"exchangeId": "binance",
"symbol": null,
"baseAsset": "BTC",
"quantity": 0.5,
"free": 0.45,
"locked": 0.05,
"costPrice": 65000.00,
"totalCost": 32500.00
},
{
"exchangeId": "binance",
"symbol": null,
"baseAsset": "USDT",
"quantity": 10000.00,
"free": 8500.00,
"locked": 1500.00,
"costPrice": 1.00,
"totalCost": 10000.00
}
],
"usage": {"cost": 1, "quota": 99}
}
Display to user:
- List all assets with non-zero balances, showing free/locked split and cost basis
24. Get Trading Config
获取用户的交易配置摘要（不包含密钥敏感信息）。
curl -s "$BASE_URL/open/trader/newsliquid/v1/config" \
-H "$AUTH_HEADER"
Parameters: None
Response:
{
"success": true,
"data": {
"defaultExchange": "binance",
"defaultLeverage": 10,
"defaultPosition": 100.0,
"general": {},
"binanceConfigured": true,
"bybitConfigured": false,
"okxConfigured": true,
"hyperliquidConfigured": false,
"asterConfigured": false
},
"usage": {"cost": 1, "quota": 99}
}
Display to user:
- "Default Exchange: binance | Leverage: 10x | Position: $100"
- List which exchanges are configured
25. Update Trading Config
更新用户的交易配置，包括默认交易所、杠杆和交易所凭证。
IMPORTANT: Exchange API credentials (apiKey, secret, password) are sensitive. Never log or display them.
curl -s -X PUT "$BASE_URL/open/trader/newsliquid/v1/config" \
-H "$AUTH_HEADER" -H "Content-Type: application/json" \
-d '{
"defaultExchange": "binance",
"defaultLeverage": 10,
"defaultPosition": 100.0,
"binance": {
"apiKey": "your-api-key",
"secret": "your-api-secret",
"password": ""
}
}'
Parameters (body):
| Field | Type | Required | Description |
|---|
defaultExchange | String | No | Default exchange: binance, bybit, okx, hyperliquid |
defaultLeverage | Integer | No | Default leverage (1-125) |
defaultPosition | Float | No | Default position size |
general | Object | No | General config |
binance / bybit / okx / hyperliquid / aster | Object | No | Exchange credentials: apiKey (required), secret (required), password (optional, OKX requires) |
Response:
{
"success": true,
"data": {
"updated": true
},
"usage": {"cost": 1, "quota": 99}
}
26. Place Order (Risk Controlled)
在指定交易所下单。支持多种订单类型。
This endpoint is protected by the risk engine — orders that deviate too far from market price, exceed position limits, hit rate limits, or lack sufficient balance will be rejected.
CRITICAL — Required Parameters:
type (REQUIRED): Order type must be explicitly specified. Choose from: market, limit, stop_market, take_profit_market. Each type has different parameter requirements (see Order Types section below).hedged (REQUIRED): Hedge mode flag. If the value is unknown, call GET /position/mode first to obtain data.hedged. Once obtained, it can be reused for subsequent orders on the same symbol/exchange.
curl -s "$BASE_URL/open/trader/newsliquid/v1/position/mode?symbol=BTC/USDT:USDT&exchangeId=binance" \
-H "$AUTH_HEADER"
curl -s -X POST "$BASE_URL/open/trader/newsliquid/v1/orders" \
-H "$AUTH_HEADER" -H "Content-Type: application/json" \
-d '{
"exchangeId": "binance",
"symbol": "BTC/USDT:USDT",
"side": "buy",
"type": "limit",
"quantity": 0.01,
"price": 65000.00,
"hedged": false,
"stopLossPrice": 64000.00,
"takeProfitPrice": 70000.00
}'
curl -s "$BASE_URL/open/trader/newsliquid/v1/position/mode?symbol=ETH/USDT:USDT&exchangeId=binance" -H "$AUTH_HEADER"
curl -s -X POST "$BASE_URL/open/trader/newsliquid/v1/orders" \
-H "$AUTH_HEADER" -H "Content-Type: application/json" \
-d '{
"exchangeId": "binance",
"symbol": "ETH/USDT:USDT",
"side": "sell",
"type": "market",
"quantity": 0.5,
"hedged": false
}'
curl -s "$BASE_URL/open/trader/newsliquid/v1/position/mode?symbol=BTC/USDT:USDT&exchangeId=binance" -H "$AUTH_HEADER"
curl -s -X POST "$BASE_URL/open/trader/newsliquid/v1/orders" \
-H "$AUTH_HEADER" -H "Content-Type: application/json" \
-d '{
"exchangeId": "binance",
"symbol": "BTC/USDT:USDT",
"side": "sell",
"type": "stop_market",
"quantity": 0.01,
"triggerPrice": 58000.00,
"hedged": false
}'
Parameters (body):
| Field | Type | Required | Description |
|---|
exchangeId | String | No | Exchange ID (default: binance) |
symbol | String | Yes | Trading pair in CCXT format (e.g., BTC/USDT:USDT) |
side | String | Yes | buy or sell |
type | String | Yes | Order type (REQUIRED) - determines execution behavior and which other parameters are needed. See Order Types below. |
quantity | Float | Conditional | Base currency quantity |
quoteAmount | Float | Conditional | Quote currency amount (e.g., USDT) |
price | Float | Conditional | Limit price, required for limit, stop_limit, take_profit_limit |
triggerPrice | Float | Conditional | Trigger price, required for stop_market, stop_limit, take_profit_market, take_profit_limit |
hedged | Boolean | Yes | Hedge mode (REQUIRED) - MUST be obtained from GET /position/mode if unknown. Using incorrect value may cause order rejection. |
stopLossPrice | Float | No | Attached stop-loss trigger price |
takeProfitPrice | Float | No | Attached take-profit trigger price |
Order types:
market — Market order (executes immediately at current market price, no price needed)limit — Limit order (executes at specified price or better, price required)stop_market — Stop-loss market order (triggers at triggerPrice, executes at market, triggerPrice required)take_profit_market — Take-profit market order (triggers at triggerPrice, executes at market, triggerPrice required)
Important: Always specify type explicitly. Different order types require different parameters:
market: requires quantity or quoteAmountlimit: requires quantity or quoteAmount + pricestop_market / take_profit_market: requires quantity + triggerPrice
Response:
{
"success": true,
"data": {
"exchange": "binance",
"orderId": "123456789",
"symbol": "BTC/USDT:USDT",
"side": "buy",
"type": "limit",
"amount": 0.01,
"price": 65000.00,
"triggerPrice": 0,
"status": "open",
"filledQty": 0,
"avgPrice": 0,
"reduceOnly": false,
"createdAt": "2026-03-21T10:30:00Z",
"tpsl": {
"tpTriggerPx": 70000.00,
"tpTriggerPxType": "last",
"tpOrdPx": -1,
"slTriggerPx": 64000.00,
"slTriggerPxType": "last",
"slOrdPx": -1,
"attachId": "attach_001",
"closePosition": false
}
},
"usage": {"cost": 1, "quota": 99}
}
Display to user:
- "Order placed! ID: 123456789"
- "Buy 0.01 BTC @ $65,000 (Limit) on Binance"
- "TP: $70,000 | SL: $64,000"
- "Status: Open"
27. Cancel Order
取消指定的挂单。
curl -s -X DELETE "$BASE_URL/open/trader/newsliquid/v1/orders/123456789?exchangeId=binance&symbol=BTC/USDT:USDT" \
-H "$AUTH_HEADER"
Parameters:
| Field | Type | Required | Description |
|---|
orderId | String (path) | Yes | Order ID (in URL path) |
exchangeId | String (query) | Yes | Exchange ID |
symbol | String (query) | Yes | Trading pair |
type | String (query) | No | Order type (required for TP/SL orders) |
Response:
{
"success": true,
"data": {
"cancelled": true
},
"usage": {"cost": 1, "quota": 99}
}
28. List Open Orders
获取当前所有未成交的挂单。
curl -s "$BASE_URL/open/trader/newsliquid/v1/orders/open?exchangeId=binance&symbol=BTC/USDT:USDT" \
-H "$AUTH_HEADER"
Parameters:
| Field | Type | Required | Description |
|---|
exchangeId | String (query) | No | Exchange ID (omit for all exchanges) |
symbol | String (query) | No | Filter by trading pair |
days | Integer (query) | No | Filter by creation time (days) |
Response:
{
"success": true,
"data": [
{
"exchange": "binance",
"orderId": "123456789",
"symbol": "BTC/USDT:USDT",
"side": "buy",
"type": "limit",
"amount": 0.01,
"price": 65000.00,
"triggerPrice": 0,
"status": "open",
"filledQty": 0,
"avgPrice": 0,
"reduceOnly": false,
"createdAt": "2026-03-21T10:30:00Z",
"tpsl": null
}
],
"usage": {"cost": 1, "quota": 99}
}
Display to user:
- Table of open orders with exchange, ID, pair, side, type, amount, price, status
29. List Closed Orders
获取已完成（成交/取消）的历史订单。
curl -s "$BASE_URL/open/trader/newsliquid/v1/orders/closed?exchangeId=binance&symbol=BTC/USDT:USDT&days=7" \
-H "$AUTH_HEADER"
Parameters:
| Field | Type | Required | Description |
|---|
exchangeId | String (query) | No | Exchange ID (omit for all exchanges) |
symbol | String (query) | No | Filter by trading pair |
days | Integer (query) | No | Filter by days (default: 7) |
Response: Same []OrderResponse structure as List Open Orders.
30. List Current Positions
获取当前所有持仓信息。
curl -s "$BASE_URL/open/trader/newsliquid/v1/positions?exchangeId=binance" \
-H "$AUTH_HEADER"
Parameters:
| Field | Type | Required | Description |
|---|
exchangeId | String (query) | No | Exchange ID (omit for all exchanges) |
symbol | String (query) | No | Filter by trading pair |
Response:
{
"success": true,
"data": [
{
"exchange": "binance",
"symbol": "BTC/USDT:USDT",
"side": "long",
"contracts": 0.01,
"entryPrice": 65000.00,
"markPrice": 67890.50,
"unrealizedPnl": 28.905,
"leverage": 10,
"liquidationPrice": 58500.00,
"marginMode": "cross",
"hedged": false,
"timestamp": 1679400000000
}
],
"usage": {"cost": 1, "quota": 99}
}
Display to user:
- "BTC/USDT:USDT Long 0.01 BTC (Binance)"
- "Entry: $65,000 | Mark: $67,890.50"
- "P&L: +$28.91 (+4.45%)"
- "Leverage: 10x Cross | Liq: $58,500"
31. List Historical Positions
获取已平仓的历史持仓记录（包含关联的交易明细）。
curl -s "$BASE_URL/open/trader/newsliquid/v1/positions/history?exchangeId=binance&days=7" \
-H "$AUTH_HEADER"
Parameters:
| Field | Type | Required | Description |
|---|
exchangeId | String (query) | No | Exchange ID |
symbol | String (query) | No | Filter by trading pair |
days | Integer (query) | No | Filter by days (default: 0 = all) |
Response:
{
"success": true,
"data": [
{
"exchange": "binance",
"symbol": "BTC/USDT:USDT",
"side": "long",
"marginMode": "cross",
"leverage": 10,
"entryPrice": 65000.00,
"openDateTime": "2026-03-20T08:00:00Z",
"openTimestamp": 1679313600000,
"closePrice": 67500.00,
"fullyClosed": true,
"closeDateTime": "2026-03-21T10:30:00Z",
"closeTimestamp": 1679400600000,
"closedAmount": 0.01,
"totalAmount": 0.01,
"realizedPnl": 25.00,
"totalFee": 1.30,
"tradeCount": 2,
"openTrades": 1,
"closeTrades": 1,
"trades": [
{
"exchange": "binance",
"tradeId": "trade_001",
"orderId": "order_001",
"symbol": "BTC/USDT:USDT",
"side": "buy",
"price": 65000.00,
"amount": 0.01,
"cost": 650.00,
"fee": 0.65,
"pnl": 0,
"reduceOnly": false,
"timestamp": 1679313600000,
"datetime": "2026-03-20T08:00:00Z"
},
{
"exchange": "binance",
"tradeId": "trade_002",
"orderId": "order_002",
"symbol": "BTC/USDT:USDT",
"side": "sell",
"price": 67500.00,
"amount": 0.01,
"cost": 675.00,
"fee": 0.65,
"pnl": 25.00,
"reduceOnly": true,
"timestamp": 1679400600000,
"datetime": "2026-03-21T10:30:00Z"
}
]
}
],
"usage": {"cost": 1, "quota": 99}
}
Display to user:
- "BTC/USDT:USDT Long — Closed"
- "Entry: $65,000 → Exit: $67,500"
- "Realized P&L: +$25.00 (Fee: $1.30)"
- "Duration: ~26.5 hours"
32. Close Position (Risk Controlled)
关闭指定的持仓（全部或部分平仓）。
This endpoint is protected by the risk engine.
CRITICAL — Required Parameters:
quantity (REQUIRED): You must explicitly provide the position size to close. 0 is not allowed. Use the actual position size from GET /positions when closing the full position.hedged (REQUIRED): If the value is unknown, call GET /position/mode first to obtain data.hedged. Once obtained, it can be reused for subsequent requests on the same symbol/exchange.
curl -s "$BASE_URL/open/trader/newsliquid/v1/position/mode?symbol=BTC/USDT:USDT&exchangeId=binance" \
-H "$AUTH_HEADER"
curl -s -X POST "$BASE_URL/open/trader/newsliquid/v1/positions/close" \
-H "$AUTH_HEADER" -H "Content-Type: application/json" \
-d '{
"exchangeId": "binance",
"symbol": "BTC/USDT:USDT",
"side": "long",
"quantity": 0.01,
"hedged": false
}'
Parameters (body):
| Field | Type | Required | Description |
|---|
exchangeId | String | Yes | Exchange ID |
symbol | String | Yes | Trading pair |
side | String | Yes | Position side: long or short |
quantity | Float | Yes | Close quantity (REQUIRED). Must be greater than 0. Use the actual position size from GET /positions to close the full position. |
hedged | Boolean | Yes | Hedge mode (REQUIRED). If unknown, get data.hedged from GET /position/mode. |
price | Float | No | Market price for Hyperliquid |
Response: Same OrderResponse structure as Place Order.
Display to user:
- "Position closed! BTC/USDT:USDT Long"
- Show realized P&L from the order response
33. Get Trade History
获取历史成交记录。
curl -s "$BASE_URL/open/trader/newsliquid/v1/trades/history?exchangeId=binance&symbol=BTC/USDT:USDT&days=7" \
-H "$AUTH_HEADER"
Parameters:
| Field | Type | Required | Description |
|---|
exchangeId | String (query) | No | Exchange ID |
symbol | String (query) | No | Filter by trading pair |
days | Integer (query) | No | Filter by days (default: 7) |
Response:
{
"success": true,
"data": [
{
"exchange": "binance",
"tradeId": "trade_001",
"orderId": "order_001",
"symbol": "BTC/USDT:USDT",
"side": "buy",
"price": 65000.00,
"amount": 0.01,
"cost": 650.00,
"fee": 0.65,
"pnl": 0,
"reduceOnly": false,
"timestamp": 1679313600000,
"datetime": "2026-03-20T08:00:00Z"
}
],
"usage": {"cost": 1, "quota": 99}
}
Display to user:
- Table of trades with exchange, pair, side, price, amount, cost, fee, P&L
34. Get Leverage Tiers
获取指定交易对的杠杆档位（梯度）信息。
curl -s "$BASE_URL/open/trader/newsliquid/v1/leverage?symbol=BTC/USDT:USDT&exchangeId=binance" \
-H "$AUTH_HEADER"
Parameters:
| Field | Type | Required | Description |
|---|
symbol | String (query) | Yes | Trading pair |
exchangeId | String (query) | Yes | Exchange ID |
Response:
{
"success": true,
"data": {
"exchangeId": "binance",
"symbol": "BTC/USDT:USDT",
"tiers": [
{
"tier": 1,
"minNotional": 0,
"maxNotional": 50000,
"maintenanceMarginRate": 0.004,
"initialMarginRate": 0.01,
"maxLeverage": 100
},
{
"tier": 2,
"minNotional": 50000,
"maxNotional": 250000,
"maintenanceMarginRate": 0.005,
"initialMarginRate": 0.02,
"maxLeverage": 50
}
],
"supportsDynamicLeverage": true,
"baseCurrency": "BTC",
"quoteCurrency": "USDT",
"settleCurrency": "USDT",
"minNotional": 5.0,
"generatedAt": 1679400000000
},
"usage": {"cost": 1, "quota": 99}
}
Display to user:
- Table of leverage tiers with max leverage, notional range, and margin rates
35. Get Current Leverage
获取指定交易对当前设置的杠杆倍数和保证金模式。
curl -s "$BASE_URL/open/trader/newsliquid/v1/leverage/current?symbol=BTC/USDT:USDT&exchangeId=binance" \
-H "$AUTH_HEADER"
Parameters:
| Field | Type | Required | Description |
|---|
symbol | String (query) | Yes | Trading pair |
exchangeId | String (query) | Yes | Exchange ID |
Response:
{
"success": true,
"data": {
"leverage": 10,
"marginMode": "cross"
},
"usage": {"cost": 1, "quota": 99}
}
Display to user:
- "BTC/USDT:USDT: 10x leverage, Cross margin"
36. Set Leverage (Risk Controlled)
设置指定交易对的杠杆倍数。
This endpoint is protected by the risk engine.
curl -s -X PUT "$BASE_URL/open/trader/newsliquid/v1/leverage/current" \
-H "$AUTH_HEADER" -H "Content-Type: application/json" \
-d '{"exchangeId":"binance","symbol":"BTC/USDT:USDT","leverage":20}'
Parameters (body):
| Field | Type | Required | Description |
|---|
exchangeId | String | Yes | Exchange ID |
symbol | String | Yes | Trading pair |
leverage | Integer | Yes | Leverage multiplier (min: 1) |
Response:
{
"success": true,
"data": {
"updated": true
},
"usage": {"cost": 1, "quota": 99}
}
Display to user:
- "Leverage updated! BTC/USDT:USDT: 20x"
37. Get Margin Mode
获取指定交易对的保证金模式（cross 全仓 / isolated 逐仓）。
curl -s "$BASE_URL/open/trader/newsliquid/v1/margin/mode?symbol=BTC/USDT:USDT&exchangeId=binance" \
-H "$AUTH_HEADER"
Parameters:
| Field | Type | Required | Description |
|---|
symbol | String (query) | Yes | Trading pair |
exchangeId | String (query) | Yes | Exchange ID |
Response:
{
"success": true,
"data": {
"marginMode": "cross"
},
"usage": {"cost": 1, "quota": 99}
}
38. Get Position Mode
获取指定交易对的持仓模式（单向/双向）。
curl -s "$BASE_URL/open/trader/newsliquid/v1/position/mode?symbol=BTC/USDT:USDT&exchangeId=binance" \
-H "$AUTH_HEADER"
Parameters:
| Field | Type | Required | Description |
|---|
symbol | String (query) | Yes | Trading pair |
exchangeId | String (query) | Yes | Exchange ID |
Response:
{
"success": true,
"data": {
"hedged": false,
"info": {
"dualSidePosition": false
}
},
"usage": {"cost": 1, "quota": 99}
}
Key field: data.hedged — this value MUST be passed as the hedged parameter when placing orders (POST /orders) or closing positions (POST /positions/close). If the hedged value is unknown, call this endpoint first to obtain it; once obtained, it can be reused for subsequent requests on the same symbol and exchange.
39. Set Position Mode
设置指定交易对的持仓模式。
curl -s -X PUT "$BASE_URL/open/trader/newsliquid/v1/position/mode" \
-H "$AUTH_HEADER" -H "Content-Type: application/json" \
-d '{"exchangeId":"binance","symbol":"BTC/USDT:USDT","hedged":true}'
Parameters (body):
| Field | Type | Required | Description |
|---|
exchangeId | String | Yes | Exchange ID |
symbol | String | Yes | Trading pair |
hedged | Boolean | Yes | true = Hedge Mode (two-way), false = One-way Mode |
Response:
{
"success": true,
"data": {
"updated": true
},
"usage": {"cost": 1, "quota": 99}
}
Display to user:
- "Position mode updated to Hedge (two-way)"
Cross-Skill Workflows
Workflow A: CEX Spot Trading
User: "Buy 0.1 BTC on Binance"
1. opentrade-cex GET /market/ticker?symbol=BTC/USDT&exchangeId=binance → check current price
2. opentrade-cex GET /account/summary?exchangeId=binance → verify available balance
3. opentrade-cex GET /market/metadata?ticker=BTC → confirm pair info/limits
4. opentrade-cex POST /orders → place order
{"symbol":"BTC/USDT:USDT","side":"buy","type":"market","quantity":0.1,"exchangeId":"binance"}
5. opentrade-cex GET /orders/open → confirm order status
Data handoff:
last price from step 1 → helps user decide order type (market vs limit)available balance from step 2 → validates user can afford the order- Market info from step 3 → confirms pair exists and shows limits
Workflow B: CEX Futures Trading
User: "Open a 10x long on ETH with $1000"
1. opentrade-cex GET /market/ticker?symbol=ETH/USDT&exchangeId=binance → check ETH price
2. opentrade-cex GET /account/summary?exchangeId=binance&symbol=ETH/USDT:USDT&accountType=swap → check margin balance
3. opentrade-cex GET /leverage/current?symbol=ETH/USDT:USDT&exchangeId=binance → check current leverage
4. opentrade-cex PUT /leverage/current → set leverage to 10x (if needed)
{"symbol":"ETH/USDT:USDT","leverage":10,"exchangeId":"binance"}
5. opentrade-cex GET /position/mode?symbol=ETH/USDT:USDT&exchangeId=binance → get hedged value (if unknown)
6. opentrade-cex POST /orders → open long position (use hedged from step 5)
{"symbol":"ETH/USDT:USDT","side":"buy","type":"market","quantity":<calculated>,"exchangeId":"binance","hedged":false}
7. opentrade-cex GET /positions → verify position opened
Data handoff:
last price from step 1 → calculate quantity: $1000 / ETH_price- Leverage 10x means only $100 margin needed for $1000 position
data.hedged from step 5 → pass to order request in step 6
Workflow C: News-Driven CEX Trading
User: "Check latest crypto news and trade accordingly"
1. [opennews] Search crypto news → get AI ratings and trade signals
2. [opentwitter] Check KOL sentiment on the target token
3. opentrade-cex GET /market/ticker → check CEX price
4. opentrade-cex GET /market/klines?interval=1h → check recent trend
5. opentrade-cex GET /account/summary → check balance
6. opentrade-cex POST /orders → execute trade
7. opentrade-cex GET /positions → monitor position
Workflow D: CEX-DEX Price Arbitrage
User: "Compare BTC price between CEX and DEX"
1. opentrade-cex GET /market/ticker?symbol=BTC/USDT&exchangeId=binance → CEX price
2. [opentrade-market] GET /market/price (on-chain) → DEX price
3. Compare prices → identify arbitrage opportunity
4a. CEX cheaper → opentrade-cex POST /orders (CEX buy) + [opentrade-dex-swap] (DEX sell)
4b. DEX cheaper → [opentrade-dex-swap] (DEX buy) + opentrade-cex POST /orders (CEX sell)
5. Confirm both sides filled → calculate profit
Workflow E: CEX Hedge + DEX Spot Holdings
User: "Hedge my on-chain ETH holdings with a CEX short"
1. [opentrade-portfolio] Check on-chain ETH balance → e.g., 10 ETH
2. opentrade-cex GET /account/summary → check CEX margin
3. opentrade-cex PUT /leverage/current → set leverage
4. opentrade-cex POST /orders → open short position
{"symbol":"ETH/USDT:USDT","side":"sell","type":"market","quantity":10,"exchangeId":"binance"}
5. opentrade-cex GET /positions → confirm hedge position
Workflow F: DEX Discovery + CEX Execution
User: "Find trending tokens and trade on CEX"
1. [opentrade-token] Search trending tokens → discover hot tokens
2. [opentrade-market] Check on-chain trading activity → smart money signals
3. opentrade-cex GET /market/metadata → check if listed on CEX
4. If CEX listed → opentrade-cex POST /orders → trade on CEX (lower fees)
If not listed → [opentrade-dex-swap] → trade on DEX
Workflow G: Cross-Venue Portfolio Overview
User: "Show me all my assets across CEX and DEX"
1. opentrade-cex GET /account/summary → CEX total balance
2. opentrade-cex GET /account/spots → CEX spot assets
3. opentrade-cex GET /positions → CEX open positions
4. [opentrade-portfolio] Get on-chain wallet balances → DEX holdings
5. Combine and present unified portfolio report
Operation Flow
Step 1: Identify Intent
| User wants to... | Action |
|---|
| Check CEX market price | GET /market/ticker |
| View K-line / chart data | GET /market/klines |
| Get order book depth | GET /public/metadata/orderbook |
| Get multiple tickers | GET /public/metadata/tickers |
| Get OHLCV candles | GET /public/metadata/ohlcv |
| View recent public trades | GET /public/metadata/trades |
| Check funding rate | GET /public/metadata/funding-rate |
| Compare funding rates across exchanges | GET /public/metadata/funding-rate/exchanges |
| Check current open interest | GET /public/metadata/open-interest |
| Check open interest history | GET /public/metadata/open-interest/history |
| Get index price constituents | GET /public/market/index-constituents |
| Get smart money signal | GET /public/market/smart-money |
| Check account balance | GET /account/summary or GET /account/spots |
| Place a buy/sell order | POST /orders |
| Cancel an order | DELETE /orders/:orderId |
| View open orders | GET /orders/open |
| View closed orders | GET /orders/closed |
| Check current positions | GET /positions |
| Close a position | POST /positions/close |
| Set leverage | PUT /leverage/current |
| Check leverage / margin | GET /leverage/current, GET /margin/mode |
| View trade history | GET /trades/history |
Step 2: Collect Parameters
- Missing exchangeId → ask user which exchange (e.g.,
binance, bybit, okx, hyperliquid)
- Missing symbol → ask user which trading pair; format as CCXT standard (e.g.,
BTC/USDT for spot, BTC/USDT:USDT for perpetual)
- Missing side → ask user: buy or sell?
- Missing order type → suggest
market for immediate execution, limit for price control
- Missing quantity → ask user; for futures, help calculate based on notional value and leverage. For
POST /positions/close, quantity is mandatory and must be greater than 0.
- Missing price → required for limit orders; call
GET /market/ticker to show current price as reference
- Missing leverage → check current setting with
GET /leverage/current; suggest 1x-10x for beginners
Step 3: Execute & Display
- Run the API call
- Parse JSON response
- Display human-readable summary with prices, quantities, P&L in friendly format
- For order creation: show order ID, pair, side, type, quantity, price, status
- For positions: show pair, side, entry/mark price, P&L, leverage
- For account: show total/available balance, unrealized P&L
Step 4: Suggest Next Steps
| Just completed | Suggest |
|---|
| Checked ticker | 1. Place an order 2. View K-line for trend analysis |
| Checked balance | 1. Place an order 2. Check positions |
| Placed order | 1. Check open orders 2. View positions 3. Set stop-loss |
| Order filled | 1. View positions 2. Set take-profit/stop-loss |
| Position opened | 1. Monitor with ticker 2. Set stop-loss order 3. Close position |
| Position closed | 1. Check realized P&L in trade history 2. Check updated balance |
| Set leverage | 1. Place an order 2. Check position limits |
Present conversationally — never expose endpoint paths to the user.
Risk Engine Notes
All risk-controlled endpoints (marked with "Risk: Yes" in Command Index) pass through a 4-layer risk engine before execution:
| Rule | Name | Trigger | Default Threshold |
|---|
| 1 | Price Deviation Check | Limit orders | Max 10% deviation from market price |
| 2 | Position Size Limit | Order creation, position close | Single: 20% of balance, Total: 80% of balance |
| 3 | Rate Limit | All risk-controlled endpoints | 30 requests per minute |
| 4 | Balance Check | Order creation | Min 5% balance reserve |
What happens when risk check fails:
- The API returns an error with a description of which rule was triggered
- The order/action is NOT executed
- Display the reason to the user clearly (e.g., "Order rejected: price deviates 15% from market price, max allowed is 10%")
- Suggest corrective action (adjust price, reduce quantity, wait and retry, etc.)
Risk engine behavior:
- Rules are checked in priority order (rate limit → price deviation → position limit → balance check)
- First failure stops the chain — remaining rules are not checked
- The risk engine uses a fail-open strategy: if market data or Redis is unavailable, the check passes (prioritizing availability)
Input / Output Examples
User says: "What's the BTC price on Binance?"
curl -s "$BASE_URL/open/trader/newsliquid/v1/market/ticker?symbol=BTC/USDT&exchangeId=binance" -H "$AUTH_HEADER"
User says: "Buy 0.01 BTC at $65,000"
curl -s "$BASE_URL/open/trader/newsliquid/v1/position/mode?symbol=BTC/USDT:USDT&exchangeId=binance" -H "$AUTH_HEADER"
curl -s -X POST "$BASE_URL/open/trader/newsliquid/v1/orders" \
-H "$AUTH_HEADER" -H "Content-Type: application/json" \
-d '{"symbol":"BTC/USDT:USDT","side":"buy","type":"limit","quantity":0.01,"price":65000,"exchangeId":"binance","hedged":false}'
User says: "Close my BTC position"
curl -s "$BASE_URL/open/trader/newsliquid/v1/position/mode?symbol=BTC/USDT:USDT&exchangeId=binance" -H "$AUTH_HEADER"
curl -s -X POST "$BASE_URL/open/trader/newsliquid/v1/positions/close" \
-H "$AUTH_HEADER" -H "Content-Type: application/json" \
-d '{"symbol":"BTC/USDT:USDT","side":"long","quantity":0.01,"exchangeId":"binance","hedged":false}'
User says: "Set my ETH leverage to 20x"
curl -s -X PUT "$BASE_URL/open/trader/newsliquid/v1/leverage/current" \
-H "$AUTH_HEADER" -H "Content-Type: application/json" \
-d '{"symbol":"ETH/USDT:USDT","leverage":20,"exchangeId":"binance"}'
Edge Cases
- Risk engine rejects order: Display the rejection reason clearly. Common causes: price too far from market (>10%), position too large, rate limited, insufficient balance. Suggest the user adjust parameters and retry.
- Insufficient balance: Check balance with
GET /account/summary first. For futures, consider leverage — required margin = order value / leverage.
- Rate limited: If 30+ requests in 1 minute, wait 60 seconds before retrying. Inform the user about the cooldown.
- Close position quantity missing or zero: For
POST /positions/close, quantity must be explicitly provided and must be greater than 0. To close the full position, call GET /positions first and use the actual current position size.
- Position mode conflict: Cannot switch position mode while holding open positions. Close all positions first.
- Leverage change with open positions: Some exchanges restrict leverage changes when positions are open. Close positions or reduce size first.
- Order quantity precision: Use
GET /market/metadata to check amountMin and costMin. Ensure order meets minimum requirements.
- Minimum notional: Orders below the minimum cost (e.g., $5
costMin) will be rejected by the exchange.
- Network error: Retry once, then prompt user to try again later.
- Region restriction (error code 50125 or 80001): Do NOT show the raw error code to the user. Instead, display:
Service is not available in your region. Please switch to a supported region and try again.
Amount Display Rules
- CEX amounts use standard units (e.g.,
0.1 BTC, 100 USDT) — NOT minimal units like DEX
- Always show currency symbol alongside amounts
- Format large numbers with commas (e.g.,
$67,500.50)
- Show P&L with sign and color hint: positive (+$250.00), negative (-$100.00)
- Show percentage changes with sign (e.g., +1.89%, -0.52%)
- Leverage shown as multiplier (e.g., 10x, 20x)
Global Notes
- All endpoints require
Authorization: Bearer <token> header
- Supported exchanges:
binance, bybit, okx, hyperliquid, aster
- Trading pair format follows CCXT standard:
- Spot:
BTC/USDT (no colon suffix)
- Characteristics:
spot: true, swap: false, contract: false, leverageMax: 1
- Use for spot trading without leverage
- Perpetual futures (swap):
BTC/USDT:USDT (with :SETTLE suffix)
- Characteristics:
spot: false, swap: true, contract: true, leverageMax: 125
- The
:SETTLE suffix indicates settlement currency (usually matches quote currency)
- Use for leveraged perpetual contract trading
- Always use the exact
symbol value from GET /market/metadata response to ensure correct market type
- Always use
symbol, NOT displaySymbol when calling API endpoints (displaySymbol is for display only)
- Default to contract (swap) symbol when multiple markets exist for the same ticker — only use spot when user explicitly asks for spot trading
- Quick check: If
symbol contains : → it's a perpetual futures contract; no : → it's spot
- The API routes through the CEX gateway with built-in risk controls — trades execute server-side
- No private keys or transaction signing involved — this is CEX trading via API
- CEX uses standard amount units (e.g.,
0.1 BTC), unlike DEX which uses minimal units (wei/lamports)
- Numeric values in request bodies use native types (numbers, not strings):
"quantity": 0.01, "price": 65000.00
- Risk-controlled endpoints may reject requests — always display the rejection reason to the user
- Query parameters go in the URL, body parameters go in JSON request body
- Each API request consumes 1 quota unit (shown in
usage field of response)
- Success response:
{"success": true, "data": {...}, "usage": {"cost": 1, "quota": 99}}
- Error response (upstream):
{"success": false, "code": "INVALID_REQUEST", "error": "message"}
- Error response (gateway):
{"code": 400, "message": "error message", "error": "details"}
- The skill uses the same
OPEN_TOKEN as all other opentrade skills — no additional configuration needed
