DEVELOPERS // CHOOSE BY JOB

Choose the machine by the job.

Discover by job, inspect the 402 terms, then pay only if they fit. REST/OpenAPI is the product interface. x402 is the payment adapter. Agent Mercantile does not run an MCP server. Free machine-readable catalog: GET /v1/catalog. Live base: https://api.agentmercantile.com.

Live REST / OPENAPI 0.005 OR 0.01 USDC
JOB INDEX

Eleven jobs, eleven routes

SHARED PAYMENT BEHAVIOR

Expect HTTP 402. Do not send a signature.

Every machine is POST JSON to https://api.agentmercantile.com on network eip155:8453, asset Base USDC 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913. A syntactically valid unpaid body returns x402 v2 HTTP 402. That body is the payment contract for Agent Mercantile, not the product. Malformed or unsupported input returns HTTP 400 with advertise_payment false and no payable contract. Do not send a manual USDC transfer. A raw transfer does not settle the call.

Prices: URL Context Pack, Allowance Exposure Preflight, Portfolio Preflight, Productive Venue Snapshot, Bazaar Visibility Snapshot, x402 Service Change Snapshot, and x402 Pre-Sign Handoff Packet are $0.01 / 10000 atomic (0.01 USDC). Transaction Gas Preflight, Web Change Snapshot, Payment Authority Snapshot, and Bazaar Visibility Change Snapshot are $0.005 / 5000 atomic (0.005 USDC).

After settlement, read product JSON separately from payment success. status of OK, PARTIAL, or HOLD is product health. PARTIAL can be the truthful result, including Portfolio Preflight when the 40-holding cap is reached. HOLD after settlement means required evidence was unavailable. It is not a second price. The settlement record does not store the purchased page body or the raw payment signature header.

CATALOGGET /v1/catalog
OPENAPIGET /openapi.json
HEALTHGET /health
URL CONTEXT PACK · WEB INTELLIGENCE · 0.01 USDC

Read one public HTTPS page

POST /v1/url-context. Methodology url-context-0.1.0. Call when you need a bounded JSON reading of one public HTTPS page without a browser, login, site crawl, or LLM.

curl -sS -D - -o - -X POST https://api.agentmercantile.com/v1/url-context \
  -H "content-type: application/json" \
  -d '{"url":"https://example.com/"}'

Paid JSON includes canonical URL, title, headings, bounded text, JSON-LD types, observed freshness headers, and limitations. It does not invent a stale or fresh label. http, credentials in the URL, non-443 ports, and extra fields are HTTP 400.

Open the URL Context Pack page.

WEB CHANGE SNAPSHOT · WEB INTELLIGENCE · 0.005 USDC

See whether a webpage, documentation page, or pricing page changed

POST /v1/web-change-snapshot. Methodology web-change-snapshot-0.1.0. Store the baseline returned by the first complete observation and resubmit it unchanged. Not continuous monitoring, alerts, text diffs, or site-wide crawling.

curl -sS -D - -o - -X POST https://api.agentmercantile.com/v1/web-change-snapshot \
  -H "content-type: application/json" \
  -d '{"url":"https://example.com/"}'

Product health and comparison_status are separate. Comparison is BASELINE, UNCHANGED, CHANGED, or INCONCLUSIVE. UNCHANGED covers the bounded normalized representation, not the entire website. Incomplete or truncated evidence must not be treated as UNCHANGED. Request body max 8192 bytes.

Open the Web Change Snapshot page.

ALLOWANCE EXPOSURE · ONCHAIN PREFLIGHT · 0.01 USDC

One Base allowance versus one balance

POST /v1/allowance-exposure. Methodology allowance-exposure-0.1.0. Same-block read for one owner, one ERC-20, and one spender. Not Permit2, not a wallet scan, not revoke advice.

curl -sS -D - -o - -X POST https://api.agentmercantile.com/v1/allowance-exposure \
  -H "content-type: application/json" \
  -d '{"owner":"0x0000000000000000000000000000000000000001","token":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","spender":"0x0000000000000000000000000000000000000002"}'

Read allowance_raw, balance_raw, and the exposure flags together. A max-uint256 allowance is an observed flag, not an instruction to revoke. No chain read runs before payment.

Open the Allowance Exposure page.

