DALP API token volume statistics for indexed transfers

Token volume statistics return a time series of completed transfer volume for one token. Use this endpoint for chart data, operational monitoring, or reconciliation checks over a bounded trailing window.

The endpoint is read-only. It reports indexed activity and does not execute transfers or change token state.

Endpoint

GET /api/v2/tokens/{tokenAddress}/stats/volume

tokenAddress is the EVM contract address of the token in the active DALP tenant and system scope. The optional days query parameter selects how many trailing days of indexed history to return.

Smallest request

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

The response uses the single-resource envelope. volumeHistory is an ordered time series of period points:

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

Parameters and fields

Field	Location	Type	Notes
`tokenAddress`	Path	EVM address	Token contract address. The address must be visible to the active DALP tenant and system scope.
`days`	Query	number	Optional trailing range in days. Defaults to `30`. Minimum `1`, maximum `365`.
`volumeHistory[].timestamp`	Body	UTC timestamp	Period timestamp serialized as an ISO 8601 date-time string, for example `2026-03-24T00:00:00.000Z`.
`volumeHistory[].totalVolume`	Body	decimal string	Total completed transfer volume for the period, returned in raw token units rather than display-unit decimals.

For short ranges of one or two days, DALP returns hourly points. For longer ranges, DALP returns daily points. The current incomplete hour or day is included only when that current period has non-zero transfer volume.

totalVolume is a decimal string so clients can preserve token amount precision. Do not parse it with JavaScript Number. Use a bigint or decimal-safe type before applying the token's decimals for display.

CLI request

The DALP CLI exposes the same read as tokens stats-volume:

dalp tokens stats-volume 0x1111111111111111111111111111111111111111

The CLI command currently reads the default API window. Use the HTTP API directly when an integration must set a custom days value.

How the value is calculated

The statistic is indexer-backed. DALP sums indexed TransferCompleted events for the requested token and returns an evenly spaced time series for the resolved window.

Ranges can include periods with no activity. Keep zero-value points in charts and reconciliation jobs so the x-axis remains continuous and missing activity is not confused with missing data.

Because the endpoint reads indexed data, recently completed transfers can appear after the relevant indexer has processed them. If a just-completed transfer is missing from the response, retry after indexing catches up before treating the gap as a reconciliation failure.

Production handling

Authenticate the request with an API key that has access to the target tenant and system.
Treat the response as indexed history for one token, not a source for submitting or approving transfers.
Preserve timestamps in UTC when storing or comparing points across systems.
Preserve raw-unit amount strings until the final presentation layer.
Use the token holders and transfers API when you need the underlying transfer records or holder-level reconciliation detail.

Token volume statistics