Skip to main content
Every operation is priced once and charged twice. Half is collected when you prepare it, half when you send it, in both client-signed and client-broadcast mode. Calling POST /prepare-transactions directly is therefore a paid call. A valid x-api-key is accepted instead of paying, on both steps. Prices are in USDC on Base mainnet, and the figures below are the total for the operation.

Agent getter pricing

GET /get-agents, GET /get-agent-info, and GET /get-agent-transactions cost 0.000001 USDC per x402 call. They are free of x402 payment when called with a valid API key.

How RAMS is priced

RAMS runs on Ethereum Sepolia (11155111) at launch, on both sandbox and production. All /x402/rams/* prepare facades default to chainId: "11155111".
RAMS writes are priced the same way as the rest: the total splits evenly across prepare and send, so ramsGrantMandate costs 0.49 at prepare and 0.49 at send. Four of the ten writes — grant-mandate, revoke-mandate, extend-mandate, and set-operator — are authorized by a principal EIP-712 signature, so the wallet that sends the transaction does not have to be the principal. The other six check msg.sender against an on-chain role, so signerAddress must be the role holder itself. The nine RAMS read and typed-data endpoints (GET /rams/*) are priced at the cheaper GETTER tier, not the transaction tier. They are also callable with an x-api-key instead of paying.
Prices are resolved from a database table at request time and environment defaults are only a fallback, so the GETTER amount is not fixed here. Read it from the PAYMENT-REQUIRED header of the 402 response.
Sandbox, Base Sepolia, and other non-production environments use a flat reference price of 0.01 USDC per write. Agent getters keep their separate 0.000001 USDC price.
The exact amount, asset, and chain are always quoted in the PAYMENT-REQUIRED header of the 402 response (and previewed in the prepare response’s x402Requirements). Read them from there rather than hardcoding the table above.
x402 payments and on-chain transactions are non-refundable. Confirm chain, signer/recipient, token address, and expected USDC price before paying.