# Vybe Solana Analytics API – Top Traders

> Vybe Solana Analytics API – Top Traders is a paid API for AI agents from x402-api.vybenetwork.xyz, paid per call via x402, $0.015/call, status unknown (last checked 2026-10-02).

Returns a ranked leaderboard of top Solana wallet traders with PnL, win rate, and volume metrics, filterable by token, label, and time resolution

## Facts

- Endpoint: GET https://x402-api.vybenetwork.xyz/v4/wallets/top-traders?utm_source=zero.xyz
- Price: $0.015/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-02
- Activations on Zero: 0
- Tags: x402, finance
- Canonical page: https://www.zero.xyz/c/vybe-solana-analytics-api-top-traders-9e62bc76
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_sHbcbRizg0qSR_oX3J888

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 vybe-solana-analytics-api-top-traders-9e62bc76
```

Example prompt: Show me the top 50 Solana traders over the last 7 days sorted by realized PnL descending, and filter results to only show wallets trading the token at mint address So11111111111111111111111111111111111111112.

## When to prefer this

Use this endpoint when you need a ranked leaderboard of Solana traders with rich performance metrics (PnL, win rate, volume) across configurable time windows. Prefer it over generic wallet lookup endpoints when the goal is comparative ranking, alpha research, or identifying whale wallets associated with a specific token. It is the right choice when you need paginated, sortable, filterable trader performance data rather than a single wallet's history.

## Known failure modes

- Payment not provided or insufficient USDC balance — 402 Payment Required
- Invalid mint address format — 400 Bad Request
- Both sortByAsc and sortByDesc specified simultaneously — 400 Bad Request
- Invalid resolution value outside 1d/7d/30d — 400 Bad Request
- Page or limit out of range — 400 or empty data array
- Network timeout or upstream Solana RPC lag — 503 or delayed response

## How this service works

Solana API endpoint for fetching top traders on Solana ranked by PnL, win rate and volume. Power copy trading leaderboards and smart money discovery tools.

## Output

An array of trader records, each containing the wallet's public key, display name, labels, logo and Twitter URLs, and a metrics object with realized PnL, unrealized PnL, win rate, trade volume, and trade count — all denominated in USD and ranked per the requested sort field and time resolution.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "page": {
   "type": "integer",
   "format": "int32",
   "minimum": 0,
   "nullable": true,
   "description": "The requested page."
  },
  "label": {
   "allOf": [
    {
     "enum": [
      "All",
      "Kol"
     ],
     "type": "string",
     "description": "Represents the label type for trader categorization."
    }
   ],
   "nullable": true,
   "description": "Represents the label type for trader categorization. Default is 'all'."
  },
  "limit": {
   "type": "integer",
   "format": "int32",
   "minimum": 0,
   "nullable": true,
   "description": "The limit of entries to return. If not passed, a maximum of 1000 entries are returned."
  },
  "sortByAsc": {
   "type": "string",
   "nullable": true,
   "description": "Sort ascending by 'realizedPnlUsd', 'unrealizedPnlUsd', 'winRate', 'tradesVolumeUsd', 'tradesCount', 'accountAddress'. Only one of sort_by_asc or sort_by_desc can be used."
  },
  "resolution": {
   "allOf": [
    {
     "enum": [
      "1d",
      "7d",
      "30d"
     ],
     "type": "string",
     "description": "Represents the supported time-window resolutions for account/PnL queries."
    }
   ],
   "nullable": true,
   "description": "Resolution of the data. Possible values: 1d, 7d, 30d. Default is \"1d\"."
  },
  "sortByDesc": {
   "type": "string",
   "nullable": true,
   "description": "Sort descending by 'realizedPnlUsd', 'unrealizedPnlUsd', 'winRate', 'tradesVolumeUsd', 'tradesCount', 'accountAddress'. Only one of sort_by_asc or sort_by_desc can be used."
  },
  "ilikeFilter": {
   "type": "string",
   "nullable": true,
   "description": "Optional ILIKE filter applied to both trader names and address fields for any match."
  },
  "mintAddress": {
   "allOf": [
    {
     "type": "string",
     "format": "pubkey"
    }
   ],
   "nullable": true,
   "description": "The token mint address filter for tokens. Provides the token address to filter the requested data by."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "data"
 ],
 "properties": {
  "data": {
   "type": "array",
   "items": {
    "type": "object",
    "required": [
     "accountAddress",
     "accountLabels",
     "metrics"
    ],
    "properties": {
     "metrics": {
      "type": "object",
      "required": [
       "realizedPnlUsd",
       "unrealizedPnlUsd",
       "winRate",
       "tradesVolumeUsd",
       "tradesCount",
       "sevenDayPnl"
      ],
      "properties": {
       "winRate": {
        "type": "number",
        "format": "double",
        "description": "The percentage of winning trades (0.0 to 100.0)."
       },
       "sevenDayPnl": {
        "type": "array",
        "items": {
         "type": "array",
         "items": {
          "type": "number",
          "format": "double"
         }
        },
        "description": "The profit and loss trend over the last seven days."
       },
       "tradesCount": {
        "type": "integer",
        "format": "int64",
        "minimum": 0,
        "description": "The total number of trades executed."
       },
       "realizedPnlUsd": {
        "type": "number",
        "format": "double",
        "description": "The total realized profit in USD."
       },
       "tradesVolumeUsd": {
        "type": "number",
        "format": "double",
        "description": "The total trading volume in USD."
       },
       "unrealizedPnlUsd": {
        "type": "number",
        "format": "double",
        "description": "The total unrealized profit in USD."
       },
       "uniqueTokensTraded": {
        "type": "integer",
        "format": "int64",
        "minimum": 0,
        "nullable": true,
        "description": "The count of unique tokens traded by the account."
       },
       "bestPerformingToken": {
        "allOf": [
         {
          "type": "object",
          "required": [
           "mintAddress",
           "pnlUsd"
          ],
          "properties": {
           "pnlUsd": {
            "type": "number",
            "format": "double",
            "description": "The profit or loss for the token in USD."
           },
           "tokenName": {
            "type": "string",
            "nullable": true,
            "description": "The name of token (if any)."
           },
           "mintAddress": {
            "type": "string",
            "description": "The address of mint."
           },
           "tokenSymbol": {
            "type": "string",
            "nullable": true,
            
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/vybe-solana-analytics-api-top-traders-9e62bc76/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402-api.vybenetwork.xyz](https://www.zero.xyz/host/x402-api.vybenetwork.xyz/llms.txt)
