Skip to main content
POST
get_token_holders_traders

Reading the result

The response example uses made-up values and shows selected fields. Fields vary by network and available data.
  • holders describes current holdings; traders describes trading activity. Rows can include labels, funding sources, buy/sell volumes, and PnL when available.
  • ownership_percentage is a percentage of supply. Missing enrichment values can be null.
  • has_more_holders and has_more_traders indicate additional results. Read traders_unavailable_reason if trader data is missing, and metadata.date_range for the trading window.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
token_address
string
required

Exact token contract address or mint on the selected network; resolve a ticker first.

network
string
required

Network to query, for example ethereum. See Supported Networks for coverage.

Response

Top holders + trader PnL/concentration for a token. Fields vary by network and available data. Check for status: no_data, status: error, or an error field even when HTTP status is 200. See Errors & status.

Response fields depend on the network and available data. The example shows selected fields; see Reading the result for details.