---
title: "Get trader leaderboard"
method: GET
path: "/api/v1/market-data/leaderboard"
tags: ["get-trader-leaderboard"]
---

# Get trader leaderboard

`GET /api/v1/market-data/leaderboard`

Returns a global ranking of traders sorted by realised PnL, win rate, or volume for a given time period. Pass a `user` wallet address to retrieve a single wallet's rank within the leaderboard.

## Query parameters

- `period` '1d' | '7d' | '30d' | 'all'
- `sort_by` 'pnl' | 'win_rate' | 'volume'
- `user` string
- `limit` integer
- `offset` integer

## Response `200`

OK

- FtMarketServiceV2PkgApiPaginatedResponseInternalHandlerLeaderboardEntry
  - `data` InternalHandlerLeaderboardEntry[]
    - `losingPredictions` integer
    - `losingSells` integer
    - `pnl` number
    - `pnlPct` number
    - `profitableSells` integer
    - `rank` integer
    - `totalVolume` number
    - `tradeCount` integer
    - `walletAddress` string
    - `winRate` number
    - `winningPredictions` integer
  - `pagination` FtMarketServiceV2PkgApiPagination
    - `hasMore` boolean
    - `totalResults` integer

## Other responses

- `400` — Bad Request
- `500` — Internal Server Error

---

[API](https://skmtc.dev/42/apis/fortytwo-read-api.md) · [All operations](https://skmtc.dev/42/apis/fortytwo-read-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/42/fortytwo-read-api/revisions/660740bda403/schema)