⚙️Token God Mode

The following endpoints returns data that are available under the Token God Mode

Balance Changes (Last 7 Days)

POST https://query.api.nansen.ai/v1/questions/api_tgm_balance_change_7d

Return the Balance Changes (Last 7 Days) section of Nansen's Notable Wallets in Token God Mode.

NOTE: For some tokens that have non-standard events the balance change may be inaccurate

Nansen URL: https://pro.nansen.ai/token-god-mode/notable?token_address=[token]

Headers

Name	Type	Description
Authorization: Bearer TOKEN*	String	Generated by Nansen using your Nansen web login credentials.

Request Body

Name	Type	Description
token*	String	Token address in string
network	String	Default is ethereum, can be one of "ethereum", "polygon", "fantom", "celo", "avalanche", "bsc", "ronin"

200: OK

{
   "result_data": [
	{
	"Address": "0x0000000000000000000000000000000000000000",
	"Balance": 0.0,
	"Change": -147417858.6484375,
	"FirstReceivedAt": {
	"seconds": 1574060828
	},
	"token_address": "0x6b175474e89094c44da98b954eedeac495271d0f"
	},
	...
   ],
   "updated_at": 1642067293
}

Addresses Depositing/Withdrawing To/From Exchanges

POST https://query.api.nansen.ai/v1/questions/api_tgm_depositing_withdrawing

Return the Addresses depositing/withdrawing to/from exchanges section of Nansen's Token God Mode.

Nansen URL: https://pro.nansen.ai/token-god-mode?token_address=[token]

Headers

Name	Type	Description
Authorization: Bearer TOKEN*	String	Generated by Nansen using your Nansen web login credentials.

Request Body

Name	Type	Description
token*	String	Token address in string
network	String	Default is ethereum, can be one of "ethereum", "polygon", "fantom", "celo", "avalanche", "bsc", "ronin"

200: OK

{
   "result_data": [
      {
         "block_date": {
            "seconds": UNIX
            },
         "flux": FLOAT64,
         "nof_depositers": INT,
         "nof_withdrawers": INT
      }
   ],
   "updated_at": UNIX
}

Token Balances: Exchanges vs Dex Traders

POST https://query.api.nansen.ai/v1/questions/api_tgm_token_balances

Return the Token Balances: Exchanges vs Dex Traders section of Nansen's Token God Mode.

NOTE: For some tokens that have non-standard events the balance change may be inaccurate

Nansen URL: https://pro.nansen.ai/token-god-mode?token_address=[token]

Headers

Name	Type	Description
Authorization: Bearer TOKEN*	String	Generated by Nansen using your Nansen web login credentials.

Request Body

Name	Type	Description
token*	String	Token address in string
network	String	Default is ethereum, can be one of "ethereum", "polygon", "fantom", "celo", "avalanche", "bsc", "ronin"

200: OK

{
   "result_data": [
      {
         "date": {
         "seconds": UNIX
         },
      "pct_of_supply": FLOAT,
      "sum_balance": FLOAT,
      "wallet_type": string
      },
   ],
   "updated_at": UNIX
}

Top Token Balances

POST https://query.api.nansen.ai/v1/questions/api_tgm_top_balances

Return the Top Balances section of Nansen's Notable Wallets in Token God Mode.

NOTE: For some tokens that have non-standard events the balance change may be inaccurate

Nansen URL: https://pro.nansen.ai/token-god-mode/notable?token_address=[token]

Headers

Name	Type	Description
Authorization: Bearer TOKEN*	String	Generated by Nansen using your Nansen web login credentials.

Request Body

Name	Type	Description
token*	String	Token address in string
network	String	Default is ethereum, can be one of "ethereum", "polygon", "fantom", "celo", "avalanche", "bsc", "ronin"

200: OK

