---
title: "Market History"
method: GET
path: "/defi/v3/market-history"
tags: ["DEX & Protocol"]
---

# Market History

`GET /defi/v3/market-history`

Retrieves historical market metrics for the specified blockchain, aggregated by the specified time frame. The response includes trading metrics (trading volume, trade count, and active trading tokens) aggregated over each time frame, and snapshot metric (stablecoin market capitalization) representing values at the end of each time frame.

## Query parameters

- `time_frame` '1D'
- `time` integer
- `direction` 'backward' | 'forward'
- `count` integer

## Headers

- `x-chain` 'solana'

## Response `200`

JSON object containing market history data of a specified chain.

- MarketHistoryResponseType
  - `success` boolean, required
  - `data` object, required
    - `items` object[]
      - `unix_time` integer — The Unix timestamp in seconds (UTC timezone) of the beginning of the aggregated time frame.
      - `volume_usd` number — The total trading volume in USD for the corresponding time frame.
      - `trade_count` number — The total number of trades during the corresponding time frame.
      - `active_trading_tokens` number — The number of unique tokens with at least one trade during the corresponding time frame.
      - `stable_coin_market_cap` number — The total market capitalization (USD) of all stablecoins on the selected blockchain at the end of the corresponding time frame.
    - `has_more` boolean — Indicates whether there are more data points available beyond the current response.

## Other responses

- `400` — Bad Request
- `401` — Unauthorized. API key is missing or invalid
- `403` — Forbidden. Request is blacklisted or not whitelisted
- `429` — Too Many Requests. Rate limit reached
- `500` — Internal Server Error

---

[API](https://skmtc.net/birdeye/apis/birdeye-data-api.md) · [All operations](https://skmtc.net/birdeye/apis/birdeye-data-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/birdeye/birdeye-data-api/revisions/fcaba926a089/schema)