Leaderboard

List trending wallets

Returns wallets ranked by Polymarket weekly/monthly P&L (Polymarket-only discovery), with opaque page-cursor pagination. trending_pnl_usd and the by-PNL row order come from Polymarket's canonical leaderboard (data-api.polymarket.com/v1/leaderboard?timePeriod=week|month&orderBy=PNL), not a locally summed realized-leaf total. Each row also carries window volume, distinct markets, grade, hot-streak tier, and a shape-only daily P&L sparkline derived from the Polymarket user-pnl cumulative curve (per-day deltas; not guaranteed to sum to trending_pnl_usd). The underlying read model is warmed into Redis; a cold read returns 503 (warming, retry-after), never a 500 or a fabricated ranking. Polymarket-only: the read model filters platform = 'polymarket'.

get/api/v1/leaderboard/trending

Query parameters

limitinteger

Polymarket's weekly leaderboard caps the ranked set at 50 wallets; requests above 50 still return at most 50.

cursorstring

Opaque pagination cursor from a previous response.

window'7d' | '30d'

Trailing window.

Response

Trending wallets list

object'list' required

has_moreboolean required

next_cursorstring nullable

Opaque cursor for the next page; absent on the last page.

totalinteger nullable

Total ranked rows when the read model exposes a count; may be absent.

Changes

Changed in 5 of the 31 revisions of this API.121143

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, 20268582a359fa0716See the full diff
- ○
  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 400 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 400 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, 202619193b1771541488See the full diff
- ●
  added the new idempotency_in_progress enum value to the error/reason response property for the response status 400
  response-property-enum-value-added
- ●
  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 400
  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 400 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 400 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 400 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 400 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 400 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 400 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 400 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 400 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 400 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 400 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 400 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, 202622ab6cfbf300138See the full diff
- ▲
  for the query request parameter limit, the max was decreased from 100.00 to 50.00
  request-parameter-max-decreased
- ○
  added the optional property error/reason to the response with the 400 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 400 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 400 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 400 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 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 400 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 15, 20265b6d6ff7692c1See the full diff
- ○
  endpoint added
  endpoint-added

Full history