Skip to content

MCP Tool Reference

Browse 19 tools at https://mcp.trade8.xyz/mcp. Start with Connect Your AI Agent or the Protocol Guide for authorization and transport details.

Download the Tool Catalog · Download the Read-Only Node.js Client

Public tools are trade8_list_markets, trade8_get_market, and trade8_list_exchanges. Anonymous tools/list returns these three definitions. The reference below also documents permissioned account and trading tools.

Each call uses tools/call with the tool name and arguments shown below. Account grants apply to every private call. Request and result values are illustrative; read current exchange specifications before building an order.

Results include text and structuredContent. The catalog’s output schemas accept the operation’s result or the shared error model. For lists, pass pagination.next_cursor as the next call’s cursor argument. See Requests and Retries for record ordering and time ranges.

Market Data

List Perpetual Markets

trade8_list_marketsRead OnlyPublic

List perpetual markets with their native exchange contracts. Filter by instrument, exchange, or settlement asset. No API key is required.

trade8_list_markets Arguments
FieldTypeDescription
instrumentstringNormalized perpetual family.
venuestringExchange identifier.
settlement_assetstringFilter contracts by settlement asset.
limitintegerPage size, default 10; maximum 200.
cursorstringOpaque next_cursor from the preceding response.
trade8_list_markets Request
{
  "jsonrpc": "2.0",
  "id": "call-trade8_list_markets",
  "method": "tools/call",
  "params": {
    "name": "trade8_list_markets",
    "arguments": {
      "instrument": "BTC-PERP",
      "limit": 10
    },
    "_meta": {
      "io.modelcontextprotocol/protocolVersion": "2026-07-28",
      "io.modelcontextprotocol/clientInfo": {
        "name": "trade8-research-agent",
        "version": "1.0.0"
      },
      "io.modelcontextprotocol/clientCapabilities": {}
    }
  }
}
Result Example and Fields
trade8_list_markets Result
{
  "jsonrpc": "2.0",
  "id": "call-trade8_list_markets",
  "result": {
    "resultType": "complete",
    "content": [
      {
        "type": "text",
        "text": "{\"markets\":[{\"instrument\":\"BTC-PERP\",\"contract_type\":\"perpetual\",\"base_asset\":\"BTC\",\"contracts\":[{\"venue\":\"apex\",\"venue_instrument\":\"BTC-USDT\",\"settlement_asset\":\"USDT\",\"payoff_type\":\"linear\",\"quantity_unit\":\"BTC\",\"price_unit\":\"USDT\",\"price_rule\":{\"type\":\"fixed_tick\",\"tick_size\":\"0.1\"},\"quantity_step\":\"0.001\",\"minimum_quantity\":\"0.0010\",\"maximum_quantity\":\"50\",\"max_leverage\":\"100\"},{\"venue\":\"aster\",\"venue_instrument\":\"BTCU\",\"settlement_asset\":\"U\",\"payoff_type\":\"linear\",\"quantity_unit\":\"BTC\",\"price_unit\":\"U\",\"price_rule\":{\"type\":\"fixed_tick\",\"tick_size\":\"0.10\"},\"quantity_step\":\"0.001\",\"minimum_quantity\":\"0.001\",\"maximum_quantity\":\"1000\",\"minimum_notional\":\"5\"},{\"venue\":\"aster\",\"venue_instrument\":\"BTCUSD1\",\"settlement_asset\":\"USD1\",\"payoff_type\":\"linear\",\"quantity_unit\":\"BTC\",\"price_unit\":\"USD1\",\"price_rule\":{\"type\":\"fixed_tick\",\"tick_size\":\"0.10\"},\"quantity_step\":\"0.001\",\"minimum_quantity\":\"0.001\",\"maximum_quantity\":\"1000\",\"minimum_notional\":\"5\"},{\"venue\":\"aster\",\"venue_instrument\":\"BTCUSDT\",\"settlement_asset\":\"USDT\",\"payoff_type\":\"linear\",\"quantity_unit\":\"BTC\",\"price_unit\":\"USDT\",\"price_rule\":{\"type\":\"fixed_tick\",\"tick_size\":\"0.1\"},\"quantity_step\":\"0.001\",\"minimum_quantity\":\"0.001\",\"maximum_quantity\":\"1000\",\"minimum_notional\":\"5\"},{\"venue\":\"binance\",\"venue_instrument\":\"BTCU\",\"settlement_asset\":\"U\",\"payoff_type\":\"linear\",\"quantity_unit\":\"BTC\",\"price_unit\":\"U\",\"price_rule\":{\"type\":\"fixed_tick\",\"tick_size\":\"0.10\"},\"quantity_step\":\"0.0001\",\"minimum_quantity\":\"0.0001\",\"maximum_quantity\":\"800\",\"minimum_notional\":\"5\"},{\"venue\":\"binance\",\"venue_instrument\":\"BTCUSD_PERP\",\"settlement_asset\":\"BTC\",\"payoff_type\":\"inverse\",\"quantity_unit\":\"contract\",\"price_unit\":\"USD\",\"price_rule\":{\"type\":\"fixed_tick\",\"tick_size\":\"0.1\"},\"quantity_step\":\"1\",\"minimum_quantity\":\"1\",\"maximum_quantity\":\"1000000\",\"contract_size\":\"100\",\"contract_size_unit\":\"USD\"},{\"venue\":\"binance\",\"venue_instrument\":\"BTCUSD1\",\"settlement_asset\":\"USD1\",\"payoff_type\":\"linear\",\"quantity_unit\":\"BTC\",\"price_unit\":\"USD1\",\"price_rule\":{\"type\":\"fixed_tick\",\"tick_size\":\"0.10\"},\"quantity_step\":\"0.0001\",\"minimum_quantity\":\"0.0001\",\"maximum_quantity\":\"800\",\"minimum_notional\":\"50\"},{\"venue\":\"binance\",\"venue_instrument\":\"BTCUSDC\",\"settlement_asset\":\"USDC\",\"payoff_type\":\"linear\",\"quantity_unit\":\"BTC\",\"price_unit\":\"USDC\",\"price_rule\":{\"type\":\"fixed_tick\",\"tick_size\":\"0.1\"},\"quantity_step\":\"0.001\",\"minimum_quantity\":\"0.001\",\"maximum_quantity\":\"800\",\"minimum_notional\":\"50\"},{\"venue\":\"binance\",\"venue_instrument\":\"BTCUSDT\",\"settlement_asset\":\"USDT\",\"payoff_type\":\"linear\",\"quantity_unit\":\"BTC\",\"price_unit\":\"USDT\",\"price_rule\":{\"type\":\"fixed_tick\",\"tick_size\":\"0.10\"},\"quantity_step\":\"0.001\",\"minimum_quantity\":\"0.001\",\"maximum_quantity\":\"1000\",\"minimum_notional\":\"50\"},{\"venue\":\"bitget\",\"venue_instrument\":\"BTCPERP\",\"settlement_asset\":\"USDC\",\"payoff_type\":\"linear\",\"quantity_unit\":\"BTC\",\"price_unit\":\"USDC\",\"price_rule\":{\"type\":\"fixed_tick\",\"tick_size\":\"0.1\"},\"quantity_step\":\"0.0001\",\"minimum_quantity\":\"0.0001\",\"maximum_quantity\":\"100\",\"minimum_notional\":\"5\",\"max_leverage\":\"125\"},{\"venue\":\"bitget\",\"venue_instrument\":\"BTCUSDT\",\"settlement_asset\":\"USDT\",\"payoff_type\":\"linear\",\"quantity_unit\":\"BTC\",\"price_unit\":\"USDT\",\"price_rule\":{\"type\":\"fixed_tick\",\"tick_size\":\"0.1\"},\"quantity_step\":\"0.0001\",\"minimum_quantity\":\"0.0001\",\"maximum_quantity\":\"1200\",\"minimum_notional\":\"5\",\"max_leverage\":\"150\"},{\"venue\":\"bybit\",\"venue_instrument\":\"BTCPERP\",\"settlement_asset\":\"USDC\",\"payoff_type\":\"linear\",\"quantity_unit\":\"BTC\",\"price_unit\":\"USDC\",\"price_rule\":{\"type\":\"fixed_tick\",\"tick_size\":\"0.10\"},\"quantity_step\":\"0.001\",\"minimum_quantity\":\"0.001\",\"maximum_quantity\":\"1000.000\",\"minimum_notional\":\"5\",\"max_leverage\":\"125.00\"},{\"venue\":\"bybit\",\"venue_instrument\":\"BTCUSD\",\"settlement_asset\":\"BTC\",\"payoff_type\":\"inverse\",\"quantity_unit\":\"USD\",\"price_unit\":\"USD\",\"price_rule\":{\"type\":\"fixed_tick\",\"tick_size\":\"0.10\"},\"quantity_step\":\"1\",\"minimum_quantity\":\"1\",\"maximum_quantity\":\"25000000\",\"minimum_notional\":\"5\",\"max_leverage\":\"100.00\"},{\"venue\":\"bybit\",\"venue_instrument\":\"BTCUSDT\",\"settlement_asset\":\"USDT\",\"payoff_type\":\"linear\",\"quantity_unit\":\"BTC\",\"price_unit\":\"USDT\",\"price_rule\":{\"type\":\"fixed_tick\",\"tick_size\":\"0.10\"},\"quantity_step\":\"0.001\",\"minimum_quantity\":\"0.001\",\"maximum_quantity\":\"1500.000\",\"minimum_notional\":\"5\",\"max_leverage\":\"150.00\"},{\"venue\":\"deribit\",\"venue_instrument\":\"BTC_USDC-PERPETUAL\",\"settlement_asset\":\"USDC\",\"payoff_type\":\"linear\",\"quantity_unit\":\"BTC\",\"price_unit\":\"USDC\",\"price_rule\":{\"type\":\"fixed_tick\",\"tick_size\":\"0.1\"},\"quantity_step\":\"0.0001\",\"minimum_quantity\":\"0.0001\",\"max_leverage\":\"50\"},{\"venue\":\"deribit\",\"venue_instrument\":\"BTC-PERPETUAL\",\"settlement_asset\":\"BTC\",\"payoff_type\":\"inverse\",\"quantity_unit\":\"USD\",\"price_unit\":\"USD\",\"price_rule\":{\"type\":\"fixed_tick\",\"tick_size\":\"0.5\"},\"quantity_step\":\"10\",\"minimum_quantity\":\"10\",\"max_leverage\":\"50\"},{\"venue\":\"dydx\",\"venue_instrument\":\"BTC-USD\",\"settlement_asset\":\"USDC\",\"payoff_type\":\"linear\",\"quantity_unit\":\"BTC\",\"price_unit\":\"USD\",\"price_rule\":{\"type\":\"fixed_tick\",\"tick_size\":\"1\"},\"quantity_step\":\"0.0001\"},{\"venue\":\"edgex\",\"venue_instrument\":\"BTCUSD\",\"settlement_asset\":\"USDT\",\"payoff_type\":\"linear\",\"quantity_unit\":\"BTC\",\"price_unit\":\"USD\",\"price_rule\":{\"type\":\"fixed_tick\",\"tick_size\":\"0.1\"},\"quantity_step\":\"0.001\",\"minimum_quantity\":\"0.003\",\"maximum_quantity\":\"22\",\"max_leverage\":\"100\"},{\"venue\":\"extended\",\"venue_instrument\":\"BTC-USD\",\"settlement_asset\":\"USDC\",\"payoff_type\":\"linear\",\"quantity_unit\":\"BTC\",\"price_unit\":\"USD\",\"price_rule\":{\"type\":\"fixed_tick\",\"tick_size\":\"1\"},\"quantity_step\":\"0.00001\",\"minimum_quantity\":\"0.0001\",\"max_leverage\":\"50.00\"},{\"venue\":\"gate\",\"venue_instrument\":\"BTC_USD\",\"settlement_asset\":\"BTC\",\"payoff_type\":\"inverse\",\"quantity_unit\":\"contract\",\"price_unit\":\"USD\",\"price_rule\":{\"type\":\"fixed_tick\",\"tick_size\":\"0.1\"},\"quantity_step\":\"1\",\"minimum_quantity\":\"1\",\"maximum_quantity\":\"530000\",\"max_leverage\":\"100\"},{\"venue\":\"gate\",\"venue_instrument\":\"BTC_USDT\",\"settlement_asset\":\"USDT\",\"payoff_type\":\"linear\",\"quantity_unit\":\"contract\",\"price_unit\":\"USDT\",\"contract_size\":\"0.0001\",\"contract_size_unit\":\"BTC\",\"price_rule\":{\"type\":\"fixed_tick\",\"tick_size\":\"0.1\"},\"quantity_step\":\"1\",\"minimum_quantity\":\"1\",\"maximum_quantity\":\"12000000\",\"max_leverage\":\"200\"},{\"venue\":\"gmx\",\"venue_instrument\":\"0x3ce7BCDB37Bf587d1C17B930Fa0A7000A0648D12\",\"network\":\"avalanche\",\"settlement_assets\":[\"BTC\"],\"quantity_unit\":\"USD\",\"price_unit\":\"USD\"},{\"venue\":\"gmx\",\"venue_instrument\":\"0x47c031236e19d024b42f8AE6780E44A573170703\",\"network\":\"arbitrum\",\"settlement_assets\":[\"WBTC.b\",\"USDC\"],\"quantity_unit\":\"USD\",\"price_unit\":\"USD\"},{\"venue\":\"gmx\",\"venue_instrument\":\"0x7C11F78Ce78768518D743E81Fdfa2F860C6b9A77\",\"network\":\"arbitrum\",\"settlement_assets\":[\"WBTC.b\"],\"quantity_unit\":\"USD\",\"price_unit\":\"USD\"},{\"venue\":\"gmx\",\"venue_instrument\":\"0xd62068697bCc92AF253225676D618B0C9f17C663\",\"network\":\"arbitrum\",\"settlement_assets\":[\"tBTC\"],\"quantity_unit\":\"USD\",\"price_unit\":\"USD\"},{\"venue\":\"gmx\",\"venue_instrument\":\"0xFb02132333A79C8B5Bd0b64E3AbccA5f7fAf2937\",\"network\":\"avalanche\",\"settlement_assets\":[\"BTC\",\"USDC\"],\"quantity_unit\":\"USD\",\"price_unit\":\"USD\"},{\"venue\":\"grvt\",\"venue_instrument\":\"BTC_USDT_Perp\",\"settlement_asset\":\"USDT\",\"payoff_type\":\"linear\",\"quantity_unit\":\"BTC\",\"price_unit\":\"USDT\",\"price_rule\":{\"type\":\"fixed_tick\",\"tick_size\":\"0.1\"},\"minimum_quantity\":\"0.001\",\"minimum_notional\":\"100.0\"},{\"venue\":\"hyperliquid\",\"venue_instrument\":\"BTC\",\"settlement_asset\":\"USDC\",\"payoff_type\":\"linear\",\"quantity_unit\":\"BTC\",\"price_unit\":\"USD\",\"price_rule\":{\"type\":\"significant_figures\",\"max_significant_figures\":5,\"max_decimal_places\":1,\"integer_prices_allowed\":true},\"quantity_step\":\"0.00001\",\"max_leverage\":\"40\"},{\"venue\":\"kraken\",\"venue_instrument\":\"PF_XBTUSD\",\"settlement_asset\":\"USD\",\"payoff_type\":\"linear\",\"quantity_unit\":\"BTC\",\"price_unit\":\"USD\",\"price_rule\":{\"type\":\"fixed_tick\",\"tick_size\":\"1\"},\"quantity_step\":\"0.0001\"},{\"venue\":\"kucoin\",\"venue_instrument\":\"XBTUSDCM\",\"settlement_asset\":\"USDC\",\"payoff_type\":\"linear\",\"quantity_unit\":\"contract\",\"price_unit\":\"USDC\",\"contract_size\":\"0.0001\",\"contract_size_unit\":\"BTC\",\"price_rule\":{\"type\":\"fixed_tick\",\"tick_size\":\"0.1\"},\"quantity_step\":\"1\",\"maximum_quantity\":\"1000000\"},{\"venue\":\"kucoin\",\"venue_instrument\":\"XBTUSDM\",\"settlement_asset\":\"BTC\",\"payoff_type\":\"inverse\",\"quantity_unit\":\"contract\",\"price_unit\":\"USD\",\"contract_size\":\"1\",\"contract_size_unit\":\"USD\",\"price_rule\":{\"type\":\"fixed_tick\",\"tick_size\":\"0.1\"},\"quantity_step\":\"1\",\"maximum_quantity\":\"1000000\"},{\"venue\":\"kucoin\",\"venue_instrument\":\"XBTUSDTM\",\"settlement_asset\":\"USDT\",\"payoff_type\":\"linear\",\"quantity_unit\":\"contract\",\"price_unit\":\"USDT\",\"contract_size\":\"0.001\",\"contract_size_unit\":\"BTC\",\"price_rule\":{\"type\":\"fixed_tick\",\"tick_size\":\"0.1\"},\"quantity_step\":\"1\",\"maximum_quantity\":\"1000000\"},{\"venue\":\"lighter\",\"venue_instrument\":\"BTC\",\"settlement_asset\":\"USDC\",\"payoff_type\":\"linear\",\"quantity_unit\":\"BTC\",\"price_unit\":\"USD\",\"price_rule\":{\"type\":\"fixed_tick\",\"tick_size\":\"0.1\"},\"quantity_step\":\"0.00001\",\"minimum_quantity\":\"0.00010\",\"minimum_notional\":\"10.000000\"},{\"venue\":\"mexc\",\"venue_instrument\":\"BTC_USD\",\"settlement_asset\":\"BTC\",\"quantity_unit\":\"contract\",\"price_unit\":\"USD\",\"contract_size\":\"100\",\"contract_size_unit\":\"BTC\",\"price_rule\":{\"type\":\"fixed_tick\",\"tick_size\":\"0.1\"},\"quantity_step\":\"1\",\"minimum_quantity\":\"1\",\"maximum_quantity\":\"2800\",\"max_leverage\":\"125\"},{\"venue\":\"mexc\",\"venue_instrument\":\"BTC_USD1\",\"settlement_asset\":\"USD1\",\"quantity_unit\":\"contract\",\"price_unit\":\"USD1\",\"contract_size\":\"0.0001\",\"contract_size_unit\":\"BTC\",\"price_rule\":{\"type\":\"fixed_tick\",\"tick_size\":\"0.1\"},\"quantity_step\":\"1\",\"minimum_quantity\":\"1\",\"maximum_quantity\":\"350000\",\"max_leverage\":\"100\"},{\"venue\":\"mexc\",\"venue_instrument\":\"BTC_USDC\",\"settlement_asset\":\"USDC\",\"quantity_unit\":\"contract\",\"price_unit\":\"USDC\",\"contract_size\":\"0.0001\",\"contract_size_unit\":\"BTC\",\"price_rule\":{\"type\":\"fixed_tick\",\"tick_size\":\"0.1\"},\"quantity_step\":\"1\",\"minimum_quantity\":\"1\",\"maximum_quantity\":\"1500000\",\"max_leverage\":\"200\"},{\"venue\":\"mexc\",\"venue_instrument\":\"BTC_USDT\",\"settlement_asset\":\"USDT\",\"quantity_unit\":\"contract\",\"price_unit\":\"USDT\",\"contract_size\":\"0.0001\",\"contract_size_unit\":\"BTC\",\"price_rule\":{\"type\":\"fixed_tick\",\"tick_size\":\"0.1\"},\"quantity_step\":\"1\",\"minimum_quantity\":\"1\",\"maximum_quantity\":\"2500000\",\"max_leverage\":\"500\"},{\"venue\":\"okx\",\"venue_instrument\":\"BTC-USD-SWAP\",\"settlement_asset\":\"BTC\",\"payoff_type\":\"inverse\",\"quantity_unit\":\"contract\",\"price_unit\":\"USD\",\"contract_size\":\"100\",\"contract_size_unit\":\"USD\",\"price_rule\":{\"type\":\"fixed_tick\",\"tick_size\":\"0.1\"},\"quantity_step\":\"0.1\",\"minimum_quantity\":\"0.1\",\"maximum_quantity\":\"100000000\",\"max_leverage\":\"100\"},{\"venue\":\"okx\",\"venue_instrument\":\"BTC-USDT-SWAP\",\"settlement_asset\":\"USDT\",\"payoff_type\":\"linear\",\"quantity_unit\":\"contract\",\"price_unit\":\"USDT\",\"contract_size\":\"0.01\",\"contract_size_unit\":\"BTC\",\"price_rule\":{\"type\":\"fixed_tick\",\"tick_size\":\"0.1\"},\"quantity_step\":\"0.01\",\"minimum_quantity\":\"0.01\",\"maximum_quantity\":\"100000000\",\"max_leverage\":\"100\"},{\"venue\":\"paradex\",\"venue_instrument\":\"BTC-USD-PERP\",\"settlement_asset\":\"USDC\",\"payoff_type\":\"linear\",\"quantity_unit\":\"BTC\",\"price_unit\":\"USD\",\"price_rule\":{\"type\":\"fixed_tick\",\"tick_size\":\"0.1\"},\"quantity_step\":\"0.00001\",\"maximum_quantity\":\"100\",\"minimum_notional\":\"10\"}]}],\"pagination\":{\"next_cursor\":null,\"has_more\":false}}"
      }
    ],
    "structuredContent": {
      "markets": [
        {
          "instrument": "BTC-PERP",
          "contract_type": "perpetual",
          "base_asset": "BTC",
          "contracts": [
            {
              "venue": "apex",
              "venue_instrument": "BTC-USDT",
              "settlement_asset": "USDT",
              "payoff_type": "linear",
              "quantity_unit": "BTC",
              "price_unit": "USDT",
              "price_rule": {
                "type": "fixed_tick",
                "tick_size": "0.1"
              },
              "quantity_step": "0.001",
              "minimum_quantity": "0.0010",
              "maximum_quantity": "50",
              "max_leverage": "100"
            },
            {
              "venue": "aster",
              "venue_instrument": "BTCU",
              "settlement_asset": "U",
              "payoff_type": "linear",
              "quantity_unit": "BTC",
              "price_unit": "U",
              "price_rule": {
                "type": "fixed_tick",
                "tick_size": "0.10"
              },
              "quantity_step": "0.001",
              "minimum_quantity": "0.001",
              "maximum_quantity": "1000",
              "minimum_notional": "5"
            },
            {
              "venue": "aster",
              "venue_instrument": "BTCUSD1",
              "settlement_asset": "USD1",
              "payoff_type": "linear",
              "quantity_unit": "BTC",
              "price_unit": "USD1",
              "price_rule": {
                "type": "fixed_tick",
                "tick_size": "0.10"
              },
              "quantity_step": "0.001",
              "minimum_quantity": "0.001",
              "maximum_quantity": "1000",
              "minimum_notional": "5"
            },
            {
              "venue": "aster",
              "venue_instrument": "BTCUSDT",
              "settlement_asset": "USDT",
              "payoff_type": "linear",
              "quantity_unit": "BTC",
              "price_unit": "USDT",
              "price_rule": {
                "type": "fixed_tick",
                "tick_size": "0.1"
              },
              "quantity_step": "0.001",
              "minimum_quantity": "0.001",
              "maximum_quantity": "1000",
              "minimum_notional": "5"
            },
            {
              "venue": "binance",
              "venue_instrument": "BTCU",
              "settlement_asset": "U",
              "payoff_type": "linear",
              "quantity_unit": "BTC",
              "price_unit": "U",
              "price_rule": {
                "type": "fixed_tick",
                "tick_size": "0.10"
              },
              "quantity_step": "0.0001",
              "minimum_quantity": "0.0001",
              "maximum_quantity": "800",
              "minimum_notional": "5"
            },
            {
              "venue": "binance",
              "venue_instrument": "BTCUSD_PERP",
              "settlement_asset": "BTC",
              "payoff_type": "inverse",
              "quantity_unit": "contract",
              "price_unit": "USD",
              "price_rule": {
                "type": "fixed_tick",
                "tick_size": "0.1"
              },
              "quantity_step": "1",
              "minimum_quantity": "1",
              "maximum_quantity": "1000000",
              "contract_size": "100",
              "contract_size_unit": "USD"
            },
            {
              "venue": "binance",
              "venue_instrument": "BTCUSD1",
              "settlement_asset": "USD1",
              "payoff_type": "linear",
              "quantity_unit": "BTC",
              "price_unit": "USD1",
              "price_rule": {
                "type": "fixed_tick",
                "tick_size": "0.10"
              },
              "quantity_step": "0.0001",
              "minimum_quantity": "0.0001",
              "maximum_quantity": "800",
              "minimum_notional": "50"
            },
            {
              "venue": "binance",
              "venue_instrument": "BTCUSDC",
              "settlement_asset": "USDC",
              "payoff_type": "linear",
              "quantity_unit": "BTC",
              "price_unit": "USDC",
              "price_rule": {
                "type": "fixed_tick",
                "tick_size": "0.1"
              },
              "quantity_step": "0.001",
              "minimum_quantity": "0.001",
              "maximum_quantity": "800",
              "minimum_notional": "50"
            },
            {
              "venue": "binance",
              "venue_instrument": "BTCUSDT",
              "settlement_asset": "USDT",
              "payoff_type": "linear",
              "quantity_unit": "BTC",
              "price_unit": "USDT",
              "price_rule": {
                "type": "fixed_tick",
                "tick_size": "0.10"
              },
              "quantity_step": "0.001",
              "minimum_quantity": "0.001",
              "maximum_quantity": "1000",
              "minimum_notional": "50"
            },
            {
              "venue": "bitget",
              "venue_instrument": "BTCPERP",
              "settlement_asset": "USDC",
              "payoff_type": "linear",
              "quantity_unit": "BTC",
              "price_unit": "USDC",
              "price_rule": {
                "type": "fixed_tick",
                "tick_size": "0.1"
              },
              "quantity_step": "0.0001",
              "minimum_quantity": "0.0001",
              "maximum_quantity": "100",
              "minimum_notional": "5",
              "max_leverage": "125"
            },
            {
              "venue": "bitget",
              "venue_instrument": "BTCUSDT",
              "settlement_asset": "USDT",
              "payoff_type": "linear",
              "quantity_unit": "BTC",
              "price_unit": "USDT",
              "price_rule": {
                "type": "fixed_tick",
                "tick_size": "0.1"
              },
              "quantity_step": "0.0001",
              "minimum_quantity": "0.0001",
              "maximum_quantity": "1200",
              "minimum_notional": "5",
              "max_leverage": "150"
            },
            {
              "venue": "bybit",
              "venue_instrument": "BTCPERP",
              "settlement_asset": "USDC",
              "payoff_type": "linear",
              "quantity_unit": "BTC",
              "price_unit": "USDC",
              "price_rule": {
                "type": "fixed_tick",
                "tick_size": "0.10"
              },
              "quantity_step": "0.001",
              "minimum_quantity": "0.001",
              "maximum_quantity": "1000.000",
              "minimum_notional": "5",
              "max_leverage": "125.00"
            },
            {
              "venue": "bybit",
              "venue_instrument": "BTCUSD",
              "settlement_asset": "BTC",
              "payoff_type": "inverse",
              "quantity_unit": "USD",
              "price_unit": "USD",
              "price_rule": {
                "type": "fixed_tick",
                "tick_size": "0.10"
              },
              "quantity_step": "1",
              "minimum_quantity": "1",
              "maximum_quantity": "25000000",
              "minimum_notional": "5",
              "max_leverage": "100.00"
            },
            {
              "venue": "bybit",
              "venue_instrument": "BTCUSDT",
              "settlement_asset": "USDT",
              "payoff_type": "linear",
              "quantity_unit": "BTC",
              "price_unit": "USDT",
              "price_rule": {
                "type": "fixed_tick",
                "tick_size": "0.10"
              },
              "quantity_step": "0.001",
              "minimum_quantity": "0.001",
              "maximum_quantity": "1500.000",
              "minimum_notional": "5",
              "max_leverage": "150.00"
            },
            {
              "venue": "deribit",
              "venue_instrument": "BTC_USDC-PERPETUAL",
              "settlement_asset": "USDC",
              "payoff_type": "linear",
              "quantity_unit": "BTC",
              "price_unit": "USDC",
              "price_rule": {
                "type": "fixed_tick",
                "tick_size": "0.1"
              },
              "quantity_step": "0.0001",
              "minimum_quantity": "0.0001",
              "max_leverage": "50"
            },
            {
              "venue": "deribit",
              "venue_instrument": "BTC-PERPETUAL",
              "settlement_asset": "BTC",
              "payoff_type": "inverse",
              "quantity_unit": "USD",
              "price_unit": "USD",
              "price_rule": {
                "type": "fixed_tick",
                "tick_size": "0.5"
              },
              "quantity_step": "10",
              "minimum_quantity": "10",
              "max_leverage": "50"
            },
            {
              "venue": "dydx",
              "venue_instrument": "BTC-USD",
              "settlement_asset": "USDC",
              "payoff_type": "linear",
              "quantity_unit": "BTC",
              "price_unit": "USD",
              "price_rule": {
                "type": "fixed_tick",
                "tick_size": "1"
              },
              "quantity_step": "0.0001"
            },
            {
              "venue": "edgex",
              "venue_instrument": "BTCUSD",
              "settlement_asset": "USDT",
              "payoff_type": "linear",
              "quantity_unit": "BTC",
              "price_unit": "USD",
              "price_rule": {
                "type": "fixed_tick",
                "tick_size": "0.1"
              },
              "quantity_step": "0.001",
              "minimum_quantity": "0.003",
              "maximum_quantity": "22",
              "max_leverage": "100"
            },
            {
              "venue": "extended",
              "venue_instrument": "BTC-USD",
              "settlement_asset": "USDC",
              "payoff_type": "linear",
              "quantity_unit": "BTC",
              "price_unit": "USD",
              "price_rule": {
                "type": "fixed_tick",
                "tick_size": "1"
              },
              "quantity_step": "0.00001",
              "minimum_quantity": "0.0001",
              "max_leverage": "50.00"
            },
            {
              "venue": "gate",
              "venue_instrument": "BTC_USD",
              "settlement_asset": "BTC",
              "payoff_type": "inverse",
              "quantity_unit": "contract",
              "price_unit": "USD",
              "price_rule": {
                "type": "fixed_tick",
                "tick_size": "0.1"
              },
              "quantity_step": "1",
              "minimum_quantity": "1",
              "maximum_quantity": "530000",
              "max_leverage": "100"
            },
            {
              "venue": "gate",
              "venue_instrument": "BTC_USDT",
              "settlement_asset": "USDT",
              "payoff_type": "linear",
              "quantity_unit": "contract",
              "price_unit": "USDT",
              "contract_size": "0.0001",
              "contract_size_unit": "BTC",
              "price_rule": {
                "type": "fixed_tick",
                "tick_size": "0.1"
              },
              "quantity_step": "1",
              "minimum_quantity": "1",
              "maximum_quantity": "12000000",
              "max_leverage": "200"
            },
            {
              "venue": "gmx",
              "venue_instrument": "0x3ce7BCDB37Bf587d1C17B930Fa0A7000A0648D12",
              "network": "avalanche",
              "settlement_assets": [
                "BTC"
              ],
              "quantity_unit": "USD",
              "price_unit": "USD"
            },
            {
              "venue": "gmx",
              "venue_instrument": "0x47c031236e19d024b42f8AE6780E44A573170703",
              "network": "arbitrum",
              "settlement_assets": [
                "WBTC.b",
                "USDC"
              ],
              "quantity_unit": "USD",
              "price_unit": "USD"
            },
            {
              "venue": "gmx",
              "venue_instrument": "0x7C11F78Ce78768518D743E81Fdfa2F860C6b9A77",
              "network": "arbitrum",
              "settlement_assets": [
                "WBTC.b"
              ],
              "quantity_unit": "USD",
              "price_unit": "USD"
            },
            {
              "venue": "gmx",
              "venue_instrument": "0xd62068697bCc92AF253225676D618B0C9f17C663",
              "network": "arbitrum",
              "settlement_assets": [
                "tBTC"
              ],
              "quantity_unit": "USD",
              "price_unit": "USD"
            },
            {
              "venue": "gmx",
              "venue_instrument": "0xFb02132333A79C8B5Bd0b64E3AbccA5f7fAf2937",
              "network": "avalanche",
              "settlement_assets": [
                "BTC",
                "USDC"
              ],
              "quantity_unit": "USD",
              "price_unit": "USD"
            },
            {
              "venue": "grvt",
              "venue_instrument": "BTC_USDT_Perp",
              "settlement_asset": "USDT",
              "payoff_type": "linear",
              "quantity_unit": "BTC",
              "price_unit": "USDT",
              "price_rule": {
                "type": "fixed_tick",
                "tick_size": "0.1"
              },
              "minimum_quantity": "0.001",
              "minimum_notional": "100.0"
            },
            {
              "venue": "hyperliquid",
              "venue_instrument": "BTC",
              "settlement_asset": "USDC",
              "payoff_type": "linear",
              "quantity_unit": "BTC",
              "price_unit": "USD",
              "price_rule": {
                "type": "significant_figures",
                "max_significant_figures": 5,
                "max_decimal_places": 1,
                "integer_prices_allowed": true
              },
              "quantity_step": "0.00001",
              "max_leverage": "40"
            },
            {
              "venue": "kraken",
              "venue_instrument": "PF_XBTUSD",
              "settlement_asset": "USD",
              "payoff_type": "linear",
              "quantity_unit": "BTC",
              "price_unit": "USD",
              "price_rule": {
                "type": "fixed_tick",
                "tick_size": "1"
              },
              "quantity_step": "0.0001"
            },
            {
              "venue": "kucoin",
              "venue_instrument": "XBTUSDCM",
              "settlement_asset": "USDC",
              "payoff_type": "linear",
              "quantity_unit": "contract",
              "price_unit": "USDC",
              "contract_size": "0.0001",
              "contract_size_unit": "BTC",
              "price_rule": {
                "type": "fixed_tick",
                "tick_size": "0.1"
              },
              "quantity_step": "1",
              "maximum_quantity": "1000000"
            },
            {
              "venue": "kucoin",
              "venue_instrument": "XBTUSDM",
              "settlement_asset": "BTC",
              "payoff_type": "inverse",
              "quantity_unit": "contract",
              "price_unit": "USD",
              "contract_size": "1",
              "contract_size_unit": "USD",
              "price_rule": {
                "type": "fixed_tick",
                "tick_size": "0.1"
              },
              "quantity_step": "1",
              "maximum_quantity": "1000000"
            },
            {
              "venue": "kucoin",
              "venue_instrument": "XBTUSDTM",
              "settlement_asset": "USDT",
              "payoff_type": "linear",
              "quantity_unit": "contract",
              "price_unit": "USDT",
              "contract_size": "0.001",
              "contract_size_unit": "BTC",
              "price_rule": {
                "type": "fixed_tick",
                "tick_size": "0.1"
              },
              "quantity_step": "1",
              "maximum_quantity": "1000000"
            },
            {
              "venue": "lighter",
              "venue_instrument": "BTC",
              "settlement_asset": "USDC",
              "payoff_type": "linear",
              "quantity_unit": "BTC",
              "price_unit": "USD",
              "price_rule": {
                "type": "fixed_tick",
                "tick_size": "0.1"
              },
              "quantity_step": "0.00001",
              "minimum_quantity": "0.00010",
              "minimum_notional": "10.000000"
            },
            {
              "venue": "mexc",
              "venue_instrument": "BTC_USD",
              "settlement_asset": "BTC",
              "quantity_unit": "contract",
              "price_unit": "USD",
              "contract_size": "100",
              "contract_size_unit": "BTC",
              "price_rule": {
                "type": "fixed_tick",
                "tick_size": "0.1"
              },
              "quantity_step": "1",
              "minimum_quantity": "1",
              "maximum_quantity": "2800",
              "max_leverage": "125"
            },
            {
              "venue": "mexc",
              "venue_instrument": "BTC_USD1",
              "settlement_asset": "USD1",
              "quantity_unit": "contract",
              "price_unit": "USD1",
              "contract_size": "0.0001",
              "contract_size_unit": "BTC",
              "price_rule": {
                "type": "fixed_tick",
                "tick_size": "0.1"
              },
              "quantity_step": "1",
              "minimum_quantity": "1",
              "maximum_quantity": "350000",
              "max_leverage": "100"
            },
            {
              "venue": "mexc",
              "venue_instrument": "BTC_USDC",
              "settlement_asset": "USDC",
              "quantity_unit": "contract",
              "price_unit": "USDC",
              "contract_size": "0.0001",
              "contract_size_unit": "BTC",
              "price_rule": {
                "type": "fixed_tick",
                "tick_size": "0.1"
              },
              "quantity_step": "1",
              "minimum_quantity": "1",
              "maximum_quantity": "1500000",
              "max_leverage": "200"
            },
            {
              "venue": "mexc",
              "venue_instrument": "BTC_USDT",
              "settlement_asset": "USDT",
              "quantity_unit": "contract",
              "price_unit": "USDT",
              "contract_size": "0.0001",
              "contract_size_unit": "BTC",
              "price_rule": {
                "type": "fixed_tick",
                "tick_size": "0.1"
              },
              "quantity_step": "1",
              "minimum_quantity": "1",
              "maximum_quantity": "2500000",
              "max_leverage": "500"
            },
            {
              "venue": "okx",
              "venue_instrument": "BTC-USD-SWAP",
              "settlement_asset": "BTC",
              "payoff_type": "inverse",
              "quantity_unit": "contract",
              "price_unit": "USD",
              "contract_size": "100",
              "contract_size_unit": "USD",
              "price_rule": {
                "type": "fixed_tick",
                "tick_size": "0.1"
              },
              "quantity_step": "0.1",
              "minimum_quantity": "0.1",
              "maximum_quantity": "100000000",
              "max_leverage": "100"
            },
            {
              "venue": "okx",
              "venue_instrument": "BTC-USDT-SWAP",
              "settlement_asset": "USDT",
              "payoff_type": "linear",
              "quantity_unit": "contract",
              "price_unit": "USDT",
              "contract_size": "0.01",
              "contract_size_unit": "BTC",
              "price_rule": {
                "type": "fixed_tick",
                "tick_size": "0.1"
              },
              "quantity_step": "0.01",
              "minimum_quantity": "0.01",
              "maximum_quantity": "100000000",
              "max_leverage": "100"
            },
            {
              "venue": "paradex",
              "venue_instrument": "BTC-USD-PERP",
              "settlement_asset": "USDC",
              "payoff_type": "linear",
              "quantity_unit": "BTC",
              "price_unit": "USD",
              "price_rule": {
                "type": "fixed_tick",
                "tick_size": "0.1"
              },
              "quantity_step": "0.00001",
              "maximum_quantity": "100",
              "minimum_notional": "10"
            }
          ]
        }
      ],
      "pagination": {
        "next_cursor": null,
        "has_more": false
      }
    },
    "isError": false
  }
}
trade8_list_markets Result Fields
FieldTypeDescription
marketsRequiredarrayInstruments on this page.
markets[].instrumentRequiredstringNormalized perpetual family, for example BTC-PERP. Select a settlement asset and exchange to identify a contract.
markets[].contract_typeRequiredstringPerpetual futures instrument family; payoff details belong to each exchange contract. Values: perpetual.
markets[].base_assetRequiredstringAsset symbol, such as BTC, USDT, or USDC.
markets[].contractsRequiredarrayNative contract mappings, grouped under one perpetual instrument.
markets[].contracts[].venueRequiredstringExchange identifier from GET /v1/venues, such as binance, okx, bybit, hyperliquid, or dydx.
markets[].contracts[].venue_instrumentRequiredstringNative exchange symbol, such as BTCUSDT or BTC.
markets[].contracts[].settlement_assetstringAsset symbol, such as BTC, USDT, or USDC.
markets[].contracts[].settlement_assetsarraySettlement tokens for a pool with side-dependent collateral.
markets[].contracts[].networkstringBlockchain network for an onchain pool.
markets[].contracts[].payoff_typestringContract payoff where specified by the exchange. Values: linear, inverse.
markets[].contracts[].contract_sizestringValue represented by one native contract.
markets[].contracts[].contract_size_unitstringUnit of contract_size; multiply native contract quantity by contract_size to express face value.
markets[].contracts[].quantity_unitRequiredstringNative size unit: base asset, USD, or contract. Read contract_size for lot-based contracts.
markets[].contracts[].price_unitRequiredstringPrice quote unit.
markets[].contracts[].price_rulevalueFixed increment or significant-figure pricing rule.
markets[].contracts[].quantity_stepstringSize increment in quantity_unit.
markets[].contracts[].minimum_quantitystringExchange LOT_SIZE minimum for limit orders.
markets[].contracts[].maximum_quantitystringExchange LOT_SIZE maximum for limit orders; market-order limits may differ.
markets[].contracts[].minimum_notionalstringMinimum order value in price_unit.
markets[].contracts[].max_leveragestringPublished exchange ceiling at snapshot time; account risk tiers can lower it.
paginationRequiredobject
pagination.next_cursorRequiredstring | nullOpaque cursor for the next page; null at the end.
pagination.has_moreRequiredbooleanTrue when another page is available.
Related REST Operation →

