Quickstart

export KASH_API_KEY="kash_test_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
export KASH_API="https://api-staging.kash.bot/v1"

curl "$KASH_API/markets?status=ACTIVE&limit=5" \
  -H "X-API-Key: $KASH_API_KEY" \
  -H "X-Kash-Api-Version: 2026-08-19"

MARKET_ID="<a market id from step 3>"

curl "$KASH_API/markets/$MARKET_ID/quote?outcomeIndex=0&action=buy&amount=10000000" \
  -H "X-API-Key: $KASH_API_KEY" \
  -H "X-Kash-Api-Version: 2026-08-19"

curl -X POST "$KASH_API/trades" \
  -H "X-API-Key: $KASH_API_KEY" \
  -H "X-Kash-Api-Version: 2026-08-19" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "marketId": "'"$MARKET_ID"'",
    "outcomeIndex": 0,
    "amount": "10",
    "side": "buy",
    "metadata": { "source": "quickstart" }
  }'

{
  "trade": { "id": "…", "status": "pending", "correlationId": "…", "chainRef": "solana:devnet", "txHash": null, "…": "…" },
  "data":  { "…": "same as trade" },
  "_meta": { "requestId": "…", "timestamp": "…", "idempotent": false }
}

TRADE_ID="<the id from step 5>"

curl "$KASH_API/trades/$TRADE_ID" \
  -H "X-API-Key: $KASH_API_KEY" \
  -H "X-Kash-Api-Version: 2026-08-19"

{
  "id": "…",
  "type": "trade.completed",
  "apiVersion": "2026-08-19",
  "createdAt": "…",
  "data": {
    "tradeId": "…",
    "marketId": "…",
    "chainRef": "solana:devnet",
    "outcomeIndex": 0,
    "amount": "10",
    "side": "buy",
    "status": "completed",
    "txHash": "5VERv8NMvzbJMEkV8xnrLkEaWRtSz9CosKDYjCJjBRnbJLgp8uirBgmQpjKhoR4tjF3ZpRzrFmBV6UjKdiSZkQUW",
    "tokensOut": "18734012471176000000",
    "metadata": { "source": "quickstart" }
  }
}

X-Kash-Signature:   t=1792000000000,v1=<hex-hmac-sha256>
X-Kash-Event-Id:    <same as the body id>
X-Kash-Event-Type:  trade.completed
X-Kash-Api-Version: 2026-08-19

npm install @kashdao/sdk

import { KashClient } from '@kashdao/sdk';

// A kash_test_ key is routed to staging automatically.
const kash = new KashClient({ apiKey: process.env.KASH_API_KEY! });

const trade = await kash.trades.create({
  marketId,
  outcomeIndex: 0,
  amount: '10',
  side: 'buy',
  metadata: { source: 'quickstart' },
});

const final = await kash.trades.waitForCompletion(trade.id);
console.log(final.status, final.txHash);