Skip to main content
GET
/
v1
/
market
/
{symbol}
/
stats
Get market stats history
curl --request GET \
  --url https://perp-api.phoenix.trade/v1/market/{symbol}/stats \
  --header 'Authorization: Bearer <token>'
{
  "market_id": 123,
  "stats": [
    {
      "mark_price": 123,
      "open_interest": 123,
      "slot": 123,
      "spot_price": 123,
      "timestamp": "2023-11-07T05:31:56Z",
      "total_maker_fees": 123,
      "total_taker_fees": 123
    }
  ],
  "symbol": "<string>",
  "timeframe": "<string>"
}

Authorizations

Authorization
string
header
required

Bearer access token issued by /v1/auth/* login endpoints.

Path Parameters

symbol
string
required

Market symbol

Query Parameters

start_time
string<date-time> | null

Start time for market stats history (defaults to 1 hour ago)

end_time
string<date-time> | null

End time for market stats history (defaults to now)

limit
integer<int64> | null

Maximum number of data points to return (max 10000, default 1000)

timeframe
string | null

Timeframe for aggregating stats (1s, 5s, 1m, 5m, 15m, 30m, 1h, 4h, 1d)

Response

Successfully retrieved market stats history

Response for market stats history endpoint

market_id
integer<int64>
required
stats
object[]
required
symbol
string
required
timeframe
string | null