Read Contract Specifications

trade8_get_marketRead OnlyPublic

Read an instrument’s exchange symbols, settlement assets, price rules, and quantity increments. Public access; unknown instruments return HTTP 404.

trade8_get_market Arguments
FieldTypeDescription
instrumentRequiredstringIdentifier of the resource to read or change.
trade8_get_market Request
{
  "jsonrpc": "2.0",
  "id": "call-trade8_get_market",
  "method": "tools/call",
  "params": {
    "name": "trade8_get_market",
    "arguments": {
      "instrument": "BTC-PERP"
    },
    "_meta": {
      "io.modelcontextprotocol/protocolVersion": "2026-07-28",
      "io.modelcontextprotocol/clientInfo": {
        "name": "trade8-research-agent",
        "version": "1.0.0"
      },
      "io.modelcontextprotocol/clientCapabilities": {}
    }
  }
}
Result Example and Fields
trade8_get_market Result
{
  "jsonrpc": "2.0",
  "id": "call-trade8_get_market",
  "result": {
    "resultType": "complete",
    "content": [
      {
        "type": "text",
        "text": "{\"instrument\":\"BTC-PERP\",\"contract_type\":\"perpetual\",\"base_asset\":\"BTC\",\"contracts\":[{\"venue\":\"apex\",\"venue_instrument\":\"BTC-USDT\",\"settlement_asset\":\"USDT\",\"payoff_type\":\"linear\",\"quantity_unit\":\"BTC\",\"price_unit\":\"USDT\",\"price_rule\":{\"type\":\"fixed_tick\",\"tick_size\":\"0.1\"},\"quantity_step\":\"0.001\",\"minimum_quantity\":\"0.0010\",\"maximum_quantity\":\"50\",\"max_leverage\":\"100\"},{\"venue\":\"aster\",\"venue_instrument\":\"BTCU\",\"settlement_asset\":\"U\",\"payoff_type\":\"linear\",\"quantity_unit\":\"BTC\",\"price_unit\":\"U\",\"price_rule\":{\"type\":\"fixed_tick\",\"tick_size\":\"0.10\"},\"quantity_step\":\"0.001\",\"minimum_quantity\":\"0.001\",\"maximum_quantity\":\"1000\",\"minimum_notional\":\"5\"},{\"venue\":\"aster\",\"venue_instrument\":\"BTCUSD1\",\"settlement_asset\":\"USD1\",\"payoff_type\":\"linear\",\"quantity_unit\":\"BTC\",\"price_unit\":\"USD1\",\"price_rule\":{\"type\":\"fixed_tick\",\"tick_size\":\"0.10\"},\"quantity_step\":\"0.001\",\"minimum_quantity\":\"0.001\",\"maximum_quantity\":\"1000\",\"minimum_notional\":\"5\"},{\"venue\":\"aster\",\"venue_instrument\":\"BTCUSDT\",\"settlement_asset\":\"USDT\",\"payoff_type\":\"linear\",\"quantity_unit\":\"BTC\",\"price_unit\":\"USDT\",\"price_rule\":{\"type\":\"fixed_tick\",\"tick_size\":\"0.1\"},\"quantity_step\":\"0.001\",\"minimum_quantity\":\"0.001\",\"maximum_quantity\":\"1000\",\"minimum_notional\":\"5\"},{\"venue\":\"binance\",\"venue_instrument\":\"BTCU\",\"settlement_asset\":\"U\",\"payoff_type\":\"linear\",\"quantity_unit\":\"BTC\",\"price_unit\":\"U\",\"price_rule\":{\"type\":\"fixed_tick\",\"tick_size\":\"0.10\"},\"quantity_step\":\"0.0001\",\"minimum_quantity\":\"0.0001\",\"maximum_quantity\":\"800\",\"minimum_notional\":\"5\"},{\"venue\":\"binance\",\"venue_instrument\":\"BTCUSD_PERP\",\"settlement_asset\":\"BTC\",\"payoff_type\":\"inverse\",\"quantity_unit\":\"contract\",\"price_unit\":\"USD\",\"price_rule\":{\"type\":\"fixed_tick\",\"tick_size\":\"0.1\"},\"quantity_step\":\"1\",\"minimum_quantity\":\"1\",\"maximum_quantity\":\"1000000\",\"contract_size\":\"100\",\"contract_size_unit\":\"USD\"},{\"venue\":\"binance\",\"venue_instrument\":\"BTCUSD1\",\"settlement_asset\":\"USD1\",\"payoff_type\":\"linear\",\"quantity_unit\":\"BTC\",\"price_unit\":\"USD1\",\"price_rule\":{\"type\":\"fixed_tick\",\"tick_size\":\"0.10\"},\"quantity_step\":\"0.0001\",\"minimum_quantity\":\"0.0001\",\"maximum_quantity\":\"800\",\"minimum_notional\":\"50\"},{\"venue\":\"binance\",\"venue_instrument\":\"BTCUSDC\",\"settlement_asset\":\"USDC\",\"payoff_type\":\"linear\",\"quantity_unit\":\"BTC\",\"price_unit\":\"USDC\",\"price_rule\":{\"type\":\"fixed_tick\",\"tick_size\":\"0.1\"},\"quantity_step\":\"0.001\",\"minimum_quantity\":\"0.001\",\"maximum_quantity\":\"800\",\"minimum_notional\":\"50\"},{\"venue\":\"binance\",\"venue_instrument\":\"BTCUSDT\",\"settlement_asset\":\"USDT\",\"payoff_type\":\"linear\",\"quantity_unit\":\"BTC\",\"price_unit\":\"USDT\",\"price_rule\":{\"type\":\"fixed_tick\",\"tick_size\":\"0.10\"},\"quantity_step\":\"0.001\",\"minimum_quantity\":\"0.001\",\"maximum_quantity\":\"1000\",\"minimum_notional\":\"50\"},{\"venue\":\"bitget\",\"venue_instrument\":\"BTCPERP\",\"settlement_asset\":\"USDC\",\"payoff_type\":\"linear\",\"quantity_unit\":\"BTC\",\"price_unit\":\"USDC\",\"price_rule\":{\"type\":\"fixed_tick\",\"tick_size\":\"0.1\"},\"quantity_step\":\"0.0001\",\"minimum_quantity\":\"0.0001\",\"maximum_quantity\":\"100\",\"minimum_notional\":\"5\",\"max_leverage\":\"125\"},{\"venue\":\"bitget\",\"venue_instrument\":\"BTCUSDT\",\"settlement_asset\":\"USDT\",\"payoff_type\":\"linear\",\"quantity_unit\":\"BTC\",\"price_unit\":\"USDT\",\"price_rule\":{\"type\":\"fixed_tick\",\"tick_size\":\"0.1\"},\"quantity_step\":\"0.0001\",\"minimum_quantity\":\"0.0001\",\"maximum_quantity\":\"1200\",\"minimum_notional\":\"5\",\"max_leverage\":\"150\"},{\"venue\":\"bybit\",\"venue_instrument\":\"BTCPERP\",\"settlement_asset\":\"USDC\",\"payoff_type\":\"linear\",\"quantity_unit\":\"BTC\",\"price_unit\":\"USDC\",\"price_rule\":{\"type\":\"fixed_tick\",\"tick_size\":\"0.10\"},\"quantity_step\":\"0.001\",\"minimum_quantity\":\"0.001\",\"maximum_quantity\":\"1000.000\",\"minimum_notional\":\"5\",\"max_leverage\":\"125.00\"},{\"venue\":\"bybit\",\"venue_instrument\":\"BTCUSD\",\"settlement_asset\":\"BTC\",\"payoff_type\":\"inverse\",\"quantity_unit\":\"USD\",\"price_unit\":\"USD\",\"price_rule\":{\"type\":\"fixed_tick\",\"tick_size\":\"0.10\"},\"quantity_step\":\"1\",\"minimum_quantity\":\"1\",\"maximum_quantity\":\"25000000\",\"minimum_notional\":\"5\",\"max_leverage\":\"100.00\"},{\"venue\":\"bybit\",\"venue_instrument\":\"BTCUSDT\",\"settlement_asset\":\"USDT\",\"payoff_type\":\"linear\",\"quantity_unit\":\"BTC\",\"price_unit\":\"USDT\",\"price_rule\":{\"type\":\"fixed_tick\",\"tick_size\":\"0.10\"},\"quantity_step\":\"0.001\",\"minimum_quantity\":\"0.001\",\"maximum_quantity\":\"1500.000\",\"minimum_notional\":\"5\",\"max_leverage\":\"150.00\"},{\"venue\":\"deribit\",\"venue_instrument\":\"BTC_USDC-PERPETUAL\",\"settlement_asset\":\"USDC\",\"payoff_type\":\"linear\",\"quantity_unit\":\"BTC\",\"price_unit\":\"USDC\",\"price_rule\":{\"type\":\"fixed_tick\",\"tick_size\":\"0.1\"},\"quantity_step\":\"0.0001\",\"minimum_quantity\":\"0.0001\",\"max_leverage\":\"50\"},{\"venue\":\"deribit\",\"venue_instrument\":\"BTC-PERPETUAL\",\"settlement_asset\":\"BTC\",\"payoff_type\":\"inverse\",\"quantity_unit\":\"USD\",\"price_unit\":\"USD\",\"price_rule\":{\"type\":\"fixed_tick\",\"tick_size\":\"0.5\"},\"quantity_step\":\"10\",\"minimum_quantity\":\"10\",\"max_leverage\":\"50\"},{\"venue\":\"dydx\",\"venue_instrument\":\"BTC-USD\",\"settlement_asset\":\"USDC\",\"payoff_type\":\"linear\",\"quantity_unit\":\"BTC\",\"price_unit\":\"USD\",\"price_rule\":{\"type\":\"fixed_tick\",\"tick_size\":\"1\"},\"quantity_step\":\"0.0001\"},{\"venue\":\"edgex\",\"venue_instrument\":\"BTCUSD\",\"settlement_asset\":\"USDT\",\"payoff_type\":\"linear\",\"quantity_unit\":\"BTC\",\"price_unit\":\"USD\",\"price_rule\":{\"type\":\"fixed_tick\",\"tick_size\":\"0.1\"},\"quantity_step\":\"0.001\",\"minimum_quantity\":\"0.003\",\"maximum_quantity\":\"22\",\"max_leverage\":\"100\"},{\"venue\":\"extended\",\"venue_instrument\":\"BTC-USD\",\"settlement_asset\":\"USDC\",\"payoff_type\":\"linear\",\"quantity_unit\":\"BTC\",\"price_unit\":\"USD\",\"price_rule\":{\"type\":\"fixed_tick\",\"tick_size\":\"1\"},\"quantity_step\":\"0.00001\",\"minimum_quantity\":\"0.0001\",\"max_leverage\":\"50.00\"},{\"venue\":\"gate\",\"venue_instrument\":\"BTC_USD\",\"settlement_asset\":\"BTC\",\"payoff_type\":\"inverse\",\"quantity_unit\":\"contract\",\"price_unit\":\"USD\",\"price_rule\":{\"type\":\"fixed_tick\",\"tick_size\":\"0.1\"},\"quantity_step\":\"1\",\"minimum_quantity\":\"1\",\"maximum_quantity\":\"530000\",\"max_leverage\":\"100\"},{\"venue\":\"gate\",\"venue_instrument\":\"BTC_USDT\",\"settlement_asset\":\"USDT\",\"payoff_type\":\"linear\",\"quantity_unit\":\"contract\",\"price_unit\":\"USDT\",\"contract_size\":\"0.0001\",\"contract_size_unit\":\"BTC\",\"price_rule\":{\"type\":\"fixed_tick\",\"tick_size\":\"0.1\"},\"quantity_step\":\"1\",\"minimum_quantity\":\"1\",\"maximum_quantity\":\"12000000\",\"max_leverage\":\"200\"},{\"venue\":\"gmx\",\"venue_instrument\":\"0x3ce7BCDB37Bf587d1C17B930Fa0A7000A0648D12\",\"network\":\"avalanche\",\"settlement_assets\":[\"BTC\"],\"quantity_unit\":\"USD\",\"price_unit\":\"USD\"},{\"venue\":\"gmx\",\"venue_instrument\":\"0x47c031236e19d024b42f8AE6780E44A573170703\",\"network\":\"arbitrum\",\"settlement_assets\":[\"WBTC.b\",\"USDC\"],\"quantity_unit\":\"USD\",\"price_unit\":\"USD\"},{\"venue\":\"gmx\",\"venue_instrument\":\"0x7C11F78Ce78768518D743E81Fdfa2F860C6b9A77\",\"network\":\"arbitrum\",\"settlement_assets\":[\"WBTC.b\"],\"quantity_unit\":\"USD\",\"price_unit\":\"USD\"},{\"venue\":\"gmx\",\"venue_instrument\":\"0xd62068697bCc92AF253225676D618B0C9f17C663\",\"network\":\"arbitrum\",\"settlement_assets\":[\"tBTC\"],\"quantity_unit\":\"USD\",\"price_unit\":\"USD\"},{\"venue\":\"gmx\",\"venue_instrument\":\"0xFb02132333A79C8B5Bd0b64E3AbccA5f7fAf2937\",\"network\":\"avalanche\",\"settlement_assets\":[\"BTC\",\"USDC\"],\"quantity_unit\":\"USD\",\"price_unit\":\"USD\"},{\"venue\":\"grvt\",\"venue_instrument\":\"BTC_USDT_Perp\",\"settlement_asset\":\"USDT\",\"payoff_type\":\"linear\",\"quantity_unit\":\"BTC\",\"price_unit\":\"USDT\",\"price_rule\":{\"type\":\"fixed_tick\",\"tick_size\":\"0.1\"},\"minimum_quantity\":\"0.001\",\"minimum_notional\":\"100.0\"},{\"venue\":\"hyperliquid\",\"venue_instrument\":\"BTC\",\"settlement_asset\":\"USDC\",\"payoff_type\":\"linear\",\"quantity_unit\":\"BTC\",\"price_unit\":\"USD\",\"price_rule\":{\"type\":\"significant_figures\",\"max_significant_figures\":5,\"max_decimal_places\":1,\"integer_prices_allowed\":true},\"quantity_step\":\"0.00001\",\"max_leverage\":\"40\"},{\"venue\":\"kraken\",\"venue_instrument\":\"PF_XBTUSD\",\"settlement_asset\":\"USD\",\"payoff_type\":\"linear\",\"quantity_unit\":\"BTC\",\"price_unit\":\"USD\",\"price_rule\":{\"type\":\"fixed_tick\",\"tick_size\":\"1\"},\"quantity_step\":\"0.0001\"},{\"venue\":\"kucoin\",\"venue_instrument\":\"XBTUSDCM\",\"settlement_asset\":\"USDC\",\"payoff_type\":\"linear\",\"quantity_unit\":\"contract\",\"price_unit\":\"USDC\",\"contract_size\":\"0.0001\",\"contract_size_unit\":\"BTC\",\"price_rule\":{\"type\":\"fixed_tick\",\"tick_size\":\"0.1\"},\"quantity_step\":\"1\",\"maximum_quantity\":\"1000000\"},{\"venue\":\"kucoin\",\"venue_instrument\":\"XBTUSDM\",\"settlement_asset\":\"BTC\",\"payoff_type\":\"inverse\",\"quantity_unit\":\"contract\",\"price_unit\":\"USD\",\"contract_size\":\"1\",\"contract_size_unit\":\"USD\",\"price_rule\":{\"type\":\"fixed_tick\",\"tick_size\":\"0.1\"},\"quantity_step\":\"1\",\"maximum_quantity\":\"1000000\"},{\"venue\":\"kucoin\",\"venue_instrument\":\"XBTUSDTM\",\"settlement_asset\":\"USDT\",\"payoff_type\":\"linear\",\"quantity_unit\":\"contract\",\"price_unit\":\"USDT\",\"contract_size\":\"0.001\",\"contract_size_unit\":\"BTC\",\"price_rule\":{\"type\":\"fixed_tick\",\"tick_size\":\"0.1\"},\"quantity_step\":\"1\",\"maximum_quantity\":\"1000000\"},{\"venue\":\"lighter\",\"venue_instrument\":\"BTC\",\"settlement_asset\":\"USDC\",\"payoff_type\":\"linear\",\"quantity_unit\":\"BTC\",\"price_unit\":\"USD\",\"price_rule\":{\"type\":\"fixed_tick\",\"tick_size\":\"0.1\"},\"quantity_step\":\"0.00001\",\"minimum_quantity\":\"0.00010\",\"minimum_notional\":\"10.000000\"},{\"venue\":\"mexc\",\"venue_instrument\":\"BTC_USD\",\"settlement_asset\":\"BTC\",\"quantity_unit\":\"contract\",\"price_unit\":\"USD\",\"contract_size\":\"100\",\"contract_size_unit\":\"BTC\",\"price_rule\":{\"type\":\"fixed_tick\",\"tick_size\":\"0.1\"},\"quantity_step\":\"1\",\"minimum_quantity\":\"1\",\"maximum_quantity\":\"2800\",\"max_leverage\":\"125\"},{\"venue\":\"mexc\",\"venue_instrument\":\"BTC_USD1\",\"settlement_asset\":\"USD1\",\"quantity_unit\":\"contract\",\"price_unit\":\"USD1\",\"contract_size\":\"0.0001\",\"contract_size_unit\":\"BTC\",\"price_rule\":{\"type\":\"fixed_tick\",\"tick_size\":\"0.1\"},\"quantity_step\":\"1\",\"minimum_quantity\":\"1\",\"maximum_quantity\":\"350000\",\"max_leverage\":\"100\"},{\"venue\":\"mexc\",\"venue_instrument\":\"BTC_USDC\",\"settlement_asset\":\"USDC\",\"quantity_unit\":\"contract\",\"price_unit\":\"USDC\",\"contract_size\":\"0.0001\",\"contract_size_unit\":\"BTC\",\"price_rule\":{\"type\":\"fixed_tick\",\"tick_size\":\"0.1\"},\"quantity_step\":\"1\",\"minimum_quantity\":\"1\",\"maximum_quantity\":\"1500000\",\"max_leverage\":\"200\"},{\"venue\":\"mexc\",\"venue_instrument\":\"BTC_USDT\",\"settlement_asset\":\"USDT\",\"quantity_unit\":\"contract\",\"price_unit\":\"USDT\",\"contract_size\":\"0.0001\",\"contract_size_unit\":\"BTC\",\"price_rule\":{\"type\":\"fixed_tick\",\"tick_size\":\"0.1\"},\"quantity_step\":\"1\",\"minimum_quantity\":\"1\",\"maximum_quantity\":\"2500000\",\"max_leverage\":\"500\"},{\"venue\":\"okx\",\"venue_instrument\":\"BTC-USD-SWAP\",\"settlement_asset\":\"BTC\",\"payoff_type\":\"inverse\",\"quantity_unit\":\"contract\",\"price_unit\":\"USD\",\"contract_size\":\"100\",\"contract_size_unit\":\"USD\",\"price_rule\":{\"type\":\"fixed_tick\",\"tick_size\":\"0.1\"},\"quantity_step\":\"0.1\",\"minimum_quantity\":\"0.1\",\"maximum_quantity\":\"100000000\",\"max_leverage\":\"100\"},{\"venue\":\"okx\",\"venue_instrument\":\"BTC-USDT-SWAP\",\"settlement_asset\":\"USDT\",\"payoff_type\":\"linear\",\"quantity_unit\":\"contract\",\"price_unit\":\"USDT\",\"contract_size\":\"0.01\",\"contract_size_unit\":\"BTC\",\"price_rule\":{\"type\":\"fixed_tick\",\"tick_size\":\"0.1\"},\"quantity_step\":\"0.01\",\"minimum_quantity\":\"0.01\",\"maximum_quantity\":\"100000000\",\"max_leverage\":\"100\"},{\"venue\":\"paradex\",\"venue_instrument\":\"BTC-USD-PERP\",\"settlement_asset\":\"USDC\",\"payoff_type\":\"linear\",\"quantity_unit\":\"BTC\",\"price_unit\":\"USD\",\"price_rule\":{\"type\":\"fixed_tick\",\"tick_size\":\"0.1\"},\"quantity_step\":\"0.00001\",\"maximum_quantity\":\"100\",\"minimum_notional\":\"10\"}]}"
      }
    ],
    "structuredContent": {
      "instrument": "BTC-PERP",
      "contract_type": "perpetual",
      "base_asset": "BTC",
      "contracts": [
        {
          "venue": "apex",
          "venue_instrument": "BTC-USDT",
          "settlement_asset": "USDT",
          "payoff_type": "linear",
          "quantity_unit": "BTC",
          "price_unit": "USDT",
          "price_rule": {
            "type": "fixed_tick",
            "tick_size": "0.1"
          },
          "quantity_step": "0.001",
          "minimum_quantity": "0.0010",
          "maximum_quantity": "50",
          "max_leverage": "100"
        },
        {
          "venue": "aster",
          "venue_instrument": "BTCU",
          "settlement_asset": "U",
          "payoff_type": "linear",
          "quantity_unit": "BTC",
          "price_unit": "U",
          "price_rule": {
            "type": "fixed_tick",
            "tick_size": "0.10"
          },
          "quantity_step": "0.001",
          "minimum_quantity": "0.001",
          "maximum_quantity": "1000",
          "minimum_notional": "5"
        },
        {
          "venue": "aster",
          "venue_instrument": "BTCUSD1",
          "settlement_asset": "USD1",
          "payoff_type": "linear",
          "quantity_unit": "BTC",
          "price_unit": "USD1",
          "price_rule": {
            "type": "fixed_tick",
            "tick_size": "0.10"
          },
          "quantity_step": "0.001",
          "minimum_quantity": "0.001",
          "maximum_quantity": "1000",
          "minimum_notional": "5"
        },
        {
          "venue": "aster",
          "venue_instrument": "BTCUSDT",
          "settlement_asset": "USDT",
          "payoff_type": "linear",
          "quantity_unit": "BTC",
          "price_unit": "USDT",
          "price_rule": {
            "type": "fixed_tick",
            "tick_size": "0.1"
          },
          "quantity_step": "0.001",
          "minimum_quantity": "0.001",
          "maximum_quantity": "1000",
          "minimum_notional": "5"
        },
        {
          "venue": "binance",
          "venue_instrument": "BTCU",
          "settlement_asset": "U",
          "payoff_type": "linear",
          "quantity_unit": "BTC",
          "price_unit": "U",
          "price_rule": {
            "type": "fixed_tick",
            "tick_size": "0.10"
          },
          "quantity_step": "0.0001",
          "minimum_quantity": "0.0001",
          "maximum_quantity": "800",
          "minimum_notional": "5"
        },
        {
          "venue": "binance",
          "venue_instrument": "BTCUSD_PERP",
          "settlement_asset": "BTC",
          "payoff_type": "inverse",
          "quantity_unit": "contract",
          "price_unit": "USD",
          "price_rule": {
            "type": "fixed_tick",
            "tick_size": "0.1"
          },
          "quantity_step": "1",
          "minimum_quantity": "1",
          "maximum_quantity": "1000000",
          "contract_size": "100",
          "contract_size_unit": "USD"
        },
        {
          "venue": "binance",
          "venue_instrument": "BTCUSD1",
          "settlement_asset": "USD1",
          "payoff_type": "linear",
          "quantity_unit": "BTC",
          "price_unit": "USD1",
          "price_rule": {
            "type": "fixed_tick",
            "tick_size": "0.10"
          },
          "quantity_step": "0.0001",
          "minimum_quantity": "0.0001",
          "maximum_quantity": "800",
          "minimum_notional": "50"
        },
        {
          "venue": "binance",
          "venue_instrument": "BTCUSDC",
          "settlement_asset": "USDC",
          "payoff_type": "linear",
          "quantity_unit": "BTC",
          "price_unit": "USDC",
          "price_rule": {
            "type": "fixed_tick",
            "tick_size": "0.1"
          },
          "quantity_step": "0.001",
          "minimum_quantity": "0.001",
          "maximum_quantity": "800",
          "minimum_notional": "50"
        },
        {
          "venue": "binance",
          "venue_instrument": "BTCUSDT",
          "settlement_asset": "USDT",
          "payoff_type": "linear",
          "quantity_unit": "BTC",
          "price_unit": "USDT",
          "price_rule": {
            "type": "fixed_tick",
            "tick_size": "0.10"
          },
          "quantity_step": "0.001",
          "minimum_quantity": "0.001",
          "maximum_quantity": "1000",
          "minimum_notional": "50"
        },
        {
          "venue": "bitget",
          "venue_instrument": "BTCPERP",
          "settlement_asset": "USDC",
          "payoff_type": "linear",
          "quantity_unit": "BTC",
          "price_unit": "USDC",
          "price_rule": {
            "type": "fixed_tick",
            "tick_size": "0.1"
          },
          "quantity_step": "0.0001",
          "minimum_quantity": "0.0001",
          "maximum_quantity": "100",
          "minimum_notional": "5",
          "max_leverage": "125"
        },
        {
          "venue": "bitget",
          "venue_instrument": "BTCUSDT",
          "settlement_asset": "USDT",
          "payoff_type": "linear",
          "quantity_unit": "BTC",
          "price_unit": "USDT",
          "price_rule": {
            "type": "fixed_tick",
            "tick_size": "0.1"
          },
          "quantity_step": "0.0001",
          "minimum_quantity": "0.0001",
          "maximum_quantity": "1200",
          "minimum_notional": "5",
          "max_leverage": "150"
        },
        {
          "venue": "bybit",
          "venue_instrument": "BTCPERP",
          "settlement_asset": "USDC",
          "payoff_type": "linear",
          "quantity_unit": "BTC",
          "price_unit": "USDC",
          "price_rule": {
            "type": "fixed_tick",
            "tick_size": "0.10"
          },
          "quantity_step": "0.001",
          "minimum_quantity": "0.001",
          "maximum_quantity": "1000.000",
          "minimum_notional": "5",
          "max_leverage": "125.00"
        },
        {
          "venue": "bybit",
          "venue_instrument": "BTCUSD",
          "settlement_asset": "BTC",
          "payoff_type": "inverse",
          "quantity_unit": "USD",
          "price_unit": "USD",
          "price_rule": {
            "type": "fixed_tick",
            "tick_size": "0.10"
          },
          "quantity_step": "1",
          "minimum_quantity": "1",
          "maximum_quantity": "25000000",
          "minimum_notional": "5",
          "max_leverage": "100.00"
        },
        {
          "venue": "bybit",
          "venue_instrument": "BTCUSDT",
          "settlement_asset": "USDT",
          "payoff_type": "linear",
          "quantity_unit": "BTC",
          "price_unit": "USDT",
          "price_rule": {
            "type": "fixed_tick",
            "tick_size": "0.10"
          },
          "quantity_step": "0.001",
          "minimum_quantity": "0.001",
          "maximum_quantity": "1500.000",
          "minimum_notional": "5",
          "max_leverage": "150.00"
        },
        {
          "venue": "deribit",
          "venue_instrument": "BTC_USDC-PERPETUAL",
          "settlement_asset": "USDC",
          "payoff_type": "linear",
          "quantity_unit": "BTC",
          "price_unit": "USDC",
          "price_rule": {
            "type": "fixed_tick",
            "tick_size": "0.1"
          },
          "quantity_step": "0.0001",
          "minimum_quantity": "0.0001",
          "max_leverage": "50"
        },
        {
          "venue": "deribit",
          "venue_instrument": "BTC-PERPETUAL",
          "settlement_asset": "BTC",
          "payoff_type": "inverse",
          "quantity_unit": "USD",
          "price_unit": "USD",
          "price_rule": {
            "type": "fixed_tick",
            "tick_size": "0.5"
          },
          "quantity_step": "10",
          "minimum_quantity": "10",
          "max_leverage": "50"
        },
        {
          "venue": "dydx",
          "venue_instrument": "BTC-USD",
          "settlement_asset": "USDC",
          "payoff_type": "linear",
          "quantity_unit": "BTC",
          "price_unit": "USD",
          "price_rule": {
            "type": "fixed_tick",
            "tick_size": "1"
          },
          "quantity_step": "0.0001"
        },
        {
          "venue": "edgex",
          "venue_instrument": "BTCUSD",
          "settlement_asset": "USDT",
          "payoff_type": "linear",
          "quantity_unit": "BTC",
          "price_unit": "USD",
          "price_rule": {
            "type": "fixed_tick",
            "tick_size": "0.1"
          },
          "quantity_step": "0.001",
          "minimum_quantity": "0.003",
          "maximum_quantity": "22",
          "max_leverage": "100"
        },
        {
          "venue": "extended",
          "venue_instrument": "BTC-USD",
          "settlement_asset": "USDC",
          "payoff_type": "linear",
          "quantity_unit": "BTC",
          "price_unit": "USD",
          "price_rule": {
            "type": "fixed_tick",
            "tick_size": "1"
          },
          "quantity_step": "0.00001",
          "minimum_quantity": "0.0001",
          "max_leverage": "50.00"
        },
        {
          "venue": "gate",
          "venue_instrument": "BTC_USD",
          "settlement_asset": "BTC",
          "payoff_type": "inverse",
          "quantity_unit": "contract",
          "price_unit": "USD",
          "price_rule": {
            "type": "fixed_tick",
            "tick_size": "0.1"
          },
          "quantity_step": "1",
          "minimum_quantity": "1",
          "maximum_quantity": "530000",
          "max_leverage": "100"
        },
        {
          "venue": "gate",
          "venue_instrument": "BTC_USDT",
          "settlement_asset": "USDT",
          "payoff_type": "linear",
          "quantity_unit": "contract",
          "price_unit": "USDT",
          "contract_size": "0.0001",
          "contract_size_unit": "BTC",
          "price_rule": {
            "type": "fixed_tick",
            "tick_size": "0.1"
          },
          "quantity_step": "1",
          "minimum_quantity": "1",
          "maximum_quantity": "12000000",
          "max_leverage": "200"
        },
        {
          "venue": "gmx",
          "venue_instrument": "0x3ce7BCDB37Bf587d1C17B930Fa0A7000A0648D12",
          "network": "avalanche",
          "settlement_assets": [
            "BTC"
          ],
          "quantity_unit": "USD",
          "price_unit": "USD"
        },
        {
          "venue": "gmx",
          "venue_instrument": "0x47c031236e19d024b42f8AE6780E44A573170703",
          "network": "arbitrum",
          "settlement_assets": [
            "WBTC.b",
            "USDC"
          ],
          "quantity_unit": "USD",
          "price_unit": "USD"
        },
        {
          "venue": "gmx",
          "venue_instrument": "0x7C11F78Ce78768518D743E81Fdfa2F860C6b9A77",
          "network": "arbitrum",
          "settlement_assets": [
            "WBTC.b"
          ],
          "quantity_unit": "USD",
          "price_unit": "USD"
        },
        {
          "venue": "gmx",
          "venue_instrument": "0xd62068697bCc92AF253225676D618B0C9f17C663",
          "network": "arbitrum",
          "settlement_assets": [
            "tBTC"
          ],
          "quantity_unit": "USD",
          "price_unit": "USD"
        },
        {
          "venue": "gmx",
          "venue_instrument": "0xFb02132333A79C8B5Bd0b64E3AbccA5f7fAf2937",
          "network": "avalanche",
          "settlement_assets": [
            "BTC",
            "USDC"
          ],
          "quantity_unit": "USD",
          "price_unit": "USD"
        },
        {
          "venue": "grvt",
          "venue_instrument": "BTC_USDT_Perp",
          "settlement_asset": "USDT",
          "payoff_type": "linear",
          "quantity_unit": "BTC",
          "price_unit": "USDT",
          "price_rule": {
            "type": "fixed_tick",
            "tick_size": "0.1"
          },
          "minimum_quantity": "0.001",
          "minimum_notional": "100.0"
        },
        {
          "venue": "hyperliquid",
          "venue_instrument": "BTC",
          "settlement_asset": "USDC",
          "payoff_type": "linear",
          "quantity_unit": "BTC",
          "price_unit": "USD",
          "price_rule": {
            "type": "significant_figures",
            "max_significant_figures": 5,
            "max_decimal_places": 1,
            "integer_prices_allowed": true
          },
          "quantity_step": "0.00001",
          "max_leverage": "40"
        },
        {
          "venue": "kraken",
          "venue_instrument": "PF_XBTUSD",
          "settlement_asset": "USD",
          "payoff_type": "linear",
          "quantity_unit": "BTC",
          "price_unit": "USD",
          "price_rule": {
            "type": "fixed_tick",
            "tick_size": "1"
          },
          "quantity_step": "0.0001"
        },
        {
          "venue": "kucoin",
          "venue_instrument": "XBTUSDCM",
          "settlement_asset": "USDC",
          "payoff_type": "linear",
          "quantity_unit": "contract",
          "price_unit": "USDC",
          "contract_size": "0.0001",
          "contract_size_unit": "BTC",
          "price_rule": {
            "type": "fixed_tick",
            "tick_size": "0.1"
          },
          "quantity_step": "1",
          "maximum_quantity": "1000000"
        },
        {
          "venue": "kucoin",
          "venue_instrument": "XBTUSDM",
          "settlement_asset": "BTC",
          "payoff_type": "inverse",
          "quantity_unit": "contract",
          "price_unit": "USD",
          "contract_size": "1",
          "contract_size_unit": "USD",
          "price_rule": {
            "type": "fixed_tick",
            "tick_size": "0.1"
          },
          "quantity_step": "1",
          "maximum_quantity": "1000000"
        },
        {
          "venue": "kucoin",
          "venue_instrument": "XBTUSDTM",
          "settlement_asset": "USDT",
          "payoff_type": "linear",
          "quantity_unit": "contract",
          "price_unit": "USDT",
          "contract_size": "0.001",
          "contract_size_unit": "BTC",
          "price_rule": {
            "type": "fixed_tick",
            "tick_size": "0.1"
          },
          "quantity_step": "1",
          "maximum_quantity": "1000000"
        },
        {
          "venue": "lighter",
          "venue_instrument": "BTC",
          "settlement_asset": "USDC",
          "payoff_type": "linear",
          "quantity_unit": "BTC",
          "price_unit": "USD",
          "price_rule": {
            "type": "fixed_tick",
            "tick_size": "0.1"
          },
          "quantity_step": "0.00001",
          "minimum_quantity": "0.00010",
          "minimum_notional": "10.000000"
        },
        {
          "venue": "mexc",
          "venue_instrument": "BTC_USD",
          "settlement_asset": "BTC",
          "quantity_unit": "contract",
          "price_unit": "USD",
          "contract_size": "100",
          "contract_size_unit": "BTC",
          "price_rule": {
            "type": "fixed_tick",
            "tick_size": "0.1"
          },
          "quantity_step": "1",
          "minimum_quantity": "1",
          "maximum_quantity": "2800",
          "max_leverage": "125"
        },
        {
          "venue": "mexc",
          "venue_instrument": "BTC_USD1",
          "settlement_asset": "USD1",
          "quantity_unit": "contract",
          "price_unit": "USD1",
          "contract_size": "0.0001",
          "contract_size_unit": "BTC",
          "price_rule": {
            "type": "fixed_tick",
            "tick_size": "0.1"
          },
          "quantity_step": "1",
          "minimum_quantity": "1",
          "maximum_quantity": "350000",
          "max_leverage": "100"
        },
        {
          "venue": "mexc",
          "venue_instrument": "BTC_USDC",
          "settlement_asset": "USDC",
          "quantity_unit": "contract",
          "price_unit": "USDC",
          "contract_size": "0.0001",
          "contract_size_unit": "BTC",
          "price_rule": {
            "type": "fixed_tick",
            "tick_size": "0.1"
          },
          "quantity_step": "1",
          "minimum_quantity": "1",
          "maximum_quantity": "1500000",
          "max_leverage": "200"
        },
        {
          "venue": "mexc",
          "venue_instrument": "BTC_USDT",
          "settlement_asset": "USDT",
          "quantity_unit": "contract",
          "price_unit": "USDT",
          "contract_size": "0.0001",
          "contract_size_unit": "BTC",
          "price_rule": {
            "type": "fixed_tick",
            "tick_size": "0.1"
          },
          "quantity_step": "1",
          "minimum_quantity": "1",
          "maximum_quantity": "2500000",
          "max_leverage": "500"
        },
        {
          "venue": "okx",
          "venue_instrument": "BTC-USD-SWAP",
          "settlement_asset": "BTC",
          "payoff_type": "inverse",
          "quantity_unit": "contract",
          "price_unit": "USD",
          "contract_size": "100",
          "contract_size_unit": "USD",
          "price_rule": {
            "type": "fixed_tick",
            "tick_size": "0.1"
          },
          "quantity_step": "0.1",
          "minimum_quantity": "0.1",
          "maximum_quantity": "100000000",
          "max_leverage": "100"
        },
        {
          "venue": "okx",
          "venue_instrument": "BTC-USDT-SWAP",
          "settlement_asset": "USDT",
          "payoff_type": "linear",
          "quantity_unit": "contract",
          "price_unit": "USDT",
          "contract_size": "0.01",
          "contract_size_unit": "BTC",
          "price_rule": {
            "type": "fixed_tick",
            "tick_size": "0.1"
          },
          "quantity_step": "0.01",
          "minimum_quantity": "0.01",
          "maximum_quantity": "100000000",
          "max_leverage": "100"
        },
        {
          "venue": "paradex",
          "venue_instrument": "BTC-USD-PERP",
          "settlement_asset": "USDC",
          "payoff_type": "linear",
          "quantity_unit": "BTC",
          "price_unit": "USD",
          "price_rule": {
            "type": "fixed_tick",
            "tick_size": "0.1"
          },
          "quantity_step": "0.00001",
          "maximum_quantity": "100",
          "minimum_notional": "10"
        }
      ]
    },
    "isError": false
  }
}
trade8_get_market Result Fields
FieldTypeDescription
instrumentRequiredstringNormalized perpetual family, for example BTC-PERP. Select a settlement asset and exchange to identify a contract.
contract_typeRequiredstringPerpetual futures instrument family; payoff details belong to each exchange contract. Values: perpetual.
base_assetRequiredstringAsset symbol, such as BTC, USDT, or USDC.
contractsRequiredarrayNative contract mappings, grouped under one perpetual instrument.
contracts[].venueRequiredstringExchange identifier from GET /v1/venues, such as binance, okx, bybit, hyperliquid, or dydx.
contracts[].venue_instrumentRequiredstringNative exchange symbol, such as BTCUSDT or BTC.
contracts[].settlement_assetstringAsset symbol, such as BTC, USDT, or USDC.
contracts[].settlement_assetsarraySettlement tokens for a pool with side-dependent collateral.
contracts[].networkstringBlockchain network for an onchain pool.
contracts[].payoff_typestringContract payoff where specified by the exchange. Values: linear, inverse.
contracts[].contract_sizestringValue represented by one native contract.
contracts[].contract_size_unitstringUnit of contract_size; multiply native contract quantity by contract_size to express face value.
contracts[].quantity_unitRequiredstringNative size unit: base asset, USD, or contract. Read contract_size for lot-based contracts.
contracts[].price_unitRequiredstringPrice quote unit.
contracts[].price_rulevalueFixed increment or significant-figure pricing rule.
contracts[].quantity_stepstringSize increment in quantity_unit.
contracts[].minimum_quantitystringExchange LOT_SIZE minimum for limit orders.
contracts[].maximum_quantitystringExchange LOT_SIZE maximum for limit orders; market-order limits may differ.
contracts[].minimum_notionalstringMinimum order value in price_unit.
contracts[].max_leveragestringPublished exchange ceiling at snapshot time; account risk tiers can lower it.
Related REST Operation →

