public-pm-data

Probability history for up to five venue markets

Keyless probability history addressed by venue market id rather than by event: up to five Polymarket CLOB token ids or Kalshi tickers (an outcome's tokenId), or stored-history outcomes of the other venues. This is the series behind CoinRithm's event charts; for one outcome of an event, /event/{source}/{slug}/price-history is simpler.

Polymarket and Kalshi series come from the venue. When a venue request fails, the series is filled from CoinRithm's stored price snapshots instead and labelled: that market carries historySource: "stored_snapshots" and asOf, and the response carries freshness: {status: "lagging", reason: "upstream_unavailable", storedMarkets} and is cached for at most 30 seconds. Stored snapshots are written when the price changes, so they are sparser than the venue series. When every venue request fails and nothing is stored, the answer is 503 price_history_unavailable with Retry-After: 10. The route also has an in-flight cap: 503 temporarily_busy with Retry-After: 5. A 200 with markets: [] means the venue answered with no points.

Point times are unix SECONDS for Polymarket and MILLISECONDS for Kalshi and the stored-history venues; one response never mixes units. Only the parameters below are accepted; any other returns 400 unsupported_query_parameter.

get/api/prediction-markets/prices-history

Request

  • Base URL: https://api.coinrithm.com
  • URL: https://api.coinrithm.com/api/prediction-markets/prices-history
  • Auth: none required

Query parameters

marketsstring

Comma-separated venue market ids, 1-5 (more returns 400). One of markets, market or tokenIds is required; the first present is used.

marketstring

Alias of markets.

tokenIdsstring

Alias of markets.

source'polymarket' | 'kalshi' | 'rothera' | 'limitless' | 'smarkets' | 'manifold' | 'metaculus' | 'predictit' | 'futuur' | 'myriad' | 'forecastex' | 'gemini'

Venue slug, case-insensitive (default polymarket).

interval'1h' | '6h' | '1d' | '1w' | '1m' | 'max' | '24h' | '7d' | '30d' | 'all'

Lookback range (default 1w); aliases 24h, 7d, 30d and all mean 1d, 1w, 1m and max. Any other value returns 400 unless startTs and endTs are both set. Echoed as sent.

seriesTickerstring

Kalshi series ticker (event detail chartContext.seriesTicker). Required when source=kalshi, or 400.

eventIdstring

Venue event id. Required for the stored-history venues (every source except polymarket and kalshi), or 400.

fidelityinteger

Polymarket point spacing in minutes; raised to the venue minimum for the range.

startTsinteger

Custom range start, unix seconds. With endTs, replaces interval on Polymarket.

endTsinteger

Custom range end, unix seconds (default now).

Response

One series per market with points, live or labelled as stored

intervalstring required

The interval as sent (default 1w).

Changes

No recorded changes to this operation across all 1 revision of this API.