Price History

Get Price History

GET

Retrieve historical price snapshots showing how a market's price has changed over time. Unlike OHLC, this returns raw snapshot data at regular intervals.

GET /api/v1/markets/{id}/market-history

Path Parameters

Parameter	Type	Description
`id`	string	Market UUID

Query Parameters

Parameter	Type	Default	Description
`limit`	number	100	Number of snapshots (max 500)
`from`	string	-	Start time (ISO 8601)
`to`	string	-	End time (ISO 8601)
`interval`	string	`auto`	Aggregation: `1h`, `4h`, `1d`, `auto`

Example

curl -H "Authorization: Bearer or_live_xxx" \
  "https://api.tessradar.com/api/v1/markets/{id}/market-history?limit=24&interval=1h"

Response

{
  "data": {
    "marketId": "e4ec57b5-94d1-4159-87c0-5bb6827928f7",
    "question": "Will Bitcoin reach $100k by end of 2026?",
    "exchange": "POLYMARKET",
    "snapshots": [
      {
        "timestamp": "2026-01-11T00:00:00.000Z",
        "yesPrice": 0.652,
        "noPrice": 0.348,
        "volume24h": 5524432,
        "liquidity": 926805
      },
      {
        "timestamp": "2026-01-10T23:00:00.000Z",
        "yesPrice": 0.648,
        "noPrice": 0.352,
        "volume24h": 5312000,
        "liquidity": 918500
      },
      {
        "timestamp": "2026-01-10T22:00:00.000Z",
        "yesPrice": 0.645,
        "noPrice": 0.355,
        "volume24h": 5215000,
        "liquidity": 912000
      }
    ],
    "priceChange24h": 0.012,
    "priceChangePercent24h": 1.88
  }
}

Snapshot Fields

Field	Type	Description
`timestamp`	string	Snapshot time (ISO 8601)
`yesPrice`	number	Yes outcome price (0-1)
`noPrice`	number	No outcome price (0-1)
`volume24h`	number	24h volume at snapshot time
`liquidity`	number	Liquidity at snapshot time

Cost: 1 credit per request

Price History vs OHLC: Price history shows raw snapshots, while OHLC aggregates into candlesticks. Use price history for simple line charts, OHLC for technical analysis.