Leaderboard

Get trader leaderboard

Returns ranked traders (grades S/A/B) sorted by score descending. Supports cursor pagination and optional category/strategy filters.

get/api/v1/leaderboard

Query parameters

limitinteger

Maximum number of ranked traders to return.

cursorstring

Opaque lbv1_ pagination cursor from a prior response. It binds the finite score/address boundary to the committed leaderboard generation and the effective category/strategy filters; legacy, malformed, non-finite, and unsupported-version cursors are rejected.

categorystring

Filter by category. Values are matched to canonical category buckets: political variants (Elections, Global Politics, U.S. Politics, ...) fold into Politics, Geopolitics stays distinct, Culture/Entertainment map to Pop Culture, Science maps to Science & Tech, and Finance/Business map to Stocks. Mapped buckets are case-insensitive; passthrough categories (Crypto, NBA, and the sports leagues) match case-sensitively against the provider-native bucket key, so use exact casing (e.g. Crypto, NBA).

Filter by ML-detected strategy type. Values come from backend/crates/analytics/src/trader_analysis/classification/decision_tree.rs and are matched exactly against ml_trader_category.primary_type. Values outside the declared enum return HTTP 400.

Headers

If-None-Matchstring

Conditional GET validator from a previous ETag. Matching values return 304 Not Modified with an empty body.

Response

Ranked trader list

object'list' required

has_moreboolean required

next_cursorstring nullable

totalinteger nullable

Total matching rows when the read model exposes a count; absent (or null) when it does not.

Changes

Changed in 9 of the 31 revisions of this API.174147

Aug 29, 20267c0c7cdd41ee7See the full diff
- ●
  added the new database_unavailable enum value to the error/reason response property for the response status 400
  response-property-enum-value-added
- ●
  added the new database_unavailable enum value to the error/reason response property for the response status 401
  response-property-enum-value-added
- ●
  added the new database_unavailable enum value to the error/reason response property for the response status 402
  response-property-enum-value-added
- ●
  added the new database_unavailable enum value to the error/reason response property for the response status 403
  response-property-enum-value-added
- ●
  added the new database_unavailable enum value to the error/reason response property for the response status 423
  response-property-enum-value-added
- ●
  added the new database_unavailable enum value to the error/reason response property for the response status 429
  response-property-enum-value-added
- ●
  added the new database_unavailable enum value to the error/reason response property for the response status 503
  response-property-enum-value-added
Aug 29, 20268582a359fa0715See the full diff
- ○
  added the non-success response with the status 400
  response-non-success-status-added
- ○
  added the optional property meta/ranking_as_of to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property meta/ranking_as_of to the response with the 401 status
  response-optional-property-added
- ○
  added the optional property meta/ranking_as_of to the response with the 402 status
  response-optional-property-added
- ○
  added the optional property meta/ranking_as_of to the response with the 403 status
  response-optional-property-added
- ○
  added the optional property meta/ranking_as_of to the response with the 423 status
  response-optional-property-added
- ○
  added the optional property meta/ranking_as_of to the response with the 429 status
  response-optional-property-added
- ○
  added the optional property meta/ranking_as_of to the response with the 503 status
  response-optional-property-added
- ○
  added the optional property meta/ranking_generation to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property meta/ranking_generation to the response with the 401 status
  response-optional-property-added
- ○
  added the optional property meta/ranking_generation to the response with the 402 status
  response-optional-property-added
- ○
  added the optional property meta/ranking_generation to the response with the 403 status
  response-optional-property-added
- ○
  added the optional property meta/ranking_generation to the response with the 423 status
  response-optional-property-added
- ○
  added the optional property meta/ranking_generation to the response with the 429 status
  response-optional-property-added
- ○
  added the optional property meta/ranking_generation to the response with the 503 status
  response-optional-property-added
Jul 30, 202619193b1771541277See the full diff
- ●
  added the new idempotency_in_progress enum value to the error/reason response property for the response status 401
  response-property-enum-value-added
