Give the machine one exact x402 request and one public payer. After payment it reports the observed payment requirement, the same-block token balance, and the authority path that requirement implies. It does not approve, sign, judge native gas, or pay the target.
PURPOSE
Plain-English job
Given the exact current x402 payment requirement, this public payer, and an optional caller-held prior authority baseline, report what payment authority exists now, what authority path is required, and whether that authority materially changed.
WHEN TO CALL
Job-shaped selection
Call when a planner needs a read-only authority snapshot before considering an approval or payment. Not a wallet, not a gas estimator, not a recommendation, not a target payment. Before purchasing x402 Pre-Sign Handoff Packet or Payment Authority Snapshot, the POST target body must satisfy the target route's schema. payer_address must be the caller's actual public EVM payer address. The published payer example is a placeholder, not a real buyer or funded wallet.
INPUT
Resource, method, and public payer
Required resource_url, method, and payer_address. Optional body for POST targets. Optional baseline is a prior compact authority snapshot the caller stored. Callers cannot supply an RPC URL or a spender. The machine derives protocol authority context.
state may be READY_EXISTING, APPROVAL_PATH_SPONSORED_ERC20, APPROVAL_PATH_EIP2612, DIRECT_APPROVAL_REQUIRED, NOT_READY_BALANCE, UNSUPPORTED_PROTOCOL_OR_NETWORK, or INDETERMINATE. READY_EXISTING means an existing allowance path was observed. It is not permission to pay. DIRECT_APPROVAL_REQUIRED does not mean Agent Mercantile will submit an approval. The block below is an illustrative catalog shape, not a captured production result.
A valid unpaid request returns x402 v2 HTTP 402 for $0.005 / 5000 atomic Base USDC. The body is the payment contract for this snapshot. It does not approve a token and it does not pay the target. Malformed input returns HTTP 400 without a payable contract.
LIMITATIONS
Known bounds
READ ONLYsigning, payment_execution, transaction_construction, approval_mutation, custody, recommendation, and gas_sufficiency_judgment are false.
NO GAS JUDGMENTNative-gas sufficiency is not estimated. Use Transaction Gas Preflight when the job is gas units and recent fee context.
NO CALLER RPCThe caller cannot supply an RPC URL or spender. No target probe or chain read happens before the Agent Mercantile payment.
OPTIONAL BASELINEMaterial change versus a prior snapshot is reported only when the caller resubmits a baseline it stored. This machine does not keep that history.
PLACEHOLDER PAYER0x1111111111111111111111111111111111111111 is not a buyer and not a funded wallet.
CONTRACT
Intended routes
Public API origin:
POST https://api.agentmercantile.com/v1/payment-authority-snapshot
GET https://api.agentmercantile.com/openapi.json
This page does not start a payment. Paid JSON machine is VM10 for this route. Public contact: contact@agentmercantile.com.