Skip to main content
Agent flows are in beta. Join Mobula Telegram for updates.

Agentic payments

Agents access Mobula without a dashboard, a sign-up form, or a human in the loop. Your wallet is your identity. Subscribe to a plan, receive an api_key and user_id, and start making API calls immediately — entirely in code.

Why x402 — and why not per-request payments

The x402 protocol enables on-chain micropayments per HTTP request. In theory, every Mobula endpoint could charge $0.001 per call via x402. For humans managing a dashboard, that works fine. For agents operating at scale, it breaks down fast. The fee problem. Every x402 call carries a $0.001 facilitator fee for payment-protocol settlement, on top of the data cost. An agent making thousands of calls per day would spend more on settlement overhead than on the data itself. Per-request x402 is simply not economical at volume. The infrastructure problem. Most API infrastructure assumes a human is in the loop — someone who opens a dashboard, creates an account, copies an API key, and configures billing. Agents can’t do any of that. There’s no session, no browser, no operator standing by to click through an onboarding flow. Traditional provisioning is a dead end for autonomous agents. How x402 solves both. Instead of paying per request, agents use x402 to self-provision a full account — autonomously, on-chain, in a single payment flow. Once subscribed, the agent uses standard REST endpoints at plan rates with no per-call settlement overhead. The x402 protocol is only invoked for account management operations (subscribe, top-up), not for every data request. What agents can do autonomously via x402:
  • Subscribe to a plan and receive an api_key and user_id immediately
  • Top up credits when they run low, without changing the plan
  • Create and delete API keys programmatically
  • Issue short-lived API tokens for scoped or temporary access
  • Access all existing REST endpoints, WebSocket streams, and data APIs using the provisioned api_key
The result: agents get the same full account flexibility a human would have through a dashboard — accessed entirely through wallet signatures and code.

Settlement, facilitator fees, and control

Each paid agent-management request goes through the payment protocol: facilitator settlement applies (for example the ~$0.001 protocol fee on small operations), on top of the plan or operation price. That keeps flows fully programmaticno human in the loop — and gives agents full control via wallet signatures and API keys after subscribe.

MPP vs x402 at Mobula

Both rails use HTTP 402 + payment proof. They implement the same agent product (subscribe, status, top-up, create/revoke API keys); only chain and client libraries differ.
MPPx402
Payment stackTempo + mppxBase / Solana USDC + x402 client (x-payment, etc.)
Agent path prefix/agent/mpp/.../agent/x402/...
Revoke API keyGET/api-keys/revoke?api_key=DELETE/api-keys/revoke?api_key=
Do not use the same wallet for x402 and MPP. Each rail ties plan, credits, and API keys to a separate payer identity — two rails ⇒ two agent records if you mix carelessly. Pick one rail per integration (or use different wallets to test both).

Agent endpoints only (subscription flows)

This guide covers only the five agent operations — subscription status, subscribe, top-up, create API key, revoke API key. Same five on both rails; swap the prefix /agent/x402/agent/mpp (only difference: revoke is DELETE on x402 and GET on MPP).
Operationx402 pathMPP path
Subscription (plan stats)GET /agent/x402/subscriptionGET /agent/mpp/subscription
SubscribeGET /agent/x402/subscribeGET /agent/mpp/subscribe
Top upGET /agent/x402/top-upGET /agent/mpp/top-up
Create API keyGET /agent/x402/api-keys/createGET /agent/mpp/api-keys/create
Revoke API keyDELETE /agent/x402/api-keys/revoke?api_key=GET /agent/mpp/api-keys/revoke?api_key=
Documentation — x402: x402 Get subscription status · x402 Subscribe to a plan · x402 Top up credits · x402 Create API key · x402 Revoke API key Documentation — MPP: MPP Get subscription status · MPP Subscribe to a plan · MPP Top up credits · MPP Create API key · MPP Revoke API key · MPP Agent endpoints Other MPP-priced REST paths (per-request data under /api/2/...) and the full machine-readable catalog live in openapi.json — see MPP Agent endpoints. Other x402 routes outside agent provisioning are documented separately (e.g. sidebar Agentic payments and REST guides).

Pricing (both rails)

PlanMonthlyYearly
Startup$50$400
Growth$400$4,200
Enterprise$750 (base) + variable$7,200 (base) + variable (see team for quote)
Top-ups: minimum $20 (configurable). Small fixed fees apply on subscription status checks (facilitator / protocol layer).

Human-managed access

Prefer a dashboard? Get a free API key at admin.mobula.io and use the REST API without agent payment flows.