AGENT COMMERCE // PAYMENT AUTHORITY SNAPSHOT

AGENT COMMERCE

Payment Authority Snapshot

Live 0.005 USDC

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.

{
  "resource_url": "https://api.agentmercantile.com/v1/url-context",
  "method": "POST",
  "body": { "url": "https://example.com/" },
  "payer_address": "0x1111111111111111111111111111111111111111"
}
OUTPUT

State is not authorization

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.

{
  "status": "OK",
  "machine": "VM10",
  "methodology_version": "payment-authority-snapshot-0.1.0",
  "state": "READY_EXISTING",
  "signing": false,
  "payment_execution": false,
  "approval_mutation": false,
  "custody": false,
  "recommendation": false,
  "gas_sufficiency_judgment": false
}
UNPAID 402

Expect HTTP 402. Do not send a signature yet.

curl -sS -D - -o - -X POST https://api.agentmercantile.com/v1/payment-authority-snapshot \
  -H "content-type: application/json" \
  -d '{"resource_url":"https://api.agentmercantile.com/v1/url-context","method":"POST","body":{"url":"https://example.com/"},"payer_address":"0x1111111111111111111111111111111111111111"}'

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

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.