GET /v1/trades

Individual trade ticks from Polymarket, Kalshi, and Hyperliquid. Binance spot trade buckets are on GET /v1/flow.

Credits: Per OpenAPI (base + per row)

Tier (per OpenAPI): Free 7d · Pro 14d · Business 31d

Parameters

Parameter	Type	Required	Default	Description
`api-key`	string	Yes	—	`X-API-Key` header (recommended) or `api-key` query. Authentication.
`symbol`	string	Yes	—	Asset symbol (`BTC`, `ETH`, `SOL`, `XRP`) or, where supported, market slug / identifier (see OpenAPI).
`source`	string	No	—	Filter: `polymarket`, `kalshi`, `hyperliquid`. Omit per OpenAPI where “all” is implied.
`start`	string	No	—	ISO-8601 UTC.
`end`	string	No	—	ISO-8601 UTC.
`limit`	integer	No	`500`	Max rows (1–10000 per OpenAPI).
`after`	string	No	—	Cursor from `meta.next_cursor`.

Shortcuts: GET /v1/polymarket/trades, GET /v1/hyperliquid/trades — Platform routes.

Example

import requests

resp = requests.get(
    "https://kwery-api.com/v1/trades",
    headers={"X-API-Key": "YOUR_KEY"},
    params={
        "symbol": "BTC",
        "source": "hyperliquid",
        "start": "2026-03-08T14:00:00Z",
        "end": "2026-03-08T14:05:00Z",
        "limit": 5,
    },
)
data = resp.json()
print(data["data"][:3])

Query parameter alternative: api-key=YOUR_KEY on the URL.

Response

Typical row fields include timestamp, symbol, source, trade_id, price, size, side, optional maker_taker, optional market_id. Exact shape: TradesEnvelope in OpenAPI.

Errors

403 plan required, 422 validation, 429 rate limit — see Error codes.