Skip to main content
GET
/
v1
/
api
/
markets
/
price-history
Get market price history
curl --request GET \
  --url https://api.dotprediction.io/v1/api/markets/price-history \
  --header 'X-API-Key: <api-key>'
{
  "data": [
    {
      "timestamp": 123,
      "platform": "<string>",
      "marketId": "<string>",
      "volume": 123,
      "openInterest": 123,
      "outcomeId": "<string>",
      "price": {
        "open": 123,
        "high": 123,
        "low": 123,
        "close": 123
      },
      "bidAsk": {
        "bid": {
          "open": 123,
          "high": 123,
          "low": 123,
          "close": 123
        },
        "ask": {
          "open": 123,
          "high": 123,
          "low": 123,
          "close": 123
        }
      }
    }
  ],
  "meta": {
    "total_points": 123,
    "platforms": [
      "<string>"
    ],
    "time_range": {
      "start": 123,
      "end": 123
    },
    "interval": "<string>",
    "request_time": 123,
    "cache_hit": true,
    "data_freshness": "<string>"
  }
}

Authorizations

​
X-API-Key
string
header
required

API key for authentication. Generate one via the dashboard or the /v1/api/auth/api-keys endpoint.

Query Parameters

​
market_ids
string
required

Comma-separated list of market IDs (maximum 10).

​
start_ts
integer<int64>
required

Start timestamp (Unix epoch).

​
end_ts
integer<int64>
required

End timestamp (Unix epoch).

​
provider
enum<string>
required

The prediction market platform to query.

Available options:
kalshi,
polymarket,
limitless
​
interval
enum<integer>

Candlestick interval in minutes. 1 = 1 minute, 60 = 1 hour, 1440 = 1 day.

Available options:
1,
60,
1440
​
limit
integer

Maximum number of data points to return (max 5000).

Required range: x <= 5000

Response

Price history data points.

​
data
object[]
​
meta
object