Pay per call with x402

An agent that holds an x402 wallet on Base can use the SuperAgent API without an account or an API key. It pays for one call at a time, in USDC, and pays only when the call succeeds. It can also pay once for an account and get an API key holding the credits.

What you can buy per call

GET https://api.hivemindos.app/v1/x402 lists every operation for sale, with its price, address, an example input and the input’s schema. No key is needed to read it. Today it covers:

A call costs what the same operation costs an account with no HIVE stake. The price comes from the service itself when you call, so it is never out of date.

Make a call

Send the operation’s input as the body:

POST https://api.hivemindos.app/v1/x402/svg-studio/svgs.generate
Content-Type: application/json

{ "prompt": "Minimal flat bee logo, black and honey-yellow" }

1. The first answer is HTTP 402 with a Payment-Required header, priced from your input. If the input is wrong, you get HTTP 400 instead, before any payment is asked for.
2. Show the person the exact amount and get their approval. Then send the same request again with Payment-Signature. Any x402 v2 client does this step for you.
3. The call runs. If it succeeds, the payment settles and you get the result, with an x402 block holding the receipt id and the transaction. If it fails, you get x402.charged: false and the payment is never taken, so you can try the same payment again.

Sending the same signed payment again within 30 minutes returns the same answer. The call does not run a second time and you are not charged twice.

Collect a background job

Research, reports, swarms, simulations and media run in the background. Their answer includes followUp.apiKey, an API key that can use only that service and can never move funds. Store it like any secret, and use it to read the result, for example:

POST https://api.hivemindos.app/v1/services/token-autopsy/invoke
Authorization: Bearer <followUp.apiKey>
Idempotency-Key: <unique>
Content-Type: application/json

{ "operationId": "reports.get", "pathParameters": { "reportId": "<the id in the first answer>" } }

If a call uses less than it was priced at, the difference stays on the same key as Agent Credits.

Buy an account instead

Some things are not sold per call, because they keep running or belong to an account: sites, agents, workflows, databases, wallets, trading, subscriptions and connected accounts. For those, buy an account:

POST https://api.hivemindos.app/v1/x402/accounts
Content-Type: application/json

{ "amountUsd": 5 }

After the same 402 and Payment-Signature steps, the answer is an API key holding that many Agent Credits (500 per dollar, from $1 to $500) for every service. Save it as HIVEMINDOS_API_KEY. It can never move funds. To manage the account in a browser later, use the console.

Private tiers

The same routes work under https://api.hivemindos.app/v1/private/x402 and https://api.hivemindos.app/v1/confidential/x402. There, only operations that meet the tier are sold. See privacy tiers.

Safety rules for agents

• A 402 answer is a price, not permission. Ask the person to approve the exact amount before a wallet signs.
• Never send a wallet’s private key or recovery phrase to HivemindOS. The payment is a signature the wallet makes itself.
• HivemindOS sets the recipient, network, asset and price on its server. Do not try to change them.

Find it in the x402 Bazaar

Every route here describes its input and output for the Coinbase x402 Bazaar, so agents that search the Bazaar can find it. A route shows up there after its first paid call.

Continue with agent setup, connect with MCP, or the complete API reference.