GETGet Price History
Retrieve historical price data for a specific outcome. Polymarket-compatible format with unix timestamps and configurable fidelity.
Request
GET /v1/markets/:id/prices-history
Path Parameters
| Parameter | Type | Required | Description |
|---|
id | string | Yes | Market UUID |
Query Parameters
| Parameter | Type | Required | Default | Description |
|---|
outcomeId | string | Yes | — | Outcome ID to get price history for |
startTs | number | No | 1 week ago | Start unix timestamp (seconds) |
endTs | number | No | now | End unix timestamp (seconds) |
fidelity | number | No | 1 | Data fidelity in minutes. Higher values produce fewer data points. |
Response
{
"history": [
{ "t": 1710000000, "p": 0.67 },
{ "t": 1710000300, "p": 0.68 },
{ "t": 1710000600, "p": 0.665 }
]
}
Response Fields
| Field | Type | Description |
|---|
history | array | Array of price points |
history[].t | number | Unix timestamp (seconds) |
history[].p | number | Closing price for the interval (0-1) |
Notes
- Price data is generated from filled and partially filled orders
- Each data point represents the closing price within the fidelity interval
- Higher fidelity values produce fewer, more aggregated data points
- Use
fidelity=5 for 5-minute candles, fidelity=60 for hourly, etc.
Errors
| Status | Description |
|---|
400 | Missing outcomeId or outcome does not belong to market |
404 | Market or outcome not found |
Examples
Last 24 hours with 5-minute fidelity
curl "https://api.conviction.bet/v1/markets/550e8400-e29b-41d4-a716-446655440000/prices-history?outcomeId=outcome-uuid-1&startTs=1709913600&endTs=1710000000&fidelity=5"
Last week with default fidelity
curl "https://api.conviction.bet/v1/markets/550e8400-e29b-41d4-a716-446655440000/prices-history?outcomeId=outcome-uuid-1"