Transfer Activity Summary

GET/gateway/v1/token/transfer-stats

Aggregate transfer-activity summary for a token over a window — total transfers, unique senders/receivers, total amount, first/last activity, and an optional daily series (`include=series`).

Lookup: `address` (token contract) + `chain`.

Related: per-counterparty ranking → `/v1/token/transfer-counterparties`; raw rows → `/v1/token/transfers`.

Chains: Ethereum, Base, BSC, Arbitrum, Tron · Refresh: ~24h · USD value lags ~3 days (see `enriched_ratio`).

Query Parameters

addressstringrequired

Token CONTRACT ADDRESS (0x-hex for EVM; Tron accepts base58 `T...` or 0x-hex). Not a ticker — resolve a symbol via GET /v1/search/token?q={symbol}&chain={chain} and use a returned address whose chain is supported by this endpoint.

Example: 0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48

chainenum<string>required

Chain the token contract is deployed on.

Available options:ethereumbasebscarbitrumtron

Example: ethereum

time_rangeenum<string>

Look-back window (hard 90d cap).

Available options:1d7d30d90d

includestring

Comma-separated extras. `series` adds a daily trend breakdown (volume only).

Example: series

Transfer Activity Summary

const options = {method: 'GET'};

fetch('https://api.asksurf.ai/gateway/v1/token/transfer-stats?address=0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48&chain=ethereum&include=series', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "$schema": "https://example.com/schemas/TransferStatsResponse.json",
  "data": {
    "enriched_ratio": 123,
    "first_transfer_at": 123,
    "last_transfer_at": 123,
    "series": [
      {
        "amount": "<string>",
        "amount_usd": 123,
        "date": 123,
        "enriched_ratio": 123,
        "transfer_count": 123
      }
    ],
    "total_amount": "<string>",
    "total_amount_usd": 123,
    "total_transfers": 123,
    "unique_receivers": 123,
    "unique_senders": 123
  },
  "meta": {
    "cached": true,
    "credits_used": 123,
    "empty_reason": "<string>",
    "enriched_ratio": 123
  }
}