PORTFOLIO PREFLIGHT · ONCHAIN PREFLIGHT · 0.01 USDC

Bounded portfolio evidence, not net worth

POST /v1/portfolio-preflight. Methodology portfolio-preflight-0.2.0. Current price is 0.01 USDC / 10,000 atomic. Not investment advice, not transaction approval, and not guaranteed net worth.

curl -sS -D - -o - -X POST https://api.agentmercantile.com/v1/portfolio-preflight \
  -H "content-type: application/json" \
  -d '{"address":"0x0000000000000000000000000000000000000001","chains":["eip155:1","eip155:8453"]}'

At most 40 holdings are returned. overflow_holding_count greater than 0 means holdings were omitted. overflow_count_complete false means that omitted count is not guaranteed complete. status PARTIAL can be expected when the cap is reached and does not mean the request failed. Missing prices are null, not zero. READY on the readiness object is not transaction safety.

Open the Portfolio Preflight page.

PRODUCTIVE VENUE · ONCHAIN PREFLIGHT · 0.01 USDC

Observed Aave V3 and Lido rates for one asset

POST /v1/productive-venue-snapshot. Methodology productive-venue-0.2.0. Factual snapshot only. Not a ranking, recommendation, or complete map of DeFi. The free sample captured at 2026-08-22T20:17:57.164Z is not this call’s result.

curl -sS -D - -o - -X POST https://api.agentmercantile.com/v1/productive-venue-snapshot \
  -H "content-type: application/json" \
  -d '{"chain_id":1,"asset":{"kind":"native"}}'

Supported chain_id values are 1 and 8453. Allowlisted symbols are ETH, WETH, USDC, stETH, and wstETH. Optional V2 fields are venue_types, protocols, sort, and limit. Read each rate’s explicit APR or APY label. A derived APY is not a guaranteed return. Unsupported symbols and extra fields return HTTP 400.

Current CLI form, after you have inspected the 402. Load https://agentic.market/SKILL.md and search for the job you need:

npx awal x402 pay "https://api.agentmercantile.com/v1/productive-venue-snapshot" \
  --method POST \
  --data '{"chain_id":1,"asset":{"kind":"native"}}' \
  --max-amount 10000

Open the Productive Venue Snapshot page. View the captured sample.

TRANSACTION GAS · ONCHAIN PREFLIGHT · 0.005 USDC

Gas units and recent fee context

POST /v1/transaction-gas-preflight. Methodology transaction-gas-preflight-0.1.0. Not transaction execution, signing, or a guaranteed inclusion cost. Calldata max 8192 bytes. Request body max 20480 bytes.

curl -sS -D - -o - -X POST https://api.agentmercantile.com/v1/transaction-gas-preflight \
  -H "content-type: application/json" \
  -d '{"chain":"eip155:8453","to":"0x0000000000000000000000000000000000000001","data":"0x","value_wei":"0"}'

The result is eth_estimateGas units plus recent eth_feeHistory evidence and illustrative execution-fee arithmetic. Illustrative arithmetic is not a max-fee recommendation and not the final cost. Chains are eip155:1 and eip155:8453. Do not send nonce, gas fields, a signed transaction, or an RPC URL.

Open the Transaction Gas Preflight page.

BAZAAR VISIBILITY · AGENT COMMERCE · 0.01 USDC

Point-in-time Bazaar presence

POST /v1/bazaar-visibility. Methodology bazaar-visibility-0.1.0. Not a trust score, SEO score, or rank beyond the observed top 20. For a later comparison against a baseline you store, use Bazaar Visibility Change Snapshot. For the direct payment contract, use x402 Service Change Snapshot.

curl -sS -D - -o - -X POST https://api.agentmercantile.com/v1/bazaar-visibility \
  -H "content-type: application/json" \
  -d '{"resource":"https://api.example.com/v1/paid","pay_to":"0x0000000000000000000000000000000000000001","queries":["example paid json api"]}'

Merchant presence is FOUND, NOT_FOUND when one page proves absence, or UNKNOWN_TRUNCATED. Search visibility is IN_TOP_20 with a 1-indexed position, or NOT_IN_TOP_20 with position null. The resource URL is an identifier and is never fetched. No discovery call runs before payment.

Open the Bazaar Visibility Snapshot page.

