POST /api/twitter-links

Generate Twitter prediction URLs for multiple markets in batch

Generate Twitter intent URLs for multiple markets in a single request. Useful for building custom UIs with multiple prediction buttons.

---

Endpoint

POST https://app.kash.bot/api/twitter-links

Request Body

{
  "markets": [
    { "marketId": "abc123", "side": "yes", "amount": 25 },
    { "marketId": "def456", "side": "no", "amount": 50 }
  ]
}

markets · array · required

Array of market prediction requests (max 50)

Show Market Request Object

marketId · string · required

Market ID

side · string · required

Prediction side: yes or no

amount · number · required

Prediction amount in USD (1-10000)

Response

links · array

Successfully generated links

Show Link Object

marketId · string

Market ID

question · string

Market question

sourceTweetUrl · string

Original market tweet URL

twitterUrl · string

Twitter intent URL

tweetContent · string

Tweet content

side · string

Prediction side

amount · number

Prediction amount

errors · array

Failed requests with error messages

Show Error Object

marketId · string

Market ID that failed

error · string

Error message

Rate Limit

100 requests per minute per IP address (max 50 markets per request)

Example Request

cURL

curl -X POST "https://app.kash.bot/api/twitter-links" \
  -H "Content-Type: application/json" \
  -d '{
    "markets": [
      { "marketId": "abc123", "side": "yes", "amount": 25 },
      { "marketId": "def456", "side": "no", "amount": 50 }
    ]
  }'

Example Response

200 - Success

{
  "links": [
    {
      "marketId": "abc123",
      "question": "Will BTC hit $100k?",
      "sourceTweetUrl": "https://twitter.com/...",
      "twitterUrl": "https://twitter.com/intent/tweet?text=...",
      "tweetContent": "@kash_bot $25 on Yes https://twitter.com/...",
      "side": "yes",
      "amount": 25
    }
  ],
  "errors": [
    {
      "marketId": "def456",
      "error": "Market not found"
    }
  ],
  "_meta": {
    "requestedAt": "2025-01-15T12:00:00Z",
    "totalRequested": 2,
    "totalGenerated": 1,
    "totalErrors": 1
  }
}

---

Dynamic Market Discovery

Since markets can expire after 24 hours, use discovery endpoints to always show active markets:

async function loadTrendingPredictions() {
  // 1. Get trending markets
  const marketsRes = await fetch('https://app.kash.bot/api/markets/trending?limit=5');
  const { markets } = await marketsRes.json();

  // 2. Generate Twitter links for each market
  const linksRes = await fetch('https://app.kash.bot/api/twitter-links', {
    method: 'POST',
    headers: { 'Content-Type': 'application/json' },
    body: JSON.stringify({
      markets: markets.map(m => ({
        marketId: m.id,
        side: 'yes',
        amount: 25
      }))
    })
  });

  const { links } = await linksRes.json();
  
  // 3. Render your custom UI with the links
  renderMarkets(markets, links);
}

// Refresh every hour to get fresh markets
setInterval(loadTrendingPredictions, 60 * 60 * 1000);
loadTrendingPredictions();