Sign in
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'. Cursors are bound to the effective limit, window and ranked-board generation; a changed board or request scope returns 400 with error.reason=cursor_expired, and legacy page-only cursors must restart from page one.

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, bound to its effective limit, window and ranked-board generation. A changed board or request scope returns error.reason=cursor_expired; legacy page-only cursors must restart from page one.

window'7d' | '30d'

Trailing window.

Headers

X-Query-Validation'strict'

Opt into strict query-name validation. The default is compatible: unknown names are ignored and reported in X-Query-Ignored. With strict, an unknown name returns 400 bad_request with error.reason unknown_query_parameter before the handler runs, including when its percent escape is incomplete.

Response

Trending wallets list

object'list' required
has_moreboolean required
next_cursorstring

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

totalinteger

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

Changes

Changed in 14 of the 89 revisions of this API.10184155

  • ece7a25b7a4488See the full diff
    • ●

      added the new freshness_ceiling_unsatisfied enum value to the / response property for the response status

      response-property-enum-value-added

    • ●

      added the new freshness_ceiling_unsatisfied enum value to the / response property for the response status

      response-property-enum-value-added

    • ●

      added the new freshness_ceiling_unsatisfied enum value to the / response property for the response status

      response-property-enum-value-added

    • ●

      added the new freshness_ceiling_unsatisfied enum value to the / response property for the response status

      response-property-enum-value-added

    • ●

      added the new freshness_ceiling_unsatisfied enum value to the / response property for the response status

      response-property-enum-value-added

    • ●

      added the new freshness_ceiling_unsatisfied enum value to the / response property for the response status

      response-property-enum-value-added

    • ●

      added the new freshness_ceiling_unsatisfied enum value to the / response property for the response status

      response-property-enum-value-added

    • ●

      added the new freshness_ceiling_unsatisfied enum value to the / response property for the response status

      response-property-enum-value-added

    • ○

      added the optional property / to the response with the status

      response-optional-property-added

    • ○

      added the optional property / to the response with the status

      response-optional-property-added

    • ○

      added the optional property / to the response with the status

      response-optional-property-added

    • ○

      added the optional property / to the response with the status

      response-optional-property-added

    • ○

      added the optional property / to the response with the status

      response-optional-property-added

    • ○

      added the optional property / to the response with the status

      response-optional-property-added

    • ○

      added the optional property / to the response with the status

      response-optional-property-added

    • ○

      added the optional property / to the response with the status

      response-optional-property-added

  • 8462acf80f8c8See the full diff
    • ●

      added the new export_expired enum value to the / response property for the response status

      response-property-enum-value-added

    • ●

      added the new export_expired enum value to the / response property for the response status

      response-property-enum-value-added

    • ●

      added the new export_expired enum value to the / response property for the response status

      response-property-enum-value-added

    • ●

      added the new export_expired enum value to the / response property for the response status

      response-property-enum-value-added

    • ●

      added the new export_expired enum value to the / response property for the response status

      response-property-enum-value-added

    • ●

      added the new export_expired enum value to the / response property for the response status

      response-property-enum-value-added

    • ●

      added the new export_expired enum value to the / response property for the response status

      response-property-enum-value-added

    • ●

      added the new export_expired enum value to the / response property for the response status

      response-property-enum-value-added

    This revision also has 3 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

  • 1c5e270b412481See the full diff
    • ●

      added the new unknown_query_parameter enum value to the / response property for the response status

      response-property-enum-value-added

    • ●

      added the new unknown_query_parameter enum value to the / response property for the response status

      response-property-enum-value-added

    • ●

      added the new unknown_query_parameter enum value to the / response property for the response status

      response-property-enum-value-added

    • ●

      added the new unknown_query_parameter enum value to the / response property for the response status

      response-property-enum-value-added

    • ●

      added the new unknown_query_parameter enum value to the / response property for the response status

      response-property-enum-value-added

    • ●

      added the new unknown_query_parameter enum value to the / response property for the response status

      response-property-enum-value-added

    • ●

      added the new unknown_query_parameter enum value to the / response property for the response status

      response-property-enum-value-added

    • ●

      added the new unknown_query_parameter enum value to the / response property for the response status

      response-property-enum-value-added

    • ○

      added the new optional header request parameter X-Query-Validation

      new-optional-request-parameter

  • 9958c95371de16See the full diff
    • ●

      added the new webhook_secret_rotation_not_prepared enum value to the / response property for the response status

      response-property-enum-value-added

    • ●

      added the new webhook_secret_rotation_not_prepared enum value to the / response property for the response status

      response-property-enum-value-added

    • ●

      added the new webhook_secret_rotation_not_prepared enum value to the / response property for the response status

      response-property-enum-value-added

    • ●

      added the new webhook_secret_rotation_not_prepared enum value to the / response property for the response status

      response-property-enum-value-added

    • ●

      added the new webhook_secret_rotation_not_prepared enum value to the / response property for the response status

      response-property-enum-value-added

    • ●

      added the new webhook_secret_rotation_not_prepared enum value to the / response property for the response status

      response-property-enum-value-added

    • ●

      added the new webhook_secret_rotation_not_prepared enum value to the / response property for the response status

      response-property-enum-value-added

    • ●

      added the new webhook_secret_rotation_not_prepared enum value to the / response property for the response status

      response-property-enum-value-added

    • ●

      added the new webhook_secret_rotation_overlap_active enum value to the / response property for the response status

      response-property-enum-value-added

    • ●

      added the new webhook_secret_rotation_overlap_active enum value to the / response property for the response status

      response-property-enum-value-added

    • ●

      added the new webhook_secret_rotation_overlap_active enum value to the / response property for the response status

      response-property-enum-value-added

    • ●

      added the new webhook_secret_rotation_overlap_active enum value to the / response property for the response status

      response-property-enum-value-added

    • ●

      added the new webhook_secret_rotation_overlap_active enum value to the / response property for the response status

      response-property-enum-value-added

    • ●

      added the new webhook_secret_rotation_overlap_active enum value to the / response property for the response status

      response-property-enum-value-added

    • ●

      added the new webhook_secret_rotation_overlap_active enum value to the / response property for the response status

      response-property-enum-value-added

    • ●

      added the new webhook_secret_rotation_overlap_active enum value to the / response property for the response status

      response-property-enum-value-added

  • 4bade829e22816See the full diff
    • ●

      added the new ip_rate_limited enum value to the / response property for the response status

      response-property-enum-value-added

    • ●

      added the new ip_rate_limited enum value to the / response property for the response status

      response-property-enum-value-added

    • ●

      added the new ip_rate_limited enum value to the / response property for the response status

      response-property-enum-value-added

    • ●

      added the new ip_rate_limited enum value to the / response property for the response status

      response-property-enum-value-added

    • ●

      added the new ip_rate_limited enum value to the / response property for the response status

      response-property-enum-value-added

    • ●

      added the new ip_rate_limited enum value to the / response property for the response status

      response-property-enum-value-added

    • ●

      added the new ip_rate_limited enum value to the / response property for the response status

      response-property-enum-value-added

    • ●

      added the new ip_rate_limited enum value to the / response property for the response status

      response-property-enum-value-added

    • ●

      added the new ip_throttled enum value to the / response property for the response status

      response-property-enum-value-added

    • ●

      added the new ip_throttled enum value to the / response property for the response status

      response-property-enum-value-added

    • ●

      added the new ip_throttled enum value to the / response property for the response status

      response-property-enum-value-added

    • ●

      added the new ip_throttled enum value to the / response property for the response status

      response-property-enum-value-added

    • ●

      added the new ip_throttled enum value to the / response property for the response status

      response-property-enum-value-added

    • ●

      added the new ip_throttled enum value to the / response property for the response status

      response-property-enum-value-added

    • ●

      added the new ip_throttled enum value to the / response property for the response status

      response-property-enum-value-added

    • ●

      added the new ip_throttled enum value to the / response property for the response status

      response-property-enum-value-added

  • 7b5489c2cd3e491See the full diff
    • ●

      added the new invalid_body enum value to the / response property for the response status

      response-property-enum-value-added

    • ●

      added the new invalid_body enum value to the / response property for the response status

      response-property-enum-value-added

    • ●

      added the new invalid_body enum value to the / response property for the response status

      response-property-enum-value-added

    • ●

      added the new invalid_body enum value to the / response property for the response status

      response-property-enum-value-added

    • ●

      added the new invalid_body enum value to the / response property for the response status

      response-property-enum-value-added

    • ●

      added the new invalid_body enum value to the / response property for the response status

      response-property-enum-value-added

    • ●

      added the new invalid_body enum value to the / response property for the response status

      response-property-enum-value-added

    • ●

      added the new invalid_path enum value to the / response property for the response status

      response-property-enum-value-added

    • ●

      added the new invalid_path enum value to the / response property for the response status

      response-property-enum-value-added

    • ●

      added the new invalid_path enum value to the / response property for the response status

      response-property-enum-value-added

    • ●

      added the new invalid_path enum value to the / response property for the response status

      response-property-enum-value-added

    • ●

      added the new invalid_path enum value to the / response property for the response status

      response-property-enum-value-added

    • ●

      added the new invalid_path enum value to the / response property for the response status

      response-property-enum-value-added

    • ●

      added the new invalid_path enum value to the / response property for the response status

      response-property-enum-value-added

    • ●

      added the new invalid_query enum value to the / response property for the response status

      response-property-enum-value-added

    • ●

      added the new invalid_query enum value to the / response property for the response status

      response-property-enum-value-added

    • ●

      added the new invalid_query enum value to the / response property for the response status

      response-property-enum-value-added

    • ●

      added the new invalid_query enum value to the / response property for the response status

      response-property-enum-value-added

    • ●

      added the new invalid_query enum value to the / response property for the response status

      response-property-enum-value-added

    • ●

      added the new invalid_query enum value to the / response property for the response status

      response-property-enum-value-added

    • ●

      added the new invalid_query enum value to the / response property for the response status

      response-property-enum-value-added

    • ●

      added the new method_not_allowed enum value to the / response property for the response status

      response-property-enum-value-added

    • ●

      added the new method_not_allowed enum value to the / response property for the response status

      response-property-enum-value-added

    • ●

      added the new method_not_allowed enum value to the / response property for the response status

      response-property-enum-value-added

    • ●

      added the new method_not_allowed enum value to the / response property for the response status

      response-property-enum-value-added

    • ●

      added the new method_not_allowed enum value to the / response property for the response status

      response-property-enum-value-added

    • ●

      added the new method_not_allowed enum value to the / response property for the response status

      response-property-enum-value-added

    • ●

      added the new method_not_allowed enum value to the / response property for the response status

      response-property-enum-value-added

    • ●

      added the new payload_too_large enum value to the / response property for the response status

      response-property-enum-value-added

    • ●

      added the new payload_too_large enum value to the / response property for the response status

      response-property-enum-value-added

    • ●

      added the new payload_too_large enum value to the / response property for the response status

      response-property-enum-value-added

    • ●

      added the new payload_too_large enum value to the / response property for the response status

      response-property-enum-value-added

    • ●

      added the new payload_too_large enum value to the / response property for the response status

      response-property-enum-value-added

    • ●

      added the new payload_too_large enum value to the / response property for the response status

      response-property-enum-value-added

    • ●

      added the new payload_too_large enum value to the / response property for the response status

      response-property-enum-value-added

    • ●

      added the new request_timeout enum value to the / response property for the response status

      response-property-enum-value-added

    • ●

      added the new request_timeout enum value to the / response property for the response status

      response-property-enum-value-added

    • ●

      added the new request_timeout enum value to the / response property for the response status

      response-property-enum-value-added

    • ●

      added the new request_timeout enum value to the / response property for the response status

      response-property-enum-value-added

    • ●

      added the new request_timeout enum value to the / response property for the response status

      response-property-enum-value-added

    • ●

      added the new request_timeout enum value to the / response property for the response status

      response-property-enum-value-added

    • ●

      added the new request_timeout enum value to the / response property for the response status

      response-property-enum-value-added

    • ●

      added the new unsupported_media_type enum value to the / response property for the response status

      response-property-enum-value-added

    • ●

      added the new unsupported_media_type enum value to the / response property for the response status

      response-property-enum-value-added

    • ●

      added the new unsupported_media_type enum value to the / response property for the response status

      response-property-enum-value-added

    • ●

      added the new unsupported_media_type enum value to the / response property for the response status

      response-property-enum-value-added

    • ●

      added the new unsupported_media_type enum value to the / response property for the response status

      response-property-enum-value-added

    • ●

      added the new unsupported_media_type enum value to the / response property for the response status

      response-property-enum-value-added

    • ●

      added the new unsupported_media_type enum value to the / response property for the response status

      response-property-enum-value-added

    • ○

      added the media type application/json for the response with the status

      response-media-type-added

  • 4b70e1891f611141See the full diff
    • ▲

      the response property // became optional for the status

      response-property-became-optional

    • ●

      added the new insufficient_scope enum value to the / response property for the response status

      response-property-enum-value-added

    • ●

      added the new insufficient_scope enum value to the / response property for the response status

      response-property-enum-value-added

    • ●

      added the new insufficient_scope enum value to the / response property for the response status

      response-property-enum-value-added

    • ●

      added the new insufficient_scope enum value to the / response property for the response status

      response-property-enum-value-added

    • ●

      added the new insufficient_scope enum value to the / response property for the response status

      response-property-enum-value-added

    • ●

      added the new insufficient_scope enum value to the / response property for the response status

      response-property-enum-value-added

    • ●

      added the new insufficient_scope enum value to the / response property for the response status

      response-property-enum-value-added

    • ●

      added the new monthly_quota_exceeded enum value to the / response property for the response status

      response-property-enum-value-added

    • ●

      added the new monthly_quota_exceeded enum value to the / response property for the response status

      response-property-enum-value-added

    • ●

      added the new monthly_quota_exceeded enum value to the / response property for the response status

      response-property-enum-value-added

    • ●

      added the new monthly_quota_exceeded enum value to the / response property for the response status

      response-property-enum-value-added

    • ●

      added the new monthly_quota_exceeded enum value to the / response property for the response status

      response-property-enum-value-added

    • ●

      added the new monthly_quota_exceeded enum value to the / response property for the response status

      response-property-enum-value-added

    • ●

      added the new monthly_quota_exceeded enum value to the / response property for the response status

      response-property-enum-value-added

    • ○

      added the optional property // to the response with the status

      response-optional-property-added

  • 05ff312f4bbc7See the full diff
    • ●

      added the new api_key_in_query enum value to the / response property for the response status

      response-property-enum-value-added

    • ●

      added the new api_key_in_query enum value to the / response property for the response status

      response-property-enum-value-added

    • ●

      added the new api_key_in_query enum value to the / response property for the response status

      response-property-enum-value-added

    • ●

      added the new api_key_in_query enum value to the / response property for the response status

      response-property-enum-value-added

    • ●

      added the new api_key_in_query enum value to the / response property for the response status

      response-property-enum-value-added

    • ●

      added the new api_key_in_query enum value to the / response property for the response status

      response-property-enum-value-added

    • ●

      added the new api_key_in_query enum value to the / response property for the response status

      response-property-enum-value-added

  • 1b8c2226ee7b8371See the full diff
    • ▲

      the response property const value partial_whale_threshold_fills was removed for the status

      response-property-const-removed

    • ▲

      the response property const value partial_whale_threshold_fills was removed for the status

      response-property-const-removed

    • ▲

      the response property const value partial_whale_threshold_fills was removed for the status

      response-property-const-removed

    • ▲

      the response property const value partial_whale_threshold_fills was removed for the status

      response-property-const-removed

    • ▲

      the response property const value partial_whale_threshold_fills was removed for the status

      response-property-const-removed

    • ▲

      the response property const value partial_whale_threshold_fills was removed for the status

      response-property-const-removed

    • ▲

      the response property const value partial_whale_threshold_fills was removed for the status

      response-property-const-removed

    • ▲

      the response property const value partial_whale_threshold_fills was removed for the status

      response-property-const-removed

    • ●

      added the new graded_wallet_fills enum value to the / response property for the response status

      response-property-enum-value-added

    • ●

      added the new graded_wallet_fills enum value to the / response property for the response status

      response-property-enum-value-added

    • ●

      added the new graded_wallet_fills enum value to the / response property for the response status

      response-property-enum-value-added

    • ●

      added the new graded_wallet_fills enum value to the / response property for the response status

      response-property-enum-value-added

    • ●

      added the new graded_wallet_fills enum value to the / response property for the response status

      response-property-enum-value-added

    • ●

      added the new graded_wallet_fills enum value to the / response property for the response status

      response-property-enum-value-added

    • ●

      added the new graded_wallet_fills enum value to the / response property for the response status

      response-property-enum-value-added

    • ●

      added the new graded_wallet_fills enum value to the / response property for the response status

      response-property-enum-value-added

    • ●

      added the new partial_whale_threshold_fills enum value to the / response property for the response status

      response-property-enum-value-added

    • ●

      added the new partial_whale_threshold_fills enum value to the / response property for the response status

      response-property-enum-value-added

    • ●

      added the new partial_whale_threshold_fills enum value to the / response property for the response status

      response-property-enum-value-added

    • ●

      added the new partial_whale_threshold_fills enum value to the / response property for the response status

      response-property-enum-value-added

    • ●

      added the new partial_whale_threshold_fills enum value to the / response property for the response status

      response-property-enum-value-added

    • ●

      added the new partial_whale_threshold_fills enum value to the / response property for the response status

      response-property-enum-value-added

    • ●

      added the new partial_whale_threshold_fills enum value to the / response property for the response status

      response-property-enum-value-added

    • ●

      added the new partial_whale_threshold_fills enum value to the / response property for the response status

      response-property-enum-value-added

    • ●

      added the new request_accounting_unavailable enum value to the / response property for the response status

      response-property-enum-value-added

    • ●

      added the new request_accounting_unavailable enum value to the / response property for the response status

      response-property-enum-value-added

    • ●

      added the new request_accounting_unavailable enum value to the / response property for the response status

      response-property-enum-value-added

    • ●

      added the new request_accounting_unavailable enum value to the / response property for the response status

      response-property-enum-value-added

    • ●

      added the new request_accounting_unavailable enum value to the / response property for the response status

      response-property-enum-value-added

    • ●

      added the new request_accounting_unavailable enum value to the / response property for the response status

      response-property-enum-value-added

    • ●

      added the new request_accounting_unavailable enum value to the / response property for the response status

      response-property-enum-value-added

    • ●

      added the new sandbox_api_key enum value to the / response property for the response status

      response-property-enum-value-added

    • ●

      added the new sandbox_api_key enum value to the / response property for the response status

      response-property-enum-value-added

    • ●

      added the new sandbox_api_key enum value to the / response property for the response status

      response-property-enum-value-added

    • ●

      added the new sandbox_api_key enum value to the / response property for the response status

      response-property-enum-value-added

    • ●

      added the new sandbox_api_key enum value to the / response property for the response status

      response-property-enum-value-added

    • ●

      added the new sandbox_api_key enum value to the / response property for the response status

      response-property-enum-value-added

    • ●

      added the new sandbox_api_key enum value to the / response property for the response status

      response-property-enum-value-added

    • ●

      added the new subscription_inactive enum value to the / response property for the response status

      response-property-enum-value-added

    • ●

      added the new subscription_inactive enum value to the / response property for the response status

      response-property-enum-value-added

    • ●

      added the new subscription_inactive enum value to the / response property for the response status

      response-property-enum-value-added

    • ●

      added the new subscription_inactive enum value to the / response property for the response status

      response-property-enum-value-added

    • ●

      added the new subscription_inactive enum value to the / response property for the response status

      response-property-enum-value-added

    • ●

      added the new subscription_inactive enum value to the / response property for the response status

      response-property-enum-value-added

    • ●

      added the new subscription_inactive enum value to the / response property for the response status

      response-property-enum-value-added

    • ○

      removed the kalshi enum value from the // response property for the response status

      response-property-enum-value-removed

    This revision also has 2 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

  • 7c0c7cdd41ee7See the full diff
    • ●

      added the new database_unavailable enum value to the / response property for the response status

      response-property-enum-value-added

    • ●

      added the new database_unavailable enum value to the / response property for the response status

      response-property-enum-value-added

    • ●

      added the new database_unavailable enum value to the / response property for the response status

      response-property-enum-value-added

    • ●

      added the new database_unavailable enum value to the / response property for the response status

      response-property-enum-value-added

    • ●

      added the new database_unavailable enum value to the / response property for the response status

      response-property-enum-value-added

    • ●

      added the new database_unavailable enum value to the / response property for the response status

      response-property-enum-value-added

    • ●

      added the new database_unavailable enum value to the / response property for the response status

      response-property-enum-value-added