Method - get_quotes
Returns one QuoteSnapshotDto (single mode) or a QuotesBulkSnapshotDto (bulk mode). See snapshot_kind in the JSON body.
Contract (arguments)
| Argument | Required | Default | Notes |
|---|---|---|---|
exchange | yes | — | e.g. Binance |
market | yes | — | spot or futures |
symbol | no | null | Single: e.g. BTCUSDT. Bulk: omit, "", *, or all (case-insensitive). |
waitSeconds | no | 20 | Single: clamped 5–90. Bulk: 5–45. |
maxSymbols | no | 40 | Bulk only, clamped 1–1000; ignored in single mode. |
Response shape
Single mode: one QuoteSnapshotDto — root includes "snapshot_kind":"single" plus watchlist-style fields (market_price, volume_24h, optional screener metrics when the overlay is active, futures funding fields on perpetuals, etc.).
Bulk mode: QuotesBulkSnapshotDto — "snapshot_kind":"bulk", plus exchange, market_type, trading_pairs_total, max_symbols, returned_count, truncated, and quotes (array of per-row objects, each with "snapshot_kind":"single"). Bulk fills last prices quickly; extended screener columns may be empty.
Example tools/call (single)
json
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "get_quotes",
"arguments": {
"exchange": "Binance",
"market": "spot",
"symbol": "BTCUSDT",
"waitSeconds": 15
}
}
}Example arguments (bulk only)
json
"arguments": {
"exchange": "Binance",
"market": "futures",
"maxSymbols": 10,
"waitSeconds": 15
}Example success body (fragment)
Inside the MCP tool result string (single):
json
{
"snapshot_kind": "single",
"display_symbol": "BTCUSDT",
"exchange": "Binance",
"market_type": "Spot",
"market_price": 98234.5,
"volume_24h": 1234567890.12,
"change_24h_percent": -1.25
}