Aggregated Polymarket prediction market category statistics via Nansen's on-chain analytics API.
What it does
This endpoint returns aggregated statistics for all Polymarket prediction market categories. Each category record includes the number of active markets, total open interest, total volume (all-time, 24h, 1-week), unique traders in 24h, and the top market by 24h volume with its question and volume. The data is sourced from on-chain activity on Polygon.
The endpoint is part of Nansen's broader API (v1), which covers blockchain analytics including smart money tracking, wallet profiling, token screening, DEX trades, PnL analysis, and prediction market intelligence across multiple chains. This specific endpoint accepts a POST request with an optional pagination body. It costs 10 credits on the free tier or 1 credit on the pro tier per call, and supports x402 pay-per-request at $0.01 per call. The MPP probe returned HTTP 402, confirming the endpoint is live and gated behind payment.
Pagination is supported via `page` and `per_page` parameters (max 1000 per page). Responses include standard rate-limit headers (per-second and per-minute) and credit usage headers. Authentication is via an `apiKey` header, or payment can be made through the x402 protocol.
Capabilities
Use cases
- —Discover which prediction market categories (e.g., Politics, Crypto, Sports) have the most trading activity
- —Compare open interest and volume across Polymarket categories to identify trending topics
- —Build dashboards showing prediction market category breakdowns with top markets per category
- —Automate monitoring of category-level volume changes for trading signals
- —Feed category-level data into agents that route users to high-activity prediction markets
Fit
Best for
- —Agents or dashboards needing a high-level overview of Polymarket activity by category
- —Researchers analyzing prediction market trends across topic areas
- —Traders looking for the most liquid or active prediction market categories
Not for
- —Getting individual market-level detail (use market-screener or event-screener endpoints instead)
- —Non-Polymarket prediction platforms — this endpoint is Polymarket-specific
- —Free unlimited access — requires Nansen API key or x402 payment
Quick start
curl -X POST https://api.nansen.ai/api/v1/prediction-market/categories \
-H 'Content-Type: application/json' \
-H 'apiKey: YOUR_NANSEN_API_KEY' \
-d '{"pagination": {"page": 1, "per_page": 10}}'Example
Request
{
"pagination": {
"page": 1,
"per_page": 10
}
}Response
{
"data": [
{
"category": "Politics",
"total_volume": 85000000,
"top_market_id": "654412",
"active_markets": 42,
"total_volume_1wk": 8500000,
"total_traders_24h": 350,
"total_volume_24hr": 1200000,
"top_market_question": "Will candidate X win the election?",
"total_open_interest": 15000000,
"top_market_volume_24hr": 450000
}
],
"pagination": {
"page": 1,
"per_page": 10,
"is_last_page": false
}
}Endpoint
Quality
Full OpenAPI 3.1 schema with detailed request/response models, clear pricing ($0.01/call via x402, 1 credit on pro), and a confirmed live 402 MPP challenge. Docs pages on the origin returned 404 but the OpenAPI spec is comprehensive. Minor gap: no standalone crawled documentation page for this specific endpoint beyond the spec.
Warnings
- —No dedicated human-readable docs page found at api.nansen.ai/docs (returns 404); all documentation is inferred from the OpenAPI spec.
- —The example response is synthesized from the schema — no actual sample response was captured from the probe.
Citations
- —The endpoint costs 10 credits (free) or 1 credit (pro) per call and supports x402 at $0.01.https://api.nansen.ai
- —The endpoint returns category, active_markets, total_open_interest, total_volume, total_volume_24hr, total_volume_1wk, total_traders_24h, top_market_id, top_market_question, and top_market_volume_24hr fields.https://api.nansen.ai
- —The MPP probe returned HTTP 402, confirming the endpoint is live.https://api.nansen.ai/api/v1/prediction-market/categories
- —Nansen API v1 uses apiKey header authentication and OpenAPI 3.1.0.https://api.nansen.ai