# Nansen API
> On-chain analytics API covering smart money flows, token metrics, wallet profiling, Nansen Score, perpetual markets, prediction markets, and token screening across multiple blockchains.

## Agent Summary
- FQN: `nansen-ai/nansen-api`
- Category: finance
- Operator: nansen-ai
- Origin: nansen-ai
- Version: 
- Endpoints: 56
- Pricing: free
- HTML page: https://pay.sh/services/nansen-ai/nansen-api
- Markdown page: https://pay.sh/services/nansen-ai/nansen-api/index.md

## Service URLs
- Gateway: https://api.nansen.ai
- Source: solana-foundation/pay-skills
- Source path: providers/nansen-ai/nansen-api/PAY.md
- Source skill: pay-skills

## Use Case
Use for smart money tracking, wallet profiling and PnL analysis, token holder and flow analytics, on-chain signal discovery, Nansen Score token rankings, perpetual and prediction market data, and token screening.

## Endpoint Table
| Method | Path | Pricing | Description |
| --- | --- | --- | --- |
| POST | api/v1/agent/expert | free | Interact with the Nansen Research Agent in "expert" mode |
| POST | api/v1/agent/fast | free | Interact with the Nansen Research Agent in "fast" mode |
| POST | api/v1/nansen-score/top-tokens | free | Get Nansen Score Top Tokens |
| POST | api/v1/perp-leaderboard | free | Get Perpetual Trading Leaderboard Data |
| POST | api/v1/perp-screener | free | Get Perpetual Contract Screening Data |
| POST | api/v1/prediction-market/address-summary | free | Get Prediction Market Address Summary |
| POST | api/v1/prediction-market/categories | free | Get Prediction Market Categories |
| POST | api/v1/prediction-market/event-screener | free | Get Prediction Market Event Screener |
| POST | api/v1/prediction-market/market-screener | free | Get Prediction Market Screener |
| POST | api/v1/prediction-market/ohlcv | free | Get Prediction Market OHLCV Candles |
| POST | api/v1/prediction-market/orderbook | free | Get Prediction Market Orderbook |
| POST | api/v1/prediction-market/pnl-by-address | free | Get Prediction Market PnL by Address |
| POST | api/v1/prediction-market/pnl-by-market | free | Get Prediction Market PnL by Market |
| POST | api/v1/prediction-market/position-detail | free | Get Prediction Market Position Detail |
| POST | api/v1/prediction-market/top-holders | free | Get Prediction Market Top Holders |
| POST | api/v1/prediction-market/trades-by-address | free | Get Prediction Market Trades by Address |
| POST | api/v1/prediction-market/trades-by-market | free | Get Prediction Market Trades by Market |
| POST | api/v1/profiler/address/counterparties | free | Get Address Counterparties Data |
| POST | api/v1/profiler/address/current-balance | free | Get Address Current Balance Data |
| POST | api/v1/profiler/address/historical-balances | free | Get Address Historical Balances Data |
| POST | api/v1/profiler/address/pnl | free | Retrieve address PnL data |
| POST | api/v1/profiler/address/pnl-summary | free | Get Address PnL Summary Data |
| POST | api/v1/profiler/address/related-wallets | free | Get Address Related Wallets Data |
| POST | api/v1/profiler/address/transactions | free | Get Address Transactions Data |
| POST | api/v1/profiler/perp-positions | free | Get Perpetual Positions Data |
| POST | api/v1/smart-money/dcas | free | Get Smart Money DCAs Data |
| POST | api/v1/smart-money/dex-trades | free | Get Smart Money DEX Trades Data |
| POST | api/v1/smart-money/historical-holdings | free | Get Smart Money Historical Holdings Data |
| POST | api/v1/smart-money/holdings | free | Get Smart Money Holdings Data |
| POST | api/v1/smart-money/netflow | free | Get Smart Money Netflow Data |
| POST | api/v1/smart-money/perp-trades | free | Get Smart Money Perpetual Trades Data |
| POST | api/v1/tgm/dex-trades | free | Get "Token God Mode" (TGM) DEX trades data |
| POST | api/v1/tgm/holders | free | Get "Token God Mode" (TGM) holders data |
| POST | api/v1/tgm/indicators | free | Get Nansen Score Indicators |
| POST | api/v1/tgm/jup-dca | free | Get "Token God Mode" (TGM) Jupiter DCA data |
| POST | api/v1/tgm/perp-pnl-leaderboard | free | Get "Token God Mode" (TGM) perp PnL leaderboard data |
| POST | api/v1/tgm/perp-positions | free | Get "Token God Mode" (TGM) perp positions data |
| POST | api/v1/tgm/pnl-leaderboard | free | Get "Token God Mode" (TGM) PnL leaderboard data |
| POST | api/v1/tgm/position-intelligence | free | Get "Token God Mode" (TGM) position intelligence data |
| POST | api/v1/tgm/token-information | free | Get "Token God Mode" (TGM) token information data |
| POST | api/v1/tgm/token-ohlcv | free | Retrieve token OHLCV candle data |
| POST | api/v1/tgm/transfers | free | Get "Token God Mode" (TGM) transfers data |
| POST | api/v1/tgm/who-bought-sold | free | Get "Token God Mode" (TGM) who bought/sold data |
| POST | api/v1/token-screener | free | Retrieve token screener data |
| POST | api/v1/transaction-with-token-transfer-lookup | free | Get Transaction with Token Transfer Lookup Data |
| POST | api/v1beta1/profiler/address/historical-token-balances | free | Get Historical Balances by Address (Beta) |
| POST | api/v1beta1/profiler/address/historical-transactions | free | Get Historical Transactions for an Address (Beta) |
| POST | api/v1beta1/profiler/historical-transaction-lookup | free | Get Historical (Time-Travel) Transaction Lookup Data (Beta) |
| POST | api/v1beta1/smart-money/historical-token-balances | free | Get Historical SM Token Balances (Beta) |
| POST | api/v1beta1/tgm/historical-dex-trades | free | Get historical "Token God Mode" (TGM) DEX trades (Beta) |
| POST | api/v1beta1/tgm/historical-pnl-leaderboard | free | Get historical "Token God Mode" (TGM) PnL leaderboard (Beta) |
| POST | api/v1beta1/tgm/historical-token-flow-summary | free | Get historical "Token God Mode" (TGM) token flow summary (Beta) |
| POST | api/v1beta1/tgm/historical-token-quant-scores | free | Get Historical Token Quant Scores (Beta) |
| POST | api/v1beta1/tgm/historical-top-holders | free | Get historical "Token God Mode" (TGM) top holders (Beta) |
| POST | api/v1beta1/tgm/historical-who-bought-sold | free | Get historical "Token God Mode" (TGM) who bought/sold (Beta) |
| POST | api/v1beta1/token-screener/historical | free | Get Historical Token Screener (Beta) |