Get Prediction Market OHLCV

Get OHLCV (candlestick) data for a specific outcome of a prediction market.

GET /2/pm/market/ohlcv

Get Prediction Market OHLCV

cURL

curl --request GET \
  --url https://pm-api-prod-eu.mobula.io/api/2/pm/market/ohlcv

200

{
  "data": [
    {}
  ]
}

Alpha — This endpoint is part of the Prediction Markets API, currently in early access. May change without notice.

Query Parameters

platform · string · required

The prediction market platform (e.g., polymarket).

outcomeId · string · required

The outcome token ID.

period · string · default: "1h"

Candle period. Possible values: 1s, 5s, 10s, 1m, 5m, 15m, 1h, 4h, 1d, 1w.

from · string | number

Start time. Accepts Unix timestamp in milliseconds (e.g., 1709913600000) or ISO 8601 string (e.g., 2024-03-01T00:00:00Z). If omitted, returns the most recent candles.

to · string | number

End time. Accepts Unix timestamp in milliseconds (e.g., 1709913600000) or ISO 8601 string (e.g., 2024-03-01T00:00:00Z). Defaults to now.

limit · number · default: "500"

Maximum number of candles to return (1 to 1000).

offset · number · default: "0"

Number of records to skip for pagination.

Response

data · array

Array of OHLCV candle objects. Uses the same abbreviated field names as the spot OHLCV endpoint (/2/token/ohlcv-history).

Show Candle Object

t · number

Candle open timestamp in milliseconds.

o · number

Open price.

h · number

High price.

l · number

Low price.

c · number

Close price.

v · number

Trading volume in USD.

tradesCount · number

Number of trades in this candle (PM-specific).

pagination · object

Pagination metadata.

Show Pagination Object

page · number

Current page number (1-based).

offset · number

Number of records skipped.

limit · number

Maximum records per page.

pageEntries · number

Number of records returned in this page.

hostname · string

Server node identifier.

took · number

Request processing time in milliseconds.

Usage Example

curl -X GET "https://api.mobula.io/api/2/pm/market/ohlcv?platform=polymarket&outcomeId=71321...&period=1h&limit=100"

Example Response

{
  "data": [
    { "t": 1709910000000, "o": 0.34, "h": 0.36, "l": 0.33, "c": 0.35, "v": 12500, "tradesCount": 45 },
    { "t": 1709913600000, "o": 0.35, "h": 0.37, "l": 0.34, "c": 0.36, "v": 8900, "tradesCount": 32 }
  ],
  "pagination": { "page": 1, "offset": 0, "limit": 500, "pageEntries": 2 },
  "hostname": "node-xyz",
  "took": 42
}

Query Parameters

platform · enum<string> · required

Prediction market platform. Today only polymarket is supported; any other value returns 400.

Available options: polymarket

Example:

"polymarket"

outcomeId · string · required

Polymarket outcome / token ID — uint256 decimal string (the ERC-1155 token id of the YES/NO/etc. side).

Pattern: ^[0-9]+$

Example:

"59855952379545476461266875939089074481171378466995213858930892770855011813551"

period · enum<string> · default: 1h

Candle resolution.

Available options: 1s, 5s, 10s, 1m, 5m, 15m, 1h, 4h, 1d, 1w

from · integer<int64>

Start time in Unix milliseconds.

Required range: x >= 0

to · integer<int64>

End time in Unix milliseconds.

Required range: x >= 0

limit · integer · default: 500

Page size (1-5000).

Required range: 1 <= x <= 5000

offset · integer · default: 0

Pagination offset.

Required range: x >= 0

Response

200 - application/json

OHLCV candles

data · object[]