Prediction Market Research API
Prediction Market research searches and analyzes public Polymarket resources.
Every operation requires research and completes synchronously.
Operations
| Method | Path | Required scope | Purpose |
|---|---|---|---|
POST | /v1/research/prediction-market/analyze | research | Resolve and analyze one supported market URL |
GET | /v1/research/prediction-market/search | research | Search markets by text and platform |
GET | /v1/research/prediction-market/list | research | List markets with probability, horizon, and sort filters |
Platform and identity
The only supported platform value is polymarket. analyze requires an HTTPS
Polymarket URL and can infer the platform when omitted. Search/list results are
research records whose provider identifiers, URLs, probability, liquidity,
volume, and end-time fields preserve the upstream Polymarket contract.
Do not submit a display title as a market identity. Preserve the returned URL,
platform, slug, market/event ID, and outcome identifiers. A prediction-market
probability is not a guaranteed outcome or an order quote. For Polymarket
trading discovery, use api/market/polymarket and then validate the CLOB token
through the account/order contracts.
Failures
These endpoints use the API Server's shared Polymarket catalog synchronously.
Unavailable provider data returns a 502 upstream error, and a malformed
provider payload returns 502 UPSTREAM_PROTOCOL_ERROR. A selected event that
does not exist returns 404 NOT_FOUND. Validation failures such as unsupported
hosts or incompatible filters are client errors and should be corrected rather
than retried.