Quick Start — Vordium Docs

1 — Install the SDK

Bash

pip install vordium==0.3.1

Requires Python 3.9+. The package is published on PyPI.

2 — Create an agent

An agent is an ordinary account operated through a session key. Creating one is local — nothing is registered on-chain.

Python

from vordium import Agent

agent = Agent()
print(agent.address)
print(agent.balance)

There is no faucet

faucet.vordium.com is decommissioned. Fund an account by bridging USDC from Arbitrum — see the Bridge guide.

3 — Fund the account

Deposit USDC on Arbitrum through the bridge, then confirm the balance settled into the vault:

Python

from vordium import Vordex

vx = Vordex()
print(vx.balance(agent.address))

4 — Read a market

Python

markets = vx.markets()
for m in markets[:5]:
    print(m['symbol'], m['oracle_price'])

book = vx.orderbook(1)          # ETH = pair_id 1
print(book['bids'][:3], book['asks'][:3])

5 — Place an order

Orders are EIP-712 signed with a session key and applied natively by VordCore.

Python

from vordium.dex import BUY, LIMIT

res = 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,
)
print(res)

Next steps

Session Keys — how gasless signing works and how long keys last.
Perpetuals Trading — margin, funding, liquidation.
Error codes — what the engine returns when an order is rejected.