Skip to content
onelayer.
All tools

Tool detail

Nansen

Returns Nansen's 'Token God Mode' holder data for a token — labeled holder breakdown by chain and token address.

Categories: Wallet analytics, Onchain data

Use when

  • list labeled holders of a token on a given chain
  • check smart-money or entity concentration among a token's holders
  • get paginated holder data for onchain due diligence

Not for

  • not price or market data — holder composition only
  • not a netflow or fund-movement view — see the smart-money netflow endpoint

Inputs

POST JSON body: { chain: string, token_address: string } (required); aggregate_by_entity, filters, label_type, order_by, pagination, premium_labels (optional)

Inputs undocumented: open object without declared properties

Endpoint

Method
POST
URL
https://api.nansen.ai/api/v1/tgm/holders

Payment

Protocol
x402
Listed price
0.05 USDC per call on Base
Payment method
exact
Network
eip155:8453
Asset
0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913

Listed terms are catalog metadata. The caller supplies inputs and calls the tool outside Onelayer. If payment is required, the caller uses a compatible wallet to pay.

Source

Record
POST https://api.nansen.ai/api/v1/tgm/holders
Retrieved
2026-09-30T20:37:07.382Z
Catalog file SHA-256
6837ccddf886f0007cf3727ea9d27faaa5047b51b4f425345c554ce1c271a524
Catalog built
2026-09-30T22:31:58.034Z