Docs | Kash

A thread is a curated collection of related markets with its own start and end time. This endpoint lists threads across the whole platform.

Endpoint

GET https://app.kash.bot/api/threads

Query parameters

string

default:"active"

active returns threads whose start time has passed and whose end time hasn’t. upcoming returns threads that haven’t started. closed returns threads that have ended. A thread without both a start and an end time is never active. all is accepted but currently returns the same set as active.

string

Only threads created by this user (UUID).

string

default:"created_at"

created_at, start_time or total_volume.

string

default:"desc"

asc or desc.

integer

default:"100"

1 to 500.

integer

default:"0"

0 to 10,000.

Response

Thread[]

Show Thread

string

Thread UUID

string

Title

string

Description ("" if none)

string

Image URL ("" if none)

string

Background image URL, when set

string

upcoming, active or completed

boolean

true when status is active

string

ISO 8601, when set

string

ISO 8601. If the thread has no end time, this is the time of the request.

integer

Number of markets

number

Volume across the thread’s markets, in atomic USDC

integer

Number of distinct traders

string

Category ID, when set

array

Always empty

string

ISO 8601

string

ISO 8601

object

{ offset, limit, total, hasMore }

object

{ requestedAt, transformed, dataSource, filters }. filters repeats the query you sent.

Caching and rate limit

Thread list group, rate-limited per IP (see Rate limits). Responses may be served from a short-lived cache.

Example request

curl "https://app.kash.bot/api/threads?status=upcoming&sortBy=start_time&sortOrder=asc&limit=10"

const res = await fetch('https://app.kash.bot/api/threads?status=active&limit=20');
const { threads, pagination } = await res.json();
threads.forEach((t) => console.log(t.title, t.marketCount));

Example response

200

{
  "threads": [
    {
      "id": "00000001-0000-4000-a000-000000000003",
      "title": "Soccer & World Football",
      "description": "",
      "image": "",
      "status": "active",
      "isActive": true,
      "startTime": "2026-10-01T00:00:00.000Z",
      "endTime": "2026-12-31T23:59:59.000Z",
      "marketCount": 12,
      "totalVolume": 1250000000,
      "participantCount": 210,
      "category": "cc727321-5211-44a1-9d14-0c267e12073c",
      "topUsers": [],
      "createdAt": "2026-06-08T00:41:00.855Z",
      "updatedAt": "2026-06-08T00:41:00.855Z"
    }
  ],
  "pagination": { "offset": 0, "limit": 20, "total": 1, "hasMore": false },
  "_meta": {
    "requestedAt": "2026-10-20T17:40:22.978Z",
    "transformed": true,
    "dataSource": "drizzle",
    "filters": { "status": "active", "sortBy": "created_at", "sortOrder": "desc", "limit": 20, "offset": 0 }
  }
}

GET /api/threads/:id

One thread

GET /api/threads/:id/markets

A thread’s markets

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/threads

Endpoint

Query parameters

Response

Caching and rate limit

Example request

Example response

GET /api/threads/:id

GET /api/threads/:id/markets

​Endpoint

​Query parameters

​Response

​Caching and rate limit

​Example request

​Example response

​Related

GET /api/threads/:id

GET /api/threads/:id/markets

Endpoint

Query parameters

Response

Caching and rate limit

Example request

Example response

Related