Docs | Kash

Returns a page of verified markets. With no parameters you get active markets, newest first.

Endpoint

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

Query parameters

string

default:"active"

active, resolved or all. active includes markets that have passed their end time but are still waiting to resolve. all returns every market. cancelled, paused and refunded are accepted but currently return the same set as active.

string

true/1 or false/0. A shortcut that overrides status: true returns active markets and false returns resolved markets.

boolean

default:"false"

Applies to the active set only. When true, frozen and expired markets are left out, so every result can still be traded.

string

Matches against market titles and descriptions. Every word must match. 1 to 120 characters.

string

A category slug, such as football or business. /api/markets/category-stats lists the slugs.

string

Only markets in this thread (UUID). thread_id is also accepted.

string

Only markets in this chapter.

string

A comma-separated list of up to 100 market UUIDs.

boolean

default:"false"

When true, returns only markets created by creators rather than by Kash.

string

true or false. Filters on whether the market has an active fan-token redemption option.

integer

Earliest resolution time, in epoch seconds. Use it with status=resolved or status=all.

integer

Latest resolution time, in epoch seconds.

string

default:"created_at"

created_at, total_volume, current_probability, current_implied_chance, title or end_time.

string

default:"desc"

asc or desc.

integer

default:"100"

1 to 500.

integer

default:"0"

0 to 10,000.

Response

Market[]

Each market object has the fields below. Markets carry more fields than this list, but those extra fields are internal and may change.

Show Market

string

Market UUID

string

The market question. question holds the same value.

string | null

Longer description

string | null

How the market settles

object[]

{ name, url, imageUrl } for each source used to settle the market

object[]

{ title, url, linkType, displayOrder }: related links

string

UNSEEDED, ACTIVE, RESOLVED, ABANDONED or CANCELLED

boolean

true while trading is open

boolean

true once trading has stopped but the market hasn’t resolved yet

boolean

true once the market is resolved

integer | null

The winning outcome, once resolved

string | null

Set if the market was cancelled

number

End of the market, in milliseconds since the epoch

number

End of the market, in seconds since the epoch

number | null

When trading stops, in seconds since the epoch

number | null

When the market was resolved, in seconds since the epoch

number

9000001 (Solana) or 8453 (Base, older markets only)

string

On-chain market address (base58 on Solana, 0x on Base)

integer

Number of outcomes

object[]

{ outcomeIndex, tokenId, label, weight, shareSupply, probability, impliedChance }. impliedChance is the displayed implied probability (0 to 1), and probability is set to the same value. weight and shareSupply are WAD strings.

boolean

false when there is no price yet, so the prices are only a placeholder

number

Implied probability of outcome 0

number

AMM marginal price for outcome 0. Not normalized, so show currentImpliedChance instead.

number

Lifetime volume in atomic USDC (6 decimals)

number

Volume over the last 24 hours, in atomic USDC

string

Opening liquidity in atomic USDC

integer

Number of trades

integer

Number of distinct traders

number

Trading fee as a fraction of the trade amount

number

Smallest trade, in atomic USDC

number

Largest trade, in atomic USDC

string | null

Category slug

string | null

Category display name

string | null

Subcategory slug

string | null

Subcategory display name

string | null

HTTPS banner image URL

string | null

Image URI from the market metadata (may be ipfs://)

string | null

Creator’s display name

string | null

Creator’s username

string | null

Creator’s avatar

string | null

The tweet that announced the market

string | null

The X handle that trade tweets for this market should mention

string

When the market was created

object

{ offset, limit, total, hasMore }

object

{ requestedAt, cached, computed }

Rate limit

Market reads 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/markets?status=active&tradableOnly=true&sortBy=total_volume&limit=10"

const params = new URLSearchParams({
  status: 'active',
  tradableOnly: 'true',
  sortBy: 'total_volume',
  limit: '10',
});
const res = await fetch(`https://app.kash.bot/api/markets?${params}`);
const { markets, pagination } = await res.json();

for (const m of markets) {
  const prices = m.outcomes.map((o) => `${o.label} ${(o.impliedChance * 100).toFixed(0)}%`);
  console.log(m.title, prices.join(' / '));
}

import requests

res = requests.get(
    "https://app.kash.bot/api/markets",
    params={"status": "resolved", "resolvedAfter": 1790000000, "limit": 50},
)
data = res.json()
print(data["pagination"]["total"], "resolved markets")

Example response

200 (trimmed)

{
  "markets": [
    {
      "id": "93f1445c-912c-47b4-8065-d1ff5a6b8dfc",
      "title": "Will Ousmane Dembélé score against FC Barcelona?",
      "question": "Will Ousmane Dembélé score against FC Barcelona?",
      "status": "ACTIVE",
      "tradable": true,
      "frozen": false,
      "isResolved": false,
      "chainId": 9000001,
      "contractAddress": "HGiuo13ea68p3BphxamZSyHzqo8HYnUJutFFqyrbfA7C",
      "endTime": 1792530000000,
      "expiresAt": 1792530000,
      "freezeAt": 1792526400,
      "outcomeCount": 2,
      "outcomes": [
        { "outcomeIndex": 0, "tokenId": 60928, "label": "Yes", "weight": "500000000000000000", "shareSupply": "26053103461967827528", "probability": 0.279436651, "impliedChance": 0.279436651 },
        { "outcomeIndex": 1, "tokenId": 60929, "label": "No", "weight": "500000000000000000", "shareSupply": "41836357394017945260", "probability": 0.7205633489, "impliedChance": 0.7205633489 }
      ],
      "priceKnown": true,
      "currentImpliedChance": 0.279436651,
      "totalVolume": 35000000,
      "seedAmountAtomic": "20000000",
      "tradeCount": 4,
      "participantCount": 4,
      "category": "football",
      "categoryLabel": "Football",
      "marketBotHandle": "hot_takefc",
      "sourceTweetUrl": "https://x.com/hot_takefc/status/2112339123369394597"
    }
  ],
  "pagination": { "offset": 0, "limit": 10, "total": 47, "hasMore": true },
  "_meta": { "requestedAt": "2026-10-20T17:41:08.698Z", "cached": false, "computed": false }
}

400

{
  "error": "ValidationError",
  "message": "Invalid query parameters",
  "code": "VALIDATION_ERROR",
  "details": [
    { "origin": "number", "code": "too_big", "maximum": 500, "inclusive": true, "path": ["limit"], "message": "Too big: expected number to be <=500" }
  ],
  "timestamp": "2026-10-20T17:52:15.345Z"
}

GET /api/markets/:id

One market in full

GET /api/markets/state

Refresh prices for many 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/markets

Endpoint

Query parameters

Response

Rate limit

Example request

Example response

GET /api/markets/:id

GET /api/markets/state

​Endpoint

​Query parameters

​Response

​Rate limit

​Example request

​Example response

​Related

GET /api/markets/:id

GET /api/markets/state

Endpoint

Query parameters

Response

Rate limit

Example request

Example response

Related