⚙️

Portfolio APIs

Portfolio APIs are a set of APIs that corresponds to the data that is shown on Nansen Portfolio. These APIs can return:
  • All ERC20 tokens held by a wallet address
  • Outstanding protocols positions held by the wallet address
These APIs endpoints fall into the following broad categories:
  • Protocols: These return all tokens held by the wallet address, plus the associated positions for each protocol.
  • Transactions: These return all the transactions performed by a given address
  • Wallets: These return only the tokens held by the wallet address
    • Note that we filter out tokens with balance less than $1.00 USD to return more relevant results
  • Tokens: These are reference APIs that return basic information
To get started, refer the API Key section for how to obtain your API Key.

Rate Limits

To ensure the smooth and efficient operation of our API, we have implemented rate limits to manage the frequency of requests. Here are the rate limits for our API:
  • 60 Requests/Minute
  • 600 Requests/Hour
  • 6000 Requests/Day

API Coverage

Number of Chains Covered

Portfolio API offers a variety of endpoints to track wallet balances, transactions and protocol positions. Here's a breakdown of the number of chains covered for different API endpoints:
Endpoint
# of Chains
/wallet (wallet balance)
49
/txns (transactions)
18
/protocols (protocol positions)
13

Total Number of Protocols Covered

We currently support a total of 350 different protocols across 13 different chains ensuring comprehensive coverage for tracking an address' position across protocols.
Here's a breakdown of the number of protocols supported for each blockchain:
Blockchain
# of Protocols Covered
Ethereum
76
BSC (Binance Smart Chain)
49
Fantom
37
Arbitrum
36
Polygon
35
Avax (Avalanche)
31
Optimism
28
Cronos
15
Solana
12
Harmony
11
Moonbeam
7
Moonriver
7
Boba
6