Agent API 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.

This is the AiFi half of the terminal: everything a human does in the Ozmium app, an agent can do over HTTP. Your agent pays per call in USDC over the x402 protocol and signs every transaction with its own wallet. Ozmium never custodies funds or keys.

The whole design goal: the shortest path from a question to a signed transaction on Base.

Why This Exists

Picture what an agent normally has to do before it can act onchain. It finds a price feed, then finds a second one so it can tell whether the first is lying, then learns each protocol's parameter scaling, gets the decimals right, encodes the approve, encodes the action, and finally discovers which of those steps it got wrong by watching a transaction revert and paying for the privilege.

Ozmium sells the finished version of all that. Every endpoint hands back either the data you asked for or a ready-to-sign { to, data, value }, encoded against the exact Base mainnet contracts with the parameter scales, decimals, and market ids already correct.

No Account, No Key

There is no signup, no API key, and no key rotation. Payment is authentication. A valid x402 payment is the credential, and the wallet that paid is the identity.

Paid traffic is granted a far higher rate ceiling than anonymous traffic, automatically. There is nothing to request and nobody to ask.

Independently Scored

Cloudflare publishes isitagentready.com, which grades a site on how well an autonomous agent can discover, read, authenticate against, and transact with it.

Ozmium scores 100 out of 100, at Level 5, Agent-Native.

That last row is the one worth noting. Commerce is an optional category on the rubric, because almost nothing scored against it can actually take a machine payment. Ozmium can, through x402, which is why the category is full rather than skipped.

Grade it yourself. The result is reproducible against the live site.

Discovery Surface

Point your agent at any of these:

The catalog at /v1 is free and complete. Start there.

Found Us Through A Marketplace?

Ozmium is listed on Agentic Market as Ozmium Agent API. Agentic Market is a directory of x402-enabled services - operated by Coinbase, owned by the Linux Foundation - where agents browse and call services with per-request USDC pricing and no registration or API keys.

The listing carries the whole /v1 surface: prices, crowd positioning, signals, candles, portfolio and position reads, vault and loan markets, ranked ideas, arbitrage, and every transaction builder from swaps through Morpho Midnight fixed-rate borrowing and Gains perpetual management.

If your agent discovered Ozmium there, nothing changes about how you call it - the endpoints, the 402 flow, and the pricing are the same ones documented here, because they are the same service. The directory is a front door, not a middleman, and no request is proxied through it.

What You Can Buy

At rest nothing costs more than a penny. Prices can surge during congestion, but the surge is capped at 2x, so a hot window tops out at two.

Prepaid OZ credit pays half of every price above and is exempt from surge entirely, which makes it the cheapest way to call this API. See OZ credit.

The authoritative price for any endpoint is always the one in its own 402 challenge. Do not hardcode these.

Full listing: Endpoint Catalog.

The Trust Model

Non-custodial, permanently:

• Ozmium never holds funds or keys.
• Ozmium never signs on your behalf.
• Every action is calldata you inspect and broadcast yourself.
• The chain enforces the outcome.

Nothing sold here locks anyone out of anything. Morpho, Aave, Gains, Aerodrome, and Uniswap remain directly usable forever, for free, without us. What Ozmium sells is correctness, convenience, and speed for AI agents.

Referrals: 20 Percent

Append ?ref=<your-wallet> to any /v1 endpoint or app URL you share. You earn 20 percent of the paid x402 volume from wallets you refer. GET /v1/referrals/{wallet} is free and returns your tally and the amount owed.

Every 402 challenge ships a promote kit at the top level of the challenge JSON - a sibling of accepts and extensions, not inside extensions - so recruitment costs you no tokens to compose:

• pitch - a ready-to-post pitch string carrying your referral link
• shareUrl - the app URL with your ref parameter
• referralParam - the raw ?ref=<your-wallet> to append anywhere
• baseAppInvite and onboarding - for humans who need a Base account first
• discovery, openapi, catalog - machine-readable entry points to hand another agent

Pass your own ?ref= on the call and every string comes back with your address already substituted, ready to post verbatim. Call without it and you get a <your-wallet> placeholder to fill in.

Marker Feed Disclosure

FAQ

Next

• x402 Payments - the exact request flow
• Endpoint Catalog - every endpoint and its price
• Integration Notes - the mistakes worth avoiding