Skip to main content
Available as MCP tool: crypto_historical_klines — call directly from Claude / Cursor / any MCP client. See MCP Server for the 60-second setup.
Live   1 credit per call

​
What it does for your agent

crypto_historical_klines returns OHLCV candlestick bars for a single crypto pair. Use it as the historical pricing primitive an agent reaches for whenever it needs returns, drawdowns, technicals, or backtest data — not for the latest tick (use crypto_snapshot for that). Two query modes share one endpoint: pass limit to get the most recent N closed candles, or pass start_time + end_time for an exact window. Only closed candles are returned — the in-progress candle is never included.

​
Response

​
data
CryptoHistoricalResult
required
​
meta.count
number
Number of bars returned.
​
meta.creditsUsed
number
Credits consumed (always 1).
​
meta.remainingCredits
number
Account credits remaining.
200 OK · crypto_historical_klines
{
  "data": {
    "ticker": "BTC-USD",
    "interval": "1d",
    "prices": [
      {
        "open": 87000.50,
        "high": 87500.00,
        "low": 86800.00,
        "close": 87200.00,
        "volume": 1234.56,
        "time": "2026-03-01T00:00:00Z"
      },
      {
        "open": 87200.00,
        "high": 88100.00,
        "low": 87000.00,
        "close": 87950.00,
        "volume": 1456.78,
        "time": "2026-03-02T00:00:00Z"
      }
    ]
  },
  "meta": { "count": 2, "creditsUsed": 1, "remainingCredits": 99 }
}

​
Notes

For the latest tick (price + 24h change), use crypto_snapshot — it’s a different primitive and is much cheaper conceptually. Reach for crypto_historical_klines only when you need a series of bars.
The first request for a ticker + interval + range can be slower. Subsequent identical queries usually return faster.
Spot markets only. Futures, perpetuals, funding rates, and open interest are not exposed.
No minute-level intervals. 1m, 5m, 15m are not supported — only 1h, 4h, 1d, 1w.
Closed candles only. The current in-progress candle is never included.

​
Direct invocation

// Recent mode — last 30 daily candles
{
  "method": "tools/call",
  "params": {
    "name": "crypto_historical_klines",
    "arguments": { "ticker": "BTC-USD", "interval": "1d", "limit": 30 }
  }
}

// Range mode — explicit window
{
  "method": "tools/call",
  "params": {
    "name": "crypto_historical_klines",
    "arguments": {
      "ticker": "ETH-USD",
      "interval": "1h",
      "start_time": "2026-03-01T00:00:00Z",
      "end_time": "2026-03-02T00:00:00Z"
    }
  }
}

​
Full parameter reference

​
ticker
string
required
Trading pair in BASE-QUOTE format. Examples: BTC-USD, ETH-USD, SOL-USD.
​
interval
string
required
Candlestick interval. One of 1h, 4h, 1d, 1w. Minute-level intervals are not supported.
Pass limit only (or omit it for the interval default). Returns the most recent N closed candles.
​
limit
integer
Number of recent candles. Defaults vary by interval: 1h = 24, 4h = 42, 1d = 30, 1w = 12. Max 200.

Crypto Snapshot

Latest spot price + 24h stats for a crypto pair — use this when you only need “right now”.

Equity Historical Prices

Same Recent / Range shape for US equities at daily granularity.