List Exchanges

trade8_list_exchangesRead OnlyPublic

List all centralized and decentralized exchanges shown in the Trade8 integration directory, with their IDs and official websites.

trade8_list_exchanges Arguments
FieldTypeDescription
typestringExchange category. Values: centralized, decentralized.
limitintegerPage size, default 50; maximum 200.
cursorstringOpaque next_cursor from the preceding response.
trade8_list_exchanges Request
{
  "jsonrpc": "2.0",
  "id": "call-trade8_list_exchanges",
  "method": "tools/call",
  "params": {
    "name": "trade8_list_exchanges",
    "arguments": {
      "limit": 50
    },
    "_meta": {
      "io.modelcontextprotocol/protocolVersion": "2026-07-28",
      "io.modelcontextprotocol/clientInfo": {
        "name": "trade8-research-agent",
        "version": "1.0.0"
      },
      "io.modelcontextprotocol/clientCapabilities": {}
    }
  }
}
Result Example and Fields
trade8_list_exchanges Result
{
  "jsonrpc": "2.0",
  "id": "call-trade8_list_exchanges",
  "result": {
    "resultType": "complete",
    "content": [
      {
        "type": "text",
        "text": "{\"venues\":[{\"id\":\"apex\",\"name\":\"ApeX Protocol\",\"type\":\"decentralized\",\"website\":\"https://www.apex.exchange/\"},{\"id\":\"aster\",\"name\":\"Aster\",\"type\":\"decentralized\",\"website\":\"https://www.asterdex.com/\"},{\"id\":\"binance\",\"name\":\"Binance\",\"type\":\"centralized\",\"website\":\"https://www.binance.com/\"},{\"id\":\"bitget\",\"name\":\"Bitget\",\"type\":\"centralized\",\"website\":\"https://www.bitget.com/\"},{\"id\":\"bybit\",\"name\":\"Bybit\",\"type\":\"centralized\",\"website\":\"https://www.bybit.com/\"},{\"id\":\"deribit\",\"name\":\"Deribit\",\"type\":\"centralized\",\"website\":\"https://www.deribit.com/\"},{\"id\":\"dydx\",\"name\":\"dYdX\",\"type\":\"decentralized\",\"website\":\"https://www.dydx.xyz/\"},{\"id\":\"edgex\",\"name\":\"edgeX\",\"type\":\"decentralized\",\"website\":\"https://www.edgex.exchange/\"},{\"id\":\"extended\",\"name\":\"Extended\",\"type\":\"decentralized\",\"website\":\"https://extended.exchange/\"},{\"id\":\"gate\",\"name\":\"Gate\",\"type\":\"centralized\",\"website\":\"https://www.gate.com/\"},{\"id\":\"gmx\",\"name\":\"GMX\",\"type\":\"decentralized\",\"website\":\"https://gmx.io/\"},{\"id\":\"grvt\",\"name\":\"GRVT\",\"type\":\"decentralized\",\"website\":\"https://grvt.io/\"},{\"id\":\"hyperliquid\",\"name\":\"Hyperliquid\",\"type\":\"decentralized\",\"website\":\"https://hyperliquid.xyz/\"},{\"id\":\"kraken\",\"name\":\"Kraken\",\"type\":\"centralized\",\"website\":\"https://www.kraken.com/\"},{\"id\":\"kucoin\",\"name\":\"KuCoin\",\"type\":\"centralized\",\"website\":\"https://www.kucoin.com/\"},{\"id\":\"lighter\",\"name\":\"Lighter\",\"type\":\"decentralized\",\"website\":\"https://lighter.xyz/\"},{\"id\":\"mexc\",\"name\":\"MEXC\",\"type\":\"centralized\",\"website\":\"https://www.mexc.com/\"},{\"id\":\"okx\",\"name\":\"OKX\",\"type\":\"centralized\",\"website\":\"https://www.okx.com/\"},{\"id\":\"paradex\",\"name\":\"Paradex\",\"type\":\"decentralized\",\"website\":\"https://www.paradex.trade/\"}],\"pagination\":{\"next_cursor\":null,\"has_more\":false}}"
      }
    ],
    "structuredContent": {
      "venues": [
        {
          "id": "apex",
          "name": "ApeX Protocol",
          "type": "decentralized",
          "website": "https://www.apex.exchange/"
        },
        {
          "id": "aster",
          "name": "Aster",
          "type": "decentralized",
          "website": "https://www.asterdex.com/"
        },
        {
          "id": "binance",
          "name": "Binance",
          "type": "centralized",
          "website": "https://www.binance.com/"
        },
        {
          "id": "bitget",
          "name": "Bitget",
          "type": "centralized",
          "website": "https://www.bitget.com/"
        },
        {
          "id": "bybit",
          "name": "Bybit",
          "type": "centralized",
          "website": "https://www.bybit.com/"
        },
        {
          "id": "deribit",
          "name": "Deribit",
          "type": "centralized",
          "website": "https://www.deribit.com/"
        },
        {
          "id": "dydx",
          "name": "dYdX",
          "type": "decentralized",
          "website": "https://www.dydx.xyz/"
        },
        {
          "id": "edgex",
          "name": "edgeX",
          "type": "decentralized",
          "website": "https://www.edgex.exchange/"
        },
        {
          "id": "extended",
          "name": "Extended",
          "type": "decentralized",
          "website": "https://extended.exchange/"
        },
        {
          "id": "gate",
          "name": "Gate",
          "type": "centralized",
          "website": "https://www.gate.com/"
        },
        {
          "id": "gmx",
          "name": "GMX",
          "type": "decentralized",
          "website": "https://gmx.io/"
        },
        {
          "id": "grvt",
          "name": "GRVT",
          "type": "decentralized",
          "website": "https://grvt.io/"
        },
        {
          "id": "hyperliquid",
          "name": "Hyperliquid",
          "type": "decentralized",
          "website": "https://hyperliquid.xyz/"
        },
        {
          "id": "kraken",
          "name": "Kraken",
          "type": "centralized",
          "website": "https://www.kraken.com/"
        },
        {
          "id": "kucoin",
          "name": "KuCoin",
          "type": "centralized",
          "website": "https://www.kucoin.com/"
        },
        {
          "id": "lighter",
          "name": "Lighter",
          "type": "decentralized",
          "website": "https://lighter.xyz/"
        },
        {
          "id": "mexc",
          "name": "MEXC",
          "type": "centralized",
          "website": "https://www.mexc.com/"
        },
        {
          "id": "okx",
          "name": "OKX",
          "type": "centralized",
          "website": "https://www.okx.com/"
        },
        {
          "id": "paradex",
          "name": "Paradex",
          "type": "decentralized",
          "website": "https://www.paradex.trade/"
        }
      ],
      "pagination": {
        "next_cursor": null,
        "has_more": false
      }
    },
    "isError": false
  }
}
trade8_list_exchanges Result Fields
FieldTypeDescription
venuesRequiredarrayExchanges on this page.
venues[].idRequiredstringExchange identifier from GET /v1/venues, such as binance, okx, bybit, hyperliquid, or dydx.
venues[].nameRequiredstringExchange display name.
venues[].typeRequiredstringExchange category. Values: centralized, decentralized.
venues[].websiteRequiredstringOfficial exchange website.
paginationRequiredobject
pagination.next_cursorRequiredstring | nullOpaque cursor for the next page; null at the end.
pagination.has_moreRequiredbooleanTrue when another page is available.
Related REST Operation →

