Skip to main content
GET
/
v1
/
candles
Get Candles
curl --request GET \
  --url https://api.polyquantlab.com/v1/candles \
  --header 'Authorization: Bearer <token>'
{
  "market_id": "0x4a8f31...c2",
  "timeframe": "5m",
  "count": 2,
  "candles": [
    {
      "ts": "2026-06-06T03:55:00+00:00",
      "open": 0.5,
      "high": 0.62,
      "low": 0.49,
      "close": 0.61,
      "volume": 3210.5,
      "trade_count": 47
    },
    {
      "ts": "2026-06-06T04:00:00+00:00",
      "open": 0.61,
      "high": 0.83,
      "low": 0.6,
      "close": 0.82,
      "volume": 5640.2,
      "trade_count": 84
    }
  ]
}

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

market_id
string
required
timeframe
string
required
Examples:

"5m"

"15m"

"1h"

"4h"

"24h"

start
string<date-time>
required
end
string<date-time>
required
limit
integer
default:1000
Required range: x <= 10000

Response

Successful Response

market_id
string
required

Polymarket market identifier (hex 0x…).

timeframe
enum<string>
required
Available options:
5m,
15m,
1h,
4h,
24h
count
integer<int64>
required
candles
object[]
required