Holders

tgm/address/balances

post

This shows the holders of the token along with how much they have sent/received in the specified timeframe days as well as what percent of the token they own.

Parameters

Parameter	Type	Description
param_token_address	FixedString(42)	Token address input.
param_wallet_type	Array(String)	Wallet categories filter. Only show addresses which are in these categories. You can find the categories here ```SELECT DISTINCT arrayJoin(arrayJoin(groupArrayDistinct(sector))) AS categories
date_from	String	Date range start input, format YYYY-MM-DD
date_to	String	Date range end input, format YYYY-MM-DD

Body

Responses

200

Successful response

application/json

400

Bad request

application/json

401

Authentication error

application/json

403

Forbidden - Subscription tier required

application/json

500

Internal server error

application/json

post

HTTPcURLJavaScriptPython

POST /api/beta/tgm/address/balances HTTP/1.1
Host: api.nansen.ai
Content-Type: application/json
Accept: */*
Content-Length: 193

{
  "parameters": {
    "chain": "ethereum",
    "date": {
      "from": "2025-05-01",
      "to": "2025-05-03"
    },
    "tokenAddress": null,
    "walletType": null,
    "addressSmartSegmentIds": null,
    "addressCustomLabels": null,
    "smLabels": null
  }
}

[
  {
    "tokenAddress": "text",
    "address": "text",
    "walletType": "text",
    "name": "text",
    "balance": "text",
    "percentOwnership": "text",
    "sent": "text",
    "received": "text",
    "change": "text"
  }
]

tgm/entity/balances

post

The endpoint shows the holders of the inputted token along with how much they have sent/received in the specified timeframe

Parameters

Parameter	Type	Description
param_token_address	FixedString(42)	Token address input.
param_wallet_type	String	Wallet categories filter
param_chain	String	Chain parameter
date_from	String	Date range start input, format YYYY-MM-DD
date_to	String	Date range end input, format YYYY-MM-DD

Body

Responses

200

Successful response

application/json

400

Bad request

application/json

401

Authentication error

application/json

403

Forbidden - Subscription tier required

application/json

500

Internal server error

application/json

post

HTTPcURLJavaScriptPython

POST /api/beta/tgm/entity/balances HTTP/1.1
Host: api.nansen.ai
Content-Type: application/json
Accept: */*
Content-Length: 159

{
  "parameters": {
    "chain": "ethereum",
    "tokenAddress": null,
    "addressSmartSegmentIds": null,
    "addressCustomLabels": null,
    "date": {
      "from": "2025-05-01",
      "to": "2025-05-03"
    }
  }
}

[
  {
    "tokenAddress": "text",
    "address": "text",
    "name": "text",
    "balance": "text",
    "percentOwnership": "text",
    "sent": "text",
    "received": "text",
    "change": "text"
  }
]