Read an Order Book

trade8_get_order_bookRead Onlymarket:read

Read one exchange book. The example uses Hyperliquid BTC settled in USDC. Subscribe to orderbook for sequenced updates.

trade8_get_order_book Arguments
FieldTypeDescription
instrumentRequiredstringIdentifier of the resource to read or change.
venueRequiredstringExchange identifier.
settlement_assetRequiredstringFilter contracts by settlement asset.
depthintegerNumber of levels per side: 10, 20, or 50. Default 20. Values: 10, 20, 50.
trade8_get_order_book Request
{
  "jsonrpc": "2.0",
  "id": "call-trade8_get_order_book",
  "method": "tools/call",
  "params": {
    "name": "trade8_get_order_book",
    "arguments": {
      "instrument": "BTC-PERP",
      "venue": "hyperliquid",
      "settlement_asset": "USDC",
      "depth": 20
    },
    "_meta": {
      "io.modelcontextprotocol/protocolVersion": "2026-07-28",
      "io.modelcontextprotocol/clientInfo": {
        "name": "trade8-research-agent",
        "version": "1.0.0"
      },
      "io.modelcontextprotocol/clientCapabilities": {}
    }
  }
}
Result Example and Fields
trade8_get_order_book Result
{
  "jsonrpc": "2.0",
  "id": "call-trade8_get_order_book",
  "result": {
    "resultType": "complete",
    "content": [
      {
        "type": "text",
        "text": "{\"instrument\":\"BTC-PERP\",\"venue\":\"hyperliquid\",\"settlement_asset\":\"USDC\",\"book_sequence\":1042,\"bids\":[{\"price\":\"76999\",\"quantity\":\"1.25000\"}],\"asks\":[{\"price\":\"77001\",\"quantity\":\"0.90000\"}],\"updated_at\":\"2026-08-31T12:00:00.000Z\"}"
      }
    ],
    "structuredContent": {
      "instrument": "BTC-PERP",
      "venue": "hyperliquid",
      "settlement_asset": "USDC",
      "book_sequence": 1042,
      "bids": [
        {
          "price": "76999",
          "quantity": "1.25000"
        }
      ],
      "asks": [
        {
          "price": "77001",
          "quantity": "0.90000"
        }
      ],
      "updated_at": "2026-08-31T12:00:00.000Z"
    },
    "isError": false
  }
}
trade8_get_order_book Result Fields
FieldTypeDescription
instrumentRequiredstringNormalized perpetual family, for example BTC-PERP. Select a settlement asset and exchange to identify a contract.
venueRequiredstringExchange identifier from GET /v1/venues, such as binance, okx, bybit, hyperliquid, or dydx.
settlement_assetRequiredstringAsset symbol, such as BTC, USDT, or USDC.
book_sequenceRequiredintegerMonotonic sequence for this exchange/instrument book.
bidsRequiredarrayBids, highest price first.
bids[].priceRequiredstringPrice in the contract quote asset.
bids[].quantityRequiredstringAbsolute resting quantity in the contract base unit. Zero removes a level in a delta.
asksRequiredarrayAsks, lowest price first.
asks[].priceRequiredstringPrice in the contract quote asset.
asks[].quantityRequiredstringAbsolute resting quantity in the contract base unit. Zero removes a level in a delta.
updated_atRequiredstringUTC timestamp in RFC 3339 format.
Related REST Operation →

