OPopensea
Token Endpoints

Get token trading activity stats

Changed on

Get materialized trade count, USD volume, and average trade size for a token. Windows with no swaps are omitted; an omitted requested key means zero trades in that window. Each window ends at its own materialized snapshot; computed_at is the oldest snapshot among the returned windows and can precede request time because the response is cached. The 1h and 24h windows also carry unique_buyer_count and unique_seller_count, which are null when the counts are unavailable for that token; 5m and 4h never carry them.

get/api/v2/chain/{chain}/token/{address}/activity/stats

Request

Path parameters

chain'base' | 'ethereum' | 'zora' | 'arbitrum' | 'sei' | 'avalanche' | 'polygon' | 'optimism' | 'ape_chain' | 'flow' | 'soneium' | 'ronin' | 'bera_chain' | 'solana' | 'shape' | 'unichain' | 'gunzilla' | 'abstract' | 'animechain' | 'hyperevm' | 'somnia' | 'monad' | 'hyperliquid' | 'megaeth' | 'ink' | 'robinhood' | 'stablechain' required

Blockchain chain identifier. Use the chain slug (e.g., 'ethereum', 'polygon', 'arbitrum', 'optimism', 'base')

Example:ethereum

The blockchain on which to filter the results

addressstring required

The token contract address

Query parameters

windowsstring

Comma-separated windows. Defaults to 5m,1h,4h,24h.

Response

OK

addressstring required

Token contract address

chainstring required

Blockchain slug

computed_atstring date-time nullable

End time of the oldest returned aggregation window, or null when no window is returned

windowsobject required

Trading activity keyed by requested window. A requested key is omitted when the token has no swaps in that window; an omitted key means zero trades.

Example response

{
  "chain": "base"
}

Changes

  • 2c7935d84f90Revision changes
    • breaking

      removed the enum value b3 from the path request parameter chain

    • breaking

      removed the enum value blast from the path request parameter chain

    • breaking

      the response property became nullable for the status

    • info

      added the new enum value stablechain to the path request parameter chain

    • info

      added the media type */* for the response with the status

    • info

      added the media type */* for the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status