# Nansen Smart Money PnL Leaderboard

> Nansen Smart Money PnL Leaderboard is a paid API for AI agents from api.nansen.ai, paid per call via x402, $0.05/call, status unknown (last checked 2026-09-13).

Returns a ranked leaderboard of smart money wallet addresses sorted by profit and loss (PnL) over a specified timeframe across one or more blockchain networks.

## Facts

- Endpoint: GET https://api.nansen.ai/api/v1/smart-money/pnl-leaderboard
- Price: $0.05/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/nansen-smart-money-pnl-leaderboard-689a9e24
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_qdu5C29qFUwAG594mZ04D

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability nansen-smart-money-pnl-leaderboard-689a9e24
```

Example prompt: Pull up Nansen's smart money PnL leaderboard for all chains over the last 30 days, sorted by total PnL in USD descending, and show me the top 20 wallets.

## When to prefer this

Use this endpoint when you need a ranked view of which smart money wallets have the highest profit and loss over a specific time window, across one or more chains. Prefer this over individual token PnL or DEX trade endpoints when the goal is portfolio-level performance ranking of notable on-chain traders rather than token-specific analysis.

## Known failure modes

- Invalid timeframe value returns a 400 error — only allowed integer day values are accepted
- Unsupported chain identifier causes a 422 validation error
- Missing or invalid API key returns 401 Unauthorized
- Payment not fulfilled triggers 402 Payment Required
- Pagination parameters out of range may return empty results
- Rate limiting may cause 429 Too Many Requests

## How this service works

Get Smart Money PnL Leaderboard

## Output

A ranked list of wallet addresses labeled as 'smart money' by Nansen, each with their total PnL in USD and associated metadata, ordered by profit performance over the requested timeframe and filtered to the specified chains.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "chains": {
   "type": "array"
  },
  "filters": {
   "type": "object"
  },
  "order_by": {
   "type": "array"
  },
  "timeframe": {
   "type": "integer"
  },
  "pagination": {
   "type": "object"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/nansen-smart-money-pnl-leaderboard-689a9e24/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.nansen.ai](https://www.zero.xyz/host/api.nansen.ai/llms.txt)