- ●
  added the new idempotency_in_progress enum value to the error/reason response property for the response status 402
  response-property-enum-value-added
- ●
  added the new idempotency_in_progress enum value to the error/reason response property for the response status 403
  response-property-enum-value-added
- ●
  added the new idempotency_in_progress enum value to the error/reason response property for the response status 423
  response-property-enum-value-added
- ●
  added the new idempotency_in_progress enum value to the error/reason response property for the response status 429
  response-property-enum-value-added
- ●
  added the new idempotency_in_progress enum value to the error/reason response property for the response status 503
  response-property-enum-value-added
- ●
  added the new webhook_delivery_in_progress enum value to the error/reason response property for the response status 401
  response-property-enum-value-added
- ●
  added the new webhook_delivery_in_progress enum value to the error/reason response property for the response status 402
  response-property-enum-value-added
- ●
  added the new webhook_delivery_in_progress enum value to the error/reason response property for the response status 403
  response-property-enum-value-added
- ●
  added the new webhook_delivery_in_progress enum value to the error/reason response property for the response status 423
  response-property-enum-value-added
- ●
  added the new webhook_delivery_in_progress enum value to the error/reason response property for the response status 429
  response-property-enum-value-added
- ●
  added the new webhook_delivery_in_progress enum value to the error/reason response property for the response status 503
  response-property-enum-value-added
- ○
  added the optional property meta/category_skill_base_payload_hash to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property meta/category_skill_base_payload_hash to the response with the 401 status
  response-optional-property-added
- ○
  added the optional property meta/category_skill_base_payload_hash to the response with the 402 status
  response-optional-property-added
- ○
  added the optional property meta/category_skill_base_payload_hash to the response with the 403 status
  response-optional-property-added
- ○
  added the optional property meta/category_skill_base_payload_hash to the response with the 423 status
  response-optional-property-added
- ○
  added the optional property meta/category_skill_base_payload_hash to the response with the 429 status
  response-optional-property-added
- ○
  added the optional property meta/category_skill_base_payload_hash to the response with the 503 status
  response-optional-property-added
- ○
  added the optional property meta/category_skill_enriched_base_payload_hash to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property meta/category_skill_enriched_base_payload_hash to the response with the 401 status
  response-optional-property-added
- ○
  added the optional property meta/category_skill_enriched_base_payload_hash to the response with the 402 status
  response-optional-property-added
- ○
  added the optional property meta/category_skill_enriched_base_payload_hash to the response with the 403 status
  response-optional-property-added
- ○
  added the optional property meta/category_skill_enriched_base_payload_hash to the response with the 423 status
  response-optional-property-added
- ○
  added the optional property meta/category_skill_enriched_base_payload_hash to the response with the 429 status
  response-optional-property-added
- ○
  added the optional property meta/category_skill_enriched_base_payload_hash to the response with the 503 status
  response-optional-property-added
- ○
  added the optional property meta/category_skill_model_operationally_degraded to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property meta/category_skill_model_operationally_degraded to the response with the 401 status
  response-optional-property-added
- ○
  added the optional property meta/category_skill_model_operationally_degraded to the response with the 402 status
  response-optional-property-added
- ○
  added the optional property meta/category_skill_model_operationally_degraded to the response with the 403 status
  response-optional-property-added
- ○
  added the optional property meta/category_skill_model_operationally_degraded to the response with the 423 status
  response-optional-property-added
- ○
  added the optional property meta/category_skill_model_operationally_degraded to the response with the 429 status
  response-optional-property-added
- ○
  added the optional property meta/category_skill_model_operationally_degraded to the response with the 503 status
  response-optional-property-added
- ○
  added the optional property meta/category_skill_model_version to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property meta/category_skill_model_version to the response with the 401 status
  response-optional-property-added
- ○
  added the optional property meta/category_skill_model_version to the response with the 402 status
  response-optional-property-added
- ○
  added the optional property meta/category_skill_model_version to the response with the 403 status
  response-optional-property-added
- ○
  added the optional property meta/category_skill_model_version to the response with the 423 status
  response-optional-property-added