{
   "result_data": [
      {
         "address": string,
         "balance": FLOAT,
         "change_30d": FLOAT,
         "change_7d": FLOAT,
         "first_received_at": {
            "seconds": UNIX
         },
         "percent_ownership": FLOAT,
         "recv": FLOAT,
         "sent": FLOAT,
         "token_address": string
      },
   ],
   "updated_at": UNIX
}

Top Exchanges (w/ 7D Balance Change)

POST https://query.api.nansen.ai/v1/questions/api_tgm_top_exchanges_7d

Return the Top Exchanges (w/ 7D Balance Change) section of Nansen's Token God Mode.

Nansen URL:https://pro.nansen.ai/token-god-mode?token_address=[token]

Headers

Name	Type	Description
Authorization: Bearer TOKEN*	String	Generated by Nansen using your Nansen web login credentials.

Request Body

Name	Type	Description
token*	String	Token address in string
network	String	Default is ethereum, can be one of "ethereum", "polygon", "fantom", "celo", "avalanche", "bsc", "ronin"

200: OK

{
   "result_data": [
      {
         "balance": FLOAT,
         "change": FLOAT,
         "exchange": string,
         "first_received_at": {
            "seconds": UNIX
         }
      },
   ],
   "updated_at": UNIX
}

Top Transactions (Last 7 days)

POST https://query.api.nansen.ai/v1/questions/api_tgm_top_transactions_7d

Return the Top Transactions (Last 7 days) section of Nansen's Notable Wallets in Token God Mode.

Nansen URL:https://pro.nansen.ai/token-god-mode/notable?token_address=[token]

Headers

Name	Type	Description
Authorization: Bearer TOKEN*	String	Generated by Nansen using your Nansen web login credentials.

Request Body

Name	Type	Description
token*	String	Token address in string
network	String	Default is ethereum, can be one of "ethereum", "polygon", "fantom", "celo", "avalanche", "bsc", "ronin"

200: OK

{
   "result_data": [
      {
         "from_address": string,
         "time": {
            "seconds": UNIX
         },
         "to_address": string,
         "token_address": string,
         "transaction_hash": string,
         "value": FLOAT
       },
   ],
   "updated_at": UNIX
}

Total Exchange Supply

POST https://query.api.nansen.ai/v1/questions/api_tgm_total_exchange_supply

Return the Total Supply on Exchanges section of Nansen's Token God Mode.

Nansen URL:https://pro.nansen.ai/token-god-mode?token_address=[token]

Headers

Name	Type	Description
Authorization: Bearer TOKEN*	String	Generated by Nansen using your Nansen web login credentials.

Request Body

Name	Type	Description
token*	String	Token address in string
network	String	Default is ethereum, can be one of "ethereum", "polygon", "fantom", "celo", "avalanche", "bsc", "ronin"

200: OK

{
   "result_data": {
      "pct_on_exchanges": FLOAT
   },
   "updated_at": UNIX
}

Latest DEX Trades

POST https://query.api.nansen.ai/v1/questions/api_tgm_latest_dex

Return the Latest DEX Trades section of Nansen's Trades in Token God Mode.

Nansen URL:https://pro.nansen.ai/token-god-mode/trades?token_address=[token]

Headers

Name	Type	Description
Authorization: Bearer TOKEN*	String	Generated by Nansen using your Nansen web login credentials.

Request Body

Name	Type	Description
token*	String	Token address in string
network	String	Default is ethereum, can be one of "ethereum", "polygon", "fantom", "celo", "avalanche", "bsc", "ronin"

200: OK

{
   "result_data": [
      {
         "block_timestamp": {
            "seconds": UNIX
         },
      "dex": string,
      "maker_address": string,
      "maker_token": string,
      "maker_token_address": string,
      "maker_token_amount": FLOAT,
      "taker_address": string,
      "taker_token": string,
      "taker_token_address": string,
      "taker_token_amount": FLOAT,
      "token_address": string,
      "transaction_hash": string
      },
   ],
   "updated_at": UNIX
}

Token Seniority Distribution

