Skip to main content
GET
/
api
/
{exchange}
/
fetchOHLCV
import pmxt
from datetime import datetime, timezone

# API key optional — enables faster catalog-backed lookups
exchange = pmxt.Polymarket(
    pmxt_api_key="YOUR_PMXT_API_KEY",
)
result = exchange.fetch_ohlcv(
    "67890",
    resolution="1h",
    start=datetime(2026, 1, 1, tzinfo=timezone.utc),
    end=datetime(2026, 1, 31, tzinfo=timezone.utc),
    limit=10,
)
{
  "success": true,
  "error": {
    "message": "<string>",
    "retryable": true,
    "exchange": "<string>",
    "detail": {}
  },
  "data": [
    {
      "timestamp": 123,
      "open": 123,
      "high": 123,
      "low": 123,
      "close": 123,
      "volume": 123
    }
  ]
}
Hosted and self-hosted data depth — Hosted api.pmxt.dev calls require a PMXT API key. If you omit the key, SDK calls route through your local pmxt-core process and use venue-native APIs. fetchOHLCV returns normalized PriceCandle rows for venues whose implementation supports fetchOHLCV; history length, volume, and rate limits remain venue-specific. Check Feature Support & Compliance for the current matrix. Get your API key.

​
Use cases

​
Get hourly candles for a market

import pmxt

# Hosted route: include pmxt_api_key. Omit it for self-hosted/local pmxt-core.
api = pmxt.Polymarket(pmxt_api_key="YOUR_PMXT_API_KEY")
market = api.fetch_market(slug="will-alexandria-ocasio-cortez-win-the-2028-us-presidential-election")

candles = api.fetch_ohlcv(market.yes, resolution="1h", limit=100)
for c in candles:
    print(f"{c.open:.2f}  {c.high:.2f}  {c.low:.2f}  {c.close:.2f}  V:{c.volume}")

Path Parameters

​
exchange
enum<string>
required

The prediction market exchange to target.

Available options:
polymarket,
kalshi,
kalshi-demo,
limitless,
probable,
baozi,
myriad,
opinion,
hyperliquid,
rain,
hunch

Query Parameters

​
outcomeId
string
required
​
resolution
string

Required for candle aggregation

​
start
string<date-time>

Start of the time range

​
end
string<date-time>

End of the time range

​
limit
number

Maximum number of results to return

Response

200 - application/json

Fetch OHLCV response

​
success
boolean
Example:

true

​
error
object

Structured error envelope returned inside BaseResponse.error and ErrorResponse.error. Hosted-mode endpoints populate code, retryable, and optionally exchange / detail; legacy local-mode endpoints may still return only message.

​
data
object[]