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.

Do you need a Pro subscription to use the API?

No, you do not need a Pro subscription to use the API. The API is available for everyone to use.

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 API 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

Bulk purchases of more than 5 million API credit may receive a discount. Please reach out to support and ask to speak with a member of the Sales team.

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

If I downgrade my Pro subscription what happens to my API credits?

If you downgrade your Pro subscription you will lose the monthly 2,000 API credits associated with your Pro sub. Any additional credits you purchased in separate transactions will remain.

Do API credits ever expire?

Yes, API credits can expire. Unused credits expire after one year from the date of purchase.

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.

What are the rate limits for Nansen API?

Rate limits vary by subscription tier and are measured over both short and sustained windows.

• Free plan: 15 requests/second, 300 requests/minute

• Pro sub: 75 requests/second, 1500 requests/minute

Some endpoints have additional rate limits across both plans. Please read the API docs for more detailed technical information on rate limits.

Get Started with Our Top 5 APIs:

1. Token Screener

Discover and screen tokens across multiple blockchains with advanced filtering 🔗 Endpoint Reference

Sample 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 Reference

Sample 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 Reference

Sample 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 Reference

Sample 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 Reference

Sample 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']}'