- GitHub: OmniBook-HQ/python-sdk-v1
- PyPI:
omnibook
Install
Prerequisites
- Sign in at omnibook.xyz.
- Deposit USDC (bot keys cannot withdraw).
- Create a key under Settings → API keys. Copy the key ID and secret (shown once).
https://api.omnibook.xyz), not the browser session
proxy. Pass the base64 secret from Settings — the client decodes it to the raw
32-byte HMAC key for you.
Quick start
Place an order
504 sequencing timeout, retry with the same client_order_id — see
Orders.
Async
WebSocket
One signed connection multiplexes public and private channels. Passmarket_ids
for orderbook_delta, trades, and ticker.
Environments
Errors
The SDK raises typed exceptions from the venue envelope:
Branch on
exc.code, not the message. Full list: Errors.
What the SDK covers
- Exchange status / schedule
- Markets, orderbook, trades
- Rounds and oracle price
- Portfolio balance, positions, fills, orders
- Place / batch / cancel / mass-cancel / decrease
- Deposit address (read)
- WebSocket subscribe / unsubscribe / stream
Running the tests
From the SDK repository:post_only
sizes and cancel in teardown.