Rizon API

# Market data needs no key
curl https://rizon.markets/api/v1/markets

# A key: make one at https://rizon.markets/docs#keys, or have a script make an account and its key
curl -X POST https://rizon.markets/api/v1/accounts
export RIZON_API_KEY=rz_…

# Buy up, $10, on the 15-second market
curl -X POST https://rizon.markets/api/v1/orders \
  -H "Authorization: Bearer $RIZON_API_KEY" -H "Content-Type: application/json" \
  -d '{"market": "BTC-15s", "side": "up", "size": 10}'

import os, requests

API = "https://rizon.markets/api/v1"
s = requests.Session()
s.headers["Authorization"] = f"Bearer {os.environ['RIZON_API_KEY']}"

print(s.get(f"{API}/markets").json()["markets"][0])
r = s.post(f"{API}/orders", json={"market": "BTC-15s", "side": "up", "size": 10})
print(r.status_code, r.json())

const API = 'https://rizon.markets/api/v1';
const headers = { Authorization: `Bearer ${process.env.RIZON_API_KEY}`, 'Content-Type': 'application/json' };

const { markets } = await (await fetch(`${API}/markets`)).json();
const res = await fetch(`${API}/orders`, { method: 'POST', headers, body: JSON.stringify({ market: 'BTC-15s', side: 'up', size: 10 }) });
console.log(res.status, await res.json());

curl -X POST https://rizon.markets/api/v1/connect \
  -H "Content-Type: application/json" -d '{"name": "btc-mm", "scope": "trade"}'

{
  "code": "KX4P-9QHT",
  "url": "https://rizon.markets/connect?code=KX4P-9QHT",
  "poll": "https://rizon.markets/api/v1/connect/cr_8f…?wait=25",
  "expiresAt": 1761600600000
}

curl -X POST https://rizon.markets/api/v1/accounts \
  -H "Content-Type: application/json" -d '{"name": "my_bot", "keyName": "v1"}'

{
  "t": 1761600000123,
  "markets": [
    { "id": "BTC-15s", "underlying": "BTC-USD", "horizon": 15, "strikeStep": 1, "strikeOffset": 0, "spot": 114233.2, "live": true, "bid": 114232, "ask": 114234, "bidSize": 1000, "askSize": 1000, "sigma": 35.45 },
    { "id": "BTC-1m", "underlying": "BTC-USD", "horizon": 60, "strikeStep": 1, "strikeOffset": 0, "spot": 114233.2, "live": true, "bid": 114231, "ask": 114235, "bidSize": 1000, "askSize": 1000, "sigma": 70.9 },
    { "id": "BTC-5m", "underlying": "BTC-USD", "horizon": 300, "strikeStep": 1, "strikeOffset": 0, "spot": 114233.2, "live": true, "bid": 114229, "ask": 114238, "bidSize": 1000, "askSize": 1000, "sigma": 158.55 }
  ]
}

{
  "market": "BTC-15s",
  "t": 1761600000123,
  "bids": [{ "strike": 114232, "size": 1000 }, { "strike": 114230, "size": 1000 }],
  "asks": [{ "strike": 114234, "size": 1000 }, { "strike": 114236, "size": 1000 }]
}

{
  "id": "Xq3vT9aLm2Pk",
  "market": "BTC-15s",
  "strike": 114234,
  "size": 100,
  "spot": 114233.2,
  "openedAt": 1761600000105,
  "expiresAt": 1761600016000,
  "up": { "id": "a1B2c3D4e5F6", "name": "TRADER-4821" },
  "down": { "id": "Mk7p2Qa9Lr4X", "name": "TRADER-7215" },
  "taker": "up",
  "settlePrice": 114240.02,
  "outcome": "up"
}

{
  "id": "a1B2c3D4e5F6",
  "name": "TRADER-4821",
  "avatar": null,
  "rank": 41,
  "pnl": 0.5,
  "wins": 6,
  "losses": 5,
  "pushes": 1,
  "streak": 2,
  "bestStreak": 3,
  "balance": 870.5,
  "inOrders": 100,
  "inPositions": 30,
  "equity": 1000.5
}

{
  "exposure": [
    { "underlying": "BTC-USD", "expiresAt": 1761600016000, "strikes": [{ "strike": 114232, "up": 0, "down": 50 }, { "strike": 114234, "up": 120, "down": 0 }] },
    { "underlying": "BTC-USD", "expiresAt": 1761600061000, "strikes": [{ "strike": 114235, "up": 0, "down": 40 }] }
  ]
}

# market: fills now at the best strikes available, or fails with 409 no liquidity
-d '{"market": "BTC-15s", "side": "up", "size": 25}'

# limit: rests in the book at 114230 until it fills or you cancel it
-d '{"market": "BTC-1m", "side": "up", "size": 100, "strike": 114230}'

# a maker quote that never takes
-d '{"market": "BTC-15s", "side": "down", "size": 200, "strike": 114236, "tif": "post", "clientId": "ask-1"}'

{
  "order": {
    "id": "Qm7rL2xV9cNa",
    "clientId": null,
    "market": "BTC-15s",
    "side": "up",
    "strike": null,
    "size": 25,
    "filled": 25,
    "status": "filled",
    "createdAt": 1761600000105
  },
  "positions": [
    {
      "id": "Xq3vT9aLm2Pk",
      "orderId": "Qm7rL2xV9cNa",
      "market": "BTC-15s",
      "side": "up",
      "strike": 114234,
      "size": 25,
      "spot": 114233.2,
      "openedAt": 1761600000105,
      "expiresAt": 1761600016000,
      "settlePrice": null,
      "result": null,
      "pnl": null
    }
  ],
  "canceled": []
}

