> ## Documentation Index
> Fetch the complete documentation index at: https://docs.hadron.fi/llms.txt
> Use this file to discover all available pages before exploring further.

# Volume History

> Returns historical trading volume for a pool in daily buckets.

## Path Parameters

<ParamField path="address" type="string" required>
  The pool config PDA address.
</ParamField>

## Query Parameters

<ParamField query="timeframe" type="string" default="24h">
  Bucket size. Currently only `24h` is supported.
</ParamField>

<ParamField query="start_time" type="integer">
  Start of the time range as a Unix timestamp in seconds. Defaults to 7 days ago.
</ParamField>

<ParamField query="end_time" type="integer">
  End of the time range as a Unix timestamp in seconds. Defaults to current time.
</ParamField>

<ParamField query="cluster" type="string" default="mainnet-beta">
  Solana cluster — `mainnet-beta` or `devnet`.
</ParamField>

## Response

<ResponseField name="start_time" type="integer">
  Start of the requested range (Unix seconds).
</ResponseField>

<ResponseField name="end_time" type="integer">
  End of the requested range (Unix seconds).
</ResponseField>

<ResponseField name="timeframe" type="string">
  The bucket size used.
</ResponseField>

<ResponseField name="data" type="array">
  Array of volume buckets aligned to UTC days.

  <Expandable title="Volume bucket">
    <ResponseField name="timestamp" type="integer">
      Bucket start timestamp (Unix seconds, UTC midnight).
    </ResponseField>

    <ResponseField name="volume" type="number">
      Trading volume in USD for this bucket.
    </ResponseField>

    <ResponseField name="fees" type="number">
      Fees collected in USD for this bucket.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseExample>
  ```json theme={null}
  {
    "start_time": 1772646065,
    "end_time": 1773250865,
    "timeframe": "24h",
    "data": [
      {
        "timestamp": 1772582400,
        "volume": 115.41,
        "fees": 0
      },
      {
        "timestamp": 1772668800,
        "volume": 1058.62,
        "fees": 0
      },
      {
        "timestamp": 1772755200,
        "volume": 267.98,
        "fees": 0
      }
    ]
  }
  ```
</ResponseExample>

<Note>
  Sub-day timeframes (`1h`, `4h`, `12h`) are planned for a future release.
</Note>

## Errors

| Status | Message                                                    |
| ------ | ---------------------------------------------------------- |
| `400`  | `Only 24h timeframe is supported for volume history in v1` |