Your first request

This walks through the calls every integration starts with: is the venue up, what is trading, and which asset is it. All are read-scope, so they work with any key. All responses below are real, captured from production.

Is the exchange open?

GET /v1/exchange/status

{ "exchange_active": true, "as_of_seq": "3947" }

v1 always returns exchange_active: true. No exchange-wide pause control exists yet, so this field is not a working kill switch, do not gate trading on it. Trading pauses are per-round: when a round’s status leaves trading, new orders are rejected (market_frozen, trading_paused, etc.). Use cancel_on_pause on resting orders, or cancel explicitly before a round freezes. See Pauses and rounds. as_of_seq is the sequencer position the answer was computed at. It appears on every read. Two responses with the same as_of_seq describe exactly the same state, which is what lets you tell “nothing changed” from “I asked too early”.

as_of_seq restarts from a low number when the venue restarts. It is a position within the current session, not a global counter, do not persist it or assume it only ever increases. Use round_number for ordering across restarts.

What is trading right now?

Omnibook runs nine recurring series in parallel — BTC, gold (XAU), and WTI crude, each at 60-second, 5-minute, and 15-minute cadences. One round is open for trading at a time per series, so expect up to nine live markets at once. Do not use GET /v1/rounds?limit=1 as “the live round”. That list is newest round_number first, interleaved across all nine series, and may be frozen or settled while other slots are still trading. Find live slots, then read the round row:

GET /v1/markets?status=trading
GET /v1/rounds/{market_id}

{
  "markets": [
    {
      "market_id": 71,
      "status": "trading",
      "best_yes_bid": 2400,
      "best_yes_ask": 3500,
      "tick_size": {
        "type": "tick_size",
        "market_id": 71,
        "policy": "narrow",
        "mode": "cent",
        "tick_step": 10,
        "wing_lo": 400,
        "wing_hi": 9600
      }
    }
  ],
  "cursor": "",
  "as_of_seq": "3947"
}

Then the round object:

{
  "market_id": 71,
  "status": "trading",
  "strike": "6399240000000",
  "settle_price": "0",
  "winner": null,
  "round_number": "2963",
  "generation": 297,
  "category": 1,
  "open_ts": "1785301920037987210",
  "freeze_ts": "0",
  "resolve_ts": "0",
  "twap_window_secs": 10
}

The fields that matter:

market_id, what you pass to order and orderbook endpoints. It is recycled across rounds, so never cache it as an identifier for a round.
round_number, monotonic and never reused. This is the stable identity.
status - trading accepts orders. frozen does not. settled is done.
strike, the price to beat for this round’s asset, in units of 1e-8 USD. The value above is $63,992.40.
category, which of the nine series this round belongs to — 1 above is BTC 60-second. This is the only field that tells you the asset; the market object does not carry it. See Series, assets, and categories.
winner — null until settlement, then "yes" or "no".
tick_size — rest grid. Ticks are pips (2400 = 24.00¢). See Ticks, pips, and subcents.

market_id is drawn from a small recycled pool. Two different rounds will reuse the same market_id over time. Always key your own state on round_number, and re-read the round before acting on a cached market_id.A recycled slot can come back in a different series, so a cached market_id → asset mapping goes stale the same way.

Which asset is which?

category is the series id. Nine of them are live:

`category`	Series	`category`	Series	`category`	Series
1	BTC 60s	4	Gold 60s	7	WTI 60s
2	BTC 5m	5	Gold 5m	8	WTI 5m
3	BTC 15m	6	Gold 15m	9	WTI 15m

To pull one series’ history directly, filter the rounds list:

GET /v1/rounds?category=7&limit=24    # WTI crude 60-second

And to read an asset’s live reference price, scope the oracle by feed (0 = BTC, 1 = gold, 2 = WTI):

GET /v1/oracle/price?feed=2

{ "price": "6231000000", "fresh_source_count": 1, "seq": "918243" }

price: "0" is not an error — it means that feed has no valid tick, which is what a closed session looks like. Gold and crude are not 24/7. See Series, assets, and categories.

Paging

List endpoints return a cursor. Pass it back as ?cursor= to get the next page; an empty cursor means there are no more results.

GET /v1/rounds?limit=50&cursor=2963.0

GET /v1/rounds is useful for history (newest round_number first). For the live book, start from GET /v1/markets?status=trading.

Complete script

Self-contained, paste your key and secret, then run:

#!/usr/bin/env python3
"""Check exchange status and find the round that is trading."""
import hashlib, hmac, json, time, base64
import requests

BASE = "https://api.omnibook.xyz"
API_KEY = "<your alphanumeric API key>"
SECRET = bytes.fromhex("<your 64-char hex secret>")  # 32 raw bytes


def request(method, target, body=b""):
    ts = str(int(time.time() * 1000))
    canonical = f"{ts}\n{method}\n{target}\n".encode() + body
    sig = base64.b64encode(
        hmac.new(SECRET, canonical, hashlib.sha256).digest()
    ).decode()
    return requests.request(
        method, BASE + target, data=body,
        headers={
            "DX-ACCESS-KEY": API_KEY,
            "DX-ACCESS-TIMESTAMP": ts,
            "DX-ACCESS-SIGNATURE": sig,
            "Content-Type": "application/json",
        },
    )


CATEGORY = {
    1: "BTC 60s",  2: "BTC 5m",  3: "BTC 15m",
    4: "XAU 60s",  5: "XAU 5m",  6: "XAU 15m",
    7: "WTI 60s",  8: "WTI 5m",  9: "WTI 15m",
}
FEED = {"BTC": 0, "XAU": 1, "WTI": 2}

status = request("GET", "/v1/exchange/status").json()
print("Exchange status:", json.dumps(status, indent=2))

# One reference price per feed. "0" means the feed is dark (closed session).
for asset, feed in FEED.items():
    px = request("GET", f"/v1/oracle/price?feed={feed}").json()
    price = int(px["price"])
    shown = f"{price / 1e8:,.2f}" if price else "dark"
    print(f"{asset:>3} feed {feed}: {shown}")

# Every live slot, across all nine series. The market row does not carry
# `category`, so read each round to learn which series it belongs to.
markets = request("GET", "/v1/markets?status=trading").json()
for m in markets.get("markets", []):
    mid = m["market_id"]
    rnd = request("GET", f"/v1/rounds/{mid}").json()
    print(f"{CATEGORY.get(rnd['category'], 'unknown'):>8}  "
          f"market_id={mid:<4} round={rnd['round_number']:<8} "
          f"strike={int(rnd['strike']) / 1e8:,.2f}")

Read Ticks, pips, and subcents, then Place your first order.

Get started

SDKs

Strategies

Concepts

Changelog

Is the exchange open?

What is trading right now?

Which asset is which?

Paging

Complete script

Next

​Is the exchange open?

​What is trading right now?

​Which asset is which?

​Paging

​Complete script

​Next

Is the exchange open?

What is trading right now?

Which asset is which?

Paging

Complete script

Next