> ## Documentation Index > Fetch the complete documentation index at: https://dash-docs.nomos.trade/llms.txt > Use this file to discover all available pages before exploring further. # Board > A page of the board, best first: every wallet that ever traded on Polymarket, lifetime. Win rate and profit factor rank only wallets with 10 or more decided markets. Page with `cursor`. ## OpenAPI ````yaml /openapi.json get /v1/leaderboard openapi: 3.1.0 info: title: Codex API version: 1.0.0 description: >- Nomos's Polymarket index, rebuilt from Polygon: holders, positions, PnL, trades, leaderboards and live fills. servers: - url: https://codex-api.nomos.trade security: - bearerAuth: [] tags: - name: Markets - name: Wallets - name: Leaderboard - name: Events - name: Fills - name: Crypto Strikes - name: Health paths: /v1/leaderboard: get: tags: - Leaderboard summary: Board description: >- A page of the board, best first: every wallet that ever traded on Polymarket, lifetime. Win rate and profit factor rank only wallets with 10 or more decided markets. Page with `cursor`. operationId: board parameters: - name: period in: query required: false description: Lifetime. Windows are on the wallet routes. schema: type: string enum: - all default: all - name: category in: query required: false description: >- `global`, `Other`, or Politics, Sports, Crypto, Finance, Culture, Mentions, Weather, Economics, Tech (any case). schema: type: string default: global example: Politics - name: sort in: query required: false description: The column to rank by (the last two on global only). schema: type: string enum: - total_pnl - realized_pnl - unrealized_pnl - win_rate - profit_factor - volume - markets_traded - best_trade - last_trade_at - avg_win - open_position_count - open_positions_value default: total_pnl - name: dir in: query required: false description: '' schema: type: string enum: - desc - asc default: desc - name: limit in: query required: false description: Rows, 1 to 500. Out of range is clamped. schema: type: integer minimum: 1 maximum: 500 default: 100 example: 5 - name: cursor in: query required: false description: The previous page's `next`, with the same category, sort and dir. schema: type: string responses: '200': description: OK headers: x-ratelimit-limit: description: Your rate, requests a minute. schema: type: integer x-ratelimit-remaining: description: Requests left in your bucket. schema: type: integer content: application/json: schema: type: object properties: block: type: - integer - 'null' description: The leaderboard rollup's block. asOf: type: - integer - 'null' description: When the rollup ran. Unix seconds. period: type: string description: '' category: type: string description: '' sort: type: string description: '' dir: type: string description: '' rows: type: array items: $ref: '#/components/schemas/BoardRow' next: type: - string - 'null' description: 'Opaque: send it as `cursor`.' example: block: 94812300 asOf: 1790862180 period: all category: Politics sort: total_pnl dir: desc rows: - wallet: '0x1f0ebc543b2d411f66947041625c0aa1ce61cf79' category: Politics totalPnl: 2841033.12 realizedPnl: 2790210.44 unrealizedPnl: 50822.68 capital: 18320511.9 roi: 0.1551 volume: 39811240.33 buyVolume: 20114002.1 sellVolume: 19697238.23 shareVolume: 61210455.2 fees: 18322.4 fills: 48211 marketsTraded: 1822 marketsDecided: 1790 marketsWon: 1011 marketsLost: 761 winRate: 0.5705 profitFactor: 1.62 profitFactorInfinite: false winsUsd: 7290211.5 lossesUsd: -4500001.06 avgWin: 7210.89 avgLoss: -5913.27 best: pnl: 412880.5 conditionId: >- 0x8db33416a2d1ebde7438c80129e898f89a5deb3852ca64b37c4bf46513204409 question: US announces end of Iranian blockade by March 31, 2027? slug: us-announces-end-of-iranian-blockade-by-march-31-2027 eventSlug: us-announces-end-of-iranian-blockade image: >- https://polymarket-upload.s3.us-east-2.amazonaws.com/example.png worst: pnl: -188004.2 conditionId: >- 0x2c5e0f3a9b81d47e6c05f2a1b3d4e5f60718293a4b5c6d7e8f90a1b2c3d4e5f6 question: Example market slug: example eventSlug: example image: null avgHoldSeconds: 1209600 redemptions: 902 firstActivityAt: 1667001600 lastActivityAt: 1790862117 open: count: 31 value: 402118.2 cost: 351295.52 approxMarkets: 4 updatedAt: 1790862180 next: eyJwIjowLCJjIjoxLCJzIjoidG90YWxfcG5sIiwiZCI6ImRlc2MifQ '400': description: A parameter is malformed or out of range content: application/json: schema: $ref: '#/components/schemas/Error' examples: e0: summary: category must be global or one of the nine value: error: category must be global or one of the nine '401': $ref: '#/components/responses/Unauthorized' '429': $ref: '#/components/responses/RateLimited' '503': description: 'Not ready, or off: retry later' content: application/json: schema: $ref: '#/components/schemas/Error' examples: e0: summary: the leaderboard is not built yet value: error: the leaderboard is not built yet components: schemas: BoardRow: type: object properties: wallet: type: string description: The wallet. category: type: string description: global, Other, or a category name. totalPnl: type: number description: Settled PnL plus the open book at its last fill prices, in USD. realizedPnl: type: number description: Settled PnL, in USD. unrealizedPnl: type: number description: The open book, in USD. capital: type: number description: Bought plus split shares at $0.50, in USD. roi: type: - number - 'null' description: totalPnl / capital, a fraction. volume: type: number description: Bought plus sold, in USD. buyVolume: type: number description: Bought, in USD. sellVolume: type: number description: Sold, in USD. shareVolume: type: number description: Shares traded. fees: type: number description: Fees, in USD. fills: type: integer description: Fills. marketsTraded: type: integer description: Markets traded. marketsDecided: type: integer description: Resolved, or every leg under 0.1 share. marketsWon: type: integer description: Decided with PnL above 0. marketsLost: type: integer description: Decided with PnL below 0. winRate: type: - number - 'null' description: won / (won + lost), a fraction. profitFactor: type: - number - 'null' description: wins / |losses|; null when infinite. profitFactorInfinite: type: boolean description: Wins and no losses. winsUsd: type: number description: Sum of winning markets, in USD. lossesUsd: type: number description: Sum of losing markets (negative), in USD. avgWin: type: - number - 'null' description: USD. avgLoss: type: - number - 'null' description: USD, negative. best: type: - object - 'null' properties: pnl: type: number description: USD. conditionId: type: string description: The market. question: type: - string - 'null' description: '' slug: type: - string - 'null' description: '' eventSlug: type: - string - 'null' description: '' image: type: - string - 'null' description: '' worst: type: - object - 'null' properties: pnl: type: number description: USD. conditionId: type: string description: The market. question: type: - string - 'null' description: '' slug: type: - string - 'null' description: '' eventSlug: type: - string - 'null' description: '' image: type: - string - 'null' description: '' avgHoldSeconds: type: - integer - 'null' description: Average time from entering a decided market to leaving it. redemptions: type: integer description: Markets it redeemed in. firstActivityAt: type: - integer - 'null' description: First activity. Unix seconds. lastActivityAt: type: - integer - 'null' description: Latest activity. Unix seconds. open: type: - object - 'null' properties: count: type: integer description: Open legs. value: type: number description: At last fill prices, in USD. cost: type: number description: Their cost, in USD. description: Its open book; null on a past window. approxMarkets: type: integer description: Markets where a basis was approximated. updatedAt: type: - integer - 'null' description: When the row last changed. Unix seconds. description: A wallet's leaderboard row. Error: type: object properties: error: type: string description: What went wrong, for a person to read. description: Every error answer. responses: Unauthorized: description: No key, or an unknown or revoked one. content: application/json: schema: $ref: '#/components/schemas/Error' example: error: unknown or revoked API key RateLimited: description: >- Over your rate, or more than 4 requests (2 streams) at once. Wait `Retry-After` seconds. headers: retry-after: description: Seconds to wait. schema: type: integer content: application/json: schema: $ref: '#/components/schemas/Error' example: error: 'rate limit: 600 requests a minute; retry in 1 s' securitySchemes: bearerAuth: type: http scheme: bearer description: 'Your API key: `codex_` and 48 hex characters.' ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.