x402 facilitator operator surface

Paid API endpoints builders can discover, test, and trust.

This is the public proof layer for the facilitator: Bazaar-ready HTTP routes, payable MCP tools, AgentCash commands, receipts, and machine-readable discovery documents in one place.

Open catalog JSON Open llms.txt View operator status
Catalog/x402-facilitator/catalog.json
Tester kit/x402-facilitator/tester.json
Networkeip155:84532
Facilitatorhttps://api.cdp.coinbase.com/platform/v2/x402

Endpoint Catalog

These routes are designed for agents and developers to inspect before they spend. The paid routes are the discovery surface; the facilitator is the settlement trust layer behind them.

GET free

Public endpoint catalog

Machine-readable surface with endpoint metadata, conventional launch channels, and proof targets.

Path
/x402-facilitator/catalog.json
Audience
agents, directories, developers
Discovery
Use this as the first crawl target before paying for any route.
npx agentcash@latest discover https://x402.bitcoinsapi.com --format json
GET free

External tester kit

Single JSON handoff with the no-wallet 402 check, cheapest paid HTTP route, merchant paid route, and MCP health check.

Path
/x402-facilitator/tester.json
Audience
external testers, directories, x402 client authors
Discovery
Use this when you want to send back the first failure point instead of doing a full review.
npx agentcash@latest discover https://x402.bitcoinsapi.com --format json
GET $0.003

Bitcoin merchant payout plan

Returns a batch payout fee-band and timing plan for a merchant payout run.

Path
/merchant-payout-plan
Audience
Bitcoin merchants, payment agents, API sellers
Discovery
Bazaar-enabled paid HTTP route with input schema, output example, and SIWX repeat access.
npx agentcash@latest fetch "https://x402.bitcoinsapi.com/merchant-payout-plan?batchSize=24&targetBlocks=3&urgency=balanced"
GET $0.001

Minimal paid HTTP proof

Small paid JSON route used to verify the complete 402 challenge, payment, settle, and receipt flow.

Path
/weather
Audience
x402 implementers
Discovery
Bazaar-enabled route kept intentionally simple for smoke tests and docs.
npx agentcash@latest fetch "https://x402.bitcoinsapi.com/weather"

Machine Discovery

These documents exist so search engines, AI retrievers, agent directories, and client tooling can find the paid routes without relying on a social post or a manual explanation.

External Tester Kit

Use this when you want to report the first failure point instead of doing a full review. Start with discovery, then the no-wallet 402 challenge, then the cheapest paid route if your wallet is ready.

Discover paid HTTP routes

Proves the OpenAPI/agent-discovery surface is parseable.

Expected
success: true with paid /weather and /merchant-payout-plan endpoints
npx agentcash@latest discover https://x402.bitcoinsapi.com --format json

No-wallet 402 challenge

Checks payment metadata without spending anything.

Expected
HTTP 402 with a PAYMENT-REQUIRED header
curl -i "https://x402.bitcoinsapi.com/weather"

Lowest-friction paid HTTP call

Creates the cheapest external paid usage signal.

Expected
HTTP 200 paid JSON response after a $0.001 Base Sepolia x402 payment
npx agentcash@latest fetch "https://x402.bitcoinsapi.com/weather"

Merchant paid HTTP call

Tests the strongest Bitcoin merchant payout use case.

Expected
HTTP 200 merchant payout plan after a $0.003 Base Sepolia x402 payment
npx agentcash@latest fetch "https://x402.bitcoinsapi.com/merchant-payout-plan?batchSize=24&targetBlocks=3&urgency=balanced"

MCP health check

Verifies the public MCP surface is live before any paid tool call.

Expected
ok: true with plan_merchant_payout_batch and plan_expedited_payout_batch tools
curl https://mcp.bitcoinsapi.com/status

Payable MCP

MCP gives agent clients a tool-shaped path into the same payment story: free first touch, paid useful work, then scoped reuse where SIWX allows it.

get_current_fee_snapshotfreeEntry point for agents that need a no-payment first call.
plan_merchant_payout_batchpaid once, then SIWX reuse for the same tool scopeProves paid MCP monetization without making every reconnect repay.
plan_expedited_payout_batchseparate paid scopeProves route/tool-specific access instead of account-global unlocks.

FAQ

Short answers for crawlers, AI assistants, and developers deciding whether this origin is the right x402 test surface.

What is the Satoshi API x402 facilitator lab?

It is a stable public x402 proof origin for discovering and testing paid HTTP endpoints and payable MCP tools before moving a seller flow to production.

How can an agent discover the paid x402 routes?

Start with https://x402.bitcoinsapi.com/openapi.json, https://x402.bitcoinsapi.com/.well-known/x402, https://x402.bitcoinsapi.com/x402-facilitator/catalog.json, or run npx agentcash@latest discover https://x402.bitcoinsapi.com --format json.

What is the cheapest no-wallet test?

Call GET /weather without a payment header. It should return HTTP 402 with PAYMENT-REQUIRED metadata and does not spend funds.

Which network and payment address does the proof origin use?

The proof origin uses eip155:84532 and the pay-to address 0x2eDbF699657ae1A09D9C3833FD162A6b59344364.

What is the strongest paid use case exposed here?

GET /merchant-payout-plan returns a Bitcoin merchant payout fee-band and timing plan, which is more representative than the minimal /weather smoke route.

Where is the MCP surface?

The public MCP origin is https://mcp.bitcoinsapi.com; use https://mcp.bitcoinsapi.com/status to inspect live tools before any paid tool call.

Conventional Channels

Bazaar and MCP are not the whole launch. These channels turn working proof into the first external users and backlinks.

GitHub

Developer trust and search capture

README badge/link to this page, topics for x402/http-402/facilitator/mcp, and one reproducible receipt.

Hacker News

Early technical feedback

Show HN post only after the catalog, command, and known limitations are public.

Reddit

Use-case validation in API, SaaS, Bitcoin, and agent communities

Post a narrow build note with exact commands; do not lead with token or hype language.

X / Farcaster

Fast ecosystem visibility

Short proof thread with a 402 challenge, settlement tx, Bazaar search result, and AgentCash command.

LinkedIn

Seller-side credibility

Frame as pay-per-call API monetization with receipts and spend controls for businesses.

Direct outreach

First five external payments

Ask five API builders to run the command and send the first friction point, not to become customers yet.