SERVICE CHANGE · AGENT COMMERCE · 0.01 USDC

Re-qualify a payment contract

POST /v1/x402-service-change-snapshot. Methodology x402-service-change-snapshot-0.1.0. Before purchasing x402 Service Change Snapshot, a POST target body must satisfy the target route's schema. The published example uses the URL Context Pack required body and is not required for every POST target.

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

BASELINE_CREATED is first qualification, not a comparison. CONTINUE means the direct contract is equivalent under the price policy. It is not authorization to pay the target. REVIEW means re-qualify. STOP means a payment-critical change or an increase outside policy. UNKNOWN must not be stored as a reusable baseline. Omitted price_policy uses 500 bps modest and 2000 bps maximum. A price drop is review, not stop.

Open the x402 Service Change Snapshot page.

PRE-SIGN HANDOFF · AGENT COMMERCE · 0.01 USDC

One packet for a separate signer

POST /v1/x402-presign-handoff. Methodology x402-presign-handoff-0.1.0. EIP-3009 exact Base USDC only. Not a wallet and not a target payment. The published payer is a placeholder, not a real buyer or funded wallet.

curl -sS -D - -o - -X POST https://api.agentmercantile.com/v1/x402-presign-handoff \
  -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","max_amount_atomic":"20000","allowed_pay_to":["0xdb7b2b54f80479826222749a2ea73a8acc306e1e"]}'

READY means the observed unpaid requirement matched caller constraints at observed_at. The packet expires 60 seconds later. The signer must still verify identity, freshness, asset_transfer_method, and handoff_sha256. NOT_READY and INDETERMINATE are not suggestions to pay anyway. Permit2 and other non-eip3009 methods fail closed. This payment buys the packet. It does not pay the target.

Open the x402 Pre-Sign Handoff page.

PAYMENT AUTHORITY · AGENT COMMERCE · 0.005 USDC

What token authority exists now

POST /v1/payment-authority-snapshot. Methodology payment-authority-snapshot-0.1.0. Read-only. Not a gas estimate and not an approval transaction. Replace the placeholder payer before a real call.

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"}'

READY_EXISTING means an existing allowance path was observed at observed_at. It is not authorization to pay. DIRECT_APPROVAL_REQUIRED and the sponsored-path states describe an observed path. Agent Mercantile does not submit the approval. NOT_READY_BALANCE is a token-balance observation, not a native-gas judgment. gas_sufficiency_judgment is false.

Open the Payment Authority Snapshot page.

BAZAAR CHANGE · AGENT COMMERCE · 0.005 USDC

What changed in Bazaar visibility

POST /v1/bazaar-visibility-change. Methodology bazaar-visibility-change-0.1.0. Store the returned baseline and resubmit it with the same resource, payTo, and ordered queries. Not a direct payment-contract probe, global ranking, hosted monitor, or remediation recommendation.

curl -sS -D - -o - -X POST https://api.agentmercantile.com/v1/bazaar-visibility-change \
  -H "content-type: application/json" \
  -d '{"resource":"https://api.example.com/v1/paid","pay_to":"0x0000000000000000000000000000000000000001","queries":["example paid json api"]}'

BASELINE_CREATED with comparison_performed false is the first complete observation. CONTINUE means no material delta. CHANGED lists factual deltas inside merchant presence, metadata, schema discovery, visible payment fields, query position, and the observed window. HOLD means the observation is incomplete. Position outside the first 20 is not a global rank. direct_x402_probe and server_baseline_stored are false.

Open the Bazaar Visibility Change page.

WEB CHANGE REPEAT-USE

Caller-held baseline, then optional URL Context Pack

Agent Mercantile does not host a scheduler, alert service, or customer history. The caller stores the Web Change Snapshot baseline outside Agent Mercantile and resubmits that exact compact baseline on a later check. Web Change Snapshot fingerprints are not exact historical text diffs. Incomplete, truncated, HOLD, or otherwise unusable evidence must not replace a known-good baseline and must not be treated as UNCHANGED.

# 1. First check (expect HTTP 402 unpaid, then pay only if terms fit)
curl -sS -D - -o - -X POST https://api.agentmercantile.com/v1/web-change-snapshot \
  -H "content-type: application/json" \
  -d '{"url":"https://example.com/"}'

