# Token volume statistics

Source: https://docs.settlemint.com/docs/developer-guides/api-integration/token-volume-statistics
Read indexed transfer-volume history for a token through the DALP API.



Token volume statistics return the transfer volume history for one token. Use this
endpoint when an integration needs chart data or a reconciliation check for token
activity over time.

## Read token volume history [#read-token-volume-history]

Call the token statistics endpoint with the token address in the path. The optional
`days` query parameter selects the trailing window.

```bash
curl "https://your-platform.example.com/api/v2/tokens/0xTOKEN/stats/volume?days=30" \
  -H "X-Api-Key: sm_dalp_xxxxxxxxxxxxxxxx"
```

The response uses the single-resource envelope. The `volumeHistory` array contains
one point per period:

```json
{
  "data": {
    "volumeHistory": [
      {
        "timestamp": "2026-03-24T00:00:00.000Z",
        "totalVolume": "1250000000000000000000"
      }
    ]
  },
  "links": {
    "self": "/v2/tokens/0xTOKEN/stats/volume"
  }
}
```

## Parameters and fields [#parameters-and-fields]

| Field                         | Type         | Notes                                                                           |
| ----------------------------- | ------------ | ------------------------------------------------------------------------------- |
| `tokenAddress`                | path string  | Token contract address.                                                         |
| `days`                        | query number | Optional trailing range in days. Defaults to 30. Minimum 1, maximum 365.        |
| `volumeHistory[].timestamp`   | timestamp    | Period timestamp in UTC.                                                        |
| `volumeHistory[].totalVolume` | string       | Total transferred amount for the period, returned as a raw-unit decimal string. |

For short ranges up to two days, DALP returns hourly points. For longer ranges,
DALP returns daily points. The current incomplete hour or day is included when it
has transfer volume.

## How the value is calculated [#how-the-value-is-calculated]

The statistic is indexer-backed. DALP sums indexed `TransferCompleted` events for
the requested token and returns the amount as a string so clients do not lose
precision when token amounts exceed JavaScript number limits.

The endpoint is for reading indexed activity, not for executing transfers. To
inspect the underlying events or reconcile holder balances, use the [token holders
and transfers API](/docs/developer-guides/api-integration/token-holders-transfers).