Random live event
Returns one random market from the assignment-shaped live pool (24h–7d to end, outcome prices in the validator band, title does not contain denied substrings such as tweet). Handy for test/agent pipelines. Pass `seed` for deterministic selection. 404 when that pool is empty.
/v1/events/randomQuery Parameters
Non-negative seed for deterministic selection (offset = seed % poolSize).
Response Body
application/json
curl -X GET "https://example.com/v1/events/random"{ "id": "string", "source": "polymarket", "sourceMarketId": "string", "question": "string", "description": "string", "outcomes": [ { "outcomeId": "string", "name": "string" } ], "endDate": "2019-08-24T14:15:22Z", "startDate": "2019-08-24T14:15:22Z", "tagsAtAdmission": [ 0 ], "liquidityUsd": 0, "volumeUsd": 0, "volumeRecentUsd": 0, "currentLiquidityUsd": 0, "currentVolumeUsd": 0, "currentOutcomePrices": { "property1": 0, "property2": 0 }, "admittedAt": "2019-08-24T14:15:22Z", "lastSeenAt": "2019-08-24T14:15:22Z", "resolution": { "resolvedAt": "2019-08-24T14:15:22Z", "resolutionStatus": "unresolved", "winningOutcomeId": "string", "winningOutcomeName": "string", "finalOutcomePrices": { "property1": 0, "property2": 0 } }, "outcomePricesAtAdmission": { "property1": 0, "property2": 0 }}List events GET
Public keyset-paginated list of markets. Defaults to live (not-ended) markets ordered by endDate ASC, id ASC. The cursor is opaque; pass it back verbatim to fetch the next page.
Recently scored events GET
Resolved markets whose predictions have been scored, newest resolution first (by the source's resolvedAt), with each miner's result. pWin and brier are the exact per-event values the leaderboard scores (winning-outcome Brier, scorer rounding); invalid predictions carry nulls and sort last, and predictions without a uid are left out as the scorer leaves them out. The default query (no filters, limit 10, miners 10) is cached for 60s.