⚙️Other Web Endpoints

Wallet Profiler For Token

Token Balance Over Time for Address

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

Return the Token Balance Over Time for Address section of Nansen's Wallet Profiler for Token under Diligence.

Nansen URL: https://pro.nansen.ai/wallet-profiler-for-token?address=[address]&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
address*	String	Wallet address in string
token*	String	Token address in string

200: OK

{
   "result_data": [
      {
         "balance": FLOAT,
         "date": {
         "seconds": UNIX
         }
      }
   ],
   "updated_at": UNIX
}

Largest Token Transactions

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

Return the Largest Token Transactions section of Nansen's Wallet Profiler for Token under Diligence.

Nansen URL: https://pro.nansen.ai/wallet-profiler-for-token?address=[address]&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
address*	String	Wallet address in string
token_address*	String	Token address in string

200: OK

{
   "result_data": [
      {
         "block_timestamp": {
            "seconds": UNIX
         },
         "counterparty_address": string,
         "direction": string,
         "directioned_value": FLOAT,
         "token_address": string,
         "transaction_hash": string,
         "value": FLOAT
      }
   ],
   "updated_at": UNIX
}

First Received Time

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

Return the First Received section of Nansen's Wallet Profiler for Token under Diligence.

Nansen URL: https://pro.nansen.ai/wallet-profiler-for-token?address=[address]&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
address*	String	Wallet address in string
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": {
      "first_incoming": {
         "seconds": UNIX
      }
   },
   "updated_at": UNIX
}

Token Exchange Flows

Token Flow To / From Exchanges

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

Return the Token Flow To / From Exchanges section of Nansen's Token Flows under Diligence.

Nansen URL: https://pro.nansen.ai/exchange-flows

Headers

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

Request Body

Name	Type	Description
tokens	Array	Denotes what types of token flow to include. One of ["Stablecoins", "ETH", "Non-stables"] enclosed within brackets. Default is everything.
time_frame	String	Denotes how many hours of data to include. One of "1", "24", "168" in quotes. Default is 168 (7 days).
network	String	Denote which network it is for. One of "ethereum", "bsc", "polygon", "fantom", "avalanche" in quotes. Default is "ethereum".

200: OK

{
   "result_data": [
      {
         "deposits_usd_1d": FLOAT,
         "deposits_usd_1h": FLOAT,
         "deposits_usd_7d": FLOAT,
         "exchange": STRING,
         "netflow_usd_1d": FLOAT,
         "netflow_usd_1h": FLOAT,
         "netflow_usd_7d": FLOAT,
         "withdrawals_usd_1d": FLOAT,
         "withdrawals_usd_1h": FLOAT,
         "withdrawals_usd_7d": FLOAT
      }
   ],
   "updated_at": UNIX
}

Token Flow To / From Smart Money

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

Return the Token Flow To / From Smart Money section of Nansen's Token Flows under Diligence.

Nansen URL: https://pro.nansen.ai/token-flows

Headers

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

Request Body

Name	Type	Description
max_token_age	String	Token age in string. Default is 365
direction	String	Accepts ['in', 'out'] Default is “in”.

200: OK

{
   "result_data": [
      {
         "addresses_1d": INT,
         "addresses_1h": INT,
         "addresses_7d": INT,
         "inflow_1d": FLOAT,
         "inflow_1h": FLOAT,
         "inflow_7d": FLOAT,
         "symbol": string,
         "token_address": string
      }
   ],
   "updated_at": UNIX
}

Hot Contracts

Hot Contracts

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

Return the Hot Contracts section of Nansen's Hot Contracts.

Nansen URL: https://pro.nansen.ai/hot-contracts

Headers

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

200: OK

{
   "result_data": [
      {
         "contract_address": string,
         "depositors_1d": INT,
         "depositors_1h": INT,
         "depositors_7d": INT,
         "depositors_sm_1d": INT,
         "inflow_1d": FLOAT,
         "inflow_1h": FLOAT,
         "inflow_7d": FLOAT,
         "network": string
      }
   ],
   "updated_at": UNIX
}