Read Funding Rates

trade8_get_fundingRead Onlymarket:read

Compare rates with their settlement interval. The Binance example is an eight-hour indicative rate; other exchanges can use different intervals.

trade8_get_funding Arguments
FieldTypeDescription
instrumentRequiredstringNormalized perpetual family.
venuestringExchange identifier.
settlement_assetstringFilter contracts by settlement asset.
limitintegerPage size, default 50; maximum 200.
cursorstringOpaque next_cursor from the preceding response.
trade8_get_funding Request
{
  "jsonrpc": "2.0",
  "id": "call-trade8_get_funding",
  "method": "tools/call",
  "params": {
    "name": "trade8_get_funding",
    "arguments": {
      "instrument": "BTC-PERP",
      "venue": "binance",
      "settlement_asset": "USDT",
      "limit": 50
    },
    "_meta": {
      "io.modelcontextprotocol/protocolVersion": "2026-07-28",
      "io.modelcontextprotocol/clientInfo": {
        "name": "trade8-research-agent",
        "version": "1.0.0"
      },
      "io.modelcontextprotocol/clientCapabilities": {}
    }
  }
}
Result Example and Fields
trade8_get_funding Result
{
  "jsonrpc": "2.0",
  "id": "call-trade8_get_funding",
  "result": {
    "resultType": "complete",
    "content": [
      {
        "type": "text",
        "text": "{\"funding\":[{\"instrument\":\"BTC-PERP\",\"venue\":\"binance\",\"settlement_asset\":\"USDT\",\"rate\":\"0.0001\",\"interval_hours\":\"8\",\"next_funding_at\":\"2026-08-31T16:00:00.000Z\",\"type\":\"indicative\"}],\"pagination\":{\"next_cursor\":null,\"has_more\":false}}"
      }
    ],
    "structuredContent": {
      "funding": [
        {
          "instrument": "BTC-PERP",
          "venue": "binance",
          "settlement_asset": "USDT",
          "rate": "0.0001",
          "interval_hours": "8",
          "next_funding_at": "2026-08-31T16:00:00.000Z",
          "type": "indicative"
        }
      ],
      "pagination": {
        "next_cursor": null,
        "has_more": false
      }
    },
    "isError": false
  }
}
trade8_get_funding Result Fields
FieldTypeDescription
fundingRequiredarrayResults on this page.
funding[].instrumentRequiredstringNormalized perpetual family, for example BTC-PERP. Select a settlement asset and exchange to identify a contract.
funding[].venueRequiredstringExchange identifier from GET /v1/venues, such as binance, okx, bybit, hyperliquid, or dydx.
funding[].settlement_assetRequiredstringAsset symbol, such as BTC, USDT, or USDC.
funding[].rateRequiredstringDecimal funding rate for the stated interval: 0.0001 = 0.01%.
funding[].interval_hoursRequiredstringHours covered by this rate.
funding[].next_funding_atRequiredstringUTC timestamp in RFC 3339 format.
funding[].typeRequiredstringIndicative rates can change before settlement. Values: indicative, final.
paginationRequiredobject
pagination.next_cursorRequiredstring | nullOpaque cursor for the next page; null at the end.
pagination.has_moreRequiredbooleanTrue when another page is available.
Related REST Operation →

