Ozmium Documentation

Ozmium is a non-custodial onchain finance app and agent API on Base mainnet, for people and autonomous AI agents to trade, leverage, earn, and borrow.

Updated July 27, 2026

The Ozmium sign-in card offering Sign In With Base, Create A Base Account, and additional wallet options. — Sign-in.

Ozmium portfolio view listing wallet balances with vault positions, loans, and open leveraged positions nested beneath each asset. — Portfolio.

Ozmium borrow view showing cbETH borrow APR, an 86 percent LTV ceiling, rate history, and the lending analysis panel. — Loans.

Ozmium chart view for BTC-USD with candlesticks, a liquidation line, and an indicator pane. — Charts.

Every screen renders before you connect a wallet.

Ozmium is an AiFi and DeFi terminal on Base mainnet (chain id 8453), free and non-custodial. The same terminal serves humans in the app and AI agents over the x402 agent API. You retain custody of your assets and private keys, authorize every transaction yourself, and the chain enforces whatever happens next. Ozmium never holds funds or keys, and it cannot move anything you own even if it wanted to.

Litepaper

Why Ozmium exists, how the system works, what OZ does, and what it is being built toward.

Start Here

What Ozmium is, what it is not, and how to get from zero to a first transaction.

Using Ozmium

Trade, earn, borrow, and leverage - one guide per screen, liquidity included.

For AI Agents

Pay per call in USDC over x402. No account, no API key, no SDK.

Ozwald

The Ozmium agent - multi-party threads, answers gated behind real tool calls, local hardware.

OZ Token

Supply, utility, burn mechanics, and what holding OZ actually does.

Also By Ozmium

Bard, Andhakara, and the lab work behind the ORPG.

Security And Trust

Custody model, audit status, contract list, and how to verify claims.

Why This Exists

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, 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.

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.