> For the complete documentation index, see [llms.txt](https://docs.nansen.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.nansen.ai/getting-started/credits.md).

# 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>2,000 credits/month<br>(one time grant)</td><td>✅</td><td>Professional, production, and high volume integrations</td></tr><tr><td>Free</td><td>100 Trial credits with, with a daily 10 credit refill</td><td>✅</td><td>Brief experimentation and testing</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 2,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

### Free Plan Details

* 100 one-time credits to try the API (10 credits daily refill beyond that)
* Ability to purchase credits
* Access all API endpoints available in PRO

## 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.

<table><thead><tr><th width="427.9609375" valign="top">Endpoint</th><th valign="top">Credit Cost per Call (Free &#x26; 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/dex-trades</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><tr><td valign="top">tgm/historical-dex-trades</td><td valign="top">5</td></tr><tr><td valign="top">tgm/historical-who-bought-sold</td><td valign="top">5</td></tr><tr><td valign="top">tgm/historical-token-flow-summary</td><td valign="top">5</td></tr><tr><td valign="top">token-screener/historical</td><td valign="top">5</td></tr><tr><td valign="top">token-screener/historical-perps</td><td valign="top">5</td></tr><tr><td valign="top">profiler/address/historical-token-balances</td><td valign="top">5</td></tr><tr><td valign="top">profiler/address/historical-transactions</td><td valign="top">5</td></tr><tr><td valign="top">profiler/historical-transaction-lookup</td><td valign="top">5</td></tr><tr><td valign="top">tgm/historical-top-holders</td><td valign="top">25</td></tr><tr><td valign="top">tgm/historical-pnl-leaderboard</td><td valign="top">25</td></tr><tr><td valign="top">tgm/historical-token-quant-scores</td><td valign="top">25</td></tr><tr><td valign="top">smart-money/historical-token-balances</td><td valign="top">25</td></tr></tbody></table>

## FAQs

**What happens if I run out of credits?**

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

**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
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

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

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.