Docs | Kash

Returns two deep links, one for outcome 0 and one for outcome 1, for every market in a thread that is verified, tradeable and not expired. Use it to render a whole thread with your own UI. For a single market, or for outcomes beyond the first two, use GET /api/markets/:id/twitter-link or POST /api/twitter-links.

Endpoint

GET https://app.kash.bot/api/threads/:id/twitter-links

Path parameters

string

required

Thread UUID.

Query parameters

number

default:"10"

The trade amount in whole USDC, from 1 to 10,000.

string

The language of the tweet: en, es, zh, pt or ru.

Response

object

{ id, title, description }

object[]

Show Market links

string

Market UUID

string

Market title

string

Intent URL for outcome 0, written as Yes

string

Intent URL for outcome 1, written as No

string

Tweet text for outcome 0

string

Tweet text for outcome 1

object

{ requestedAt, amount, totalMarkets }

Each tweet mentions the X account that posts the market, or the Kash trading bot if there is none. These links don’t quote the market’s announcement tweet.

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/threads/00000001-0000-4000-a000-000000000003/twitter-links?amount=25"

const res = await fetch(
  'https://app.kash.bot/api/threads/00000001-0000-4000-a000-000000000003/twitter-links?amount=25'
);
const { thread, markets } = await res.json();
for (const m of markets) {
  console.log(m.question, m.outcome0Link, m.outcome1Link);
}

Example response

200

{
  "thread": {
    "id": "00000001-0000-4000-a000-000000000003",
    "title": "Soccer & World Football",
    "description": null
  },
  "markets": [
    {
      "marketId": "93f1445c-912c-47b4-8065-d1ff5a6b8dfc",
      "question": "Will Ousmane Dembélé score against FC Barcelona?",
      "outcome0Link": "https://twitter.com/intent/tweet?text=<url-encoded outcome0TweetContent>&related=kash_bot_trade",
      "outcome1Link": "https://twitter.com/intent/tweet?text=<url-encoded outcome1TweetContent>&related=kash_bot_trade",
      "outcome0TweetContent": "<generated tweet text for outcome 0>",
      "outcome1TweetContent": "<generated tweet text for outcome 1>"
    }
  ],
  "_meta": { "requestedAt": "2026-10-20T17:41:59.379Z", "amount": 25, "totalMarkets": 1 }
}

404

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

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/:id/twitter-links

Endpoint

Path parameters

Query parameters

Response

Rate limit

Example request

Example response

​Endpoint

​Path parameters

​Query parameters

​Response

​Rate limit

​Example request

​Example response

Endpoint

Path parameters

Query parameters

Response

Rate limit

Example request

Example response