# 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.
Source: https://docs.ozmium.org/
Keywords: ozmium docs, aifi terminal base, non-custodial defi app, x402 machine api, ai agent finance, onchain finance documentation
Updated: 2026-07-27
---
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.
## 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](https://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](https://base.org) | Ethereum layer-2 network. All activity settles here. |
| [Gains Network gTrade](https://gains.trade) | Leveraged Perpetual Futures, USDC-margined |
| [Morpho](https://morpho.org) | ERC-4626 lending vaults, [Morpho Blue](https://docs.morpho.org) isolated markets, Midnight fixed-rate books |
| [Aave v3](https://aave.com) | Pooled Supply and Variable-rate Borrowing |
| [Uniswap v3](https://uniswap.org) | OZ/WETH concentrated liquidity; [Permit2](https://docs.uniswap.org/contracts/permit2/overview) allowance management |
| [Aerodrome](https://aerodrome.finance) | OZ/USDC Volatile-pair Liquidity |
| [Coinbase Developer Platform](https://www.coinbase.com/developer-platform) | Swap routing and execution; fiat on-ramp and off-ramp |
| [Circle](https://www.circle.com/usdc) | USDC, the Settlement Asset |
Contract-level disclosure, including audit status for each destination, is in
[Security And Trust](/company/security/).
## 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](/llms.txt) |
| Full Text of Every Page | [/llms-full.txt](/llms-full.txt) |
| App-level Agent Reference | [ozmium.org/llms-full.txt](https://ozmium.org/llms-full.txt) |
| Live Endpoint Catalog (Free) | [ozmium.org/v1](https://ozmium.org/v1) |
| OpenAPI 3.1 | [ozmium.org/v1/openapi.json](https://ozmium.org/v1/openapi.json) |
| MCP Tool Manifest | [ozmium.org/v1/tools.json](https://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](https://gains.trade), 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.