POST https://query.api.nansen.ai/v1/questions/api_tgm_seniority_distribution

Return the Token Seniority Distribution section of Nansen's Hodlers in Token God Mode.

Nansen URL:https://pro.nansen.ai/token-god-mode/segments?token_address=[token]

Headers

Name	Type	Description
Authorization: Bearer TOKEN*	String	Generated by Nansen using your Nansen web login credentials.

Request Body

Name	Type	Description
token*	String	Token address in string
network	String	Default is ethereum, can be one of "ethereum", "polygon", "fantom", "celo", "avalanche", "bsc", "ronin"

200: OK

{
   "result_data": [
      {
         "age_group": string,
         "min_days": INT,
         "num_addresses": FLOAT,
         "sum_balance": FLOAT
      },
   ],
   "updated_at": UNIX
}

Token Price (1 Year)

POST https://query.api.nansen.ai/v1/questions/api_tgm_token_price_1y

Return the Token Price section of Nansen's Trades in Token God Mode.

Nansen URL:https://pro.nansen.ai/token-god-mode/trades?token_address=[token]

Headers

Name	Type	Description
Authorization: Bearer TOKEN*	String	Generated by Nansen using your Nansen web login credentials.

Request Body

Name	Type	Description
token*	String	Token address in string
network	String	Default is ethereum, can be one of "ethereum", "polygon", "fantom", "celo", "avalanche", "bsc", "ronin"

200: OK

{
   "result_data": [
      {
         "block_date": {
            "seconds": UNIX
         },
      "close": FLOAT,
      "price_usd": FLOAT,
      "total_volume_usd": FLOAT,
      "vol_eth": FLOAT
      },
   ],
   "updated_at": UNIX
}

Unique Addresses

POST https://query.api.nansen.ai/v1/questions/api_tgm_unique_addresses

Return the Unique Addresses for Token section of Nansen's Hodlers in Token God Mode.

Nansen URL:https://pro.nansen.ai/token-god-mode/segments?token_address=[token]

Headers

Name	Type	Description
Authorization: Bearer TOKEN*	String	Generated by Nansen using your Nansen web login credentials.

Request Body

Name	Type	Description
token*	String	Token address in string
network	String	Default is ethereum, can be one of "ethereum", "polygon", "fantom", "celo", "avalanche", "bsc", "ronin"

200: OK

{
   "result_data": [
	{
	   "date": {
	      "seconds": UNIX
	   },
	"unique_addresses": INT
	},
   ],
   "updated_at": UNIX
}

Token Market Cap

POST https://query.api.nansen.ai/v1/questions/api_token_market_cap

Return the Token Market Cap section of Nansen's Trades in Token God Mode.

Nansen URL:https://pro.nansen.ai/token-god-mode/trades?token_address=[token]

Headers

Name	Type	Description
Authorization: Bearer TOKEN*	String	Generated by Nansen using your Nansen web login credentials.

Request Body

Name	Type	Description
token*	String	Token address in string
network	String	Default is ethereum, can be one of "ethereum", "polygon", "fantom", "celo", "avalanche", "bsc", "ronin"

200: OK

{
   "result_data": {
	"market_cap_usd": FLOAT
   },
   "updated_at": UNIX
}

Token Price

POST https://query.api.nansen.ai/v1/questions/api_token_price_dai

Return the Token Price section of Nansen's Trades in Token God Mode.

Nansen URL:https://pro.nansen.ai/token-god-mode/trades?token_address=[token]

Headers

Name	Type	Description
Authorization: Bearer TOKEN*	String	Generated by Nansen using your Nansen web login credentials.

Request Body

Name	Type	Description
token*	String	Token address in string
network	String	Default is ethereum, can be one of "ethereum", "polygon", "fantom", "celo", "avalanche", "bsc", "ronin"

200: OK

{
   "result_data": {
	"token_price_in_dai": FLOAT
   },
   "updated_at": UNIX
}