Accounts and Risk

List Trading Accounts

trade8_list_accountsRead Onlyaccounts:read

Read main accounts and subaccounts available to this key, including enabled exchanges.

trade8_list_accounts Arguments
FieldTypeDescription
limitintegerPage size, default 50; maximum 200.
cursorstringOpaque next_cursor from the preceding response.
trade8_list_accounts Request
{
  "jsonrpc": "2.0",
  "id": "call-trade8_list_accounts",
  "method": "tools/call",
  "params": {
    "name": "trade8_list_accounts",
    "arguments": {
      "limit": 50
    },
    "_meta": {
      "io.modelcontextprotocol/protocolVersion": "2026-07-28",
      "io.modelcontextprotocol/clientInfo": {
        "name": "trade8-research-agent",
        "version": "1.0.0"
      },
      "io.modelcontextprotocol/clientCapabilities": {}
    }
  }
}
Result Example and Fields
trade8_list_accounts Result
{
  "jsonrpc": "2.0",
  "id": "call-trade8_list_accounts",
  "result": {
    "resultType": "complete",
    "content": [
      {
        "type": "text",
        "text": "{\"accounts\":[{\"account_id\":\"acct_example_main\",\"name\":\"Main Trading\",\"type\":\"main\",\"status\":\"active\",\"reporting_asset\":\"USDT\",\"enabled_venues\":[\"binance\",\"okx\",\"bybit\",\"hyperliquid\",\"dydx\"],\"created_at\":\"2026-08-31T12:00:00.000Z\"},{\"account_id\":\"acct_example_mm\",\"name\":\"Market Making\",\"type\":\"subaccount\",\"status\":\"active\",\"reporting_asset\":\"USDT\",\"enabled_venues\":[\"binance\",\"okx\",\"bybit\",\"hyperliquid\",\"dydx\"],\"created_at\":\"2026-08-31T12:00:00.000Z\"}],\"pagination\":{\"next_cursor\":null,\"has_more\":false}}"
      }
    ],
    "structuredContent": {
      "accounts": [
        {
          "account_id": "acct_example_main",
          "name": "Main Trading",
          "type": "main",
          "status": "active",
          "reporting_asset": "USDT",
          "enabled_venues": [
            "binance",
            "okx",
            "bybit",
            "hyperliquid",
            "dydx"
          ],
          "created_at": "2026-08-31T12:00:00.000Z"
        },
        {
          "account_id": "acct_example_mm",
          "name": "Market Making",
          "type": "subaccount",
          "status": "active",
          "reporting_asset": "USDT",
          "enabled_venues": [
            "binance",
            "okx",
            "bybit",
            "hyperliquid",
            "dydx"
          ],
          "created_at": "2026-08-31T12:00:00.000Z"
        }
      ],
      "pagination": {
        "next_cursor": null,
        "has_more": false
      }
    },
    "isError": false
  }
}
trade8_list_accounts Result Fields
FieldTypeDescription
accountsRequiredarrayResults on this page.
accounts[].account_idRequiredstringTrading account identifier within the authorized account grant.
accounts[].nameRequiredstringAccount display name.
accounts[].typeRequiredstringAccount hierarchy role. Values: main, subaccount.
accounts[].statusRequiredstringAccount access state. Values: active, read_only, suspended.
accounts[].reporting_assetRequiredstringAsset symbol, such as BTC, USDT, or USDC.
accounts[].enabled_venuesRequiredarrayExchanges enabled for this account.
accounts[].created_atRequiredstringUTC timestamp in RFC 3339 format.
paginationRequiredobject
pagination.next_cursorRequiredstring | nullOpaque cursor for the next page; null at the end.
pagination.has_moreRequiredbooleanTrue when another page is available.
Related REST Operation →

Read Account Balances

trade8_get_balancesRead Onlyaccounts:read

Read each asset separately. Custody balances and collateral allocations appear in the Custody and Settlement endpoints.

trade8_get_balances Arguments
FieldTypeDescription
account_idRequiredstringAuthorized trading account.
trade8_get_balances Request
{
  "jsonrpc": "2.0",
  "id": "call-trade8_get_balances",
  "method": "tools/call",
  "params": {
    "name": "trade8_get_balances",
    "arguments": {
      "account_id": "acct_example_main"
    },
    "_meta": {
      "io.modelcontextprotocol/protocolVersion": "2026-07-28",
      "io.modelcontextprotocol/clientInfo": {
        "name": "trade8-research-agent",
        "version": "1.0.0"
      },
      "io.modelcontextprotocol/clientCapabilities": {}
    }
  }
}
Result Example and Fields
trade8_get_balances Result
{
  "jsonrpc": "2.0",
  "id": "call-trade8_get_balances",
  "result": {
    "resultType": "complete",
    "content": [
      {
        "type": "text",
        "text": "{\"balances\":[{\"account_id\":\"acct_example_main\",\"asset\":\"USDT\",\"total\":\"10000.00\",\"available\":\"7500.00\",\"committed\":\"2500.00\",\"updated_at\":\"2026-08-31T12:00:00.000Z\"}]}"
      }
    ],
    "structuredContent": {
      "balances": [
        {
          "account_id": "acct_example_main",
          "asset": "USDT",
          "total": "10000.00",
          "available": "7500.00",
          "committed": "2500.00",
          "updated_at": "2026-08-31T12:00:00.000Z"
        }
      ]
    },
    "isError": false
  }
}
trade8_get_balances Result Fields
FieldTypeDescription
balancesRequiredarrayLedger balances by asset.
balances[].account_idRequiredstringTrading account identifier within the authorized account grant.
balances[].assetRequiredstringAsset symbol, such as BTC, USDT, or USDC.
balances[].totalRequiredstringLedger balance in this asset, excluding unrealized P&L.
balances[].availableRequiredstringUncommitted ledger balance.
balances[].committedRequiredstringAmount allocated or reserved. available + committed = total.
balances[].updated_atRequiredstringUTC timestamp in RFC 3339 format.
Related REST Operation →

Read Account Trading Fees

trade8_get_feesRead Onlyaccounts:read

Read account-specific maker, taker, and Trade8 charges by contract. Example rates illustrate the response structure.

trade8_get_fees Arguments
FieldTypeDescription
account_idRequiredstringAuthorized trading account.
instrumentstringNormalized perpetual family.
venuestringExchange identifier.
settlement_assetstringFilter contracts by settlement asset.
limitintegerPage size, default 50; maximum 200.
cursorstringOpaque next_cursor from the preceding response.
trade8_get_fees Request
{
  "jsonrpc": "2.0",
  "id": "call-trade8_get_fees",
  "method": "tools/call",
  "params": {
    "name": "trade8_get_fees",
    "arguments": {
      "account_id": "acct_example_main",
      "instrument": "BTC-PERP",
      "venue": "binance",
      "settlement_asset": "USDT",
      "limit": 50
    },
    "_meta": {
      "io.modelcontextprotocol/protocolVersion": "2026-07-28",
      "io.modelcontextprotocol/clientInfo": {
        "name": "trade8-research-agent",
        "version": "1.0.0"
      },
      "io.modelcontextprotocol/clientCapabilities": {}
    }
  }
}
Result Example and Fields
trade8_get_fees Result
{
  "jsonrpc": "2.0",
  "id": "call-trade8_get_fees",
  "result": {
    "resultType": "complete",
    "content": [
      {
        "type": "text",
        "text": "{\"fees\":[{\"venue\":\"binance\",\"instrument\":\"BTC-PERP\",\"settlement_asset\":\"USDT\",\"maker_rate\":\"0.0001\",\"taker_rate\":\"0.0003\",\"trade8_rate\":\"0.0000\",\"effective_at\":\"2026-08-31T12:00:00.000Z\"}],\"pagination\":{\"next_cursor\":null,\"has_more\":false}}"
      }
    ],
    "structuredContent": {
      "fees": [
        {
          "venue": "binance",
          "instrument": "BTC-PERP",
          "settlement_asset": "USDT",
          "maker_rate": "0.0001",
          "taker_rate": "0.0003",
          "trade8_rate": "0.0000",
          "effective_at": "2026-08-31T12:00:00.000Z"
        }
      ],
      "pagination": {
        "next_cursor": null,
        "has_more": false
      }
    },
    "isError": false
  }
}
trade8_get_fees Result Fields
FieldTypeDescription
feesRequiredarrayResults on this page.
fees[].venueRequiredstringExchange identifier from GET /v1/venues, such as binance, okx, bybit, hyperliquid, or dydx.
fees[].instrumentRequiredstringNormalized perpetual family, for example BTC-PERP. Select a settlement asset and exchange to identify a contract.
fees[].settlement_assetRequiredstringAsset symbol, such as BTC, USDT, or USDC.
fees[].maker_rateRequiredstringDecimal maker fee rate. Negative values indicate rebates.
fees[].taker_rateRequiredstringDecimal taker fee rate.
fees[].trade8_rateRequiredstringAdditional Trade8 trading charge as a decimal rate.
fees[].effective_atRequiredstringUTC timestamp in RFC 3339 format.
paginationRequiredobject
pagination.next_cursorRequiredstring | nullOpaque cursor for the next page; null at the end.
pagination.has_moreRequiredbooleanTrue when another page is available.
Related REST Operation →

Read Open Positions

trade8_list_positionsRead Onlyaccounts:read

Read exposure, margin mode, leverage, P&L, and liquidation estimates separately for each exchange contract.

trade8_list_positions Arguments
FieldTypeDescription
account_idRequiredstringAuthorized trading account.
instrumentstringNormalized perpetual family.
venuestringExchange identifier.
limitintegerPage size, default 50; maximum 200.
cursorstringOpaque next_cursor from the preceding response.
trade8_list_positions Request
{
  "jsonrpc": "2.0",
  "id": "call-trade8_list_positions",
  "method": "tools/call",
  "params": {
    "name": "trade8_list_positions",
    "arguments": {
      "account_id": "acct_example_main",
      "instrument": "BTC-PERP",
      "venue": "binance",
      "limit": 50
    },
    "_meta": {
      "io.modelcontextprotocol/protocolVersion": "2026-07-28",
      "io.modelcontextprotocol/clientInfo": {
        "name": "trade8-research-agent",
        "version": "1.0.0"
      },
      "io.modelcontextprotocol/clientCapabilities": {}
    }
  }
}
Result Example and Fields
trade8_list_positions Result
{
  "jsonrpc": "2.0",
  "id": "call-trade8_list_positions",
  "result": {
    "resultType": "complete",
    "content": [
      {
        "type": "text",
        "text": "{\"positions\":[{\"position_id\":\"pos_example_01\",\"account_id\":\"acct_example_main\",\"instrument\":\"BTC-PERP\",\"venue\":\"binance\",\"settlement_asset\":\"USDT\",\"side\":\"long\",\"quantity\":\"0.060\",\"entry_price\":\"77000.00\",\"mark_price\":\"77100.00\",\"unrealized_pnl\":\"6.00\",\"liquidation_price\":\"64000.00\",\"leverage\":\"5\",\"margin_mode\":\"isolated\",\"updated_at\":\"2026-08-31T12:00:00.000Z\"}],\"pagination\":{\"next_cursor\":null,\"has_more\":false}}"
      }
    ],
    "structuredContent": {
      "positions": [
        {
          "position_id": "pos_example_01",
          "account_id": "acct_example_main",
          "instrument": "BTC-PERP",
          "venue": "binance",
          "settlement_asset": "USDT",
          "side": "long",
          "quantity": "0.060",
          "entry_price": "77000.00",
          "mark_price": "77100.00",
          "unrealized_pnl": "6.00",
          "liquidation_price": "64000.00",
          "leverage": "5",
          "margin_mode": "isolated",
          "updated_at": "2026-08-31T12:00:00.000Z"
        }
      ],
      "pagination": {
        "next_cursor": null,
        "has_more": false
      }
    },
    "isError": false
  }
}
trade8_list_positions Result Fields
FieldTypeDescription
positionsRequiredarrayResults on this page.
positions[].position_idRequiredstringPosition identifier.
positions[].account_idRequiredstringTrading account identifier within the authorized account grant.
positions[].instrumentRequiredstringNormalized perpetual family, for example BTC-PERP. Select a settlement asset and exchange to identify a contract.
positions[].venueRequiredstringExchange identifier from GET /v1/venues, such as binance, okx, bybit, hyperliquid, or dydx.
positions[].settlement_assetRequiredstringAsset symbol, such as BTC, USDT, or USDC.
positions[].sideRequiredstringPosition direction. Values: long, short.
positions[].quantityRequiredstringAbsolute base quantity; zero marks a closed position update.
positions[].entry_priceRequiredstringQuantity-weighted entry price.
positions[].mark_priceRequiredstringCurrent exchange mark price.
positions[].unrealized_pnlRequiredstringUnrealized P&L in the settlement asset.
positions[].liquidation_priceRequiredstring | nullEstimated exchange liquidation price, or null when unavailable.
positions[].leverageRequiredstringConfigured leverage multiplier.
positions[].margin_modeRequiredstringExchange margin mode. Values: cross, isolated.
positions[].updated_atRequiredstringUTC timestamp in RFC 3339 format.
paginationRequiredobject
pagination.next_cursorRequiredstring | nullOpaque cursor for the next page; null at the end.
pagination.has_moreRequiredbooleanTrue when another page is available.
Related REST Operation →

Read Margin and Risk

trade8_get_riskRead Onlyaccounts:read

Read exchange-level equity, margin requirements, and available capacity. Compare assets within their own settlement denomination.

trade8_get_risk Arguments
FieldTypeDescription
account_idRequiredstringAuthorized trading account.
venuestringExchange identifier.
trade8_get_risk Request
{
  "jsonrpc": "2.0",
  "id": "call-trade8_get_risk",
  "method": "tools/call",
  "params": {
    "name": "trade8_get_risk",
    "arguments": {
      "account_id": "acct_example_main",
      "venue": "binance"
    },
    "_meta": {
      "io.modelcontextprotocol/protocolVersion": "2026-07-28",
      "io.modelcontextprotocol/clientInfo": {
        "name": "trade8-research-agent",
        "version": "1.0.0"
      },
      "io.modelcontextprotocol/clientCapabilities": {}
    }
  }
}
Result Example and Fields
trade8_get_risk Result
{
  "jsonrpc": "2.0",
  "id": "call-trade8_get_risk",
  "result": {
    "resultType": "complete",
    "content": [
      {
        "type": "text",
        "text": "{\"risk\":[{\"account_id\":\"acct_example_main\",\"venue\":\"binance\",\"settlement_asset\":\"USDT\",\"equity\":\"2506.00\",\"initial_margin\":\"925.20\",\"maintenance_margin\":\"23.13\",\"available_margin\":\"1580.80\",\"margin_ratio\":\"0.009230\",\"state\":\"normal\",\"updated_at\":\"2026-08-31T12:00:00.000Z\"}]}"
      }
    ],
    "structuredContent": {
      "risk": [
        {
          "account_id": "acct_example_main",
          "venue": "binance",
          "settlement_asset": "USDT",
          "equity": "2506.00",
          "initial_margin": "925.20",
          "maintenance_margin": "23.13",
          "available_margin": "1580.80",
          "margin_ratio": "0.009230",
          "state": "normal",
          "updated_at": "2026-08-31T12:00:00.000Z"
        }
      ]
    },
    "isError": false
  }
}
trade8_get_risk Result Fields
FieldTypeDescription
riskRequiredarrayRisk by exchange and settlement asset.
risk[].account_idRequiredstringTrading account identifier within the authorized account grant.
risk[].venueRequiredstringExchange identifier from GET /v1/venues, such as binance, okx, bybit, hyperliquid, or dydx.
risk[].settlement_assetRequiredstringAsset symbol, such as BTC, USDT, or USDC.
risk[].equityRequiredstringEquity in settlement_asset, including unrealized P&L.
risk[].initial_marginRequiredstringInitial margin requirement.
risk[].maintenance_marginRequiredstringMaintenance margin requirement.
risk[].available_marginRequiredstringMargin available for new positions after reservations.
risk[].margin_ratioRequiredstringMaintenance margin / equity. Rising values indicate less headroom.
risk[].stateRequiredstringExchange risk state. Values: normal, warning, reduce_only, liquidating.
risk[].updated_atRequiredstringUTC timestamp in RFC 3339 format.
Related REST Operation →

