Skip to main content
AI agents can buy access to your API without an account: they pay with a wallet over x402 or MPP and the gateway does the rest. Nothing about your API, targets or plans changes — agents are one more kind of customer.

​
What agents can buy

  • Your existing plans. Every public, USD-priced plan is purchasable by agents. An agent pays the plan price, receives a freshly issued API key bound to that subscription, and uses it like any consumer. Periods are prepaid: when a period ends the agent is offered a renewal; nothing renews automatically. Plans are sold to agents by default — publishing plans is the consent.
  • Pay per request. Optionally, price individual endpoints for keyless calls. The price is a fixed USD amount per successful request that you set on each endpoint. Requests answered with an upstream 5xx are not charged.
  • Pay-as-you-go. Agents can fund a balance with a wallet payment and subscribe to your pay-as-you-go plans; metering, tiers and formulas apply unchanged.

​
Enable pay-per-request

  1. Open the API in Studio → Details → Settings → Agent payments and turn the switch on. This is the master switch; it does nothing until at least one endpoint carries a price.
  2. Price endpoints: on an endpoint’s Details page set Agent price (USD per request), or select several endpoints on the Endpoints page and use Set agent price. Endpoints without a price are not sold per request (agents still reach them with a key from a plan).
  3. Prices are live immediately. The platform enforces a minimum and maximum per request (shown next to the field); prices are in USD and settled in USDC.
Per-request prices are independent of billable objects and usage formulas: the agent pays the fixed price, your usage counters still record the call.

​
Where agents show up

  • Subscriptions and Transactions list agents like any customer, with an Agent badge and a short wallet identity instead of an email. Filter by Agents to see only them.
  • Payouts: plan purchases are ordinary paid subscriptions (periodic revenue); per-request and pay-as-you-go charges accrue like pay-as-you-go usage. The marketplace commission is the same as for every other sale.
  • Analytics: per-key analytics work per agent purchase, because every purchase has its own key.

​
Discovery

Agent-payable APIs are listed on https://agents.jojapi.com and each API host publishes /.well-known/x402 and an annotated /openapi.json, which x402 directories index. Priced endpoints are also announced to the payment facilitator’s discovery layer on first settlement.

​
Reserved paths

/openapi.json, /.well-known/… and /_jojapi/… on your API host belong to the gateway: they serve the annotated OpenAPI document, the x402 discovery document and the agent commerce routes, without authentication. Endpoints cannot be documented on these paths, and an endpoint that already sits there is never reached by requests.

​
Policies

  • Per-request prices are charged on 2xx and 4xx upstream answers, never on 5xx.
  • An agent may hold several plans of the same API at once (each with its own key); the human “one subscription per API” rule does not apply to agents.
  • Wallet payments are final. Goodwill refunds are handled by the marketplace as balance credits.