Get Prices History

Return historical price data for a market asset (CLOB token).

GET /markets/prices-history

Get Prices History

cURL

curl --request GET \
  --url https://www.aionmarket.com/bvapi/markets/prices-history \
  --header 'Authorization: Bearer <token>'

200

{
  "code": 200,
  "message": "success",
  "data": {
    "history": [
      {
        "timestamp": "2023-11-07T05:31:56Z",
        "price": 123
      }
    ]
  }
}

Retrieve time-series price data for a specific market outcome token. Useful for charting, backtesting, and trend analysis.

Query Parameters

market · string · required

CLOB token ID (Polymarket token address). This is the unique identifier for the outcome token you want price history for.

startTs · number

Start timestamp in Unix seconds. Omit to use the server default (beginning of available data).

endTs · number

End timestamp in Unix seconds. Omit to use the current time.

interval · string

Time aggregation interval. One of: max, all, 1m, 1w, 1d, 6h, 1h.

fidelity · integer · default: "1"

Data fidelity in minutes. Higher values produce coarser data with fewer points. Default is 1 (one-minute granularity).

venue · string · default: "polymarket"

Trading venue identifier. Default: polymarket.

Response

data.history · array

Array of price data points.

Show PricePoint

t · number

Unix timestamp in seconds.

p · number

Price at this point in time (0-1 range for prediction markets).

Authorizations

Authorization · string · header · default: YOUR_API_KEY · required

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

Query Parameters

market · string · required

CLOB token ID (Polymarket token address)

startTs · number

Start timestamp (Unix seconds)

endTs · number

End timestamp (Unix seconds)

interval · enum<string>

Time aggregation interval

Available options: max, all, 1m, 1w, 1d, 6h, 1h

fidelity · integer · default: 1

Data fidelity in minutes (default 1)

Required range: x >= 1

venue · string · default: polymarket

Trading venue (default: polymarket)

Maximum string length: 50

Response

200 - application/json

Historical prices

code · integer

Example:

200

message · string

Example:

"success"

data · object

Show child attributes