| name | opentrade-cex |
| description | Use for centralized exchange trading and account queries: CEX spot/futures orders, open/closed orders, balances, spot assets, futures/perpetual positions, leverage, margin mode, position mode, funding rates, order book, tickers, K-lines, open interest, gamma exposure, account summary, and trade/position history. Trigger on buy/sell on CEX, long/short, open or close position, set leverage, cancel order, show open orders, show holdings, query positions, CEX balance, gamma exposure, option gamma, GEX, 查询持仓, 查询订单, 当前订单, 历史订单, 交易历史, 成交记录. For user-specific holdings, positions, orders, closed orders, or trade history, query CEX first; fall back to DEX/on-chain skills only if CEX has no relevant data or the user explicitly asks for wallet/DEX/on-chain data. Do not use for DEX swaps, token search, custodial wallet management, or transaction broadcasting. |
| license | MIT |
| metadata | {"author":6551,"version":"1.0.4","homepage":"https://www.newsliquid.com"} |
OpenTrade CEX Trading
40 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:
OPENNEWS_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 $OPENNEWS_TOKEN"
Skill Routing
- For user-specific holdings/assets, positions, open orders, closed orders, or trade/trading history, query CEX first with this skill. If CEX returns no relevant records, then fall back to DEX/on-chain skills:
- holdings / assets →
opentrade-portfolio
- on-chain public trade logs / swap activity →
opentrade-market
- broadcast transaction order status →
opentrade-gateway
- 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
# 1. Get real-time ticker
curl -s "$BASE_URL/open/trader/newsliquid/v1/market/ticker?symbol=BTC/USDT&exchangeId=binance" \
-H "$AUTH_HEADER"
# 2. Check account balance
curl -s "$BASE_URL/open/trader/newsliquid/v1/account/summary?exchangeId=binance&symbol=BTC/USDT:USDT" \
-H "$AUTH_HEADER"
# 3. Get position mode (if hedged value is unknown, MUST call before placing orders or closing positions)
curl -s "$BASE_URL/open/trader/newsliquid/v1/position/mode?symbol=BTC/USDT:USDT&exchangeId=binance" \
-H "$AUTH_HEADER"
# → Returns {"data": {"hedged": false, "info": {"dualSidePosition": false}}, "success": true}
# 4. Place a limit buy order (use hedged value from step 3)
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}'
# 5. Check open orders
curl -s "$BASE_URL/open/trader/newsliquid/v1/orders/open?exchangeId=binance" \
-H "$AUTH_HEADER"
# 6. Check current positions
curl -s "$BASE_URL/open/trader/newsliquid/v1/positions?exchangeId=binance" \
-H "$AUTH_HEADER"
# 7. Close a position (use hedged value from step 3, quantity is required)
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/metadata/gamma | GET | Get equity option gamma exposure by symbol |
Account (no risk control)
| # | Endpoint | Method | Description |
|---|
| 22 | /open/trader/newsliquid/v1/account/summary | GET | Account summary (balance, leverage, max position) |
| 23 | /open/trader/newsliquid/v1/account/spot | GET | Query specific spot asset |
| 24 | /open/trader/newsliquid/v1/account/spots | GET | Query all spot assets |
Config (no risk control)
| # | Endpoint | Method | Description |
|---|
| 25 | /open/trader/newsliquid/v1/config | GET | Get trading config |
| 26 | /open/trader/newsliquid/v1/config | PUT | Update trading config |
Orders (risk control on create)
| # | Endpoint | Method | Risk | Description |
|---|
| 27 | /open/trader/newsliquid/v1/orders | POST | Yes | Place order (limit/market/stop-loss/take-profit) |
| 28 | /open/trader/newsliquid/v1/orders/:orderId | DELETE | No | Cancel order |
| 29 | /open/trader/newsliquid/v1/orders/open | GET | No | List open orders |
| 30 | /open/trader/newsliquid/v1/orders/closed | GET | No | List closed orders |
Positions (risk control on close)
| # | Endpoint | Method | Risk | Description |
|---|
| 31 | /open/trader/newsliquid/v1/positions | GET | No | List current positions |
| 32 | /open/trader/newsliquid/v1/positions/history | GET | No | List historical positions |
| 33 | /open/trader/newsliquid/v1/positions/close | POST | Yes | Close position (market price) |
Trades (no risk control)
| # | Endpoint | Method | Description |
|---|
| 34 | /open/trader/newsliquid/v1/trades/history | GET | Get trade execution history |
Leverage & Margin (risk control on leverage change)
| # | Endpoint | Method | Risk | Description |
|---|
| 35 | /open/trader/newsliquid/v1/leverage | GET | No | Get available leverage tiers |
| 36 | /open/trader/newsliquid/v1/leverage/current | GET | No | Get current leverage setting |
| 37 | /open/trader/newsliquid/v1/leverage/current | PUT | Yes | Set leverage multiplier |
| 38 | /open/trader/newsliquid/v1/margin/mode | GET | No | Get margin mode |
| 39 | /open/trader/newsliquid/v1/position/mode | GET | No | Get position mode (one-way/hedge) |
| 40 | /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 and swap ), ( or ) unless the user explicitly requests spot trading
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 Gamma Exposure
获取美股标的的期权 Gamma Exposure（GEX）数据。该接口使用股票 ticker，例如 SNDK、AAPL、TSLA，不需要 exchangeId。
curl -s "$BASE_URL/open/trader/newsliquid/v1/public/metadata/gamma?symbol=SNDK&cache_ttl_seconds=300" \
-H "$AUTH_HEADER"
Parameters:
| Field | Type | Required | Description |
|---|
symbol | String (query) | Yes | US equity ticker, e.g. SNDK, AAPL, TSLA |
date | String (query) | No | Market date in YYYY-MM-DD; when omitted, provider returns the latest available market date |
expiry | String (query) | No | Option expiry date in YYYY-MM-DD; when provided, returns strike exposure for that expiry |
cache_ttl_seconds | Integer (query) | No | Override backend cache TTL; 0 forces refresh, max 86400 |
include_expiry_breakdown | Boolean (query) | No | When true, include exposure grouped by expiry |
Response:
{
"success": true,
"data": {
"symbol": "SNDK",
"source": "unusual_whales",
"provider_date": "2026-08-14",
"requested_date": null,
"requested_expiry": null,
"raw_endpoint": "/api/stock/SNDK/greek-exposure/strike",
"row_count": 558,
"total_call_gex": 24677.8465,
"total_put_gex": -13936.3542,
"total_net_gex": 10741.4923,
"max_abs_net_gex": 1683.3503,
"rows": [
{
"strike": 3000,
"date": "2026-08-14",
"call_gex": 77.886,
"put_gex": -11.8434,
"net_gex": 66.0426,
"normalized_gex": 0.0392328323,
"normalized_gex_percent": 3.9232832287
}
]
},
"usage": {"cost": "1"}
}
Display to user:
- Summarize
total_net_gex, total_call_gex, total_put_gex, and provider_date
- Highlight strikes with the largest absolute
net_gex
- If
include_expiry_breakdown=true, summarize the largest expiries by net gamma exposure
20. 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
21. 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
22. 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"
23. 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"
24. 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
25. 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
26. 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}
}
27. 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.
# Step 1: Get position mode to obtain the hedged parameter (if unknown)
curl -s "$BASE_URL/open/trader/newsliquid/v1/position/mode?symbol=BTC/USDT:USDT&exchangeId=binance" \
-H "$AUTH_HEADER"
# → Returns {"data": {"hedged": false, "info": {"dualSidePosition": false}}, "success": true}
# Extract data.hedged value to use in the order request
# Step 2: Limit order - buy 0.01 BTC at $65,000 with TP/SL (use hedged from step 1)
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
}'
# Market order: sell 0.5 ETH (get hedged first)
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
}'
# Stop-loss market order (get hedged first)
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"
28. 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}
}
29. 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
30. 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.
31. 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"
32. 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"
33. 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.
# Step 1: Get position mode to obtain the hedged parameter (if unknown)
curl -s "$BASE_URL/open/trader/newsliquid/v1/position/mode?symbol=BTC/USDT:USDT&exchangeId=binance" \
-H "$AUTH_HEADER"
# → Returns {"data": {"hedged": false, "info": {"dualSidePosition": false}}, "success": true}
# Extract data.hedged value to use in the close request
# Step 2: Close position using hedged value from step 1
# Use the actual position size from GET /positions when closing the full position
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
34. 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
35. 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
36. 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"
37. 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"
38. 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}
}
39. 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.
40. 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
Workflow H: User Query Fallback for Holdings, Orders, and Trade History
User: "查询我的持仓 / 订单 / 交易历史"
1. opentrade-cex GET /account/summary or GET /account/spots → CEX balances / spot holdings
2. opentrade-cex GET /positions → CEX current positions
3. opentrade-cex GET /orders/open and GET /orders/closed → CEX open / historical orders
4. opentrade-cex GET /trades/history or GET /positions/history → CEX execution / position history
5. If the CEX response is empty or not relevant:
- [opentrade-portfolio] Query on-chain wallet holdings
- [opentrade-market] Query public on-chain token trade logs / swap activity
- [opentrade-gateway] Query on-chain broadcast order status when an orderId is provided
Only start directly with DEX/on-chain tools when the user explicitly says "on-chain", "wallet", "DEX", provides a wallet address/chain, or asks for public token swap activity rather than their personal CEX records.
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 |
| Check equity option gamma exposure / GEX | GET /public/metadata/gamma |
| 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, |
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"
# → BTC/USDT: $67,890.50 (Bid: $67,889 | Ask: $67,891)
User says: "Buy 0.01 BTC at $65,000"
# Step 1: Get position mode (if hedged value is unknown)
curl -s "$BASE_URL/open/trader/newsliquid/v1/position/mode?symbol=BTC/USDT:USDT&exchangeId=binance" -H "$AUTH_HEADER"
# → {"data": {"hedged": false, "info": {"dualSidePosition": false}}, "success": true}
# Step 2: Place order with hedged value from step 1
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}'
# → Order placed! Buy 0.01 BTC @ $65,000 (Limit) — ID: 123456789
User says: "Close my BTC position"
# Step 1: Get position mode (if hedged value is unknown)
curl -s "$BASE_URL/open/trader/newsliquid/v1/position/mode?symbol=BTC/USDT:USDT&exchangeId=binance" -H "$AUTH_HEADER"
# → {"data": {"hedged": false, "info": {"dualSidePosition": false}}, "success": true}
# Step 2: Close position with hedged value from step 1
# Use the actual position size from GET /positions when closing the full position
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}'
# → Position closed! Realized P&L: +$25.00
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"}'
# → Leverage updated! ETH/USDT:USDT: 20x
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
