Docs | Kash

Returns a twitter.com/intent/tweet URL with the tweet already written: the outcome, the amount and the account to mention. A user who has connected their X account to the Kash web app can post it, and the Kash trading bot reads the tweet and submits the trade from the user’s own self-custodial wallet. Use it to build your own “Predict” buttons without an iframe.

Endpoint

GET https://app.kash.bot/api/markets/:id/twitter-link

Path parameters

string

required

Market UUID.

Query parameters

integer

required

The outcome you expect, from 0 to outcomeCount - 1.

number

required

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

string

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

How the tweet is built

Mention. The tweet mentions the X account that trades on this market (the market’s marketBotHandle). If the market has none, it mentions the Kash trading bot.
Outcome text. Outcome 0 is written as Yes, outcome 1 as No, and any other outcome as Outcome N, counting from 1. To use the market’s real outcome labels, call POST /api/twitter-links instead.
Quote or link. If the market was announced on X, the announcement tweet’s URL is added to the text, which makes the post a quote tweet. Otherwise the intent URL carries a url parameter that points to the market page on app.kash.bot.

Response

string

The intent URL to open

string

The tweet text, including the quoted URL when there is one

object

{ id, question, sourceTweetUrl }

Errors

Status	When
400 `VALIDATION_ERROR`	A parameter is missing or out of range, or the market isn’t accepting predictions (it isn’t `ACTIVE`, or it has expired). In the second case, `details.market` is `{ id, question, status, isExpired }`.
404 `NOT_FOUND`	Unknown market

Caching and 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/twitter-link?outcomeIndex=0&amount=10"

async function predictOnX(marketId, outcomeIndex, amount) {
  const params = new URLSearchParams({ outcomeIndex, amount });
  const res = await fetch(
    `https://app.kash.bot/api/markets/${marketId}/twitter-link?${params}`
  );
  const body = await res.json();
  if (!res.ok) throw new Error(body.message);
  window.open(body.twitterUrl, '_blank', 'noopener');
}

Example response

200

{
  "twitterUrl": "https://twitter.com/intent/tweet?text=<url-encoded tweetContent>&related=hot_takefc",
  "tweetContent": "<generated tweet text: amount, outcome, @hot_takefc and the announcement URL>",
  "market": {
    "id": "93f1445c-912c-47b4-8065-d1ff5a6b8dfc",
    "question": "Will Ousmane Dembélé score against FC Barcelona?",
    "sourceTweetUrl": "https://x.com/hot_takefc/status/2112339123369394597"
  }
}

400 (market closed)

{
  "error": "ValidationError",
  "message": "This market is no longer accepting predictions",
  "code": "VALIDATION_ERROR",
  "details": {
    "market": { "id": "…", "question": "…", "status": "RESOLVED", "isExpired": true }
  },
  "timestamp": "2026-10-20T17:52:15.648Z"
}

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/twitter-link

Endpoint

Path parameters

Query parameters

How the tweet is built

Response

Errors

Caching and rate limit

Example request

Example response

​Endpoint

​Path parameters

​Query parameters

​How the tweet is built

​Response

​Errors

​Caching and rate limit

​Example request

​Example response

Endpoint

Path parameters

Query parameters

How the tweet is built

Response

Errors

Caching and rate limit

Example request

Example response