API ReferenceMarket Data
Fetch historical OHLCV candles for one venue outcome.
const url = 'https://data.predictefy.com/api/polymarket/fetchOHLCV?resolution=1s';const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request GET \ --url 'https://data.predictefy.com/api/polymarket/fetchOHLCV?resolution=1s' \ --header 'Authorization: Bearer <token>'M2 history endpoint. outcomeId is the canonical venue-native outcome id; id is accepted as a compatibility alias. The response keeps the normalized PriceCandle fields and adds honesty fields so clients can distinguish true candles from point-derived write-forward candles. router is not supported for history.
Authorizations
Section titled “Authorizations”Parameters
Section titled “Parameters”Path Parameters
Section titled “Path Parameters”One of the 16 served product venues, or router for the all-served-venues union.
Dark venues (currently: smarkets) are implemented but not served and return 404 EXCHANGE_NOT_AVAILABLE.
SX Bet serves catalog reads, real CLOB order books, the public trades tape, tape-derived candles, Trader Intelligence, and public account resources. It has no server execution lane; its separate client-side SDK trading lane is live as of 2026-07-27, and the trading wallet must have a registered sx.bet account with betting enabled once per token per network. There is no venue-official history claim.
pascal, xo and pred all serve catalog reads and real CLOB order books,
plus a public trades tape on pascal only — xo and pred answer
501 NOT_SUPPORTED for fetchTrades. XO's is a venue property rather than a gap: its
trade endpoints are caller-scoped, so no public XO tape exists to serve. None of
the three has an account or venue-official history lane. Their execution state
differs per venue and is no longer uniform:
- Pascal is ARMED in production for build, submit, and signed cancel permits (armed 2026-08-12; fleet-verified 2026-08-15).
- XO is REBUILT AND RE-ARMED for hosted build, submit, client-credentialed status
refresh, and cancel. Live
/v1/exec/venuesre-verification on 2026-09-02 reports build, submit, and cancel true; the first live credentialed submit and cancel remain confirmation checkpoints. - PRED is production-DARKED (2026-08-13) pending the venue's key model.
PRED_EXCHANGE_ADDRESSESis empty, which unregisters the entire lane, so every PRED execution route including build answers 404 VENUE_NOT_SUPPORTED.
PredictStreet serves keyless catalog/detail reads and real two-sided CLOB books. Its ADI Chain execution lane is armed for build and submit; it has no server cancel or hosted settlement lane. Predict Street Limited states it operates under Gibraltar licence 167, and FIFA names it the official prediction-market partner of the FIFA World Cup 2026.
Eligibility and jurisdiction remain an operator/compliance responsibility.
PRED restricts the US, UK, France, Ontario, Singapore, Poland, Thailand, and
Taiwan and prohibits location masking; pascal is US-restricted at the venue, and
XO read access is partner-provided. Pascal's restricted-jurisdiction and API/data
clauses are under owner review.
GET /v1/exec/venues remains the authoritative live list; this description is not
a claim about one deployment's runtime gates.
Query Parameters
Section titled “Query Parameters”Compatibility alias for outcomeId.
5m/15m/30m/4h/6h are aggregated at query time from stored history (source: derived, sourceType: rollup). Sub-minute tiers serve Predictefy-captured trade history (source: derived, sourceType: trade-derived); depth accrues from capture enablement.
ISO timestamp or epoch milliseconds.
ISO timestamp or epoch milliseconds.
Responses
Section titled “Responses”Price candles.
object
object
Unix timestamp in milliseconds for the candle bucket.
rest-derived means a coarse REST trade-tape candle; rollup means query-time aggregation of finer candles.
mixed means the bucket aggregates inputs of differing quality.
History-only metadata. provenance is a bare string (venue-native | predictefy-store | merged), a different field from the object-shaped provenance used by served records and other response metadata.
object
Venue-native means every returned bucket came from the venue; predictefy-store means every bucket came from stored history; merged means the response contains both.
Example
{ "data": [ { "source": "official", "sourceType": "true-candle", "quality": "ok" } ], "meta": { "provenance": "venue-native" }}The request was rejected before any work was done — an invalid query, path, or body parameter, a malformed JSON body, or a parameter combination this route cannot honestly serve. Not retryable.
object
object
Always present on errors; quote this id when reporting a failed request.
Present only when a venue error is attributed to a specific exchange.
Example
{ "success": false, "error": { "code": "VALIDATION_ERROR" }}UNAUTHORIZED — platform lane (READS_ENABLE_AUTH)
object
object
Always present on errors; quote this id when reporting a failed request.
Present only when a venue error is attributed to a specific exchange.
Example
{ "success": false, "error": { "code": "VALIDATION_ERROR" }}INSUFFICIENT_CREDITS — endpoint-weighted credits
object
object
Always present on errors; quote this id when reporting a failed request.
Present only when a venue error is attributed to a specific exchange.
Example
{ "success": false, "error": { "code": "VALIDATION_ERROR" }}SCOPE_MISSING — API key lacks the route's required scope (RBAC v1); PLAN_REQUIRED — the requested start or end reaches behind the plan's trailing history window
object
object
Always present on errors; quote this id when reporting a failed request.
Present only when a venue error is attributed to a specific exchange.
Example
{ "success": false, "error": { "code": "VALIDATION_ERROR" }}The route does not exist, or the requested venue, market, event, cluster, outcome, or snapshot was not found. error.code names which. Not retryable.
object
object
Always present on errors; quote this id when reporting a failed request.
Present only when a venue error is attributed to a specific exchange.
Example
{ "success": false, "error": { "code": "VALIDATION_ERROR" }}RATE_LIMITED — per-key rps limit
object
object
Always present on errors; quote this id when reporting a failed request.
Present only when a venue error is attributed to a specific exchange.
Example
{ "success": false, "error": { "code": "VALIDATION_ERROR" }}A dependency is temporarily unavailable — the catalog, history, matching, feeds, an upstream venue, or the platform store. Retryable.
object
object
Always present on errors; quote this id when reporting a failed request.
Present only when a venue error is attributed to a specific exchange.
Example
{ "success": false, "error": { "code": "VALIDATION_ERROR" }}