> ## Documentation Index
> Fetch the complete documentation index at: https://docs.hyreagent.fun/llms.txt
> Use this file to discover all available pages before exploring further.

# Top Wallets

> Top performing wallets leaderboard ranked by PnL.

# POST /traders/top-wallets

Leaderboard of the highest-performing Solana wallets ranked by realized PnL over a given period. Useful for identifying alpha wallets to track and copy-trade.

**Price:** \$0.008 per request

**Signal vocabulary:** `follow` | `ignore`

**Sources:** Solana RPC

***

## Parameters

**period** `string` (default: 24h)

Time period for the leaderboard. Options: `24h`, `7d`.

**limit** `integer` (default: 20)

Maximum number of wallets to return (max 50).

***

## Example Request

```bash curl theme={null}
curl -X POST https://mpp.hyreagent.fun/traders/top-wallets \
  -H "Content-Type: application/json" \
  -H "X-PAYMENT: <x402-payment>" \
  -d '{"period": "24h", "limit": 10}'
```

```bash GET (legacy) theme={null}
curl "https://mpp.hyreagent.fun/traders/top-wallets?period=24h&limit=10" \
  -H "X-PAYMENT: <x402-payment>"
```

***

## Example Response

```json theme={null}
{
  "data": {
    "period": "24h",
    "wallets": [
      {
        "address": "7pKm2...",
        "pnl_usd": 45200,
        "win_rate_pct": 82.1,
        "trades": 23,
        "best_token": "BONK",
        "best_trade_pnl_usd": 18400
      },
      {
        "address": "3vFq8...",
        "pnl_usd": 31800,
        "win_rate_pct": 76.5,
        "trades": 41,
        "best_token": "WIF",
        "best_trade_pnl_usd": 9200
      }
    ],
    "total_wallets_analyzed": 5000
  },
  "insight": "Top performer 7pKm2 made $45K in 23 trades — a sniper pattern with 82% hit rate. Notable that 3 of the top 10 wallets share similar entry timing, suggesting alpha group coordination.",
  "signal": "follow",
  "confidence": 0.83,
  "sources": ["solana-rpc"],
  "model_used": "gemini-2.5-flash-lite",
  "latency_ms": 1567,
  "timestamp": "2026-04-17T10:30:00.000Z"
}
```

***

## Data Fields

**Wallet leaderboard fields**

| Field | Type | Description |
| - | - | - |
| `address` | string | Wallet address |
| `pnl_usd` | number | Net realized PnL in USD for the period |
| `win_rate_pct` | number | Percentage of profitable trades |
| `trades` | number | Total trades in the period |
| `best_token` | string | Token with the highest single-trade profit |
| `best_trade_pnl_usd` | number | PnL of the best single trade |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.