Ozmium DocsOzmium Documentation
Ozmium builds next generation animatronics and the rails underneath them - a non-custodial onchain finance app and agent API on Base mainnet.
Every screen renders before you connect a wallet.
Ozmium is a Base-maximal onchain interface, free and non-custodial. It connects you directly to first-party Base services - Aave, Avantis, Coinbase, Gains, Morpho and more - rather than through an API or a delegated centralized accounting layer. Your wallet, your transactions, your assets.
Ozmium never takes or stores permissions, keys, or other sensitive security details, so what you deal with is what exists onchain and public, rather than a pile of standing authorizations you have to remember you granted. You authorize every transaction yourself and the chain enforces whatever happens next.
The same terminal serves AI agents over the x402 agent API - the identical services, an agent-ready interface, paid per call in USDC with no account and no key. Ozwald is one of them: an AI agent who runs his own news show, keeps a trading desk, and treats Ozmium as his terminal the way you do.
Why This Exists
Ozmium is building toward live characters that perform in the same room as people: an agent who holds a conversation nobody scripted, holds a position he has to account for, and stops the instant a stage manager says so. Ozwald is that agent today, without a body. Amusement is where that goes.
The terminal is worth using on its own, and is offered on those terms. Charts, signals, swaps, vaults, loans, leverage - free, for a person. The same surface serves software over the agent API, which is what gives a machine and a person a shared baseline: same price, same venue, same math, so when either one takes a position the other can see exactly what it means.
The approach comes from theatre and from law rather than from a lab. A show has a stage manager who can stop it, a crew who can explain every effect, and a duty of care to everyone in the room.
Everything in this world is magic, except to the magician. A guest should get an effect. The person who built it should be able to name every mechanism that produced it and turn each one off.
Ozmium is built from, and for, the kind of place the industry flies over. The goal is to grow in service of small, independent, community-driven builders - the kind of people you find running projects in rural America, where this one is run - and to bring blockchain to a community physically, not only onchain. AiFi and DeFi tooling, data research, robotics, and GameFi experiments, built as working tools first and priced so normal people can actually get into them. Sometimes that price is free. Starting here, and moving outward.
Here is Scotts Bluff County, Nebraska. What got built here before Ozmium, and what each of those projects settled, is in Prior Work.
At a Glance
| Network | Base Mainnet (eip155:8453) |
| Custody Model | Self-custodial. The user retains control of assets and private keys. |
| Token | OZ, ERC-20, 0x148313dcdb7a7111ebefa4871f6a7fef34833b07, 18 decimals |
| Maximum Supply | 100,000,000,000 OZ |
| Interface | ozmium.org |
Protocols and Counterparties
Ozmium originates transactions against the following third-party protocols. It does not re-implement their functionality and does not act as counterparty to any position.
| Protocol | Function |
|---|---|
| Base | Ethereum layer-2 network. All activity settles here. |
| Gains Network gTrade | Leveraged Perpetual Futures, USDC-margined |
| Morpho | ERC-4626 lending vaults, Morpho Blue isolated markets, Midnight fixed-rate books |
| Aave v3 | Pooled Supply and Variable-rate Borrowing |
| Uniswap v3 | OZ/WETH concentrated liquidity; Permit2 allowance management |
| Aerodrome | OZ/USDC Volatile-pair Liquidity |
| Coinbase Developer Platform | Swap routing and execution; fiat on-ramp and off-ramp |
| Circle | USDC, the Settlement Asset |
Contract-level disclosure, including audit status for each destination, is in Security And Trust.
Fee Schedule
The interface is provided at no charge to individual users. Programmatic clients are billed per request under the x402 protocol, settled in USDC on Base.
| Request Class | USDC | Prepaid OZ Credit |
|---|---|---|
| Data | $0.0010 | $0.0005 |
| Focused Alpha | $0.0050 | $0.0025 |
| Strict Ideas | $0.0080 | $0.0040 |
| Alpha | $0.0100 | $0.0050 |
| Actions and Bundles | $0.0100 | $0.0050 |
Congestion surcharges are capped at 2x the posted rate. Prepaid OZ credit is exempt from surcharges. Rates quoted in the 402 challenge govern; figures above are indicative.
Scope of Service
Ozmium is an execution and analytics layer. It does not custody assets, originate credit, or act as counterparty. Every protocol it routes to remains directly accessible to any user independently of this interface.
What the interface provides is transaction construction: correctly encoded calldata against the current state of each protocol, routes priced net of gas and venue fees, and position sizing derived from realized volatility.
Individual use is not charged. Programmatic clients are billed per request, reflecting the materially different cost of serving sustained automated call volume against interactive human sessions.
Reading These Docs as an Agent
Every page on this site is available as clean Markdown. Append index.md to any URL:
https://docs.ozmium.org/agents/x402/index.md
| Surface | URL |
|---|---|
| Index for Language Models | /llms.txt |
| Full Text of Every Page | /llms-full.txt |
| App-level Agent Reference | ozmium.org/llms-full.txt |
| Live Endpoint Catalog (Free) | ozmium.org/v1 |
| OpenAPI 3.1 | ozmium.org/v1/openapi.json |
| MCP Tool Manifest | ozmium.org/v1/tools.json |
FAQ
What is Ozmium?
Ozmium is a free, non-custodial onchain finance app on Base mainnet (chain id 8453). From your own wallet you can swap tokens, supply to yield vaults, borrow against collateral, open leveraged perpetual positions, and provide liquidity. It also runs a paid agent API for AI agents over the x402 protocol.
Is Ozmium free to use?
Yes. The web app at ozmium.org is free for people. There is no subscription and no fee taken by Ozmium on swaps. The paid agent API exists only for automated clients, which pay per call in USDC.
Do I need a wallet to use Ozmium?
No. Read access requires no wallet. Ozmium runs in preview mode for visitors, so vault lists, the tradeable pair universe, charts, and loan markets are all browsable without connecting anything. Only wallet-keyed views sit behind glass, and those show clearly labeled demo samples. You need a wallet to actually transact.
Does Ozmium hold my funds?
No. Ozmium operates no contract that holds user funds. It reads public onchain state and builds transactions that your own wallet signs. If Ozmium ceased to exist, every position you hold remains yours and remains manageable directly at the underlying protocol.
What chain does Ozmium run on?
Base mainnet only, chain id 8453. Ozmium does not operate a bridge and does not support other networks, which keeps the contract address set small and verifiable.
What is the OZ token contract address?
The OZ token is a Base ERC-20 at 0x148313dcdb7a7111ebefa4871f6a7fef34833b07, with 18 decimals and a
100 billion maximum supply. There is only one OZ token; any other address is not OZ.
Can AI agents use Ozmium?
Yes. Ozmium exposes a agent API at /v1 that mirrors the app: live prices, crowd positioning,
multi-indicator signals, fee-netted arbitrage routes, ranked trade ideas, and ready-to-sign
transaction builders. Agents pay per call in USDC over x402 with no account and no API key.
Has Ozmium been audited?
The underlying protocols Ozmium routes to - Gains Network, Morpho, Aave, Uniswap, and Aerodrome - publish independent third-party audits. The Ozmium interface itself has not undergone a formal third-party audit, which is stated plainly rather than softened.