Prediction Hunt API

Orderbook

Live orderbook data proxied and normalized from source platforms. Returns the full bid/ask ladder for a given market. Kalshi, Polymarket, and Opinion are supported.

GET/v2/orderbook

Query Parameters

platformstringRequired

polymarket | kalshi | opinion (required).

market_idstringRequired

Platform-native market ID (required).

Response Schema

market_idstring

Platform-native market ID.

platformstring

Platform name.

timestampstring

Timestamp of the orderbook snapshot (ISO 8601).

yesobject

YES outcome orderbook.

bidsobject[]

Bid levels.

pricenumber

Price level.

sizenumber

Size/quantity at this level.

asksobject[]

Ask levels.

pricenumber

Price level.

sizenumber

Size/quantity at this level.

noobject

NO outcome orderbook.

bidsobject[]

Bid levels.

pricenumber

Price level.

sizenumber

Size/quantity at this level.

asksobject[]

Ask levels.

pricenumber

Price level.

sizenumber

Size/quantity at this level.

Authentication

API Key

To secure your requests, we strongly recommend passing your API key via the X-API-Key header. This prevents sensitive keys from being exposed in access logs or browser history.

Request HeaderX-API-Key: pmx_test_5e8f...

Rate Limits

API rate limits are enforced based on the tier associated with your API key. Limits are tracked on two dimensions: requests per second and requests per month. Only successful responses (where success is true) count toward your monthly quota.

Current usage is returned in every API response via the following headers:

Response HeadersX-RateLimit-Limit-Second: 10X-RateLimit-Remaining-Second: 9X-RateLimit-Limit-Month: 1000X-RateLimit-Remaining-Month: 842

If you exceed a rate limit, the API returns a 429 status with a Retry-After header indicating when you can resume.

Request

Live API Key

Demo Mode

Verified

Parameters

PlatformRequired

Market IDRequired

Response

Enter an API key and click "Try it now" to see the live response data.