Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.kash.bot/llms.txt

Use this file to discover all available pages before exploring further.

The Kash REST API is the programmatic interface to the prediction-marketplace protocol. It’s built for developers, automated agents, and market makers — anything that talks to Kash without a human in the loop.
The two surfaces, and when to use which:
  • api.kash.bot (this API) — for machines. Authenticated with API keys. Per-key rate limits, telemetry, attribution. Trade execution, webhooks, portfolio access.
  • app.kash.bot/api (the Public Embed API) — for humans / UIs. Anonymous reads, designed for embedding markets in websites and apps. No trading.
If you’re building a trading bot, an analytics dashboard against your own positions, an MM strategy, a portfolio tool, or a connector for a third-party platform, you want the REST API. If you’re embedding markets in an article or website, you want the Embed API.

​
What’s in v1

Markets & Quotes

Browse markets, fetch detail, get on-chain quotes, list recent trades against a market.

Trades

Place buy/sell orders, list and inspect your own trades, confirm high-value trades.

Portfolio

Smart-account address, position summary, per-market position detail.

Webhooks

Receive trade lifecycle events at your endpoint. Stripe-style HMAC-signed, retried, replayable.

Account

Per-key telemetry: trade volume, latency p50/p99, webhook success rate, auth failures.

Traces

Walk a trade’s event timeline by correlation id — for debugging and observability.

​
Design principles

  • Stripe-shaped wire protocol. RFC 7807 errors, Idempotency-Key header, cursor pagination, dual-key envelopes ({ trade, data } on every single-resource response), Stripe-style HMAC webhook signatures. If you’ve integrated with Stripe, this will feel familiar.
  • OpenAPI 3.1 is the contract of record. The live spec at https://api.kash.bot/v1/openapi.json is the source of truth. Interactive docs at https://api.kash.bot/v1/docs.
  • Versioning by URL. Currently /v1/. Sunset and Deprecation headers (RFC 8594) announce changes 12 months ahead.
  • Always-on auth. Every data route requires a key — no anonymous fallback. This unlocks per-key rate limits, telemetry, kill switches, and abuse mitigation.
  • Decimal strings for big numbers. USDC and outcome-token amounts are returned as decimal strings (atomic-6 for USDC, WAD-18 for tokens). Never lose precision parsing JSON.

​
Base URL

Production: https://api.kash.bot/v1
Staging:    https://api-staging.kash.bot/v1
The staging environment is wired to Base Sepolia and is the right place to integrate before going live.

​
API version

The current API version is 2026-04-29. Every response carries X-Kash-Api-Version: 2026-04-29; every webhook envelope includes apiVersion. We surface this date so consumers can detect a server upgrade and pin against it.

​
Next steps

Quickstart

Generate a key, place your first trade, receive your first webhook — under 5 minutes.

Authentication

X-API-Key, scopes, IP allowlists, and key rotation.

Endpoint Reference

The full live spec, rendered interactively at /v1/docs.

​
Need help?

Developer Support

Email [email protected] for technical questions.

Discord

Join the #developers channel for real-time help and to share what you’re building.