Token Traders Leaderboard

Overview

Returns a leaderboard of the top traders for a specified SPL token, ranked by trade count and buy/sell/total volume across major Solana DEXs over a recent lookback interval. Supports front-end sorting on total_volume, buy_volume, sell_volume, and trade_count.

Business Value

• Trading Intelligence: Identify the most active traders for any SPL token to understand market dynamics and trading patterns
• Market Analysis: Track who's driving volume and trades for specific tokens across multiple DEX platforms
• Real-time Insights: Get recent trading activity with configurable time intervals from 30 minutes to 24 hours
• Volume Tracking: Separate buy and sell volume metrics provide detailed trading behavior analysis
• Performance Ranking: Sortable columns enable flexible analysis of trader performance across multiple dimensions

Endpoint Details

URL:

https://api.cambrian.org/solana/traders/leaderboard

Method: GET
Authentication: Required via X-API-Key header

Query Parameters

Response Field Descriptions

Examples

1. Get Top Traders for USDC over 24 Hours

Retrieves the trader leaderboard for USDC over the last 24 hours, ranked by activity.

curl -X GET "https://api.cambrian.org/solana/traders/leaderboard?token_address=EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v&interval=24+HOUR" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json"

Response:

[
  {
    "columns": [
      {
        "name": "trader",
        "type": "FixedString(44)"
      },
      {
        "name": "tradeCount",
        "type": "UInt64"
      },
      {
        "name": "sellVolume",
        "type": "UInt128"
      },
      {
        "name": "buyVolume",
        "type": "UInt128"
      },
      {
        "name": "totalVolume",
        "type": "UInt128"
      }
    ],
    "data": [
      [
        "48Mp1KAiD8BoLEh9p1DudCuKRoPVpmkvzhygj9mAqv25",
        1,
        10780040,
        0,
        10780040
      ],
      [
        "H61ukuFZwQgCm2oMfBPkRxv8keTCr7JfXSGGZ9EnaYsz",
        1,
        0,
        60260280,
        60260280
      ],
      [
        "CZ7mTtg9rjtWz7CXSUuRU9ecjfyFekixQSn3ffHEuhZh",
        1,
        20580077,
        0,
        20580077
      ],
      [
        "Amn7NaWDsor2dvXN4pqH2h4HyuAnp1rbLtDHiyjfdWAr",
        1,
        5675348,
        0,
        5675348
      ],
      [
        "9d5H8CnxtqzfB373tcdyqdg829mLBHMe6yriKsdCVCPN",
        6,
        7872529,
        59391009,
        67263538
      ],
      [
        "77nDwqMiFmKDUhe7J6TVscvgkG68iXQYSufyvHohEW3v",
        1,
        0,
        29402692,
        29402692
      ],
      [
        "6452cmt8gS9gWMFGiBzVWjtSMmKiJ3WgsczBcqBEzthp",
        1,
        0,
        8111709,
        8111709
      ],
      [
        "GSQ3dijmF3TUAvGXffY8sfb5Gf4USAWLTKDTMUda8g6i",
        1,
        0,
        66957,
        66957
      ],
      [
        "6SyEc5vGePVXkHKx21sitsYmMHzS2GGiRqWuqY6FDwHv",
        1,
        24500099,
        0,
        24500099
      ],
      [
        "6w91mtDw46YBmHHhWmcRTNREUgLKcgmPxtC7Yz7VMyfh",
        1,
        0,
        546500,
        546500
      ]
    ],
    "rows": 38553
  }
]

Result collections are limited to 10 items. The response shows the top 10 traders (out of 38,553 total unique traders in the interval) for USDC, ranked by activity, with wallet 9d5H8CnxtqzfB373tcdyqdg829mLBHMe6yriKsdCVCPN showing both buy and sell activity across 6 trades.

x402 Payment Option

This endpoint supports pay-per-use access via the x402 payment protocol (v2): pay $0.05 USDC per request using blockchain micropayments. No API key required.

Quick Start (TypeScript)

npm install @x402/fetch @x402/evm viem

import { x402Client } from "@x402/core/client";
import { ExactEvmScheme } from "@x402/evm/exact/client";
import { wrapFetchWithPayment } from "@x402/fetch";
import { privateKeyToAccount } from "viem/accounts";

const signer = privateKeyToAccount(process.env.EVM_PRIVATE_KEY as `0x${string}`);
const client = new x402Client();
client.register("eip155:*", new ExactEvmScheme(signer));

const fetchWithPayment = wrapFetchWithPayment(fetch, client);
const response = await fetchWithPayment(
  "https://x402.cambrian.org/solana/traders/leaderboard"
);
const data = await response.json();

Quick Start (Python)

pip install "x402[httpx]"

import asyncio, os
from eth_account import Account
from x402 import x402Client
from x402.http.clients import x402HttpxClient
from x402.mechanisms.evm import EthAccountSigner
from x402.mechanisms.evm.exact.register import register_exact_evm_client

async def main():
    client = x402Client()
    account = Account.from_key(os.getenv("EVM_PRIVATE_KEY"))
    register_exact_evm_client(client, EthAccountSigner(account))

    async with x402HttpxClient(client) as http:
        response = await http.get("https://x402.cambrian.org/solana/traders/leaderboard")
        print(response.json())

asyncio.run(main())

Payment Flow

1. Send a normal request to the endpoint (no API key needed)
2. Server returns 402 Payment Required with payment details
3. The x402 SDK automatically signs a payment authorization with your wallet
4. The SDK resubmits the request with the signed payment
5. Server verifies payment and returns the API response

The x402 SDK handles steps 2 through 5 automatically.

Network: Base (chain ID 8453) | Currency: USDC | Price: $0.05 per request