DEV Community

Cover image for Inspect the x402 Quote First: Top-Up Is Not a Per-Call Payment
OpenAny
OpenAny

Posted on Originally published at blog.openany.si

Inspect the x402 Quote First: Top-Up Is Not a Per-Call Payment

Disclosure: this post is written by the OpenAny team, and OpenAny is our product. The commands and quote fields below come from public OpenAny documentation reviewed on 19 November 2026 (Asia/Taipei). This draft does not include a live payment or a billed API receipt.

The first useful habit with x402 is not signing a payment. It is reading a quote without paying.

A lot of agent-payment writeups skip that step. They treat “pay with x402” as one action, then either paste a transfer address from a docs example or retry after a timeout. Both are avoidable. You can inspect configuration and request an estimate first. You should also keep two flows apart: crediting a shared prepaid balance, and paying one listing directly.

OpenAny is the B2A (business to agent) marketplace. Give your agent 3,200+ APIs and 168+ AI models with one key and pay-per-call pricing. openany.si

Two inspect commands that do not pay

These commands are published on the x402 page (updated 29 October 2026). They do not authorize a payment, create a payable intent, or credit a balance.

# Read configuration only; this does not create or pay for an order.
openany topups config -j

# After authorized email login, request an estimate (not a payment).
# Use Base only if the current configuration offers it for your account.
openany topups quote --amount-usd 1 --network eip155:8453 -j
Enter fullscreen mode Exit fullscreen mode

Use Base (eip155:8453) in the second command only if the current configuration offers it for your account. The published CLI instructions list Base and Solana (solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp) for email-identity top-ups. Wallet-identity support follows the service's published EVM configuration. That is not a guarantee every network is enabled for every account.

This post does not include live command output. No funding session was run while writing it. If you run the inspect commands yourself, treat the result as an estimate until you have a locked order quote.

What to read in the locked quote

An estimate is not the quote you pay. Before signing, confirm the account that will receive the credit, and that the API key your agent will use belongs to that same account. A connected wallet is not automatically the billed account.

The USDC top-up guide (updated 4 November 2026) documents these fields:

Quote field Meaning
payAmountMicroUsd Amount you actually pay (micro-USD)
feeAmountMicroUsd Fee quoted for this order (micro-USD)
creditAmountMicroUsd Amount expected to reach the shared balance (micro-USD)
inputAmountMeaning add_on (fee on top of the payment) or deduct_from_credit (fee comes out of the credit)

The official guide uses illustrative $10 amounts to explain the semantics, not a live fee. Under add_on, entering $10 can credit $10 and still require an extra fee. Under deduct_from_credit, paying $10 credits less than $10. There is no universal published top-up fee. Read the quote in front of you.

Then pay only the asset, token contract, network, recipient, and amount on that locked quote. Do not infer an asset from a chain name. Never send funds to a documentation example.

Top-up and direct payment are not the same flow

Flow What gets paid Later authentication
x402 / USDC / card top-up Credits added to one OpenAny balance OpenAny API key; usage deducted from that balance
Direct x402 One specific resource request That endpoint's payment contract, not the OpenAny API key

Direct x402 is available only on listings that explicitly support it. Funding a balance does not turn every catalog item into a direct x402 endpoint. The OpenAny CLI documents the top-up flow, not direct per-resource execution.

Card, USDC, and x402 top-ups fund the same shared balance. The pricing page also notes that card auto top-up and USDC subscriptions fund that same balance. Signing in is not payment approval, and copied commands are not authorization.

Browsing, docs, account creation, and API-key creation are free. No OpenAny subscription is required for standard pay-as-you-go access. Eligible new accounts can receive $0.50 in signup credits toward supported calls. A free account does not include free resource usage unless an explicit trial or promotion says so.

If a payment times out, do not pay again

A signature, a submitted transaction, or a “payment confirmed” toast is not a usable balance.

Report funds as credited only after paymentStatus=paid and creditStatus=credited. For wallet identity, also wait for accountUsable=true.

If the result is unclear, keep the original intent and order reference and inspect that order (openany topups get). Do not create a replacement intent, change the amount, or pay twice. An uncertain response can hide a payment that already succeeded.

If an agent is helping with funding, give it explicit limits first: identity, network, per-payment maximum, total maximum, purpose, and expiration. A low balance is not permission to recharge. topups authorize records authorization already given; it does not create consent.

The official guide also shows topups create and topups pay as an illustrative sequence. This post does not run them, and it is not an instruction to paste a payment loop into an agent.

After the credit, one key

Once credit is confirmed, calling a model or data API is a separate, budgeted step. Keep OPENANY_API_KEY in the client environment, not in a prompt. The API base is https://api.openany.si/v1. Copy the current model ID from its listing.

This article does not include a billed usage receipt, because no paid call was completed while writing it. After a real call, check Usage. If the list price and the charged amount differ, use the charged amount.

OpenAny does not host a seller's runtime. Downloadable skills run in the buyer's agent; callable skills and bots run in the seller's environment. This post is about funding and buying calls, not about selling them.

Quick checks

  • Inspect with topups config and topups quote before you sign anything.
  • Read payAmountMicroUsd, feeAmountMicroUsd, creditAmountMicroUsd, and inputAmountMeaning on the locked quote.
  • Do not treat a top-up as a direct per-call x402 payment.
  • After a timeout, check the original order. Do not pay again.

Primary sources: x402 page, USDC guide, pricing, and docs.

OpenAny is the B2A (business to agent) marketplace. Give your agent 3,200+ APIs and 168+ AI models with one key and pay-per-call pricing. openany.si

Top comments (0)