Partner quickstart

export KASH_API=https://api-staging.kash.bot/v1
export KASH_PARTNER_KEY=kash_test_...   # from your secret store

curl -X POST "$KASH_API/partner/accounts" \
  -H "X-API-Key: $KASH_PARTNER_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: create-hsp-user-8841" \
  -d '{
    "externalId": "hsp-user-8841",
    "destination": { "network": "solana", "address": "8yYpcE7Jx9NmXNMGR6NGumBUu4UBpMTVQW44P9hwikyh" },
    "country": "GB",
    "consent": { "acceptedAt": "2026-11-06T10:15:00Z", "termsVersion": "hsp-kash-terms-2026-11" }
  }'

export ACCOUNT_ID=7a1c2e3d-4b5f-4a6e-8d7c-1b2a3c4d5e6f

curl "$KASH_API/partner/accounts/$ACCOUNT_ID" -H "X-API-Key: $KASH_PARTNER_KEY"

curl "$KASH_API/balance" \
  -H "X-API-Key: $KASH_PARTNER_KEY" \
  -H "Kash-Account: $ACCOUNT_ID"

curl "$KASH_API/markets?status=ACTIVE&category=sports&limit=5" \
  -H "X-API-Key: $KASH_PARTNER_KEY"

export MARKET_ID=...   # a market with "tradeable": true

curl "$KASH_API/markets/$MARKET_ID/quote?outcomeIndex=0&action=buy&amount=10000000" \
  -H "X-API-Key: $KASH_PARTNER_KEY"

curl -X POST "$KASH_API/trades" \
  -H "X-API-Key: $KASH_PARTNER_KEY" \
  -H "Kash-Account: $ACCOUNT_ID" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "marketId": "'"$MARKET_ID"'",
    "outcomeIndex": 0,
    "amount": "10",
    "side": "buy",
    "metadata": { "externalId": "hsp-user-8841" }
  }'

curl "$KASH_API/partner/accounts/$ACCOUNT_ID/withdrawals/quote?amountAtomic=5000000" \
  -H "X-API-Key: $KASH_PARTNER_KEY"

curl -X POST "$KASH_API/partner/accounts/$ACCOUNT_ID/withdrawals" \
  -H "X-API-Key: $KASH_PARTNER_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: hsp-withdrawal-90311" \
  -d '{ "amountAtomic": "5000000" }'

import { randomUUID } from 'node:crypto';
import { KashClient } from '@kashdao/sdk';

const kash = new KashClient({ apiKey: process.env.KASH_PARTNER_KEY! }); // a kash_test_ key goes to staging

// 1. Create the account when the user opts in. Keep the key with the pending
//    onboarding and reuse it on every retry.
const { account } = await kash.partnerAccounts.create(
  {
    externalId: 'hsp-user-8841',
    destination: { network: 'solana', address: '8yYpcE7Jx9NmXNMGR6NGumBUu4UBpMTVQW44P9hwikyh' },
    country: 'GB',
    consent: { acceptedAt: new Date().toISOString(), termsVersion: 'hsp-kash-terms-2026-11' },
  },
  { idempotencyKey: 'create-hsp-user-8841' },
);
const accountId = account.accountId;

// 2. Wait until it is active (or handle the account.active webhook).
const active = await kash.partnerAccounts.waitUntilActive(accountId);
console.log('fund', active.depositAddress);

// 3. Once funded, read what the account can spend (atomic USDC).
const { availableAtomic } = await kash.balance.get({ account: accountId });
if (BigInt(availableAtomic) < 10_000_000n) throw new Error('fund the account first');

// 4. Markets and quotes act for no account.
const page = await kash.markets.list({ status: 'ACTIVE', category: 'sports', limit: 20 });
const market = page.data.find((m) => m.tradeable);
if (!market) throw new Error('no tradeable market');
const quote = await kash.quotes.buy({ marketId: market.id, outcomeIndex: 0, amountUsdcAtomic: '10000000' });
console.log('10 USDC buys', quote.tokensOut, 'outcome tokens');

// 5. Trade for the account. The trade amount is decimal USDC.
const trade = await kash.trades.create(
  { marketId: market.id, outcomeIndex: 0, amount: '10', side: 'buy', metadata: { externalId: 'hsp-user-8841' } },
  { account: accountId },
);
console.log('trade', trade.id, trade.status); // the outcome arrives by webhook

// 6. Quote a withdrawal to the registered destination, then send it.
const withdrawalQuote = await kash.partnerAccounts.withdrawals.quote(accountId, { amountAtomic: '5000000' });
console.log('at least', withdrawalQuote.receiveAtomic, 'arrives');
const withdrawalKey = randomUUID(); // keep it with the request on your side, and reuse it on retry
const { withdrawal } = await kash.partnerAccounts.withdrawals.create(
  accountId,
  { amountAtomic: '5000000' },
  { idempotencyKey: withdrawalKey },
);
console.log('withdrawal', withdrawal.withdrawalId, withdrawal.status);