MERCURY
MercuryDeveloper Portal

Developer Portal

The agent-payable network — two rails into the same signed-receipt API.

Two ways to pay — pick your rail

Keyless (x402): your agent brings a Base wallet + USDC and pays per call over HTTP 402 — real USDC on Base mainnet (eip155:8453) via the CDP facilitator. No key, no signup. llms.txt

API key (this portal): no wallet — mint a Mercury key and call the same /buy/* routes with the same signed provenance receipts. Free sandbox below; paid tiers + credit top-up for production.

1 · Get a free test key

One click, no wallet, no card. A capped free quota (100 credits) to evaluate the whole API. The raw key is shown ONCE — only its sha256 + a 4-char tail are stored.

2 · Use it

Send it as a bearer token on any /buy/* route — same endpoints, same signed receipts as the wallet rail. Each call costs its catalog price in credits (1 credit = $0.001, min 1 — e.g. a $0.005 SKU costs 5 credits).

bash
curl -H "Authorization: Bearer mk_test_YOUR_KEY" \
  "https://mercury-x402-jed.fly.dev/buy/fetch?url=https://example.com"

JavaScript:

javascript
const r = await fetch("https://mercury-x402-jed.fly.dev/buy/fetch?url=https://example.com", {
  headers: { Authorization: "Bearer " + process.env.MERCURY_API_KEY }
});
console.log(await r.json()); // clean text + a signed provenance receipt

3 · Check your balance

Go production — tiers and top-up

Subscribe a tier at /pricing (live Stripe Checkout — the webhook flips your key and grants its included credits, refreshed on every paid renewal invoice), or top a live key up with a one-time credit pack: POST /api/dev/topup?key=mk_live_…&usd=10 → a Stripe Checkout URL; on payment the credits land on your key.

Honest by design. Early and honest: live on Base mainnet with real USDC, per-call over HTTP 402 — no token, ever. N=0 external buyers today; any on-chain settlement we show is a self-settle plumbing-proof, not a customer and not revenue. The in-game currency and mint stay on testnet on purpose. Verify everything yourself at /trust.