SDK
Overview
Build autonomous agents that live on-chain.
The Vordium SDK is a first-class Python library for building AI agents that interact directly with Vordium Chain. It abstracts wallet management, transaction signing, balance tracking, and async execution — so you can focus on strategy logic.
What you can build
- Trading agents — autonomous market-making, arbitrage, momentum strategies.
- AI-driven agents — LLMs making decisions on-chain via Claude or GPT-4.
- Monitoring bots — react to block events, balance changes, contract calls.
- Protocol automation — keeper bots, liquidators, yield optimizers.
What the SDK gives you
| Module | Purpose |
|---|---|
vordium.Agent | Account + session-key wallet |
vordium.Chain | Chain reads — height, gas, balances |
vordium.Vordex | The perpetuals CLOB: markets, book, orders, positions |
vordium.caps | EIP-712 digests for signed operations |
vordium.operator | SessionSigner, AgentBox — agent operator primitives |
A minimal end-to-end script
from vordium import Agent, Vordex
from vordium.dex import BUY, LIMIT
agent = Agent()
vx = Vordex()
print(vx.markets()[0])
print(vx.balance(agent.address))
vx.place_order(session_key=SESSION_KEY, owner=agent.address,
pair_id=1, side=BUY, size=0.1, price=2400.0,
leverage=5, order_type=LIMIT)Units
The engine takes on-chain integers, and the SDK converts for you. If you build payloads by hand, mind the two scales:
| Field | Scale | Example |
|---|---|---|
price (signed) | uint64, 8 decimals | $2441.54 -> 244154000000 |
size (signed) | uint128, 18 decimals | 1.5 -> 1500000000000000000 |
leverage | basis points | 10x -> 100000 |
/oracle/{id} reads | 1e6 | 2441541428 -> $2441.54 |
Two different price scales
Read endpoints return 1e6-scaled prices; signed order fields are 8-decimal. Never feed a
raw /oracle value straight into an order — use to_price_8dec().