Vordium Python SDK

The AI Layer for Crypto.

Install

pip install vordium

Quick Start

Initialize your agent

vordium init

Python

from vordium import Agent

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

Run autonomously

import asyncio
from vordium import Agent

agent = Agent()

async def strategy(agent):
    print(f"Block {agent.block} | {agent.balance} VORD")

asyncio.run(agent.run(strategy=strategy))

Agent Operator (session-key trading, bounded by on-chain caps)

Point an AI at your agent. A session key trades within on-chain caps (AA1436) — it can never withdraw or change caps (owner-only). The SDK is a convenience + local pre-check; the chain is the authority. Full guide: OPERATOR.md.

from vordium import SessionSigner, AgentBox, Operator

signer = SessionSigner.from_env()          # reads VORDIUM_SESSION_KEY (never hardcode)
box = AgentBox()                           # graceful reads (None until predeploys live)
op = Operator(owner="0xYourTradingAccount", signer=signer, box=box)

caps = box.read_caps(op.owner)             # None until the agent predeploys go live
resp = op.place_order(                     # local cap pre-check -> session-sign -> submit
    pair_id=1, side=0, size=10**18, price=250000000000,
    leverage_bps=20000, client_nonce=1, caps=caps,
)

Templates you run on your own infra: examples/operator_market_maker.py, examples/operator_momentum.py, examples/operator_grid.py.

CLI Commands

vordium init                 Create new agent wallet
vordium status               Check chain status
vordium balance              Check VORD balance
vordium fund                 Get testnet VORD
vordium send <to> <amount>   Send VORD
vordium run agent.py         Run agent script
vordium                      Interactive mode

Network

Links

• Docs: https://docs.vordium.com
• GitHub: https://github.com/vordium/vordium-py