Skip to main content
GET
/
v2
/
leaderboard
/
copytraded
Get Leaderboard of Most Copytraded (V2)
curl --request GET \
  --url https://api.clicker.xyz/v2/leaderboard/copytraded \
  --header 'Authorization: Bearer <token>'
{
  "periodStartUnix": 123,
  "periodEndUnix": 123,
  "ranking": 123,
  "traders": [
    {
      "profile": {
        "id": "<string>",
        "name": "<string>",
        "images": {
          "raw": "<string>",
          "xs": "<string>",
          "sm": "<string>"
        },
        "addresses": [
          "<string>"
        ],
        "metadata": {
          "farcasterUsername": "<string>",
          "farcasterId": 123,
          "lensHandle": "<string>",
          "ensName": "<string>",
          "twitterHandle": "<string>",
          "debankName": "<string>",
          "pumpName": "<string>",
          "commentCount30d": 123,
          "pnl30d": 123,
          "winRate30d": 123,
          "tradeCount30d": 123,
          "roiPercent30d": 123,
          "perAddressPnl30d": {},
          "perAddressRoiPercent30d": {},
          "perChainPnl30d": {
            "solana": 123,
            "ethereum": 123,
            "base": 123,
            "hyperliquid": 123
          },
          "perChainRoiPercent30d": {
            "solana": 123,
            "ethereum": 123,
            "base": 123,
            "hyperliquid": 123
          },
          "perChainVolumeUsd30d": {
            "solana": 123,
            "ethereum": 123,
            "base": 123,
            "hyperliquid": 123
          }
        },
        "metrics": {
          "thisPartner": {
            "followingCount": 123,
            "followerCount": 123
          },
          "allPartners": {
            "followingCount": 123,
            "followerCount": 123
          },
          "comments": {
            "commentCount30d": 123,
            "commentCountAllTime": 123
          },
          "copytradedAllTime": {
            "count": 123,
            "distinctActors": 123,
            "volumeUSD": 123
          }
        }
      },
      "pnl": {
        "total": 123,
        "perChain": {
          "base": 123,
          "solana": 123,
          "ethereum": 123,
          "hyperliquid": 123
        }
      },
      "hasComments": true,
      "copytrades": {
        "count": 123,
        "distinctActors": 123,
        "volumeUSD": 123
      }
    }
  ]
}
Get the leaderboard of traders whose swap comments have been most copied by other users.

How It Works

This leaderboard ranks traders based on:
  • Copy count: Number of times their comments were copied
  • Distinct actors: Number of unique users who copied their trades
  • Volume: Total USD volume of copytrades attributed to their comments

Usage

# Get copytraded leaderboard
GET /v2/leaderboard/copytraded

# With chain filter
GET /v2/leaderboard/copytraded?chains=base

# Check your own ranking
GET /v2/leaderboard/copytraded?address=0x1234...

Response

{
  "periodStartUnix": 1706889600,
  "periodEndUnix": 1707494400,
  "ranking": 5,
  "traders": [
    {
      "profile": { ... },
      "pnl": {
        "total": 125000,
        "perChain": { ... }
      },
      "hasComments": true,
      "copytrades": {
        "count": 150,
        "distinctActors": 42,
        "volumeUSD": 500000
      }
    }
  ]
}

Leaderboard Period

The copytraded leaderboard operates on a weekly period:
  • Starts: Friday at 12:00 PM ET
  • Ends: Following Friday at 12:00 PM ET
The periodStartUnix and periodEndUnix fields indicate the current period boundaries.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

address
string
default:0xa4e221aa5a7ba51b5d5c7d5c923bfb9bcebcb252

The address / public key.

chains
Available options:
base,
solana,
ethereum,
hyperliquid

Response

200

periodStartUnix
number
required
periodEndUnix
number
required
ranking
number | null
required
traders
object[]
required