- ○
  added the optional property meta/category_skill_model_version to the response with the 429 status
  response-optional-property-added
- ○
  added the optional property meta/category_skill_model_version to the response with the 503 status
  response-optional-property-added
- ○
  added the optional property meta/category_skill_observation_started_at to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property meta/category_skill_observation_started_at to the response with the 401 status
  response-optional-property-added
- ○
  added the optional property meta/category_skill_observation_started_at to the response with the 402 status
  response-optional-property-added
- ○
  added the optional property meta/category_skill_observation_started_at to the response with the 403 status
  response-optional-property-added
- ○
  added the optional property meta/category_skill_observation_started_at to the response with the 423 status
  response-optional-property-added
- ○
  added the optional property meta/category_skill_observation_started_at to the response with the 429 status
  response-optional-property-added
- ○
  added the optional property meta/category_skill_observation_started_at to the response with the 503 status
  response-optional-property-added
- ○
  added the optional property meta/category_skill_platform to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property meta/category_skill_platform to the response with the 401 status
  response-optional-property-added
- ○
  added the optional property meta/category_skill_platform to the response with the 402 status
  response-optional-property-added
- ○
  added the optional property meta/category_skill_platform to the response with the 403 status
  response-optional-property-added
- ○
  added the optional property meta/category_skill_platform to the response with the 423 status
  response-optional-property-added
- ○
  added the optional property meta/category_skill_platform to the response with the 429 status
  response-optional-property-added
- ○
  added the optional property meta/category_skill_platform to the response with the 503 status
  response-optional-property-added
- ○
  added the optional property meta/category_skill_scope to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property meta/category_skill_scope to the response with the 401 status
  response-optional-property-added
- ○
  added the optional property meta/category_skill_scope to the response with the 402 status
  response-optional-property-added
- ○
  added the optional property meta/category_skill_scope to the response with the 403 status
  response-optional-property-added
- ○
  added the optional property meta/category_skill_scope to the response with the 423 status
  response-optional-property-added
- ○
  added the optional property meta/category_skill_scope to the response with the 429 status
  response-optional-property-added
- ○
  added the optional property meta/category_skill_scope to the response with the 503 status
  response-optional-property-added
- ○
  added the optional property meta/category_skill_source to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property meta/category_skill_source to the response with the 401 status
  response-optional-property-added
- ○
  added the optional property meta/category_skill_source to the response with the 402 status
  response-optional-property-added
- ○
  added the optional property meta/category_skill_source to the response with the 403 status
  response-optional-property-added
- ○
  added the optional property meta/category_skill_source to the response with the 423 status
  response-optional-property-added
- ○
  added the optional property meta/category_skill_source to the response with the 429 status
  response-optional-property-added
- ○
  added the optional property meta/category_skill_source to the response with the 503 status
  response-optional-property-added
- ○
  added the optional property meta/category_skill_source_coverage to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property meta/category_skill_source_coverage to the response with the 401 status
  response-optional-property-added
- ○
  added the optional property meta/category_skill_source_coverage to the response with the 402 status
  response-optional-property-added
- ○
  added the optional property meta/category_skill_source_coverage to the response with the 403 status
  response-optional-property-added
- ○
  added the optional property meta/category_skill_source_coverage to the response with the 423 status
  response-optional-property-added
- ○
  added the optional property meta/category_skill_source_coverage to the response with the 429 status
  response-optional-property-added
- ○
  added the optional property meta/category_skill_source_coverage to the response with the 503 status
  response-optional-property-added
- ○
  added the optional property meta/category_skill_status_counts to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property meta/category_skill_status_counts to the response with the 401 status
  response-optional-property-added
- ○
  added the optional property meta/category_skill_status_counts to the response with the 402 status
  response-optional-property-added
- ○
  added the optional property meta/category_skill_status_counts to the response with the 403 status
  response-optional-property-added
- ○
  added the optional property meta/category_skill_status_counts to the response with the 423 status
  response-optional-property-added
