FeaturesProductsPricingFAQAPI Reference
API REFERENCE
Wallet Tracking›
News›
Data Trackers›
Streaming›
Wallet Tracking

Get trader leaderboard

Returns a ranked list of traders based on trading performance metrics. Supports filtering by category, timeframe, and extensive numeric range filters. Also supports a tradedIn filter to find traders who traded in specific events/markets.

Permission required: leaderboard:read

GEThttps://data.fireplace.gg/api/v1/external/leaderboard/leaderboard

Parameters

categoriesstring

Comma-separated list of categories to filter by (e.g. "Politics,Sports"). "all" or omit for no filter.

timeframestring

Time period for metrics. today, weekly, monthly are aliases for 1d, 7d, 30d.

sort_bystring

Field to sort by (e.g. total_pnl, volume_usd, win_rate, trade_count, roi)

sort_orderstring
limitinteger
offsetinteger
tradedInstring

JSON array of { eventId, marketIds? } to filter traders who traded in specific markets. Example: [{"eventId":"abc123","marketIds":["m1","m2"]}]. If marketIds is empty, all markets for that event are resolved.

min_volumenumber

Minimum volume USD

max_volumenumber

Maximum volume USD

min_tradesinteger
max_tradesinteger
min_win_ratenumber
max_win_ratenumber
min_roinumber
max_roinumber
min_pnlnumber
max_pnlnumber
min_realized_pnlnumber
max_realized_pnlnumber
min_unrealized_pnlnumber
max_unrealized_pnlnumber
min_avg_entry_pricenumber
max_avg_entry_pricenumber
min_avg_trade_sizenumber
max_avg_trade_sizenumber
min_trades_per_daynumber
max_trades_per_daynumber
min_markets_tradedinteger
max_markets_tradedinteger
has_x_profileboolean

Filter to traders with (true) or without (false) a linked X/Twitter profile. Omit for no filter.

activeWithinDaysinteger

Only include traders with at least one trade in the last N days (1–365).

Response

200application/json

Leaderboard retrieved successfully

successboolean
messagestring
dataobject
Get trader leaderboard
curl --request GET \
  --url https://data.fireplace.gg/api/v1/external/leaderboard/leaderboard \
  --header "X-API-Key: fp_pk_…" \
  --header "X-API-Secret: fp_sk_…"
200401429
{
  "success": true,
  "message": "string",
  "data": {
    "leaderboard": [
      {
        "user_address": "string",
        "username": "string",
        "win_rate": 0,
        "avg_entry_price": 0,
        "avg_trade_size_usd": 0,
        "roi": 0,
        "avg_daily_roi": 0,
        "trade_count": 0,
        "avg_daily_trade_count": 0,
        "total_markets_traded": 0,
        "pnl_percentage": 0,
        "volume_usd": 0,
        "total_pnl": 0,
        "realized_pnl": 0,
        "unrealized_pnl": 0,
        "cash_balance": 0,
        "first_trade_timestamp": 0,
        "last_trade_timestamp": 0
      }
    ],
    "category": "string",
    "timeframe": "string",
    "sort_by": "string",
    "limit": 0,
    "offset": 0
  }
}