Historical Polymarket prediction-market events via x402 micropayment at $0.01/call.
What it does
This endpoint returns historical event data from Polymarket, the popular prediction-market platform. It is hosted on the x402-tools server at `x402-tools.vercel.app` and protected by the x402 protocol, meaning callers pay per request with no account or subscription required.
Supported optional query/body parameters include `limit`, `offset`, `slug`, `tag_slug`, `endDateMin`, and `endDateMax`, allowing filtering and pagination of past Polymarket events. The price per call is $0.01 (one US cent), settled on-chain via x402. The endpoint responds to POST requests and returned a valid 402 payment challenge during probing, confirming it is live.
Documentation beyond the landing-page summary is not available — the `/docs` path returns 404 and no OpenAPI spec was found. The response schema, exact field names, and supported payment tokens/chains are not documented in the crawled material, so callers should experiment or inspect the 402 challenge headers for payment details.
Capabilities
Use cases
- —Retrieve historical prediction-market outcomes for research or backtesting
- —Filter past Polymarket events by tag, slug, or date range
- —Build dashboards or analytics on resolved prediction markets
- —Feed historical market data into AI agents for decision-making
Fit
Best for
- —Developers building prediction-market analytics tools
- —AI agents that need on-demand historical event data without account setup
- —Researchers studying prediction-market accuracy over time
Not for
- —Real-time or live-streaming market price feeds
- —Placing trades or interacting with Polymarket contracts directly
- —Users who need free, bulk data exports
Quick start
curl -X POST https://x402-tools.vercel.app/api/polymarket/historical \
-H "Content-Type: application/json" \
-H "X-Payment: <x402_payment_token>" \
-d '{"limit": 5, "tag_slug": "politics"}'Example
Request
{
"limit": 5,
"offset": 0,
"tag_slug": "politics",
"endDateMax": "2024-12-31",
"endDateMin": "2024-01-01"
}Endpoint
Quality
The endpoint is confirmed live (402 challenge returned on POST) and the landing page documents the purpose, parameters, and price. However, there is no OpenAPI spec, no response schema, no detailed docs, and the 402 challenge body was empty, leaving payment details (token, chain, exact amount in base units) unknown.
Warnings
- —No OpenAPI or formal schema available; parameter names and response format are inferred from the landing page only.
- —The 402 challenge object was empty — payment token, chain, and exact base-unit amount could not be verified from the probe.
- —No /docs page exists (returns 404).
Citations
- —Endpoint is listed as /api/polymarket/historical with optional params limit, offset, slug, tag_slug, endDateMin, endDateMax at $0.01 per callhttps://x402-tools.vercel.app
- —x402 is a protocol for accountless payments where clients pay per API callhttps://x402-tools.vercel.app
- —The endpoint returned HTTP 402 on POST, confirming it is livehttps://x402-tools.vercel.app/api/polymarket/historical