Orders and Fills

List Orders

trade8_list_ordersRead Onlyorders:read

Read parent orders in ascending created_at order. Open-order queries include all open orders unless time filters are explicit. Use status=open for pending, accepted, trigger_pending, and partially_filled orders.

trade8_list_orders Arguments
FieldTypeDescription
account_idRequiredstringAuthorized trading account.
instrumentstringNormalized perpetual family.
statusstringOpen, terminal, or any. Default open. Values: open, terminal, any.
start_timestringInclusive UTC start; default 24 hours before end_time.
end_timestringExclusive UTC end; default request time.
limitintegerPage size, default 50; maximum 200.
cursorstringOpaque next_cursor from the preceding response.
trade8_list_orders Request
{
  "jsonrpc": "2.0",
  "id": "call-trade8_list_orders",
  "method": "tools/call",
  "params": {
    "name": "trade8_list_orders",
    "arguments": {
      "account_id": "acct_example_main",
      "instrument": "BTC-PERP",
      "status": "open",
      "start_time": "2026-08-31T12:00:00.000Z",
      "end_time": "2026-09-01T12:00:00.000Z",
      "limit": 50
    },
    "_meta": {
      "io.modelcontextprotocol/protocolVersion": "2026-07-28",
      "io.modelcontextprotocol/clientInfo": {
        "name": "trade8-research-agent",
        "version": "1.0.0"
      },
      "io.modelcontextprotocol/clientCapabilities": {}
    }
  }
}
Result Example and Fields
trade8_list_orders Result
{
  "jsonrpc": "2.0",
  "id": "call-trade8_list_orders",
  "result": {
    "resultType": "complete",
    "content": [
      {
        "type": "text",
        "text": "{\"orders\":[{\"order_id\":\"ord_example_01\",\"account_id\":\"acct_example_main\",\"client_order_id\":\"strategy-a-0001\",\"instrument\":\"BTC-PERP\",\"settlement_asset\":\"USDT\",\"side\":\"buy\",\"type\":\"limit\",\"status\":\"partially_filled\",\"requested_quantity\":\"0.100\",\"filled_quantity\":\"0.060\",\"remaining_quantity\":\"0.040\",\"cancelled_quantity\":\"0.000\",\"average_fill_price\":\"77000.00\",\"revision\":2,\"created_at\":\"2026-08-31T12:00:00.000Z\",\"updated_at\":\"2026-08-31T12:00:00.250Z\"}],\"pagination\":{\"next_cursor\":null,\"has_more\":false}}"
      }
    ],
    "structuredContent": {
      "orders": [
        {
          "order_id": "ord_example_01",
          "account_id": "acct_example_main",
          "client_order_id": "strategy-a-0001",
          "instrument": "BTC-PERP",
          "settlement_asset": "USDT",
          "side": "buy",
          "type": "limit",
          "status": "partially_filled",
          "requested_quantity": "0.100",
          "filled_quantity": "0.060",
          "remaining_quantity": "0.040",
          "cancelled_quantity": "0.000",
          "average_fill_price": "77000.00",
          "revision": 2,
          "created_at": "2026-08-31T12:00:00.000Z",
          "updated_at": "2026-08-31T12:00:00.250Z"
        }
      ],
      "pagination": {
        "next_cursor": null,
        "has_more": false
      }
    },
    "isError": false
  }
}
trade8_list_orders Result Fields
FieldTypeDescription
ordersRequiredarrayResults on this page.
orders[].order_idRequiredstringTrade8 parent order identifier.
orders[].account_idRequiredstringTrading account identifier within the authorized account grant.
orders[].client_order_idRequiredstringUnique client identifier within the account. Retain it for reconciliation.
orders[].instrumentRequiredstringNormalized perpetual family, for example BTC-PERP. Select a settlement asset and exchange to identify a contract.
orders[].settlement_assetRequiredstringAsset symbol, such as BTC, USDT, or USDC.
orders[].sideRequiredstringDirection. Values: buy, sell.
orders[].typeRequiredstringOrder type.
orders[].statusRequiredstringCurrent order lifecycle state. Values: pending, accepted, trigger_pending, partially_filled, filled, cancelled, rejected, expired.
orders[].requested_quantityRequiredstringTotal requested base quantity.
orders[].filled_quantityRequiredstringCumulative executed base quantity.
orders[].remaining_quantityRequiredstringQuantity still open or awaiting execution. Zero after a terminal state.
orders[].cancelled_quantityRequiredstringQuantity cancelled, rejected, or expired without a fill.
orders[].average_fill_priceRequiredstring | nullQuantity-weighted price of actual fills; null before the first fill.
orders[].revisionRequiredintegerMonotonic order revision. Use for optimistic concurrency and event reconciliation.
orders[].created_atRequiredstringUTC timestamp in RFC 3339 format.
orders[].updated_atRequiredstringUTC timestamp in RFC 3339 format.
paginationRequiredobject
pagination.next_cursorRequiredstring | nullOpaque cursor for the next page; null at the end.
pagination.has_moreRequiredbooleanTrue when another page is available.
Related REST Operation →

Read an Order

trade8_get_orderRead Onlyorders:read

Reconcile lifecycle state and cumulative quantities. Compare revision before applying an older REST result over a streamed update.

trade8_get_order Arguments
FieldTypeDescription
order_idRequiredstringIdentifier of the resource to read or change.
account_idRequiredstringAuthorized trading account.
trade8_get_order Request
{
  "jsonrpc": "2.0",
  "id": "call-trade8_get_order",
  "method": "tools/call",
  "params": {
    "name": "trade8_get_order",
    "arguments": {
      "order_id": "ord_example_01",
      "account_id": "acct_example_main"
    },
    "_meta": {
      "io.modelcontextprotocol/protocolVersion": "2026-07-28",
      "io.modelcontextprotocol/clientInfo": {
        "name": "trade8-research-agent",
        "version": "1.0.0"
      },
      "io.modelcontextprotocol/clientCapabilities": {}
    }
  }
}
Result Example and Fields
trade8_get_order Result
{
  "jsonrpc": "2.0",
  "id": "call-trade8_get_order",
  "result": {
    "resultType": "complete",
    "content": [
      {
        "type": "text",
        "text": "{\"order_id\":\"ord_example_01\",\"account_id\":\"acct_example_main\",\"client_order_id\":\"strategy-a-0001\",\"instrument\":\"BTC-PERP\",\"settlement_asset\":\"USDT\",\"side\":\"buy\",\"type\":\"limit\",\"status\":\"partially_filled\",\"requested_quantity\":\"0.100\",\"filled_quantity\":\"0.060\",\"remaining_quantity\":\"0.040\",\"cancelled_quantity\":\"0.000\",\"average_fill_price\":\"77000.00\",\"revision\":2,\"created_at\":\"2026-08-31T12:00:00.000Z\",\"updated_at\":\"2026-08-31T12:00:00.250Z\"}"
      }
    ],
    "structuredContent": {
      "order_id": "ord_example_01",
      "account_id": "acct_example_main",
      "client_order_id": "strategy-a-0001",
      "instrument": "BTC-PERP",
      "settlement_asset": "USDT",
      "side": "buy",
      "type": "limit",
      "status": "partially_filled",
      "requested_quantity": "0.100",
      "filled_quantity": "0.060",
      "remaining_quantity": "0.040",
      "cancelled_quantity": "0.000",
      "average_fill_price": "77000.00",
      "revision": 2,
      "created_at": "2026-08-31T12:00:00.000Z",
      "updated_at": "2026-08-31T12:00:00.250Z"
    },
    "isError": false
  }
}
trade8_get_order Result Fields
FieldTypeDescription
order_idRequiredstringTrade8 parent order identifier.
account_idRequiredstringTrading account identifier within the authorized account grant.
client_order_idRequiredstringUnique client identifier within the account. Retain it for reconciliation.
instrumentRequiredstringNormalized perpetual family, for example BTC-PERP. Select a settlement asset and exchange to identify a contract.
settlement_assetRequiredstringAsset symbol, such as BTC, USDT, or USDC.
sideRequiredstringDirection. Values: buy, sell.
typeRequiredstringOrder type.
statusRequiredstringCurrent order lifecycle state. Values: pending, accepted, trigger_pending, partially_filled, filled, cancelled, rejected, expired.
requested_quantityRequiredstringTotal requested base quantity.
filled_quantityRequiredstringCumulative executed base quantity.
remaining_quantityRequiredstringQuantity still open or awaiting execution. Zero after a terminal state.
cancelled_quantityRequiredstringQuantity cancelled, rejected, or expired without a fill.
average_fill_priceRequiredstring | nullQuantity-weighted price of actual fills; null before the first fill.
revisionRequiredintegerMonotonic order revision. Use for optimistic concurrency and event reconciliation.
created_atRequiredstringUTC timestamp in RFC 3339 format.
updated_atRequiredstringUTC timestamp in RFC 3339 format.
Related REST Operation →

Find an Order by Client ID

trade8_find_orderRead Onlyorders:read

Find the existing order after a timeout or lost acknowledgement using the identifier you saved before submission.

trade8_find_order Arguments
FieldTypeDescription
client_order_idRequiredstringIdentifier of the resource to read or change.
account_idRequiredstringAuthorized trading account.
trade8_find_order Request
{
  "jsonrpc": "2.0",
  "id": "call-trade8_find_order",
  "method": "tools/call",
  "params": {
    "name": "trade8_find_order",
    "arguments": {
      "client_order_id": "strategy-a-0001",
      "account_id": "acct_example_main"
    },
    "_meta": {
      "io.modelcontextprotocol/protocolVersion": "2026-07-28",
      "io.modelcontextprotocol/clientInfo": {
        "name": "trade8-research-agent",
        "version": "1.0.0"
      },
      "io.modelcontextprotocol/clientCapabilities": {}
    }
  }
}
Result Example and Fields
trade8_find_order Result
{
  "jsonrpc": "2.0",
  "id": "call-trade8_find_order",
  "result": {
    "resultType": "complete",
    "content": [
      {
        "type": "text",
        "text": "{\"order_id\":\"ord_example_01\",\"account_id\":\"acct_example_main\",\"client_order_id\":\"strategy-a-0001\",\"instrument\":\"BTC-PERP\",\"settlement_asset\":\"USDT\",\"side\":\"buy\",\"type\":\"limit\",\"status\":\"partially_filled\",\"requested_quantity\":\"0.100\",\"filled_quantity\":\"0.060\",\"remaining_quantity\":\"0.040\",\"cancelled_quantity\":\"0.000\",\"average_fill_price\":\"77000.00\",\"revision\":2,\"created_at\":\"2026-08-31T12:00:00.000Z\",\"updated_at\":\"2026-08-31T12:00:00.250Z\"}"
      }
    ],
    "structuredContent": {
      "order_id": "ord_example_01",
      "account_id": "acct_example_main",
      "client_order_id": "strategy-a-0001",
      "instrument": "BTC-PERP",
      "settlement_asset": "USDT",
      "side": "buy",
      "type": "limit",
      "status": "partially_filled",
      "requested_quantity": "0.100",
      "filled_quantity": "0.060",
      "remaining_quantity": "0.040",
      "cancelled_quantity": "0.000",
      "average_fill_price": "77000.00",
      "revision": 2,
      "created_at": "2026-08-31T12:00:00.000Z",
      "updated_at": "2026-08-31T12:00:00.250Z"
    },
    "isError": false
  }
}
trade8_find_order Result Fields
FieldTypeDescription
order_idRequiredstringTrade8 parent order identifier.
account_idRequiredstringTrading account identifier within the authorized account grant.
client_order_idRequiredstringUnique client identifier within the account. Retain it for reconciliation.
instrumentRequiredstringNormalized perpetual family, for example BTC-PERP. Select a settlement asset and exchange to identify a contract.
settlement_assetRequiredstringAsset symbol, such as BTC, USDT, or USDC.
sideRequiredstringDirection. Values: buy, sell.
typeRequiredstringOrder type.
statusRequiredstringCurrent order lifecycle state. Values: pending, accepted, trigger_pending, partially_filled, filled, cancelled, rejected, expired.
requested_quantityRequiredstringTotal requested base quantity.
filled_quantityRequiredstringCumulative executed base quantity.
remaining_quantityRequiredstringQuantity still open or awaiting execution. Zero after a terminal state.
cancelled_quantityRequiredstringQuantity cancelled, rejected, or expired without a fill.
average_fill_priceRequiredstring | nullQuantity-weighted price of actual fills; null before the first fill.
revisionRequiredintegerMonotonic order revision. Use for optimistic concurrency and event reconciliation.
created_atRequiredstringUTC timestamp in RFC 3339 format.
updated_atRequiredstringUTC timestamp in RFC 3339 format.
Related REST Operation →

Read Account Fills

trade8_list_fillsRead Onlyorders:read

Recover executions across all orders in ascending executed_at order. Deduplicate on fill_id.

trade8_list_fills Arguments
FieldTypeDescription
account_idRequiredstringAuthorized trading account.
instrumentstringNormalized perpetual family.
venuestringExchange identifier.
start_timestringInclusive UTC start; default 24 hours before end_time.
end_timestringExclusive UTC end; default request time.
limitintegerPage size, default 50; maximum 200.
cursorstringOpaque next_cursor from the preceding response.
trade8_list_fills Request
{
  "jsonrpc": "2.0",
  "id": "call-trade8_list_fills",
  "method": "tools/call",
  "params": {
    "name": "trade8_list_fills",
    "arguments": {
      "account_id": "acct_example_main",
      "instrument": "BTC-PERP",
      "venue": "binance",
      "start_time": "2026-08-31T12:00:00.000Z",
      "end_time": "2026-09-01T12:00:00.000Z",
      "limit": 50
    },
    "_meta": {
      "io.modelcontextprotocol/protocolVersion": "2026-07-28",
      "io.modelcontextprotocol/clientInfo": {
        "name": "trade8-research-agent",
        "version": "1.0.0"
      },
      "io.modelcontextprotocol/clientCapabilities": {}
    }
  }
}
Result Example and Fields
trade8_list_fills Result
{
  "jsonrpc": "2.0",
  "id": "call-trade8_list_fills",
  "result": {
    "resultType": "complete",
    "content": [
      {
        "type": "text",
        "text": "{\"fills\":[{\"fill_id\":\"fill_example_01\",\"order_id\":\"ord_example_01\",\"account_id\":\"acct_example_main\",\"instrument\":\"BTC-PERP\",\"venue\":\"binance\",\"venue_order_id\":\"bn_example_01\",\"settlement_asset\":\"USDT\",\"quantity\":\"0.060\",\"price\":\"77000.00\",\"fee\":\"0.462\",\"fee_asset\":\"USDT\",\"liquidity\":\"maker\",\"executed_at\":\"2026-08-31T12:00:00.250Z\"}],\"pagination\":{\"next_cursor\":null,\"has_more\":false}}"
      }
    ],
    "structuredContent": {
      "fills": [
        {
          "fill_id": "fill_example_01",
          "order_id": "ord_example_01",
          "account_id": "acct_example_main",
          "instrument": "BTC-PERP",
          "venue": "binance",
          "venue_order_id": "bn_example_01",
          "settlement_asset": "USDT",
          "quantity": "0.060",
          "price": "77000.00",
          "fee": "0.462",
          "fee_asset": "USDT",
          "liquidity": "maker",
          "executed_at": "2026-08-31T12:00:00.250Z"
        }
      ],
      "pagination": {
        "next_cursor": null,
        "has_more": false
      }
    },
    "isError": false
  }
}
trade8_list_fills Result Fields
FieldTypeDescription
fillsRequiredarrayResults on this page.
fills[].fill_idRequiredstringUnique Trade8 fill identifier.
fills[].order_idRequiredstringParent order identifier.
fills[].account_idRequiredstringTrading account identifier within the authorized account grant.
fills[].instrumentRequiredstringNormalized perpetual family, for example BTC-PERP. Select a settlement asset and exchange to identify a contract.
fills[].venueRequiredstringExchange identifier from GET /v1/venues, such as binance, okx, bybit, hyperliquid, or dydx.
fills[].venue_order_idRequiredstringNative exchange order identifier.
fills[].settlement_assetRequiredstringAsset symbol, such as BTC, USDT, or USDC.
fills[].quantityRequiredstringExecuted base quantity.
fills[].priceRequiredstringExecution price in the quote asset.
fills[].feeRequiredstringTrading charge for this fill; negative indicates a rebate.
fills[].fee_assetRequiredstringAsset symbol, such as BTC, USDT, or USDC.
fills[].liquidityRequiredstringLiquidity role at execution. Values: maker, taker.
fills[].executed_atRequiredstringUTC timestamp in RFC 3339 format.
paginationRequiredobject
pagination.next_cursorRequiredstring | nullOpaque cursor for the next page; null at the end.
pagination.has_moreRequiredbooleanTrue when another page is available.
Related REST Operation →

Custody

List Custody Integrations

trade8_list_custodiansRead Onlycustody:read

Read custody providers such as Ceffu, Copper, Coinbase Custody, BitGo, Komainu, and Zodia Custody. Linked custody accounts supply the eligible exchange routes.

