> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kash.bot/llms.txt
> Use this file to discover all available pages before exploring further.

# GET /api/markets/:id/leaderboard

> Positions in one market, ranked by size

Lists the traders in one market, ranked by the amount they put in (largest first). Profit and loss figures are not exposed.

## Endpoint

```
GET https://app.kash.bot/api/markets/:id/leaderboard
```

## Path parameters

**id** `string` *required*

Market UUID.

## Query parameters

**limit** `integer` (default: 25)

1 to 50.

**offset** `integer` (default: 0)

0 to 10,000.

## Response

**entries** `Entry[]`

**Entry**

**rank** `integer`

1-based rank by `amount`

**userId** `string`

Kash user UUID

**address** `string`

Trading wallet address

**username** `string | null`

Display name

**handle** `string | null`

X handle

**profilePictureUrl** `string | null`

Avatar

**titleDisplayName** `string | null`

The trader's displayed title

**titleRarity** `string | null`

Title rarity

**outcomeIndex** `integer`

The trader's main outcome

**outcomeIndices** `integer[]`

Every outcome the trader holds

**outcomeLabel** `string`

Label of `outcomeIndex`

**outcomeColor** `string | null`

The outcome's display color

**outcomeImageUrl** `string | null`

The outcome's image

**amount** `number`

Amount put in, in atomic USDC

**currentValue** `number`

Current value of the position, in atomic USDC

**\_meta** `object`

`{ marketId, marketStatus, winningOutcomeIndex, resolvedAt, entryCount, totalEntries, returnedCount, limit, offset, hasMore }`. `totalEntries` is the number of ranked traders across all pages.

## Caching and rate limit

Leaderboards group, rate-limited per IP (see [Rate limits](/developer-docs/public-embed-api/overview#rate-limits)). Responses may be served from a short-lived cache.

## Example request

```bash cURL theme={null}
curl "https://app.kash.bot/api/markets/93f1445c-912c-47b4-8065-d1ff5a6b8dfc/leaderboard?limit=10"
```

## Example response

```json 200 theme={null}
{
  "entries": [
    {
      "userId": "3f2b0c1e-6a7d-4e59-9b8a-1c2d3e4f5a6b",
      "address": "9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM",
      "username": "Example Trader",
      "handle": "example_trader",
      "profilePictureUrl": "https://pbs.twimg.com/profile_images/…_normal.jpg",
      "titleDisplayName": "Rookie",
      "titleRarity": "common",
      "outcomeIndices": [1],
      "outcomeIndex": 1,
      "outcomeLabel": "No",
      "outcomeColor": null,
      "outcomeImageUrl": null,
      "amount": 10000000,
      "currentValue": 9702990,
      "rank": 1
    }
  ],
  "_meta": {
    "marketId": "93f1445c-912c-47b4-8065-d1ff5a6b8dfc",
    "marketStatus": "ACTIVE",
    "winningOutcomeIndex": null,
    "resolvedAt": null,
    "entryCount": 1,
    "totalEntries": 4,
    "returnedCount": 1,
    "limit": 10,
    "offset": 0,
    "hasMore": false
  }
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.