Ozmium Machine API (x402)

Everything a human does in the Ozmium app, an autonomous agent can do over HTTP - paying per call in USDC via x402 (EIP-3009). No account, no API key, no signup. Your agent signs with its own wallet; Ozmium never takes custody.

The x402 flow (how a bot transacts like a human)

Call any /v1 endpoint. An unpaid request returns HTTP 402 Payment Required with a header describing the price, the USDC asset on Base, and the pay-to address.
Your agent signs the EIP-3009 transferWithAuthorization for that amount (any x402 client library does this).
Retry with the payment header. You get 200 plus the data - or, for a transaction builder, ready-to-sign { to, data, value } calldata - and an onchain settlement receipt.
For an action, broadcast the returned calldata from your own wallet. The chain enforces everything; Ozmium never holds keys.

Discovery for agents
Catalog: https://ozmium.org/v1
OpenAPI 3.1 (with x-x402 pricing): https://ozmium.org/v1/openapi.json
MCP tool manifest: https://ozmium.org/v1/tools.json
x402 discovery: https://ozmium.org/.well-known/x402
Docs for LLMs: https://ozmium.org/llms.txt and https://ozmium.org/llms-full.txt

Endpoints & pricing (USDC per call)

Category	Price	Examples
Data reads	$0.001	/v1/prices, /v1/signals, /v1/candles, /v1/portfolio/{address}, /v1/positions/{address}, /v1/history/{address}, /v1/earn/vaults, /v1/loan/markets, /v1/risk/pairs
Alpha	$0.01	/v1/arbitrage (fee-netted routes), /v1/ideas (ranked scalp setups)
Alpha bundle	$0.02	/v1/alpha (arbitrage + ideas + signals)
Transaction builders	$0.02	/v1/tx/swap, /v1/tx/earn/deposit, /v1/tx/loan/borrow, /v1/tx/risk/open, /v1/tx/risk/close, and more

Prices can surge during network congestion. The full machine-readable schema is the OpenAPI spec.

Example

curl https://ozmium.org/v1/prices?symbols=BTC,ETH
# -> 402 Payment Required (payment requirements in the header)
# sign the EIP-3009 USDC authorization, then retry with the payment header:
curl -H "X-PAYMENT: <signed-authorization>" https://ozmium.org/v1/prices?symbols=BTC,ETH
# -> 200 { data: ... } + onchain settlement receipt

Earn by referring

Append ?ref=<your-wallet> to any /v1 link or the app URL and share it; paid x402 volume from wallets you refer is credited to you (GET /v1/referrals/{wallet}).