- ○
  added the optional property meta/category_skill_status_counts to the response with the 429 status
  response-optional-property-added
- ○
  added the optional property meta/category_skill_status_counts to the response with the 503 status
  response-optional-property-added
- ○
  added the optional property meta/category_skill_taxonomy_version to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property meta/category_skill_taxonomy_version to the response with the 401 status
  response-optional-property-added
- ○
  added the optional property meta/category_skill_taxonomy_version to the response with the 402 status
  response-optional-property-added
- ○
  added the optional property meta/category_skill_taxonomy_version to the response with the 403 status
  response-optional-property-added
- ○
  added the optional property meta/category_skill_taxonomy_version to the response with the 423 status
  response-optional-property-added
- ○
  added the optional property meta/category_skill_taxonomy_version to the response with the 429 status
  response-optional-property-added
- ○
  added the optional property meta/category_skill_taxonomy_version to the response with the 503 status
  response-optional-property-added
Jul 14, 202622ab6cfbf30035See the full diff
- ○
  added the optional property data/items/realized_pnl to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property error/reason to the response with the 401 status
  response-optional-property-added
- ○
  added the optional property error/reason to the response with the 402 status
  response-optional-property-added
- ○
  added the optional property error/reason to the response with the 403 status
  response-optional-property-added
- ○
  added the optional property error/reason to the response with the 423 status
  response-optional-property-added
- ○
  added the optional property error/reason to the response with the 429 status
  response-optional-property-added
- ○
  added the optional property error/reason to the response with the 503 status
  response-optional-property-added
- ○
  added the optional property error/retry_at to the response with the 401 status
  response-optional-property-added
- ○
  added the optional property error/retry_at to the response with the 402 status
  response-optional-property-added
- ○
  added the optional property error/retry_at to the response with the 403 status
  response-optional-property-added
- ○
  added the optional property error/retry_at to the response with the 423 status
  response-optional-property-added
- ○
  added the optional property error/retry_at to the response with the 429 status
  response-optional-property-added
- ○
  added the optional property error/retry_at to the response with the 503 status
  response-optional-property-added
- ○
  added the optional property meta/directional_source to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property meta/directional_source to the response with the 401 status
  response-optional-property-added
- ○
  added the optional property meta/directional_source to the response with the 402 status
  response-optional-property-added
- ○
  added the optional property meta/directional_source to the response with the 403 status
  response-optional-property-added
- ○
  added the optional property meta/directional_source to the response with the 423 status
  response-optional-property-added
- ○
  added the optional property meta/directional_source to the response with the 429 status
  response-optional-property-added
- ○
  added the optional property meta/directional_source to the response with the 503 status
  response-optional-property-added
- ○
  added the optional property meta/ranking_source to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property meta/ranking_source to the response with the 401 status
  response-optional-property-added
- ○
  added the optional property meta/ranking_source to the response with the 402 status
  response-optional-property-added
- ○
  added the optional property meta/ranking_source to the response with the 403 status
  response-optional-property-added
- ○
  added the optional property meta/ranking_source to the response with the 423 status
  response-optional-property-added
- ○
  added the optional property meta/ranking_source to the response with the 429 status
  response-optional-property-added
- ○
  added the optional property meta/ranking_source to the response with the 503 status
  response-optional-property-added
- ○
  added the optional property total to the response with the 200 status
  response-optional-property-added
- ○
  added the required property meta/cost to the response with the 200 status
  response-required-property-added
- ○
  added the required property meta/cost to the response with the 401 status
  response-required-property-added
- ○
  added the required property meta/cost to the response with the 402 status
  response-required-property-added
- ○
  added the required property meta/cost to the response with the 403 status
  response-required-property-added
- ○
  added the required property meta/cost to the response with the 423 status
  response-required-property-added
- ○
  added the required property meta/cost to the response with the 429 status
  response-required-property-added
- ○
  added the required property meta/cost to the response with the 503 status
  response-required-property-added
