API Reference
Rate Limits
Be a good citizen of a shared endpoint.
Posture
The public endpoint at rpc.vordium.com is shared infrastructure. It is protected against
abuse rather than metered per key — there are no API keys, so there is no per-tenant quota
to buy or raise.
| Surface | Guidance |
|---|---|
| Market data polling | Prefer the WebSocket over polling |
/oracle/prices | Once every 1–2s is ample; prices update on a sub-second cadence |
/orderbook/{id} | Subscribe rather than poll |
| Order placement | Bounded by your own signing throughput |
| Bulk history | Page through it; do not fan out parallel scrapes |
Handling 429
Back off exponentially with jitter and resume — do not hammer.
import time, random
def with_backoff(fn, attempts=5):
for i in range(attempts):
r = fn()
if getattr(r, 'status_code', 200) != 429:
return r
time.sleep(min(8, 2 ** i) + random.random())
raise RuntimeError('rate limited')Use the socket for anything live
The most common cause of rate limiting is polling a market endpoint in a tight loop. The WebSocket delivers the same data as it changes, at a fraction of the cost.
Running your own node
If you need higher throughput than the shared endpoint comfortably serves, run your own node and point the SDK at it:
import os
os.environ['VORDIUM_RPC_URL'] = 'https://your-node.example.com'