Crypto Historical Klines

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

CryptoHistoricalResult

required

Show CryptoHistoricalResult fields

string

required

The trading pair in BASE-QUOTE format (e.g. BTC-USD).

string

required

Candlestick interval (1h / 4h / 1d / 1w).

CryptoKlineBar[]

required

Klines in chronological order. Closed candles only.

Show CryptoKlineBar fields

number

required

Opening price.

number

required

High price.

number

required

Low price.

number

required

Closing price.

number

required

Base-asset trading volume.

string

required

Bar open time (ISO 8601 UTC).

number

Credits consumed (always 1).

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": { "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.

Use data.prices.length when you need the returned bar count; meta is reserved for credits and optional notices.

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

HTTP / SDK examples

// 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"
    }
  }
}

import os, requests

headers = {"Authorization": f"Bearer {os.environ['LLMQUANT_API_KEY']}"}

# Recent mode
resp = requests.get(
    "https://api.llmquantdata.com/api/crypto/historical",
    headers=headers,
    params={"ticker": "BTC-USD", "interval": "1d", "limit": 30},
).json()
for bar in resp["data"]["prices"]:
    print(f"{bar['time']}  C={bar['close']}  V={bar['volume']}")

# Range mode
resp = requests.get(
    "https://api.llmquantdata.com/api/crypto/historical",
    headers=headers,
    params={
        "ticker": "ETH-USD",
        "interval": "1h",
        "start_time": "2026-03-01T00:00:00Z",
        "end_time": "2026-03-02T00:00:00Z",
    },
).json()
print(f"Range mode returned {len(resp['data']['prices'])} bars")

# Recent mode
curl "https://api.llmquantdata.com/api/crypto/historical?ticker=BTC-USD&interval=1d&limit=30" \
  -H "Authorization: Bearer $LLMQUANT_API_KEY"

# Range mode
curl "https://api.llmquantdata.com/api/crypto/historical?ticker=ETH-USD&interval=1h&start_time=2026-03-01T00:00:00Z&end_time=2026-03-02T00:00:00Z" \
  -H "Authorization: Bearer $LLMQUANT_API_KEY"

Full parameter reference

crypto_historical_klines — request parameters

string

required

Trading pair in BASE-QUOTE format. Examples: BTC-USD, ETH-USD, SOL-USD.

string

required

Candlestick interval. One of 1h, 4h, 1d, 1w. Minute-level intervals are not supported.

Recent mode
Range mode

Pass limit only (or omit it for the interval default). Returns the most recent N closed candles.

integer

Number of recent candles. Defaults vary by interval: 1h = 24, 4h = 42, 1d = 30, 1w = 12. Max 200.

Pass start_time and end_time together. Returns all closed candles in the inclusive range.

string

required

Start of time range in ISO 8601 UTC (e.g. 2026-03-01T00:00:00Z). Must be paired with end_time.

string

required

End of time range in ISO 8601 UTC. Must be paired with start_time.

integer

Optional safety cap on returned bars (max 200). In Range mode limit is only a guard; the time window drives selection.

Passing only start_time or only end_time returns a 400 error.

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.

Getting Started

Connect

Personal Context

Knowledge Data

Crypto Prices

Prediction Markets

Equity Prices

ETF

Macro Indicators

SEC Filings

News

SEC Form 13F

Crypto Historical Klines

What it does for your agent

Response

Notes

Direct invocation

Full parameter reference

Crypto Snapshot

Equity Historical Prices

​What it does for your agent

​Response

​Notes

​Direct invocation

​Full parameter reference

​Related

Crypto Snapshot

Equity Historical Prices

What it does for your agent

Response

Notes

Direct invocation

Full parameter reference

Related