Skip to main content
POST
GetHistoricalPrices

Authorizations

Authorization
string
header
required

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

Headers

Connect-Protocol-Version
enum<number>
default:1

Define the version of the Connect protocol Define the version of the Connect protocol. If omitted, use 1.

Available options:
1
Connect-Timeout-Ms
number

Define the timeout, in ms

Example:

1000

Body

application/json
market
market · object

Required

startTime
string<date-time>

Inclusive

Example:

"2023-01-15T01:30:15.01Z"

endTime
string<date-time>

Exclusive

Example:

"2023-01-15T01:30:15.01Z"

interval
enum<string>

Candle bucket width. Omitted (UNSPECIFIED) defaults to 1 hour.

Available options:
CANDLE_INTERVAL_UNSPECIFIED,
CANDLE_INTERVAL_1_MINUTE,
CANDLE_INTERVAL_3_MINUTES,
CANDLE_INTERVAL_5_MINUTES,
CANDLE_INTERVAL_15_MINUTES,
CANDLE_INTERVAL_30_MINUTES,
CANDLE_INTERVAL_1_HOUR,
CANDLE_INTERVAL_2_HOURS,
CANDLE_INTERVAL_4_HOURS,
CANDLE_INTERVAL_8_HOURS,
CANDLE_INTERVAL_12_HOURS,
CANDLE_INTERVAL_1_DAY,
CANDLE_INTERVAL_3_DAYS,
CANDLE_INTERVAL_1_WEEK,
CANDLE_INTERVAL_1_MONTH
limit
integer
offset
integer
chainId
string<int64> | null

Optional chain identifier for the market. During testnet, Fairground runs on Arbitrum Sepolia (421614).

Response

Success

marketId
string<int64>
market
string

Canonical name, e.g. "BTC-USD"

priceCandleSticks
CandleStick · object[]

Timestamp descending

pagination
pagination · object