Skip to main content
GET
Tag trader leaderboard
GET /v3/tags/{slug}/leaderboard is the path form of a single-tag leaderboard. It supports the same all-time and rolling modes as GET /v3/leaderboard.

Request

Path parameters

Query parameters

Do not combine the path slug with a different tags or tag_slug query value. A conflict returns 400 conflicting_tag_scope.

Rolling example

The equivalent query form is:

All-time example

Omitting period preserves the all-time response and sort behavior. See Leaderboard response fields for the exact all-time and rolling row shapes.

Pagination, empty results, and errors

  • Rolling tag leaderboards return up to 100 rows per request and are capped at rank 1,000. Shorter rankings end at their last returned row.
  • All-time tag leaderboards retain their existing offset pagination and do not use the global all-time 10,000-rank cap.
  • A tag with no realized results in a valid rolling window returns HTTP 200 with an empty leaderboard.
  • A rolling view that is temporarily unavailable returns 503 leaderboard_unavailable.
  • An invalid period, sort, order, filter combination, or rank window returns HTTP 400 with a stable error code.
Rolling tag rows contain realized metrics, event_count, and condition_count. They do not contain historical unrealized P&L, total P&L, open-position counts, or volume.

Authorizations

x-api-key
string
header
required

Path Parameters

slug
string
required

One tag slug, matched case-insensitively.

Query Parameters

period
enum<string>
default:all

Ranking window. Aliases day, week, and month are also accepted. Values all_time and all-time also select all-time mode.

Available options:
1d,
7d,
30d,
all
sort
string

All-time supports the documented all-time sort set. Rolling supports realized_pnl only.

order
enum<string>
default:desc

All-time supports ascending or descending order. Rolling supports descending order only.

Available options:
asc,
desc
limit
integer
default:20

Rows per page. Values below 1 use 1; values above 100 use 100.

Required range: 1 <= x <= 100
offset
integer
default:0

Pagination offset. Negative values use 0. Rolling rankings stop at rank 1,000.

Required range: x >= 0

Response

Ranked wallets. A tag with no realized results in a valid rolling window returns an empty leaderboard.