{"service":"Agent Mercantile","machine":"VM01","methodology_version":"url-context-0.1.0","paid_resource":"POST https://api.agentmercantile.com/v1/url-context","path":"/v1/url-context","catalog":"GET https://api.agentmercantile.com/v1/catalog","families":[{"family":"WEB_INTELLIGENCE","label":"Web Intelligence","machines":["VM01","VM07"]},{"family":"ONCHAIN_PREFLIGHT","label":"Onchain Preflight","machines":["VM02","VM03","VM04","VM06"]},{"family":"AGENT_COMMERCE","label":"Agent Commerce","machines":["VM05","VM08","VM09","VM10","VM11"]}],"machines":[{"machine":"VM01","family":"WEB_INTELLIGENCE","name":"URL Context Pack","methodology_version":"url-context-0.1.0","paid_resource":"POST https://api.agentmercantile.com/v1/url-context","purpose":"Fetch one public HTTPS webpage into deterministic structured JSON context: canonical URL, title/description, headings, main text, JSON-LD types, freshness observations, size, evidence, and limitations.","when_to_call":"Call when you need a bounded JSON reading of one public HTTPS page without a browser, login, site crawl, or LLM. Not for private URLs, http, non-443 ports, authenticated pages, or multi-URL crawls."},{"machine":"VM02","family":"ONCHAIN_PREFLIGHT","name":"Allowance Exposure Preflight","methodology_version":"allowance-exposure-0.1.0","paid_resource":"POST https://api.agentmercantile.com/v1/allowance-exposure","purpose":"Read one Base ERC-20 owner/token/spender direct allowance at one block, compare it with the owner's current token balance, and return factual exposure flags including max-uint256 and effectively-unlimited approvals.","when_to_call":"Call when you need a same-block Base allowance-versus-balance snapshot for one owner, one ERC-20 token, and one spender. Not a wallet-wide scanner, Permit2 reader, other-chain checker, simulator, or revoke advisor."},{"machine":"VM03","family":"ONCHAIN_PREFLIGHT","name":"Portfolio Preflight","methodology_version":"portfolio-preflight-0.2.0","paid_resource":"POST https://api.agentmercantile.com/v1/portfolio-preflight","purpose":"Return a bounded Ethereum/Base discovery snapshot of at most 40 holdings, plus overflow_holding_count, overflow_count_complete, and a pre-action evidence-readiness summary. Not complete portfolio enumeration.","when_to_call":"Call when you need to check whether bounded Ethereum/Base wallet/portfolio evidence is sufficiently complete before downstream reasoning. Discovery returns at most 40 holdings. overflow_holding_count>0 means additional holdings were omitted. overflow_count_complete=false means that omitted-count total is not guaranteed complete. status=PARTIAL can be the expected truthful state when the 40-holding cap is reached and does not necessarily mean the request failed. Includes inventory/composition, partial DEX pricing coverage, concentration, and evidence gaps. Not guaranteed net worth, investment advice, transaction approval/safety certification, or execution."},{"machine":"VM04","family":"ONCHAIN_PREFLIGHT","name":"Productive Venue Snapshot","methodology_version":"productive-venue-0.2.0","paid_resource":"POST https://api.agentmercantile.com/v1/productive-venue-snapshot","purpose":"Observe currently factual Aave V3 lending supply APR and Lido staking APR for one supported Ethereum or Base asset from a frozen protocol set, with timestamps, evidence, explicit rate labels, optional filters/sort, and limitations.","when_to_call":"Call when you need currently observed Aave V3 supply APR and/or Lido staking APR for one supported Ethereum or Base asset. Factual snapshot only — not a ranking, recommendation, or complete map of DeFi."},{"machine":"VM05","family":"AGENT_COMMERCE","name":"Bazaar Visibility Snapshot","methodology_version":"bazaar-visibility-0.1.0","paid_resource":"POST https://api.agentmercantile.com/v1/bazaar-visibility","purpose":"Observe, for one x402 seller resource, whether Coinbase Bazaar merchant discovery currently lists that exact resource, what public Bazaar metadata describes it, and where (if anywhere) it appears in the first 20 results for 1–3 buyer-supplied job-language searches.","when_to_call":"Call when you need a point-in-time factual observation of whether one x402 resource appears in Coinbase Bazaar merchant discovery and where it sits in the first 20 results for 1–3 buyer-supplied job-language searches. Not a trust score, SEO score, rank beyond the observed top 20, or remediation recommendation."},{"machine":"VM06","family":"ONCHAIN_PREFLIGHT","name":"Transaction Gas Preflight","methodology_version":"transaction-gas-preflight-0.1.0","paid_resource":"POST https://api.agentmercantile.com/v1/transaction-gas-preflight","purpose":"Before an agent signs or submits an Ethereum or Base transaction, return bounded factual eth_estimateGas units and recent eth_feeHistory execution-fee evidence for the exact unsigned transaction facts supplied.","when_to_call":"Call when you need point-in-time gas units and recent execution-fee context before signing or submitting an Ethereum or Base transaction. Not transaction execution, signing, wallet/custody, trading, approval, simulation-as-guarantee, or financial advice."},{"machine":"VM07","family":"WEB_INTELLIGENCE","name":"Web Change Snapshot","methodology_version":"web-change-snapshot-0.1.0","paid_resource":"POST https://api.agentmercantile.com/v1/web-change-snapshot","purpose":"Let an AI agent cheaply determine whether the bounded normalized representation of one public HTTPS webpage has changed since a caller-held previous baseline.","when_to_call":"Call when you need webpage change detection, URL change, page freshness, documentation monitoring, pricing-page monitoring, or policy-page monitoring of one public HTTPS page. Not continuous monitoring, alerts, webhooks, semantic importance detection, AI summaries, or site-wide crawling."},{"machine":"VM08","family":"AGENT_COMMERCE","name":"x402 Service Change Snapshot","methodology_version":"x402-service-change-snapshot-0.1.0","paid_resource":"POST https://api.agentmercantile.com/v1/x402-service-change-snapshot","purpose":"Given what a buyer previously accepted about an x402 service, determine whether the live payment contract is still equivalent enough to proceed.","when_to_call":"Call when you need to re-qualify a previously accepted x402 payment contract using a caller-held baseline. Not an uptime monitor, 30-day watcher, webhook, trust score, or marketplace crawler."},{"machine":"VM09","family":"AGENT_COMMERCE","name":"x402 Pre-Sign Handoff Packet","methodology_version":"x402-presign-handoff-0.1.0","paid_resource":"POST https://api.agentmercantile.com/v1/x402-presign-handoff","purpose":"Given one exact intended x402 request, a public payer, and caller constraints, produce a normalized pre-sign evidence packet a separate signer can verify before protected payment execution.","when_to_call":"Call when a planner keeps wallet/signing authority separate and needs one canonical unpaid-402 + coverage packet for an EIP-3009 exact Base USDC requirement. Not a wallet, not a recommendation, not a target payment. Does not qualify non-eip3009 transfer methods."},{"machine":"VM10","family":"AGENT_COMMERCE","name":"Payment Authority Snapshot","methodology_version":"payment-authority-snapshot-0.1.0","paid_resource":"POST https://api.agentmercantile.com/v1/payment-authority-snapshot","purpose":"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":"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."},{"machine":"VM11","family":"AGENT_COMMERCE","name":"Bazaar Visibility Change Snapshot","methodology_version":"bazaar-visibility-change-0.1.0","paid_resource":"POST https://api.agentmercantile.com/v1/bazaar-visibility-change","purpose":"Tell an x402 seller what materially changed in Coinbase Bazaar discovery visibility since a caller-held known-good observation: merchant presence, discovery metadata, schema metadata, visible payment fields, and per-query position inside the observed search window. VM05 remains the point-in-time snapshot. VM08 remains the direct x402 payment-contract comparison.","when_to_call":"Call when you need a deterministic comparison of one resource's Coinbase Bazaar discovery visibility against a caller-held baseline for 1–3 buyer-job searches. Not a generic Bazaar search, not a replacement for VM05, and not a VM08 direct-contract probe."}],"openapi":"https://api.agentmercantile.com/openapi.json","documentation":"https://agentmercantile.com/developers/","health":"https://api.agentmercantile.com/health","sample":"https://api.agentmercantile.com/samples/productive-venue-snapshot","status":"https://agentmercantile.com/status/","llms":"https://api.agentmercantile.com/llms.txt"}