Get Started with API

What is Nansen API?

Nansen API is a way to get programmatic access to comprehensive onchain data including Profiler wallet analysis, Token God Mode analytics, and Smart Money insights. Built for developers and institutional users.

🎉 Congratulations on Creating Your API Key!

You're all set to start exploring blockchain data with Nansen's API. Here’s how to get started using our most popular endpoints.

How much does this cost?

It costs $10 for every 10,000 API credits purchased.

Read more about the credit pricing for each API endpoint in the API docs.

Is there a difference between the Pro and Free tier for the API?

There’s no difference in cost of credits. Every endpoint costs the same credits regardless of your plan.

Both plans receive free credits to help users get started:

• Free: 100 single use credits, plus a daily refresh to 10 credits so you’re never stuck at zero

• Pro: 2,000 credits every month, refreshed at the start of each month

Has the cost of API credits changed for the Free tier?

Previously there was a 10x mark up in the cost per API call fro Free user. We've made API credits simpler and fairer:

• No more 10x markup. The cost per API call is now identical on Free and Pro. Every endpoint consumes the same number of credits regardless of your plan.

• Your balance now shows 100 credits instead of 1,000. This isn't a cut. Your real usage capacity is exactly the same. We've just removed the 10x mu from the number you saw.

• There is a daily refresher to 10 credits so you’re never stuck at zero

What are the rules for data redistribution?

Data from permitted endpoints is allowed to be redistributed. Please note there are prohibited endpoints (eg. smart money endpoints) that are not open for redistribution.

Please read the full Data Redistribution Guidelines to understand what is permitted.

Get Started with Our Top 5 APIs:

1. Token Screener

Discover and screen tokens across multiple blockchains with advanced filtering. 🔗 Endpoint ReferenceSample Request:

curl -X POST https://api.nansen.ai/api/v1/token-screener \  -H 'apiKey: YOUR_API_KEY' \  -H 'Content-Type: application/json' \  -d '{'chains':['solana'],'date':{'from':'2025-11-25','to':'2025-11-26'}}'

2. Smart Money Netflows

Analyze net capital flows from smart traders and funds. 🔗 Endpoint ReferenceSample Request:

curl -X POST https://api.nansen.ai/api/v1/smart-money/netflow \   -H 'apiKey: YOUR_API_KEY' \   -H 'Content-Type: application/json' \   -d '{'chains':['ethereum', 'base','solana']}'

3. Token Holders

Retrieve top token holders with balances and historical activity.🔗 Endpoint ReferenceSample Request:

curl -X POST https://api.nansen.ai/api/v1/tgm/holders \   -H 'apiKey: YOUR_API_KEY' \   -H 'Content-Type: application/json' \   -d '{'chain':'ethereum','token_address':'0x7fc66500c84a76ad7e9c93437bfc5ac33e2ddae9'}' 

4. Flow Intelligence

Comprehensive flow analytics with inflows, outflows, and net flows by holder segments. 🔗 Endpoint ReferenceSample Request:

curl -X POST https://api.nansen.ai/api/v1/tgm/flow-intelligence \   -H 'apiKey: YOUR_API_KEY' \   -H 'Content-Type: application/json' \   -d '{'chain':'ethereum','token_address':'0x7fc66500c84a76ad7e9c93437bfc5ac33e2ddae9','timeframe':'1d'}'

5. Smart Money DEX Trades

Access real-time DEX trading activity from smart traders and funds. 🔗 Endpoint ReferenceSample Request:

curl -X POST https://api.nansen.ai/api/v1/smart-money/dex-trades \   -H 'apiKey: YOUR_API_KEY' \   -H 'Content-Type: application/json' \   -d '{'chains':['solana']}'