Docs | Kash

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

string

required

Market UUID.

Query parameters

integer

default:"25"

1 to 50.

integer

default:"0"

0 to 10,000.

Response

Entry[]

Show Entry

integer

1-based rank by amount

string

Kash user UUID

string

Trading wallet address

string | null

Display name

string | null

X handle

string | null

Avatar

string | null

The trader’s displayed title

string | null

Title rarity

integer

The trader’s main outcome

integer[]

Every outcome the trader holds

string

Label of outcomeIndex

string | null

The outcome’s display color

string | null

The outcome’s image

number

Amount put in, in atomic USDC

number

Current value of the position, in atomic USDC

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). Responses may be served from a short-lived cache.

Example request

cURL

curl "https://app.kash.bot/api/markets/93f1445c-912c-47b4-8065-d1ff5a6b8dfc/leaderboard?limit=10"

Example response

200

{
  "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
  }
}

Overview

REST API

Webhooks

REST API SDK (TypeScript)

CLI

Protocol SDK (TypeScript)

Protocol SDK (Python)

API Error Catalogue

Public Embed API

Embed — Thread Endpoints

Embed — Market Endpoints

Embed — Twitter Deep Links

Embed — Guides

Embed — Code Examples

GET /api/markets/:id/leaderboard

Endpoint

Path parameters

Query parameters

Response

Caching and rate limit

Example request

Example response

​Endpoint

​Path parameters

​Query parameters

​Response

​Caching and rate limit

​Example request

​Example response

Endpoint

Path parameters

Query parameters

Response

Caching and rate limit

Example request

Example response