# Ozmium Docs > Official documentation for Ozmium, the free non-custodial AiFi and DeFi terminal on Base mainnet (chain id 8453), and its pay-per-call x402 agent API for autonomous AI agents. Ozmium never holds funds or keys: it reads public onchain state and builds transactions the user's own wallet signs. Humans use the app free; machines pay per call in USDC with no account and no API key. OZ token (Base ERC-20): 0x148313dcdb7a7111ebefa4871f6a7fef34833b07. Every page on this site is also available as clean Markdown by appending `index.md` to its URL, for example https://docs.ozmium.org/agents/x402/index.md. ## Key Facts - Network: Base mainnet (eip155:8453) only. No other chain, no bridge operated by Ozmium. - Custody: non-custodial. Ozmium operates no contract that holds user funds. - Cost: free for humans. Agents pay per call in USDC over x402, from $0.001 to $0.02. - Underlying protocols: Gains Network gTrade (perpetuals), Morpho and Aave v3 (lending), Uniswap v3 and Aerodrome (liquidity), Coinbase Developer Platform (swaps and ramps). - Audit status: the underlying protocols publish independent third-party audits. The Ozmium interface itself has not had a formal third-party audit and says so. - App: https://ozmium.org | Agent API catalog: https://ozmium.org/v1 | OpenAPI 3.1: https://ozmium.org/v1/openapi.json ## Start Here - [Quickstart](https://docs.ozmium.org/start/quickstart/): Open Ozmium without a wallet, connect one when you want to transact, fund it on Base, and execute a first swap. - [About Ozmium](https://docs.ozmium.org/start/what-is-ozmium/): What is Ozmium? A free, non-custodial AiFi and DeFi terminal on Base - trade, earn, borrow, and leverage from a wallet only you control. - [Install as an App](https://docs.ozmium.org/start/web-apps/): Pin Ozmium to your home screen on iPhone or Android, add it to the Base App, or open it as a Farcaster mini-app. No app store required. - [Wallets and Base](https://docs.ozmium.org/start/wallets-and-base/): How to get a wallet on Base mainnet, which wallet types Ozmium supports, and what EIP-5792 smart wallets change about approvals and gas sponsorship. ## Using Ozmium - [Home](https://docs.ozmium.org/guides/portfolio/): The Ozmium portfolio view - how balances, vault positions, loans, and leveraged trades roll into one list, and why a value sometimes reads as unavailable. - [Risk](https://docs.ozmium.org/guides/leverage/): Leveraged perpetuals on Gains Network gTrade through Ozmium - sizing against real volatility, liquidation mechanics, managing a live position, and honest risk. - [Charts](https://docs.ozmium.org/guides/charts/): How to read the Ozmium chart on the Risk screen - candles, timeframes, indicator chips, candlestick patterns, and what a BUY or SELL marker actually means. - [Earn](https://docs.ozmium.org/guides/earn/): Supply assets to Morpho and Aave v3 vaults through Ozmium - where the yield actually comes from, how to read APY honestly, and the risks worth naming. - [Loan](https://docs.ozmium.org/guides/borrow/): Collateralized borrowing on Morpho and Aave through Ozmium - floating versus fixed rates, health factor and LLTV, liquidation mechanics, and staying solvent. - [Prop](https://docs.ozmium.org/guides/prop-desk/): Ozmium's gated action surface for qualified OZ holders and agents - how membership is proven onchain, the two authorization rails, and why paying is not authorizing. - [Trade](https://docs.ozmium.org/guides/trade/): How to swap tokens on Base with Ozmium - getting a quote, setting slippage, what the three costs are, and what to do when a swap fails. - [Liquidity](https://docs.ozmium.org/guides/liquidity/): Provide liquidity to the OZ pools on Aerodrome and Uniswap v3 - fee income, why full range is the default, impermanent loss, and claiming fees without closing. - [Transfers](https://docs.ozmium.org/guides/deposits-and-withdrawals/): How to fund an Ozmium wallet and take value back out - the Coinbase on-ramp and off-ramp, sending, receiving, and what you need on Base before anything works. - [Burning OZ](https://docs.ozmium.org/guides/burn/): How burning OZ works on Ozmium - sending to the dead address, what The Density Ladder ranks, and how burned value counts toward prop desk standing. - [Troubleshooting](https://docs.ozmium.org/guides/troubleshooting/): Fixes for the problems people actually hit on Ozmium - reverted swaps, failed approvals, odd balances, black screens, and 402 loops on the agent API. ## For AI Agents - [Agent API Overview](https://docs.ozmium.org/agents/overview/): Ozmium's AiFi API for autonomous AI agents - pay per call in USDC over x402, no account, no API key, no SDK. Live Base data and ready-to-sign calldata. - [x402 Payments](https://docs.ozmium.org/agents/x402/): The exact x402 v2 request flow for Ozmium - the HTTP 402 challenge, EIP-3009 USDC signing on Base, retry headers, surge pricing, and the settlement receipt. - [Endpoint Catalog](https://docs.ozmium.org/agents/endpoints/): Every Ozmium /v1 endpoint with its USDC price and purpose - data reads, alpha, transaction builders for swaps, vaults, loans and perps, prop desk, and referrals. - [Integration Notes](https://docs.ozmium.org/agents/integration/): The mistakes AI agents actually make wiring up Ozmium - pending orders versus positions, parameter scaling, prepended approvals, and safe unsupervised defaults. ## Ozwald - [Ozwald](https://docs.ozmium.org/ozwald/overview/): Ozwald is the Ozmium agent - multi-party threads where people and AI work in the same room, answers gated behind real tool calls, running on local hardware. ## Token - [OZ Token](https://docs.ozmium.org/token/oz/): OZ is the AiFi utility token behind Ozmium on Base - it halves agent API prices, gates the prop desk, and burns to a public ladder. ## Also By Ozmium - [Bard: The Theremini App](https://docs.ozmium.org/also/bard/): Bard is a browser-native air-theremin and pocket synth driven by touch, tilt, hand tracking, and silent lip-sync, built as a Base mini-app. - [Andhakara](https://docs.ozmium.org/also/andhakara/): Andhakara is a collectible card collection on vibe.market, trading as ANKR on Base, with an In Oz We Trust expansion. - [Engine](https://docs.ozmium.org/also/labs/): The AI NPC game engine Ozmium is building - autonomous characters deciding outside the renderer on local models, plus dialogue, voice, and character generation. ## Misc - [Security and Trust](https://docs.ozmium.org/company/security/): Ozmium's custody model, honest audit status, the full contract disclosure, privacy and crash-report handling, and how to report a vulnerability privately. - [Terms and Risk](https://docs.ozmium.org/company/terms/): Terms of use and full risk disclosure for the Ozmium interface - public beta status, non-custody, data handling, third-party protocols, and the risk of loss. - [Glossary](https://docs.ozmium.org/company/glossary/): Plain-language definitions of every term used across Ozmium - onchain basics, leverage, lending, liquidity provision, and the x402 machine payment protocol. ## Optional - [Full text of every page](https://docs.ozmium.org/llms-full.txt): all documentation concatenated as Markdown. - [Ozmium app agent reference](https://ozmium.org/llms-full.txt): the app's own machine-facing reference. - [x402 discovery](https://ozmium.org/.well-known/x402) - [MCP tool manifest](https://ozmium.org/v1/tools.json)