⚙️Wallets

The Wallets API returns the tokens held by an wallet on a chain.

Returns the token balances for an address on a given chain

GET https://query.nansen.ai/api/portfolio/wallet/{chain}/{address}

This will return the token balance for a given address on the requested chain, along with information about the token.

Path Parameters

Name	Type	Description
api_key*	String	The user's API key

200: OK

[
  {
    "address": "0xc2132d05d31c914a87c6611c10748aeb04b58e8f",
    "symbol": "USDT",
    "logo": "https://assets.coingecko.com/coins/images/325/large/Tether-logo.png?1598003707",
    "decimals": 6,
    "chain": "POLYGON",
    "name": "Tether",
    "isNative": false,
    "extensions": {
      "coingeckoId": "tether"
    },
    "price": 0.999738,
    "source": "COINGECKO",
    "isBlacklisted": false,
    "isHidden": false,
    "reportCount": 7,
    "createdAt": "2021-06-25T19:07:42.576Z",
    "modifiedAt": "2023-08-21T02:00:27.933Z",
    "balance": 1.00000
  },
  {
  ...}
]

Supported Blockchains:

Please use /eth3 for Ethereum to calculate native and erc20 token balance.

The following chains are supported:

Supported Chain	Supported Chain
Acala	Akash
Aptos	Arbitrum
Astar	Aurora
Avax	Bitcoin
Boba	BSC
Canto	Cardano
Celo	Chihuahua
Cosmos	Cronos
Dfk	Dogechain
Elrond	Ethereum( /eth3)
Evmos-Cosmos	Evmos-EVM
Fantom	Harmony
Juno	Kava
Kujira	Linea
Metis	Moonbeam
Moonriver	Near
Okc	Matic2 (optimism OP + ERC20 tokens)
Osmosis	Polygon
Ripple	Ronin
Secret	Sifchain
Solana	Sommelier
Stargaze	Terra2
Tezos	Thor
Tron	Umee
zkSync Era