Docs | Kash

Asks the market’s AMM what a trade would return. You get the tokens a buy would receive, or the USDC a sell would release, the prices after the trade, and the protocol fee. Buy quotes also include an estimated payout. A quote is read-only and places nothing.

Endpoint

GET https://app.kash.bot/api/markets/:id/quote

Path parameters

string

required

Market UUID.

Query parameters

integer

required

The outcome to trade, from 0 to outcomeCount - 1.

string

required

buy or sell.

string

required

A positive whole number in atomic units. For buy it is USDC to spend, with 6 decimals (1000000 is 1 USDC). For sell it is outcome tokens to sell, as WAD with 18 decimals (1000000000000000000 is 1 token).

Response

object

Show Quote (buy)

integer

The quoted outcome

string

buy

string

USDC in, atomic

string

Outcome tokens received, WAD

string

AMM reserve after the trade, WAD

string

AMM invariant after the trade, WAD

string[]

Each outcome’s marginal price after the trade, WAD

string[]

Each outcome’s token supply after the trade, WAD

number

USDC paid per token

number

The outcome’s marginal price after the trade (0 to 1)

number

Protocol fee in basis points

object | null

Payout estimate in whole USDC: youPayUsdc, protocolFeeUsdc, netIntoAmmUsdc, tokensReceived, payoutAtCurrentPriceUsdc (what the position pays if it wins and prices stay where they are), estimatedPayoutUsdc and snapshotPayoutUsdc (the same value with a historical adjustment applied), payoutUplift, payoutUpliftPercentile, impliedChanceAfter, effectiveBreakEvenChance and gasEstimateUsdc. A promotional promotionalEstimatedPayoutUsdc string may also be present. It is display-only and does not change the trade. estimate is null when it can’t be computed.

Show Quote (sell)

string

sell

string

Tokens sold, WAD

string

USDC received, atomic

string

Gross value released by the AMM before fees, WAD

…

As for buy

number

Estimated network cost in whole USDC

object

{ id, contractAddress, chainId, outcomes, status }. The outcomes here carry the AMM’s raw marginal probability, next to impliedChance.

object

Always { "usdc": "atomic-6", "token": "wad-18" }.

Errors

Status	When
400	`amount` isn’t a positive integer, `outcomeIndex` doesn’t exist in this market, `action` is missing, or the market has no on-chain address yet
404	Unknown market
503	The chain read timed out. Retry after the `Retry-After` header.

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/quote?outcomeIndex=0&action=buy&amount=1000000"

const usdc = 25;
const params = new URLSearchParams({
  outcomeIndex: '1',
  action: 'buy',
  amount: String(usdc * 1_000_000),
});
const res = await fetch(
  `https://app.kash.bot/api/markets/93f1445c-912c-47b4-8065-d1ff5a6b8dfc/quote?${params}`
);
const { quote } = await res.json();
console.log(`You get ${quote.estimate?.tokensReceived} tokens; pays ~$${quote.estimate?.payoutAtCurrentPriceUsdc} if it wins`);

Example response

200 (buy)

{
  "quote": {
    "outcomeIndex": 0,
    "action": "buy",
    "amountIn": "1000000",
    "tokensOut": "2560361899641206351",
    "reserveAfter": "35840000000000000000",
    "c": "1284505599999999999890015839908063127120",
    "pAfter": ["399183389531376030", "583654539537080709"],
    "qAfter": ["28613465361609033879", "41836357394017945260"],
    "effectivePrice": 0.39056978630252775,
    "impliedProbability": 0.399183389531376,
    "estimate": {
      "youPayUsdc": 1,
      "protocolFeeUsdc": 0.01,
      "netIntoAmmUsdc": 0.99,
      "tokensReceived": 2.5603618996412063,
      "snapshotPayoutUsdc": 4.490933220704572,
      "estimatedPayoutUsdc": 4.490933220704572,
      "payoutAtCurrentPriceUsdc": 3.2069995480610554,
      "impliedChanceAfter": 0.3186947569,
      "payoutUplift": 1.40035355584,
      "payoutUpliftPercentile": 95,
      "effectiveBreakEvenChance": 0.3118179422895765,
      "gasEstimateUsdc": 0.05
    }
  },
  "market": {
    "id": "93f1445c-912c-47b4-8065-d1ff5a6b8dfc",
    "contractAddress": "HGiuo13ea68p3BphxamZSyHzqo8HYnUJutFFqyrbfA7C",
    "chainId": 9000001,
    "outcomes": [
      { "outcomeIndex": 0, "tokenId": 60928, "label": "Yes", "weight": "500000000000000000", "shareSupply": "26053103461967827528", "probability": 0.3837577016, "impliedChance": 0.279436651 },
      { "outcomeIndex": 1, "tokenId": 60929, "label": "No", "weight": "500000000000000000", "shareSupply": "41836357394017945260", "probability": 0.6162422983, "impliedChance": 0.7205633489 }
    ],
    "status": "ACTIVE"
  },
  "units": { "usdc": "atomic-6", "token": "wad-18" }
}

400

{
  "error": "ValidationError",
  "message": "outcomeIndex is not an outcome",
  "code": "VALIDATION_ERROR",
  "timestamp": "2026-10-20T17:45:02.118Z"
}

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/quote

Endpoint

Path parameters

Query parameters

Response

Errors

Caching and rate limit

Example request

Example response

​Endpoint

​Path parameters

​Query parameters

​Response

​Errors

​Caching and rate limit

​Example request

​Example response

Endpoint

Path parameters

Query parameters

Response

Errors

Caching and rate limit

Example request

Example response