{ "type": "place", "reqId": 1, "market": "BTC-15s", "side": "up", "size": 10 }
{ "type": "order", "data": { "id": "Qm7rL2xV9cNa", "status": "filled", … } }
{ "type": "position", "data": { "id": "Xq3vT9aLm2Pk", "strike": 114234, … } }
{ "type": "account", "data": { "balance": 990, … } }
{ "type": "ack", "reqId": 1, "status": 201, "data": { "order": { … }, "positions": [ … ], "canceled": [] } }

import asyncio, json, os, httpx, websockets  # websockets 14+

KEY = os.environ["RIZON_API_KEY"]
AUTH = {"Authorization": f"Bearer {KEY}"}
API = "https://rizon.markets/api/v1"
WS = "wss://rizon.markets/api/v1/ws?channels=price:BTC-USD,book:BTC-15s"

async def main():
    async with httpx.AsyncClient(base_url=API, headers=AUTH) as rest:
        delay = 1
        while True:
            try:
                async with websockets.connect(WS, additional_headers=AUTH) as ws:
                    delay = 1
                    async for raw in ws:
                        m = json.loads(raw)
                        kind, data = m["type"], m.get("data")
                        if kind == "hello":  # your open orders and positions: rebuild state here
                            print("open positions:", len(data["positions"]))
                        elif kind == "price" and not data["live"]:
                            continue  # a simulated price: sit out
                        elif kind == "position" and data["result"]:
                            print("settled:", data["result"], data["pnl"])
                        # decide, then act over REST, or send {"type": "place", ...} on the socket:
                        # r = await rest.post("/orders", json={"market": "BTC-15s", "side": "up", "size": 10})
            except (OSError, websockets.exceptions.WebSocketException) as e:  # refused, dropped or closed
                print(f"disconnected ({e}), retrying in {delay}s")
                await asyncio.sleep(delay)
                delay = min(delay * 2, 30)

asyncio.run(main())

const ws = new WebSocket(`wss://rizon.markets/api/v1/ws?channels=price:BTC-USD,book:BTC-15s&key=${key}`);
ws.onmessage = (e) => {
  const { type, data } = JSON.parse(e.data);
  if (type === 'price') console.log(new Date(data.t).toISOString(), data.price, data.live ? '' : '(simulated)');
  if (type === 'book') console.log(data.market, data.bids[0]?.strike, data.asks[0]?.strike);
};

type Side = 'up' | 'down';

interface Market {                                    // an underlying and a horizon, one continuous book
  id: string; underlying: string; horizon: number;    // 'BTC-15s', 'BTC-USD', 15 (seconds)
  strikeStep: number; strikeOffset: number;           // strikes: strikeOffset + n × strikeStep
  spot: number | null; live: boolean;                 // live: false while the value is simulated or stale
  bid: number | null; ask: number | null; bidSize: number; askSize: number;
  sigma: number;                                      // realised 1-sigma move over the horizon, in the underlying's units
}
interface Book { market: string; t: number; bids: Level[]; asks: Level[] }   // best first
interface Level { strike: number; size: number }

interface Order {
  id: string; clientId: string | null; market: string; side: Side;
  strike: number | null;                              // null: a market order
  size: number; filled: number;                       // while open, size - filled rests
  status: 'open' | 'filled' | 'canceled'; createdAt: number;
}
interface Placed { order: Order; positions: Position[]; canceled: Order[] }   // POST /orders

interface Position {                                  // your side of one trade, with the trade's id
  id: string; orderId: string | null; market: string; side: Side; strike: number; size: number;
  spot: number;                                       // the underlying at the fill
  openedAt: number; expiresAt: number;                // expiresAt: a whole second. Read it, don't compute it
  settlePrice: number | null;
  result: 'win' | 'loss' | 'push' | null;             // null while open
  pnl: number | null;                                 // +size, -size or 0
}

interface Exposure { underlying: string; expiresAt: number; strikes: { strike: number; up: number; down: number }[] }

interface Trade {                                     // a fill on the public tape
  id: string; market: string; strike: number; size: number; spot: number;
  openedAt: number; expiresAt: number;
  up: Party | null; down: Party | null;               // who's on each side (null only on trades before 2026-10-28)
  taker: Side | null;                                 // the side whose order arrived (null only on old trades)
  settlePrice: number | null; outcome: Side | 'push' | null;   // null while open
}
interface Party { id: string; name: string }

interface Trader {
  id: string; name: string; avatar: string | null; rank: number | null;
  pnl: number; wins: number; losses: number; pushes: number; streak: number; bestStreak: number;
}
interface Account extends Trader { balance: number; inOrders: number; inPositions: number; equity: number }

interface ChatMessage {
  id: string; from: Party; text: string; createdAt: number;
  share?: Position; feedback?: true; api?: true;
  reactions?: { emoji: string; by: Party[] }[];
}

interface KeyInfo { id: string; name: string; scope: 'trade' | 'read'; hint: string; createdAt: number; lastUsedAt: number | null }