# Nansen DEX Trades - Token PnL Leaderboard

> Nansen DEX Trades - Token PnL Leaderboard is a paid API for AI agents from api.nansen.ai, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-14).

Returns a PnL leaderboard of traders for a specific token on a given blockchain, ranked by profitability over a date range.

## Facts

- Endpoint: GET https://api.nansen.ai/api/v1/profiler/dex-trades
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/nansen-dex-trades-token-pnl-leaderboard-01e5e481
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Ln__v1HJWt18OauWjP1Io

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-dex-trades-token-pnl-leaderboard-01e5e481
```

Example prompt: Show me the top PnL leaderboard for the PEPE token on Ethereum between January 1 and January 31 2025, filtering for traders with at least 10 trades — I want to see which wallets made the most money.

## When to prefer this

Use this endpoint when you need to identify the most profitable traders of a specific token over a defined time window on a supported blockchain. Ideal for smart money analysis, alpha discovery, and understanding which wallets are winning on a particular token. Prefer this over generic DEX trade endpoints when a ranked PnL view is needed rather than raw trade-by-trade data.

## Known failure modes

- Invalid or unsupported chain returns 400 or empty result
- Token address not found on the specified chain returns empty leaderboard
- Date range too wide or no data available for the period
- Missing required fields (chain, token_address, date) returns 422 validation error
- API key invalid or quota exceeded returns 401/429

## How this service works

Get Wallet DEX Trades

## Output

A ranked list of wallet addresses showing their profit and loss (PnL) metrics for trading a specific token over the requested date range, including number of trades, holding value in USD, realized and unrealized gains, and Nansen smart money labels where applicable.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "date": {
   "type": "object"
  },
  "chain": {
   "type": "string"
  },
  "address": {
   "type": "string"
  },
  "filters": {
   "type": "object"
  },
  "order_by": {
   "type": "array"
  },
  "pagination": {
   "type": "object"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/nansen-dex-trades-token-pnl-leaderboard-01e5e481/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)