OPopensea
Token Endpoints

Get token holders

Changed on

Get paginated list of holders for a specific token, including quantity held and USD value.

get/api/v2/chain/{chain}/token/{address}/holders

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 contract address of the token

Query parameters

limitinteger

Number of results to return (default: 20, max: 100)

cursorstring

Pagination cursor for next page

Response

OK

nextstring nullable

Cursor for the next page of results

total_countinteger nullable

Total number of holders

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

    • breaking

      the response property // became nullable for the status

    • breaking

      the response property // became nullable for the status

    • breaking

      the response property became nullable for the status

    • breaking

      the response property became nullable for the status

    • breaking

      the response's property type changed from object to no type for status

    • breaking

      removed the required property / from the response with the status

    • breaking

      removed the required property / from the response with the status

    • breaking

      removed the required property / from the response with the status

    • breaking

      removed the required property / from the response with 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 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 subschema #2 to the response property anyOf list for the response status