Prediction Hunt — Compare Odds Across Every Platform

Status

Returns API status, ingestion health, and last-updated timestamps per platform. This endpoint is unauthenticated.

Free & Unlimited. This endpoint does not count toward your monthly usage limits on any plan.

GET/v2/status

Query Parameters

Response Schema

statusstring

Overall API status ("ok").

platformsobject

Per-platform ingestion health.

statusstring

"ok" if updated within 30 minutes, "stale" otherwise.

last_updatedstring

Timestamp of the last successful data ingestion (ISO 8601).

active_marketsinteger

Number of active markets on this platform.

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. Each completed request counts toward the global monthly quota. Separate endpoint-group monthly limits (matched markets, arbitrage, EV) only advance when the response body has success: true.

Usage is returned on responses via headers such as:

Response Headers (global)X-RateLimit-Limit-Second: 10X-RateLimit-Remaining-Second: 9X-RateLimit-Limit-Month: 1000X-RateLimit-Remaining-Month: 842Example (endpoint-group, when applicable)X-RateLimit-Limit-Arb-Month: 500X-RateLimit-Remaining-Arb-Month: 412

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