Token Traders Leaderboard

This endpoint provides a leaderboard of the top traders by trade count, buy/sell/total volume for any SPL token across major Solana DEXs, for a specified recent interval. The leaderboard supports front-end sorting of columns by 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://opabinia.cambrian.network/api/v1/solana/traders/leaderboard

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

Query Parameters

Response Field Descriptions

Examples

1. Get Top USDC Traders (24 Hour)

This example retrieves the top traders for USDC over the past 24 hours.

curl -X GET "https://opabinia.cambrian.network/api/v1/solana/traders/leaderboard?token_address=EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v&interval=24%20HOUR" \
  -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": [
      [
        "5XF5V2r5HfBMXAh8xeBCwdpgEAFsjCfqXvVcN9pGpJEy",
        1,
        0,
        1461346,
        1461346
      ],
      [
        "DbCnMJyx82WTyKvmz3r4GWgPtYCY6jo6uLmP5ZDz4P2G",
        1,
        5953726,
        0,
        5953726
      ],
      [
        "GxcTwfj8jEUBfgoksKjGsEkgCzfcmEu8FLE6LfbJeTfF",
        1,
        19247543,
        0,
        19247543
      ],
      [
        "6WX5qrBBVJB9q9GSHnN3pjR3HhhL4JpiQUuKKjiv9gdk",
        1,
        2946386,
        0,
        2946386
      ]
    ]
  }
]

The response shows the top 4 USDC traders in the past 24 hours, with their wallet addresses, trade counts, and volume breakdowns. The data is returned in columnar format for efficient processing.

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://deep42.cambrian.network/api/v1/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://deep42.cambrian.network/api/v1/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–5 automatically.

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

Related Endpoints

• /api/v1/solana/tokens/holders - Returns a list of accounts currently holding a specific Solana token, sorted by balance
• /api/v1/solana/ohlcv/token - Retrieve Open, High, Low, Close, and Volume data for any SPL token
• /api/v1/solana/price-volume/single - Retrieve current USD price, timeframe volume, and percentage changes for any SPL token
• /api/v1/solana/tokens - Returns a paginated list of known tokens for the Solana chain
• /api/v1/solana/orca/pools/fee-metrics - Retrieves core metrics like fees and volume for specific Orca Whirlpools