trade8_list_custodians Arguments
FieldTypeDescription
account_idRequiredstringAuthorized trading account.
limitintegerPage size, default 50; maximum 200.
cursorstringOpaque next_cursor from the preceding response.
trade8_list_custodians Request
{
  "jsonrpc": "2.0",
  "id": "call-trade8_list_custodians",
  "method": "tools/call",
  "params": {
    "name": "trade8_list_custodians",
    "arguments": {
      "account_id": "acct_example_main",
      "limit": 50
    },
    "_meta": {
      "io.modelcontextprotocol/protocolVersion": "2026-07-28",
      "io.modelcontextprotocol/clientInfo": {
        "name": "trade8-research-agent",
        "version": "1.0.0"
      },
      "io.modelcontextprotocol/clientCapabilities": {}
    }
  }
}
Result Example and Fields
trade8_list_custodians Result
{
  "jsonrpc": "2.0",
  "id": "call-trade8_list_custodians",
  "result": {
    "resultType": "complete",
    "content": [
      {
        "type": "text",
        "text": "{\"custodians\":[{\"id\":\"ceffu\",\"name\":\"Ceffu\",\"services\":[\"custody\",\"off_exchange_collateral\"]},{\"id\":\"copper\",\"name\":\"Copper\",\"services\":[\"custody\",\"off_exchange_collateral\"]},{\"id\":\"coinbase\",\"name\":\"Coinbase Custody\",\"services\":[\"custody\"]},{\"id\":\"bitgo\",\"name\":\"BitGo\",\"services\":[\"custody\"]},{\"id\":\"komainu\",\"name\":\"Komainu\",\"services\":[\"custody\"]},{\"id\":\"zodia\",\"name\":\"Zodia Custody\",\"services\":[\"custody\"]}],\"pagination\":{\"next_cursor\":null,\"has_more\":false}}"
      }
    ],
    "structuredContent": {
      "custodians": [
        {
          "id": "ceffu",
          "name": "Ceffu",
          "services": [
            "custody",
            "off_exchange_collateral"
          ]
        },
        {
          "id": "copper",
          "name": "Copper",
          "services": [
            "custody",
            "off_exchange_collateral"
          ]
        },
        {
          "id": "coinbase",
          "name": "Coinbase Custody",
          "services": [
            "custody"
          ]
        },
        {
          "id": "bitgo",
          "name": "BitGo",
          "services": [
            "custody"
          ]
        },
        {
          "id": "komainu",
          "name": "Komainu",
          "services": [
            "custody"
          ]
        },
        {
          "id": "zodia",
          "name": "Zodia Custody",
          "services": [
            "custody"
          ]
        }
      ],
      "pagination": {
        "next_cursor": null,
        "has_more": false
      }
    },
    "isError": false
  }
}
trade8_list_custodians Result Fields
FieldTypeDescription
custodiansRequiredarrayResults on this page.
custodians[].idRequiredstringCustodian identifier from the integration catalog.
custodians[].nameRequiredstringCustodian display name.
custodians[].servicesRequiredarrayServices enabled for this integration.
paginationRequiredobject
pagination.next_cursorRequiredstring | nullOpaque cursor for the next page; null at the end.
pagination.has_moreRequiredbooleanTrue when another page is available.
Related REST Operation →

Read Collateral Allocations

trade8_list_allocationsRead Onlycustody:read

Track custody collateral committed to each exchange and its acknowledgement state.

trade8_list_allocations Arguments
FieldTypeDescription
account_idRequiredstringAuthorized trading account.
venuestringExchange identifier.
limitintegerPage size, default 50; maximum 200.
cursorstringOpaque next_cursor from the preceding response.
trade8_list_allocations Request
{
  "jsonrpc": "2.0",
  "id": "call-trade8_list_allocations",
  "method": "tools/call",
  "params": {
    "name": "trade8_list_allocations",
    "arguments": {
      "account_id": "acct_example_main",
      "limit": 50
    },
    "_meta": {
      "io.modelcontextprotocol/protocolVersion": "2026-07-28",
      "io.modelcontextprotocol/clientInfo": {
        "name": "trade8-research-agent",
        "version": "1.0.0"
      },
      "io.modelcontextprotocol/clientCapabilities": {}
    }
  }
}
Result Example and Fields
trade8_list_allocations Result
{
  "jsonrpc": "2.0",
  "id": "call-trade8_list_allocations",
  "result": {
    "resultType": "complete",
    "content": [
      {
        "type": "text",
        "text": "{\"allocations\":[{\"allocation_id\":\"alloc_example_01\",\"account_id\":\"acct_example_main\",\"client_allocation_id\":\"collateral-0001\",\"custody_account_id\":\"cust_example_ceffu\",\"custodian\":\"ceffu\",\"venue\":\"binance\",\"asset\":\"USDT\",\"amount\":\"2500.00\",\"status\":\"active\",\"updated_at\":\"2026-08-31T12:00:00.000Z\"}],\"pagination\":{\"next_cursor\":null,\"has_more\":false}}"
      }
    ],
    "structuredContent": {
      "allocations": [
        {
          "allocation_id": "alloc_example_01",
          "account_id": "acct_example_main",
          "client_allocation_id": "collateral-0001",
          "custody_account_id": "cust_example_ceffu",
          "custodian": "ceffu",
          "venue": "binance",
          "asset": "USDT",
          "amount": "2500.00",
          "status": "active",
          "updated_at": "2026-08-31T12:00:00.000Z"
        }
      ],
      "pagination": {
        "next_cursor": null,
        "has_more": false
      }
    },
    "isError": false
  }
}
trade8_list_allocations Result Fields
FieldTypeDescription
allocationsRequiredarrayResults on this page.
allocations[].allocation_idRequiredstringCollateral allocation identifier.
allocations[].account_idRequiredstringTrading account identifier within the authorized account grant.
allocations[].client_allocation_idRequiredstringUnique client identifier within the account. Retain it for reconciliation.
allocations[].custody_account_idRequiredstringSource custody account.
allocations[].custodianRequiredstringCustodian identifier.
allocations[].venueRequiredstringExchange identifier from GET /v1/venues, such as binance, okx, bybit, hyperliquid, or dydx.
allocations[].assetRequiredstringAsset symbol, such as BTC, USDT, or USDC.
allocations[].amountRequiredstringAmount in asset units.
allocations[].statusRequiredstringActive means the exchange has acknowledged usable collateral. Values: pending, active, releasing, released, rejected.
allocations[].updated_atRequiredstringUTC timestamp in RFC 3339 format.
paginationRequiredobject
pagination.next_cursorRequiredstring | nullOpaque cursor for the next page; null at the end.
pagination.has_moreRequiredbooleanTrue when another page is available.
Related REST Operation →

Read Settlement Records

trade8_list_settlementsRead Onlycustody:read

Reconcile custody and exchange settlement cycles. The Copper/OKX example credits 125.50 USDT to custody.

trade8_list_settlements Arguments
FieldTypeDescription
account_idRequiredstringAuthorized trading account.
venuestringExchange identifier.
start_timestringInclusive UTC start; default 24 hours before end_time.
end_timestringExclusive UTC end; default request time.
limitintegerPage size, default 50; maximum 200.
cursorstringOpaque next_cursor from the preceding response.
trade8_list_settlements Request
{
  "jsonrpc": "2.0",
  "id": "call-trade8_list_settlements",
  "method": "tools/call",
  "params": {
    "name": "trade8_list_settlements",
    "arguments": {
      "account_id": "acct_example_main",
      "start_time": "2026-08-31T12:00:00.000Z",
      "end_time": "2026-09-01T12:00:00.000Z",
      "limit": 50
    },
    "_meta": {
      "io.modelcontextprotocol/protocolVersion": "2026-07-28",
      "io.modelcontextprotocol/clientInfo": {
        "name": "trade8-research-agent",
        "version": "1.0.0"
      },
      "io.modelcontextprotocol/clientCapabilities": {}
    }
  }
}
Result Example and Fields
trade8_list_settlements Result
{
  "jsonrpc": "2.0",
  "id": "call-trade8_list_settlements",
  "result": {
    "resultType": "complete",
    "content": [
      {
        "type": "text",
        "text": "{\"settlements\":[{\"settlement_id\":\"settle_example_01\",\"account_id\":\"acct_example_main\",\"custodian\":\"copper\",\"venue\":\"okx\",\"asset\":\"USDT\",\"amount\":\"125.50\",\"status\":\"completed\",\"cycle_start\":\"2026-08-31T08:00:00.000Z\",\"cycle_end\":\"2026-08-31T12:00:00.000Z\",\"updated_at\":\"2026-08-31T12:00:00.000Z\"}],\"pagination\":{\"next_cursor\":null,\"has_more\":false}}"
      }
    ],
    "structuredContent": {
      "settlements": [
        {
          "settlement_id": "settle_example_01",
          "account_id": "acct_example_main",
          "custodian": "copper",
          "venue": "okx",
          "asset": "USDT",
          "amount": "125.50",
          "status": "completed",
          "cycle_start": "2026-08-31T08:00:00.000Z",
          "cycle_end": "2026-08-31T12:00:00.000Z",
          "updated_at": "2026-08-31T12:00:00.000Z"
        }
      ],
      "pagination": {
        "next_cursor": null,
        "has_more": false
      }
    },
    "isError": false
  }
}
trade8_list_settlements Result Fields
FieldTypeDescription
settlementsRequiredarrayResults on this page.
settlements[].settlement_idRequiredstringSettlement record identifier.
settlements[].account_idRequiredstringTrading account identifier within the authorized account grant.
settlements[].custodianRequiredstringCustodian identifier.
settlements[].venueRequiredstringExchange identifier from GET /v1/venues, such as binance, okx, bybit, hyperliquid, or dydx.
settlements[].assetRequiredstringAsset symbol, such as BTC, USDT, or USDC.
settlements[].amountRequiredstringPositive credits the custody account; negative debits it.
settlements[].statusRequiredstringSettlement processing state. Values: pending, processing, completed, failed.
settlements[].cycle_startRequiredstringUTC timestamp in RFC 3339 format.
settlements[].cycle_endRequiredstringUTC timestamp in RFC 3339 format.
settlements[].updated_atRequiredstringUTC timestamp in RFC 3339 format.
paginationRequiredobject
pagination.next_cursorRequiredstring | nullOpaque cursor for the next page; null at the end.
pagination.has_moreRequiredbooleanTrue when another page is available.
Related REST Operation →

Trading Actions

Create an Order

trade8_create_orderChanges Ordersorders:write

Submit a parent order with exchange and settlement constraints. The example posts a BTC limit order across Binance and Bybit.

Requires trading permission and a confirmation step in your agent client. Preserve the idempotency key when recovering a timeout.

trade8_create_order Arguments
FieldTypeDescription
idempotency_keyRequiredstringUnique 1–64 character key per account, method, and path. Retained for 24 hours. Reuse with the exact same request when recovering an unknown outcome.
orderRequiredobject
order.account_idRequiredstringTrading account identifier within the authorized account grant.
order.client_order_idRequiredstringUnique client identifier within the account. Retain it for reconciliation.
order.instrumentRequiredstringNormalized perpetual family, for example BTC-PERP. Select a settlement asset and exchange to identify a contract.
order.settlement_assetRequiredstringAsset symbol, such as BTC, USDT, or USDC.
order.sideRequiredstringTrade direction. Values: buy, sell.
order.typeRequiredstringOrder type. Values: market, limit, stop_market, stop_limit, take_profit_market, take_profit_limit.
order.quantityRequiredstringOrder size in the market base unit.
order.limit_pricestringRequired for limit, stop_limit, and take_profit_limit.
order.trigger_pricestringRequired for stop and take-profit orders.
order.trigger_sourcestringPrice used by a conditional order. Values: mark, last, index.
order.trigger_venuestringExchange identifier from GET /v1/venues, such as binance, okx, bybit, hyperliquid, or dydx.
order.time_in_forcestringLimit orders: GTC, IOC, or FOK. Market orders: IOC. Default GTC for limit variants and IOC for market variants. Values: GTC, IOC, FOK.
order.post_onlybooleanDefault false. Supported on ordinary GTC limit orders; crossing orders are rejected.
order.reduce_onlybooleanDefault false. Restricts fills to reducing the current exchange position.
order.routingRequiredstringAuto chooses eligible exchanges; direct requires exactly one allowed exchange. Values: auto, direct.
order.venue_policyobject
order.venue_policy.allowedarrayOnly these exchanges may receive child orders.
order.venue_policy.excludedarrayExchanges excluded from routing; must be disjoint from allowed.
order.venue_policy.max_slippage_bpsstringMaximum market-order slippage from the consolidated best price at acceptance, in basis points. Execution stops at this boundary.
order.self_trade_preventionstringAction when orders from the same account would match. Default cancel_newest. Values: cancel_newest, cancel_oldest, cancel_both.
trade8_create_order Request
{
  "jsonrpc": "2.0",
  "id": "call-trade8_create_order",
  "method": "tools/call",
  "params": {
    "name": "trade8_create_order",
    "arguments": {
      "idempotency_key": "request-example-0001",
      "order": {
        "account_id": "acct_example_main",
        "client_order_id": "strategy-a-0001",
        "instrument": "BTC-PERP",
        "settlement_asset": "USDT",
        "side": "buy",
        "type": "limit",
        "quantity": "0.100",
        "limit_price": "77000.00",
        "time_in_force": "GTC",
        "post_only": true,
        "reduce_only": false,
        "routing": "auto",
        "venue_policy": {
          "allowed": [
            "binance",
            "bybit"
          ]
        },
        "self_trade_prevention": "cancel_newest"
      }
    },
    "_meta": {
      "io.modelcontextprotocol/protocolVersion": "2026-07-28",
      "io.modelcontextprotocol/clientInfo": {
        "name": "trade8-research-agent",
        "version": "1.0.0"
      },
      "io.modelcontextprotocol/clientCapabilities": {}
    }
  }
}
Result Example and Fields
trade8_create_order Result
{
  "jsonrpc": "2.0",
  "id": "call-trade8_create_order",
  "result": {
    "resultType": "complete",
    "content": [
      {
        "type": "text",
        "text": "{\"order_id\":\"ord_example_01\",\"account_id\":\"acct_example_main\",\"client_order_id\":\"strategy-a-0001\",\"instrument\":\"BTC-PERP\",\"settlement_asset\":\"USDT\",\"side\":\"buy\",\"type\":\"limit\",\"status\":\"accepted\",\"requested_quantity\":\"0.100\",\"filled_quantity\":\"0.000\",\"remaining_quantity\":\"0.100\",\"cancelled_quantity\":\"0.000\",\"average_fill_price\":null,\"revision\":1,\"created_at\":\"2026-08-31T12:00:00.000Z\",\"updated_at\":\"2026-08-31T12:00:00.000Z\"}"
      }
    ],
    "structuredContent": {
      "order_id": "ord_example_01",
      "account_id": "acct_example_main",
      "client_order_id": "strategy-a-0001",
      "instrument": "BTC-PERP",
      "settlement_asset": "USDT",
      "side": "buy",
      "type": "limit",
      "status": "accepted",
      "requested_quantity": "0.100",
      "filled_quantity": "0.000",
      "remaining_quantity": "0.100",
      "cancelled_quantity": "0.000",
      "average_fill_price": null,
      "revision": 1,
      "created_at": "2026-08-31T12:00:00.000Z",
      "updated_at": "2026-08-31T12:00:00.000Z"
    },
    "isError": false
  }
}
trade8_create_order Result Fields
FieldTypeDescription
order_idRequiredstringTrade8 parent order identifier.
account_idRequiredstringTrading account identifier within the authorized account grant.
client_order_idRequiredstringUnique client identifier within the account. Retain it for reconciliation.
instrumentRequiredstringNormalized perpetual family, for example BTC-PERP. Select a settlement asset and exchange to identify a contract.
settlement_assetRequiredstringAsset symbol, such as BTC, USDT, or USDC.
sideRequiredstringDirection. Values: buy, sell.
typeRequiredstringOrder type.
statusRequiredstringCurrent order lifecycle state. Values: pending, accepted, trigger_pending, partially_filled, filled, cancelled, rejected, expired.
requested_quantityRequiredstringTotal requested base quantity.
filled_quantityRequiredstringCumulative executed base quantity.
remaining_quantityRequiredstringQuantity still open or awaiting execution. Zero after a terminal state.
cancelled_quantityRequiredstringQuantity cancelled, rejected, or expired without a fill.
average_fill_priceRequiredstring | nullQuantity-weighted price of actual fills; null before the first fill.
revisionRequiredintegerMonotonic order revision. Use for optimistic concurrency and event reconciliation.
created_atRequiredstringUTC timestamp in RFC 3339 format.
updated_atRequiredstringUTC timestamp in RFC 3339 format.
Related REST Operation →

Cancel an Order

trade8_cancel_orderChanges Ordersorders:write

Request cancellation of the open remainder across its child orders. Track the final quantities through the orders channel or order lookup.

Requires trading permission and a confirmation step in your agent client. Preserve the idempotency key when recovering a timeout.

trade8_cancel_order Arguments
FieldTypeDescription
order_idRequiredstringIdentifier of the resource to read or change.
account_idRequiredstringAuthorized trading account.
idempotency_keyRequiredstringUnique 1–64 character key per account, method, and path. Retained for 24 hours. Reuse with the exact same request when recovering an unknown outcome.
trade8_cancel_order Request
{
  "jsonrpc": "2.0",
  "id": "call-trade8_cancel_order",
  "method": "tools/call",
  "params": {
    "name": "trade8_cancel_order",
    "arguments": {
      "order_id": "ord_example_01",
      "account_id": "acct_example_main",
      "idempotency_key": "request-example-0001"
    },
    "_meta": {
      "io.modelcontextprotocol/protocolVersion": "2026-07-28",
      "io.modelcontextprotocol/clientInfo": {
        "name": "trade8-research-agent",
        "version": "1.0.0"
      },
      "io.modelcontextprotocol/clientCapabilities": {}
    }
  }
}
Result Example and Fields
trade8_cancel_order Result
{
  "jsonrpc": "2.0",
  "id": "call-trade8_cancel_order",
  "result": {
    "resultType": "complete",
    "content": [
      {
        "type": "text",
        "text": "{\"order_id\":\"ord_example_01\",\"cancellation_status\":\"pending\",\"requested_at\":\"2026-08-31T12:00:00.000Z\"}"
      }
    ],
    "structuredContent": {
      "order_id": "ord_example_01",
      "cancellation_status": "pending",
      "requested_at": "2026-08-31T12:00:00.000Z"
    },
    "isError": false
  }
}
trade8_cancel_order Result Fields
FieldTypeDescription
order_idRequiredstringParent identifier.
cancellation_statusRequiredstringFollow the order stream or order lookup for the final quantities. Values: pending, completed.
requested_atRequiredstringUTC timestamp in RFC 3339 format.
Related REST Operation →

Account access

Jurisdiction Restriction

Trade8 is not available in your jurisdiction.

You can still explore the product and read the documentation.

Explore the Docs