# 2. Store baseline.page_sha256 + baseline.components yourself.
# 3. Later recheck with the exact stored baseline (still a separate paid call).
# 4. If comparison_status is CHANGED, optionally call URL Context Pack for current page text.
#    A later URL Context Pack fetch may observe a newer page than the Web Change Snapshot comparison.
#    Callers who need exact before/after text must retain their own earlier text.

Valid Web Change Snapshot input requires a public HTTPS URL on port 443. A request without that URL is not payable. Agent Mercantile does not add a default URL. Malformed URLs return HTTP 400 without a payable contract.

Optional current-page context is a separate URL Context Pack purchase:

curl -sS -D - -o - -X POST https://api.agentmercantile.com/v1/url-context \
  -H "content-type: application/json" \
  -d '{"url":"https://example.com/"}'
SERVICE CHANGE REPEAT-USE

Caller-held payment-contract baseline

Agent Mercantile does not host a scheduler or a monitoring history for the target. The caller stores the reusable x402 Service Change Snapshot baseline outside Agent Mercantile and resubmits it only for the same request identity. A first complete direct observation is BASELINE_CREATED. That result is not a comparison against a previously accepted contract. A later call with that baseline returns CONTINUE, REVIEW, STOP, or UNKNOWN. Do not persist an UNKNOWN or incomplete observation as the new baseline. CONTINUE does not authorize payment of the target. Paying for this snapshot does not pay the probed resource.

BAZAAR CHANGE REPEAT-USE

Caller-held sealed visibility baseline

Agent Mercantile does not host a scheduler, account, or server-side watch. The caller stores current_baseline from a complete BASELINE_CREATED result and resubmits that sealed object with the same resource, payTo, and normalized queries. Tampered or identity-mismatched baselines return HTTP 400 without a payable contract. HOLD must not replace a known-good baseline. CONTINUE and CHANGED describe the observed discovery window only. They are not a global rank, a demand claim, or a direct payment-contract result. Use Bazaar Visibility Snapshot for a point-in-time look without a baseline, and x402 Service Change Snapshot to probe the direct x402 contract.

RESPONSE FIELD

Match the route, not the public name

Paid JSON includes machine. That value identifies the route for integrators. It is not the product name shown on this site.

COINBASE MCP BRIDGE

Existing x402 HTTP machines, discovered through Coinbase

Agent Mercantile does not host an MCP server. Buyers may use Coinbase’s Bazaar MCP as an external discovery/payment bridge to the existing paid HTTP resources. Local or free tools may be enough for simple URL or change checks; pay only if the 402 terms fit.

Current intended buyer route for an existing machine (Web Change Snapshot, $0.005 / 5000 atomic Base USDC):

  1. Required arguments: JSON {"url":"https://..."} plus optional caller-held baseline. Empty {} is HTTP 400 and not payable.
  2. Payment prerequisite: x402 v2 exact USDC on Base (eip155:8453). Inspect amount, network, asset, and payTo before authorizing. Do not send a manual USDC transfer.
  3. Output: bounded fingerprints and comparison_status (BASELINE, UNCHANGED, CHANGED, INCONCLUSIVE). UNCHANGED is not a guarantee the entire website is unchanged.
  4. Provider indexing and curated admission are external and may differ from HTTP Bazaar search. Default Coinbase MCP search is curated-only when curation is enabled; pass curatedOnly: false for broader search. validate_endpoint is not a required AM acceptance dependency.

HTTP pay path (verified shape; inspect 402 first):

npx awal x402 pay "https://api.agentmercantile.com/v1/web-change-snapshot" \
  --method POST \
  --data '{"url":"https://example.com/"}' \
  --max-amount 5000

Coinbase MCP discovery (read-only search_resources only). To execute a discovered tool the provider requires proxy_tool_call plus payment metadata; that is a paid request and is not performed by Agent Mercantile source workers. Example discovery call shape:

POST https://api.cdp.coinbase.com/platform/v2/x402/discovery/mcp
{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"search_resources","arguments":{"query":"webpage change detection","curatedOnly":false}}}

If MCP search does not currently return the machine you need, use the HTTP resource for that job. Do not invent a default URL. AWS-specific MCP success is not claimed here.

Public contact: contact@agentmercantile.com.