Skip to main content

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.

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

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}'

Example Response

{
  "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": "deepseek-v3.2",
  "latency_ms": 1567,
  "timestamp": "2026-04-17T10:30:00.000Z"
}

Data Fields