MERCURY x402 Storefront API

REST/JSON API (OpenAPI 3.1.0, info.title "MERCURY x402 storefront", x-spec mercury-storefront/1) of 19 GET routes under /buy/*, one per Cited web-data service, each declaring its price in x-payment-info / x-x402 and answering an unpaid call with an HTTP 402 x402 challenge (accepts[] with scheme exact, network base, USDC asset 0x8335...2913, payTo and maxTimeoutSeconds 60). Paid results carry an attestation object (EIP-191 signature over sha256(text), url, status, fetchedAt, nonce) verifiable offline against /.well-known/mercury-attestation. /buy/signal is a free $0 demo read. The same routes accept Authorization: Bearer mk_test_/mk_live_ API keys issued at /developers. The spec declares no securitySchemes, no components and no examples; every operation has an operationId, summary, description, tags and 200/402 responses.

Operations 19

GET /buy/signal signal #
GET /buy/fetch MERCURY Verifiable Web Fetch #
GET /buy/extract Structured Data Extraction API — URL to typed JSON (schema extract, keyless x402) #
GET /buy/markdown MERCURY Cited Markdown #
GET /buy/metadata MERCURY Cited Metadata #
GET /buy/robots AI Crawler Permission Audit — signed robots.txt / llms.txt / ai.txt verdict (keyless x402) #
GET /buy/diff MERCURY Cited Diff — signed web-change proof (refetch + verifiable fromHash->toHash receipt) #
GET /buy/notarize MERCURY Cited Notarize #
GET /buy/headers MERCURY Cited Security-Headers Audit #
GET /buy/table Cited Table — HTML table → typed JSON rows + CSV, with signed provenance (keyless x402) #
GET /buy/feed MERCURY Cited Feed #
GET /buy/availability MERCURY Cited Availability Probe #
GET /buy/validate Cited Validate — JSON API response vs JSON Schema, signed pass/fail + per-field errors (keyless x402) #
GET /buy/batch MERCURY Cited Batch — signed multi-page snapshot (Merkle root over every page's contentHash + per-page proofs) #
GET /buy/sitemap MERCURY Cited Sitemap #
GET /buy/dns MERCURY Cited DNS Snapshot #
GET /buy/readability MERCURY Cited Readability #
GET /buy/redirect MERCURY Cited Redirect #

Documentation

Specifications

Other Resources

🔗
DeveloperPortal
https://network.mercury-hq.com/developers
🔗
Pricing
https://network.mercury-hq.com/pricing
🔗
Overlay
https://raw.githubusercontent.com/api-evangelist/mercury-hq-com/refs/heads/main/overlays/mercury-hq-com-x402-storefront-overlay.yaml
🔗
Conventions
https://raw.githubusercontent.com/api-evangelist/mercury-hq-com/refs/heads/main/conventions/mercury-hq-com-conventions.yml
🔗
ErrorCatalog
https://raw.githubusercontent.com/api-evangelist/mercury-hq-com/refs/heads/main/errors/mercury-hq-com-problem-types.yml
🔗
Lifecycle
https://raw.githubusercontent.com/api-evangelist/mercury-hq-com/refs/heads/main/lifecycle/mercury-hq-com-lifecycle.yml
🔗
Plans
https://raw.githubusercontent.com/api-evangelist/mercury-hq-com/refs/heads/main/plans/mercury-hq-com-plans-pricing.yml
🔗
Sandbox
https://raw.githubusercontent.com/api-evangelist/mercury-hq-com/refs/heads/main/sandbox/mercury-hq-com-sandbox.yml
🔗
DataModel
https://raw.githubusercontent.com/api-evangelist/mercury-hq-com/refs/heads/main/data-model/mercury-hq-com-data-model.yml
🔗
Conformance
https://raw.githubusercontent.com/api-evangelist/mercury-hq-com/refs/heads/main/conformance/mercury-hq-com-conformance.yml
🔗
AgentSkill
https://raw.githubusercontent.com/api-evangelist/mercury-hq-com/refs/heads/main/skills/_index.yml
🔗
AgenticAccess
https://raw.githubusercontent.com/api-evangelist/mercury-hq-com/refs/heads/main/agentic-access/mercury-hq-com-agentic-access.yml
🔗
APIsJSON
https://raw.githubusercontent.com/api-evangelist/mercury-hq-com/refs/heads/main/apis.yml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/mercury-x402-storefront-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

mercury-hq-com-x402-storefront-openapi.yml Raw ↑
openapi: 3.1.0
info:
  title: MERCURY x402 storefront
  version: '1'
  x-spec: mercury-storefront/1
  description: Agent-payable resources over HTTP 402 (x402). LIVE — Base mainnet, real USDC, no token. Only currently-deliverable routes are listed (web-fetch is the live paid SKU; mints are gated off). Free discovery at /.well-known/x402, /x402/discovery, /catalog, and /manifest.
servers:


# --- truncated at 32 KB (121 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/mercury-hq-com/refs/heads/main/openapi/mercury-hq-com-x402-storefront-openapi.yml