# Credits & Pricing Guide

Welcome to our updated API pricing and credit system. We’ve made it easier to get started, scale up, and pay only for what you need.

## Available API Plans

We offer two main API plans to fit your needs:

<table><thead><tr><th>Plan</th><th>Credits Included</th><th width="109.5078125">Top Ups</th><th>Intended Use</th></tr></thead><tbody><tr><td>Pro</td><td>1,000 Starter Credits<br>(one time grant)</td><td>✅</td><td>Professional, production, and high volume integrations</td></tr><tr><td>Free</td><td>1000 Trial Credits<br>(one time grant)</td><td>✅</td><td>Brief experimentation and testing; comes at 10x credit consumption</td></tr></tbody></table>

For more information on plan features, visit [our pricing page](https://app.nansen.ai/account/switch-plans).

### Pro Plan Details

* Subscription: $49/month (annual) or $69/month (monthly)
* Starter Credits: Get 1,000 credits to start building before making your first purchase
* Flexi-Credits: Purchase as many credits as you want. (Here's a [purchase guide](https://docs.nansen.ai/about/credits-and-pricing-guide#endpoint-credit-cost))
* Expiry: Credits expire 1 year from purchase&#x20;

### Free Plan Details

* 1000 one-time credits to try the API
* Ability to purchase credits
* API credits are consumed much faster than Pro plan

<details>

<summary>List of Available Endpoints in Free Tier</summary>

Free plan users have access to the following endpoints:

* `/v1/profiler/address/transactions`
* `/v1/profiler/address/current-balance`
* `/v1/profiler/address/historical-balances`
* `/v1/profiler/address/counterparties`
* `/v1/profiler/address/related-wallets`
* `/v1/tgm/flows`
* `/v1/tgm/who-bought-sold`
* `/v1/tgm/dex-trades`
* `/v1/tgm/transfers`
* `/v1/tgm/holders`
* `/v1/portfolio/defi-holdings`
* `/v1/transaction-with-token-transfer-lookup`
* `/v1/token-screener`

</details>

## What Your Budget Gets You?

{% hint style="info" %}
You can also use [this Credit Purchase Calculator](https://docs.google.com/spreadsheets/d/15P3HFSZUq_XnSKRalqe26-N9MT59wIdH0N8STxZuRos/edit?usp=sharing) to easily plan your API budget.
{% endhint %}

Quickly compare what each credit package unlocks across our main API features.&#x20;

<table><thead><tr><th width="126.66015625">Budget</th><th width="133.6328125">Credits</th><th>What it gets you</th></tr></thead><tbody><tr><td>$100</td><td>100K</td><td>100K balance/pnl/txn checks<br>or<br>20K Smart Money calls<br>or<br>200 label lookups</td></tr><tr><td>$500</td><td>500K</td><td>500K balance/pnl/txn checks<br>or<br>100K Smart Money calls<br>or<br>1000 label lookups</td></tr><tr><td>$1000</td><td>1M</td><td>1M balance/pnl/txn checks<br>or<br>200K Smart Money calls<br>or<br>2000 label lookups</td></tr></tbody></table>

## Endpoint Credit Cost

Credit costs are structured to reflect the value of the data you’re accessing. Foundational data is inexpensive to encourage frequent use, while our proprietary, alpha-generating data costs more.

{% hint style="info" %}
Note: Free tier consumes 10x more credits than Pro. (1 credit on Pro = 10 credits on free)
{% endhint %}

<table><thead><tr><th width="427.9609375" valign="top">Endpoint</th><th valign="top">Credit Cost per Call (Pro)</th></tr></thead><tbody><tr><td valign="top">profiler/address/current-balances</td><td valign="top">1</td></tr><tr><td valign="top">profiler/address/historical-balances</td><td valign="top">1</td></tr><tr><td valign="top">profiler/perp-positions</td><td valign="top">1</td></tr><tr><td valign="top">profiler/address/transactions</td><td valign="top">1</td></tr><tr><td valign="top">profiler/perp-trades</td><td valign="top">1</td></tr><tr><td valign="top">profiler/address/related-wallets</td><td valign="top">1</td></tr><tr><td valign="top">profiler/pnl-summary</td><td valign="top">1</td></tr><tr><td valign="top">profiler/pnl</td><td valign="top">1</td></tr><tr><td valign="top">tgm/token-screener</td><td valign="top">1</td></tr><tr><td valign="top">tgm/perp-screener</td><td valign="top">1</td></tr><tr><td valign="top">tgm/transfers</td><td valign="top">1</td></tr><tr><td valign="top">tgm/dcas</td><td valign="top">1</td></tr><tr><td valign="top">tgm/flow-intel</td><td valign="top">1</td></tr><tr><td valign="top">tgm/who-bought-sold</td><td valign="top">1</td></tr><tr><td valign="top">tgm/dex-trades</td><td valign="top">1</td></tr><tr><td valign="top">portfolio/defi-holdings</td><td valign="top">1</td></tr><tr><td valign="top">tgm/token-information</td><td valign="top">1</td></tr><tr><td valign="top">tgm/token-ohlcv</td><td valign="top">1</td></tr><tr><td valign="top">tgm/flows</td><td valign="top">1</td></tr><tr><td valign="top">tgm/indicators</td><td valign="top">5</td></tr><tr><td valign="top">All Smart Money endpoints (/inflows, /holdings, /dex-trades, etc.)</td><td valign="top">5</td></tr><tr><td valign="top">profiler/perp-leaderboard</td><td valign="top">5</td></tr><tr><td valign="top">profiler/address/counterparties</td><td valign="top">5</td></tr><tr><td valign="top">tgm/perp-positions</td><td valign="top">5/150 (premium labels)</td></tr><tr><td valign="top">tgm/perp-pnl-leaderboard</td><td valign="top">5/150 (premium labels)</td></tr><tr><td valign="top">tgm/holders</td><td valign="top">5/150 (premium labels)</td></tr><tr><td valign="top">tgm/pnl-leaderboard</td><td valign="top">5/150 (premium labels)</td></tr><tr><td valign="top">Label endpoints</td><td valign="top">Common Labels: 100 <br>Premium Labels: 500</td></tr><tr><td valign="top">Agent Endpoint</td><td valign="top">Fast Mode: 200<br>Expert Mode: 750</td></tr><tr><td valign="top">prediction-market/categories</td><td valign="top">1</td></tr><tr><td valign="top">prediction-market/market-screener</td><td valign="top">1</td></tr><tr><td valign="top">prediction-market/event-screener</td><td valign="top">1</td></tr><tr><td valign="top">prediction-market/ohlcv</td><td valign="top">1</td></tr><tr><td valign="top">prediction-market/orderbook</td><td valign="top">1</td></tr><tr><td valign="top">prediction-market/trades-by-market</td><td valign="top">1</td></tr><tr><td valign="top">prediction-market/trades-by-address</td><td valign="top">1</td></tr><tr><td valign="top">prediction-market/pnl-by-address</td><td valign="top">1</td></tr><tr><td valign="top">prediction-market/address-summary</td><td valign="top">1</td></tr><tr><td valign="top">/prediction-market/top-holders</td><td valign="top">5</td></tr><tr><td valign="top">prediction-market/pnl-by-market</td><td valign="top">5</td></tr><tr><td valign="top">prediction-market/position-detail</td><td valign="top">5</td></tr></tbody></table>

## FAQs

**What happens if I run out of credits?**&#x20;

You can purchase additional credit blocks at any time to ensure your service is not interrupted.&#x20;

**Are there higher tiers or enterprise plans?**&#x20;

No, the Pro plan is designed to meet most needs. However, if you are making a bulk credit purchase over $10,000, please reach out to our sales team to discuss a custom solution.

**How do I track my credit usage?**

You can track your credit usage by visiting this link: <https://app.nansen.ai/api?tab=usage-analytics>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.nansen.ai/getting-started/credits.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.