Skip to main content

This page is the single source of truth for what each plan can access.

History depth by endpoint

Maximum time range you can query by endpoint and plan:

EndpointFreeProBusiness / Enterprise
/v1/candles14 days6 monthsFull archive
/v1/orderbook7 days6 monthsFull archive
/v1/trades7 days6 monthsFull archive
/v1/funding7 days6 monthsFull archive
/v1/open-interest7 days6 monthsFull archive
/v1/liquidations1 day6 monthsFull archive
/v1/oracle14 days6 monthsFull archive
/v1/snapshots/{id}7 days6 monthsFull archive
/v1/snapshots/{id}/at7 days6 monthsFull archive
/v1/derived7 days6 monthsFull archive
/v1/marketsActive onlyAllAll
/v1/statusOpenOpenOpen
/v1/limitsOpenOpenOpen
/v1/sourcesOpenOpenOpen
/v1/symbolsOpenOpenOpen

Locked means the endpoint returns 403 plan_required. Open means no history restriction. Full archive means data from the earliest date Kwery has for that source.

If you request a range beyond your plan’s depth, the API returns only data within the allowed window (truncated at the boundary; no error).

Candle interval restrictions

TierAllowed intervals
Free15m, 1h, 4h, 24h
Pro5m, 15m, 1h, 4h, 1d, 24h
Business+All (including 1s)

Requesting an unavailable interval returns 403 plan_required with required_tier and upgrade_url.

Feature gates

FeatureFreeProBusinessEnterprise
OHLCV candles
Funding rates
Open interest
Oracle data
Liquidation events
Trade ticks
Snapshots (no OB)
Derived metrics
Pipeline status
Market discoveryActive onlyAllAllAll
Kalshi market discovery via /v1/markets
include_orderbook=true
Binance 1s ticker
Kalshi orderbook
min_usd filter
include_diffs (orderbook)
500ms snapshot intervals
1s candle intervals
Bulk export / custom limits / SLA

Max rows per response

PlanMax rows
Free100
Pro1,000
Business2,500
Enterprise10,000

When the result set exceeds this cap, the response is truncated, X-Rows-Capped is true, and meta.next_cursor is set for the next page. See Pagination.

Rate limits

PlanRequests/minuteRequests/hour
Free15600
Pro503,000
Business1509,000
EnterpriseCustomCustom

Credit budgets

PlanMonthly credits
Free150,000
Pro1,500,000
Business10,000,000
EnterpriseCustom

For cost per endpoint, see Credits. For headers and 429 handling, see Rate Limits.