Jun 1, 2026a311bdcfd35411See the full diff
- ●
  removed the optional property data/items/form_tier from the response with the 200 status
  response-optional-property-removed
- ○
  added the optional property data/items/streak_tier to the response with the 200 status
  response-optional-property-added
Jun 1, 2026422bd4dc1611542See the full diff
- ●
  added the new account_locked enum value to the error/code response property for the response status 401
  response-property-enum-value-added
- ●
  added the new account_locked enum value to the error/code response property for the response status 402
  response-property-enum-value-added
- ●
  added the new account_locked enum value to the error/code response property for the response status 403
  response-property-enum-value-added
- ●
  added the new account_locked enum value to the error/code response property for the response status 423
  response-property-enum-value-added
- ●
  added the new account_locked enum value to the error/code response property for the response status 429
  response-property-enum-value-added
- ●
  added the new account_locked enum value to the error/code response property for the response status 503
  response-property-enum-value-added
- ●
  added the new bad_request enum value to the error/code response property for the response status 401
  response-property-enum-value-added
- ●
  added the new bad_request enum value to the error/code response property for the response status 402
  response-property-enum-value-added
- ●
  added the new bad_request enum value to the error/code response property for the response status 403
  response-property-enum-value-added
- ●
  added the new bad_request enum value to the error/code response property for the response status 423
  response-property-enum-value-added
- ●
  added the new bad_request enum value to the error/code response property for the response status 429
  response-property-enum-value-added
- ●
  added the new bad_request enum value to the error/code response property for the response status 503
  response-property-enum-value-added
- ●
  added the new forbidden enum value to the error/code response property for the response status 401
  response-property-enum-value-added
- ●
  added the new forbidden enum value to the error/code response property for the response status 402
  response-property-enum-value-added
- ●
  added the new forbidden enum value to the error/code response property for the response status 403
  response-property-enum-value-added
- ●
  added the new forbidden enum value to the error/code response property for the response status 423
  response-property-enum-value-added
- ●
  added the new forbidden enum value to the error/code response property for the response status 429
  response-property-enum-value-added
- ●
  added the new forbidden enum value to the error/code response property for the response status 503
  response-property-enum-value-added
- ●
  added the new internal_error enum value to the error/code response property for the response status 401
  response-property-enum-value-added
- ●
  added the new internal_error enum value to the error/code response property for the response status 402
  response-property-enum-value-added
- ●
  added the new internal_error enum value to the error/code response property for the response status 403
  response-property-enum-value-added
- ●
  added the new internal_error enum value to the error/code response property for the response status 423
  response-property-enum-value-added
- ●
  added the new internal_error enum value to the error/code response property for the response status 429
  response-property-enum-value-added
- ●
  added the new internal_error enum value to the error/code response property for the response status 503
  response-property-enum-value-added
- ●
  added the new invalid_api_key enum value to the error/code response property for the response status 401
  response-property-enum-value-added
- ●
  added the new invalid_api_key enum value to the error/code response property for the response status 402
  response-property-enum-value-added
- ●
  added the new invalid_api_key enum value to the error/code response property for the response status 403
  response-property-enum-value-added
- ●
  added the new invalid_api_key enum value to the error/code response property for the response status 423
  response-property-enum-value-added
- ●
  added the new invalid_api_key enum value to the error/code response property for the response status 429
  response-property-enum-value-added
- ●
  added the new invalid_api_key enum value to the error/code response property for the response status 503
  response-property-enum-value-added
- ●
  added the new not_found enum value to the error/code response property for the response status 401
  response-property-enum-value-added
- ●
  added the new not_found enum value to the error/code response property for the response status 402
  response-property-enum-value-added
- ●
  added the new not_found enum value to the error/code response property for the response status 403
  response-property-enum-value-added
- ●
  added the new not_found enum value to the error/code response property for the response status 423
  response-property-enum-value-added
- ●
  added the new not_found enum value to the error/code response property for the response status 429
  response-property-enum-value-added
- ●
  added the new not_found enum value to the error/code response property for the response status 503
  response-property-enum-value-added
