---
title: "Get market stats history"
method: GET
path: "/v1/market/{symbol}/stats"
tags: ["Exchange"]
---

# Get market stats history

`GET /v1/market/{symbol}/stats`

## Request

- Base URL: `https://perp-api.phoenix.trade`
- URL: `https://perp-api.phoenix.trade/v1/market/{symbol}/stats`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/phoenix/apis/phoenix-eternal-api/docs/v1/market/:symbol/stats/get.ts> (a function with typed inputs; its response is checked against the schema)

Handles `GET /v1/market/{symbol}/stats` via `get.v1.market.by_symbol.stats`.

## Path parameters

- `symbol` string, required

## Query parameters

- `start_time` string, date-time, nullable
- `end_time` string, date-time, nullable
- `limit` integer, nullable
- `timeframe` string, nullable

## Response `200`

Successfully retrieved market stats history

- MarketStatsHistoryResponse: Response for market stats history endpoint
  - `market_id` integer, required
  - `stats` MarketStatsPoint[], required
    - `mark_price` number, double, required
    - `open_interest` number, double, required
    - `slot` integer, required
    - `spot_price` number, double, required
    - `timestamp` string, date-time, required: Formatted datetime string (ISO 8601).
    - `total_maker_fees` number, double, nullable
    - `total_taker_fees` number, double, nullable
  - `symbol` string, required
  - `timeframe` string, nullable

## Other responses

- `400`: Standard JSON error payload.
- `404`: Standard JSON error payload.
- `500`: Standard JSON error payload.

---

[API](https://skmtc.dev/phoenix/apis/phoenix-eternal-api.md) - [All operations](https://skmtc.dev/phoenix/apis/phoenix-eternal-api/llms.txt) - [OpenAPI document](https://skmtc.dev/phoenix/apis/phoenix-eternal-api/revisions/542796fe0648?raw)