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). Use start_time and/or end_time to filter the candidate window, then limit and take_from choose which edge to keep. Results always return oldest first. 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.

string

Present only when the candidate window held more bars than were returned — i.e. limit truncated the result. The message tells the agent to narrow the window or split the query: More data exists in the requested window than the items returned; narrow the window or split the query to see more.

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

// No time boundaries — the most recent 30 daily candles
{
  "method": "tools/call",
  "params": {
    "name": "crypto_historical_klines",
    "arguments": { "ticker": "BTC-USD", "interval": "1d", "limit": 30 }
  }
}

// Earliest 12 candles inside an 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",
      "limit": 12,
      "take_from": "earliest"
    }
  }
}

import os, requests

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

# No time boundaries — most recent candles
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']}")

# Earliest 12 candles inside a bounded window
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",
        "limit": 12,
        "take_from": "earliest",
    },
).json()
print(f"Bounded query returned {len(resp['data']['prices'])} bars")

# No time boundaries — most recent candles
curl "https://api.llmquantdata.com/api/crypto/historical?ticker=BTC-USD&interval=1d&limit=30" \
  -H "Authorization: Bearer $LLMQUANT_API_KEY"

# Earliest 12 candles inside a bounded window
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&limit=12&take_from=earliest" \
  -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.

string

Optional inclusive lower boundary in ISO 8601 UTC (e.g. 2026-03-01T00:00:00Z).

string

Optional inclusive upper boundary in ISO 8601 UTC.

integer

Maximum candles to return after boundary filtering. Defaults vary by interval: 1h = 24, 4h = 42, 1d = 30, 1w = 12. Max 200.

string

default:"latest"

Which side of the filtered window to keep when more than limit candles match. Use latest or earliest; output remains chronological.

take_from=earliest requires start_time. If both time boundaries are provided, start_time must not be after end_time.

Crypto Snapshot

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

Equity Historical Prices

Same bounded historical-series 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