Skip to content

Method - search_instruments

Prefix search over loaded trading pairs. Response is metadata onlyno live prices.


Contract (arguments)

ArgumentRequiredDefaultNotes
queryyesDisplay-symbol prefix, e.g. BTC
exchangeno"all"One exchange name or all
maxResultsno20Clamped 1–50

Response shape

Returns a JSON array of InstrumentSearchResultDto (display_symbol, symbol, base_asset, quote_asset, exchange, market_type, filters, fees, etc.) — no live prices.


Example tools/call

json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "search_instruments",
    "arguments": {
      "query": "SOL",
      "exchange": "Binance",
      "maxResults": 5
    }
  }
}

Example success (fragment)

json
[
  {
    "display_symbol": "SOLUSDT",
    "base_asset": "SOL",
    "quote_asset": "USDT",
    "exchange": "Binance",
    "market_type": "Spot",
    "is_trading": true
  }
]

← MCP overview