- ●
  added the new rate_limit_unavailable enum value to the error/code response property for the response status 401
  response-property-enum-value-added
- ●
  added the new rate_limit_unavailable enum value to the error/code response property for the response status 402
  response-property-enum-value-added
- ●
  added the new rate_limit_unavailable enum value to the error/code response property for the response status 403
  response-property-enum-value-added
- ●
  added the new rate_limit_unavailable enum value to the error/code response property for the response status 423
  response-property-enum-value-added
- ●
  added the new rate_limit_unavailable enum value to the error/code response property for the response status 429
  response-property-enum-value-added
- ●
  added the new rate_limit_unavailable enum value to the error/code response property for the response status 503
  response-property-enum-value-added
- ●
  added the new rate_limited enum value to the error/code response property for the response status 401
  response-property-enum-value-added
- ●
  added the new rate_limited enum value to the error/code response property for the response status 402
  response-property-enum-value-added
- ●
  added the new rate_limited enum value to the error/code response property for the response status 403
  response-property-enum-value-added
- ●
  added the new rate_limited enum value to the error/code response property for the response status 423
  response-property-enum-value-added
- ●
  added the new rate_limited enum value to the error/code response property for the response status 429
  response-property-enum-value-added
- ●
  added the new rate_limited enum value to the error/code response property for the response status 503
  response-property-enum-value-added
- ●
  added the new subscription_required enum value to the error/code response property for the response status 401
  response-property-enum-value-added
- ●
  added the new subscription_required enum value to the error/code response property for the response status 402
  response-property-enum-value-added
- ●
  added the new subscription_required enum value to the error/code response property for the response status 403
  response-property-enum-value-added
- ●
  added the new subscription_required enum value to the error/code response property for the response status 423
  response-property-enum-value-added
- ●
  added the new subscription_required enum value to the error/code response property for the response status 429
  response-property-enum-value-added
- ●
  added the new subscription_required enum value to the error/code response property for the response status 503
  response-property-enum-value-added
- ○
  api operation id get_leaderboard removed and replaced with listLeaderboard
  api-operation-id-removed
- ○
  added the optional property data/items/form_tier to the response with the 200 status
  response-optional-property-added
May 7, 20262907497f4ca3114See the full diff
- ▲
  the query request parameter strategy was restricted to a list of enum values
  request-parameter-became-enum
- ○
  added the new optional header request parameter If-None-Match
  new-optional-request-parameter
- ○
  added the new enum value accumulator to the query request parameter strategy
  request-parameter-enum-value-added
- ○
  added the new enum value algo_trader to the query request parameter strategy
  request-parameter-enum-value-added
- ○
  added the new enum value arbitrageur to the query request parameter strategy
  request-parameter-enum-value-added
- ○
  added the new enum value directional to the query request parameter strategy
  request-parameter-enum-value-added
- ○
  added the new enum value event_driven to the query request parameter strategy
  request-parameter-enum-value-added
- ○
  added the new enum value market_maker to the query request parameter strategy
  request-parameter-enum-value-added
- ○
  added the new enum value momentum to the query request parameter strategy
  request-parameter-enum-value-added
- ○
  added the new enum value scalper to the query request parameter strategy
  request-parameter-enum-value-added
- ○
  added the new enum value speculator to the query request parameter strategy
  request-parameter-enum-value-added
- ○
  added the new enum value swing_trader to the query request parameter strategy
  request-parameter-enum-value-added
- ○
  added the non-success response with the status 304
  response-non-success-status-added
- ○
  added the non-success response with the status 408
  response-non-success-status-added
- ○
  added the non-success response with the status 503
  response-non-success-status-added
Apr 3, 202624aa764c32ea2See the full diff
- ○
  added the non-success response with the status 403
  response-non-success-status-added
- ○
  added the non-success response with the status 423
  response-non-success-status-added
Mar 25, 2026e658903dd89b1See the full diff
- ○
  endpoint added
  endpoint-added
This revision also has 4 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

Full history