API referenceEvents
Random live event
Returns one random not-ended, unresolved market — handy for test/agent pipelines. Pass `seed` for deterministic selection. 404 when the live pool is empty.
GET
/v1/events/randomQuery Parameters
seed?number
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 } }}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.
Get the org's prepaid credit balance GET
Returns the prepaid balance (micro-credits) for the API key's org, plus the timestamp of the org's most recent usage event — useful for detecting stalled mining or automation. Read-only and free — no credits are charged.