Token volume statistics

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

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

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:

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

Parameters and fields

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

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.