MCP tool reference · #477 of 563 by publishers
get_candles
Exposed by 8 servers from 8 publishers, read from the live servers by the Serverdex check; most of them sit in Finance; 87.5% of them take a limit parameter; the most-starred is CoinRithm Agent Trading (4 stars).
get_candles(limit?: integer, symbol: string, interval?: string, market: string, resolution: string, …)Parameters
share = % of the 8 servers whose schema has it · required = % of those that mark it required| Parameter | Type | Share | Required | Usual description |
|---|---|---|---|---|
| limit | integer | 87.5% | 0% | Default 100; max 300 for okx |
| symbol | string | 50% | 75% | Hyperliquid perp ticker, e.g. BTC, ETH, kPEPE; HIP-3 builder-dex perps as dex:TICKER, e.g. xyz:TSLA; for venue=okx a spot base ticker, e.g. PEPE |
| interval | string | 37.5% | 0% | Candle interval (1m, 5m, 15m, 1h, 4h, 1d). Default: 1h |
| market | string | 37.5% | 100% | Market ticker, e.g. BTC-USD |
| resolution | string | 25% | 50% | candle length (default 1h) |
| timeframe | string | 25% | 50% | — |
| agentTrace | object | 12.5% | 0% | Optional private trace metadata stored in the caller's ledger. |
| before | — | 12.5% | 0% | — |
| coinId | string | 12.5% | 100% | Coin UCID (e.g. "1" = BTC). Use resolve_symbol to find it. |
| end | string | 12.5% | 0% | Hyperliquid only: end time, epoch ms or YYYY-MM-DD / ISO 8601 UTC |
| end_user_id | — | 12.5% | 0% | — |
| fiat | string | 12.5% | 0% | Quote currency for o/h/l/c (default USD). |
Source: the input schema each server returns for get_candles, aggregated over the 8 index-tier servers; type and description are the values most servers use. Rebuilt every 6 hours.
Servers with get_candles
8 of 8 · 8 publishers · 8 answering live · most-starred first, 3 per publisher| # | Server | Publisher | Category | ★ | Live | How it describes get_candles |
|---|---|---|---|---|---|---|
| 1 | CoinRithm Agent Tradingcoinrithm · Finance | coinrithm | Finance | 4 | yes | OHLCV candles for indicator/momentum strategies (RSI, moving averages, breakouts) — resolve_symbol first to get the coinId. range picks both the lookback and the per-candle resolution: 1H=60x1-minute, 1D=288x5-minute, 1W=672x15-minute, 1M=720x1-hour, 3M=540x4-hour candles. Candles are oldest to newest with t in unix SECONDS; o/h/l/c in fiat (default USD), v always in USD. These are sampled composi |
| 2 | TraderSpytarget1m · Finance | target1m | Finance | 3 | yes | Get OHLCV (Open, High, Low, Close, Volume) candle data for a crypto futures symbol. Useful for charting, price history, and technical analysis. |
| 3 | Ironflow: Hyperliquid dataironflowsh · Crypto & Web3 | ironflowsh | Crypto & Web3 | 1 | yes | How has a Hyperliquid market's price moved? OHLCV candles of one market, built from every trade: open, high, low, close, volume and trade count per candle, oldest first. For only the current price use get_price; for individual trades use get_recent_trades. |
| 4 | Vordium MCPvordium · Finance | vordium | Finance | — | yes | Price candles (open, high, low, close, volume) for one market. Ask: "How did ETH move over the last day?" |
| 5 | cryptofeed402stovepipes55-jpg · Content & Publishing | stovepipes55-jpg | Content & Publishing | — | yes | Use when you need OHLCV candles for a Hyperliquid perp or OKX spot pair for charting or indicators. OHLCV candles API ($0.003/call, USDC on Base via x402): any Hyperliquid perp (venue=hyperliquid default; main dex + HIP-3; 1m to 1M intervals; limit 1-500, default 100; optional end for older candles) or any OKX USDT spot pair (venue=okx; limit 1-300; most recent only). Each candle: open time, close |
| 6 | Swiftedge order flownicklasandersson91-png · Finance | nicklasandersson91-png | Finance | — | yes | OHLC candles with volume split into aggressive buying and selling, delta per candle and cumulative volume delta (CVD). |
| 7 | Adona Robot market dataadona-robot · Finance | adona-robot | Finance | — | yes | Candle history for one symbol, one page, oldest first, with your API key in the request's Authorization header (Bearer adk_live_... or adk_test_...) or in its X-API-Key header (adk_live_..., for a client or gateway that keeps Authorization for itself; two different keys are refused with CONFLICTING_API_KEYS). Billed like GET /v1/candles: slices of 1000 bars, rounded up, an empty page costs nothing |
| 8 | Rubin Exchangerubin-trade · Finance | rubin-trade | Finance | — | yes | Get OHLCV candles for a market at a given resolution. Useful for trend/volatility analysis. |
Stars from GitHub as stored in the Serverdex index (re-read every 7 days per server); live = answered the last daily check of its hosted endpoint.