Build on KAOS

Build the next way
people predict.

APIs, SDKs, and webhooks to bring KAOS prediction markets into your app.

Apply now Read the docs

Docs and API

One API for every market.

Private preview. Endpoints and package names shown are illustrative and will be confirmed when builder access opens.

Markets

List live markets, prices, and volume across sports, culture, and tournaments.

GET /v1/markets

Orders

Place Yes or No orders and attribute every fill to your builder code.

POST /v1/orders

Positions

Read user positions, payouts, and history in one call.

GET /v1/positions

Streams

Subscribe to live price and order book updates over WebSocket.

wss://stream.kaos.markets

# Fetch live markets
GET https://api.kaos.markets/v1/markets
Authorization: Bearer $KAOS_KEY

# Response
{
  "id": "nba_finals_2027",
  "question": "Who wins the NBA Finals?",
  "yes": 0.62,
  "no": 0.38,
  "status": "open"
}

SDKs

Ship in your language.

TSTypeScript

npm install @kaos/sdk

PYPython

pip install kaos

SWSwift

.package(url: "kaos/swift")

KTKotlin

implementation("markets.kaos:sdk")

import { Kaos } from "@kaos/sdk"

const kaos = new Kaos({ apiKey, builderCode: "YOUR_CODE" })

const market = await kaos.markets.get("nba_finals_2027")
await kaos.orders.create({ market: market.id, side: "yes", amount: 25 })

Webhooks

Know the moment a market moves.

market.openedA new market goes live.
price.changedOdds cross a threshold you set.
order.filledA user order fills through your app.
market.resolvedThe outcome is final and payouts begin.

// POST to your endpoint
{
  "event": "market.resolved",
  "market": "nba_finals_2027",
  "outcome": "yes",
  "builder": "YOUR_CODE",
  "signed": true
}

Sandbox

Test with play money first.

Every builder gets a sandbox with mock markets, test keys, and instant resolution.

Get test keys

sandbox.kaos.markets

Will it rain in Austin on Saturday?

Who takes the padel final?

✓ order.filled sandbox 25 credits

FAQ

Questions builders ask.

What is the KAOS Builders Program?

A program for developers launching apps, tools, and experiments on KAOS prediction markets.

Builder or developer, which am I?

Builders put markets in front of users and route their orders, so every fill is attributed to your builder code. Developers use market data and APIs for analytics, bots, research, and tools. Pick either one, or both, when you apply.

How do I join?

Apply below and we will send your builder code and sandbox keys.

What are builder codes?

Builder codes attribute every order from your app to your builder profile.

What should I build?

Embedded markets, pro trading tools, analytics, media, or something we have not imagined yet.

How do weekly rewards work?

Rewards are paid weekly to top builders based on volume routed through their builder code.

What support do builders get?

Direct technical support and a boost on KAOS social channels.

Apply now.

Get a builder badge when you join.