GET /v1/limits

Returns your current plan details, credit usage, rate limits, and feature flags.

Minimum tier: Free | Credits: 0 (free — safe to poll)

GET https://kwery-api.com/v1/limits?api-key=YOUR_KEY

Parameters

Parameter	Type	Required	Default	Description
`api-key`	string	Yes	—	Your API key. Passed as a query parameter.

Response fields

The response is returned directly (not wrapped in data / meta).

Field	Type	Description
`plan`	`string`	Current plan name: `free`, `pro`, `business`, or `enterprise`.
`credits`	`object`	Credit usage for the current billing cycle.
`credits.used`	`integer`	Credits consumed so far.
`credits.limit`	`integer`	Total credits available per cycle.
`credits.remaining`	`integer`	Credits remaining (`limit - used`).
`rate_limits`	`object`	Request quotas.
`rate_limits.requests_per_minute`	`integer`	Maximum requests allowed per minute.
`rate_limits.requests_per_hour`	`integer`	Maximum requests allowed per hour.
`rate_limits.current_minute`	`integer`	Requests made in the current minute window.
`rate_limits.current_hour`	`integer`	Requests made in the current hour window.
`features`	`object`	Boolean flags for gated features.
`features.orderbook_snapshots`	`boolean`	Access to Polymarket order book depth.
`features.binance_1s_ticker`	`boolean`	Access to Binance 1-second ticker data.
`features.kalshi_orderbook`	`boolean`	Access to Kalshi order book depth.
`features.trade_ticks`	`boolean`	Access to raw trade tick data.
`features.snapshots_500ms`	`boolean`	Access to 500ms snapshot intervals.
`features.include_diffs`	`boolean`	Access to incremental order book diffs.
`features.min_usd_liquidations`	`boolean`	Access to filtered USD liquidation feeds.
`max_rows_per_request`	`integer`	Maximum rows a single request can return.
`max_history_days`	`integer`	Maximum number of days of historical data available.

Response headers

Header	Description
`X-Credits-Charged`	Always `0` for this endpoint.
`X-RateLimit-Remaining`	Requests remaining in the current rate-limit window.
`X-RateLimit-Reset`	ISO 8601 timestamp when the rate-limit window resets.

Example request

cURL

curl "https://kwery-api.com/v1/limits?api-key=YOUR_KEY"

Python

import requests

resp = requests.get("https://kwery-api.com/v1/limits", params={
    "api-key": "YOUR_KEY",
})
data = resp.json()
print(f"Credits remaining: {data['credits']['remaining']}")

TypeScript

const res = await fetch(
  `https://kwery-api.com/v1/limits?api-key=YOUR_KEY`
);
const data = await res.json();
console.log(`Credits remaining: ${data.credits.remaining}`);

Example response

{
  "plan": "pro",
  "credits": {
    "used": 142350,
    "limit": 1000000,
    "remaining": 857650
  },
  "rate_limits": {
    "requests_per_minute": 50,
    "requests_per_hour": 3000,
    "current_minute": 12,
    "current_hour": 487
  },
  "features": {
    "orderbook_snapshots": true,
    "binance_1s_ticker": true,
    "kalshi_orderbook": true,
    "trade_ticks": false,
    "snapshots_500ms": false,
    "include_diffs": false,
    "min_usd_liquidations": false
  },
  "max_rows_per_request": 1000,
  "max_history_days": 365
}

Source-specific behavior

This endpoint is source-agnostic. Feature flags apply globally across all sources — for example, orderbook_snapshots: true unlocks order book data on both Polymarket and Kalshi endpoints.

Errors

Status	Code	Description
`401`	`unauthorized`	Missing or invalid `api-key`.
`429`	`rate_limit_exceeded`	You have exceeded your per-minute or per-hour request quota.