Docs | Kash

Returns one market with the same fields as GET /api/markets. You can also ask for its price history, its recent trades and an AI-written summary.

Endpoint

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

Path parameters

string

required

Market UUID.

Query parameters

boolean

default:"false"

Include priceHistory.

boolean

default:"false"

Include recentTrades.

integer

default:"100"

How many recent trades to return, 1 to 500.

Response

Market

A market object. Prices are normalized as described there, and priceKnown is included.

object[]

Only present when history=true. Each point is { timestamp, price, probability, volume }. volume is atomic USDC.

object[]

Only present when trades=true. Newest first. Useful fields: id, outcomeIndex, tradeType (buy or sell), usdcIn and tokensOut (buys), usdcOut and tokensIn (sells), price, probability, traderAddress, transactionHash, chainId and timestamp. USDC values are atomic strings and token values are WAD strings.

object | null

{ summary, aiModel, createdAt }: an AI-generated background summary, or null.

object

{ requestedAt, transformed, includes: { history, trades, tradesCount } }

Caching

Priced markets are cached at the edge for 5 seconds, plus 5 seconds stale-while-revalidate. A market that is still being indexed, and so has no outcomes yet, is sent with Cache-Control: private, no-store. Poll it until outcomes is filled in.

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/93f1445c-912c-47b4-8065-d1ff5a6b8dfc?history=true&trades=true&trades_limit=5"

const id = '93f1445c-912c-47b4-8065-d1ff5a6b8dfc';
const res = await fetch(`https://app.kash.bot/api/markets/${id}?history=true`);
if (res.status === 404) throw new Error('Unknown market');
const { market, priceHistory } = await res.json();
console.log(market.title, market.outcomes[0].impliedChance, priceHistory.length);

Example response

200 (trimmed)

{
  "market": {
    "id": "93f1445c-912c-47b4-8065-d1ff5a6b8dfc",
    "title": "Will Ousmane Dembélé score against FC Barcelona?",
    "status": "ACTIVE",
    "chainId": 9000001,
    "outcomes": [
      { "outcomeIndex": 0, "label": "Yes", "probability": 0.279436651, "impliedChance": 0.279436651 },
      { "outcomeIndex": 1, "label": "No", "probability": 0.7205633489, "impliedChance": 0.7205633489 }
    ],
    "priceKnown": true,
    "totalVolume": 35000000
  },
  "priceHistory": [
    { "timestamp": "2026-10-20T01:43:09.000Z", "price": 0.523076, "probability": 0.523076, "volume": 1000000 }
  ],
  "recentTrades": [
    {
      "id": "GFhhTfDN…-3-1",
      "marketId": "93f1445c-912c-47b4-8065-d1ff5a6b8dfc",
      "outcomeIndex": 1,
      "tradeType": "buy",
      "usdcIn": "10000000",
      "tokensOut": "18040542635955972148",
      "price": "0.554307",
      "probability": "0.616242",
      "traderAddress": "Czt4oWbMewF6FDmx3dieTJPfvDJWajMJPgJU8RDmrEbi",
      "transactionHash": "GFhhTfDNtSz56JNHCKbTNSak6NirHNNB4J4higfGapaec8JCwGQVDHcPvgpjzw1MpFkdccSSLdfCTQGASczmdJE",
      "chainId": 9000001,
      "timestamp": "2026-10-20 16:06:49+00"
    }
  ],
  "aiInsight": {
    "summary": "Paris Saint-Germain host Barcelona on 20 October 2026…",
    "aiModel": "perplexity/sonar-pro",
    "createdAt": "2026-10-20 00:24:22.083662+00"
  },
  "_meta": {
    "requestedAt": "2026-10-20T17:40:51.417Z",
    "transformed": true,
    "includes": { "history": true, "trades": true, "tradesCount": 1 }
  }
}

404

{
  "error": "NotFoundError",
  "message": "Market '00000000-0000-4000-8000-000000000000' not found",
  "code": "NOT_FOUND",
  "timestamp": "2026-10-20T17:40:53.349Z"
}

GET /api/markets/:id/state

Lightweight live prices

GET /api/markets/:id/quote

Price a trade

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

Endpoint

Path parameters

Query parameters

Response

Caching

Rate limit

Example request

Example response

GET /api/markets/:id/state

GET /api/markets/:id/quote

​Endpoint

​Path parameters

​Query parameters

​Response

​Caching

​Rate limit

​Example request

​Example response

​Related

GET /api/markets/:id/state

GET /api/markets/:id/quote

Endpoint

Path parameters

Query parameters

Response

Caching

Rate limit

Example request

Example response

Related