{"schemaVersion":"2026-04-27","name":"Satoshi API x402 Facilitator Lab","description":"Stable x402 proof origin for discovering and testing paid HTTP endpoints, payable MCP tools, and facilitator settlement metadata.","canonicalUrl":"https://x402.bitcoinsapi.com/x402-facilitator","generatedAt":"2026-04-28T15:10:21.518Z","keywords":["x402","HTTP 402","paid API","agent payments","facilitator","MCP","Bitcoin merchant payout","Base Sepolia","USDC"],"origins":{"http":"https://x402.bitcoinsapi.com","mcp":"https://mcp.bitcoinsapi.com"},"discoveryDocuments":{"openapi":"https://x402.bitcoinsapi.com/openapi.json","openapiWellKnownAlias":"https://x402.bitcoinsapi.com/.well-known/openapi.json","x402":"https://x402.bitcoinsapi.com/.well-known/x402","x402JsonAlias":"https://x402.bitcoinsapi.com/.well-known/x402.json","catalog":"https://x402.bitcoinsapi.com/x402-facilitator/catalog.json","testerKit":"https://x402.bitcoinsapi.com/x402-facilitator/tester.json","discoveryManifest":"https://x402.bitcoinsapi.com/x402-facilitator/discovery.json","llmsTxt":"https://x402.bitcoinsapi.com/llms.txt","sitemap":"https://x402.bitcoinsapi.com/sitemap.xml","robotsTxt":"https://x402.bitcoinsapi.com/robots.txt"},"paidResources":[{"method":"GET","path":"/merchant-payout-plan","url":"https://x402.bitcoinsapi.com/merchant-payout-plan","title":"Bitcoin merchant payout plan","priceUsd":"0.003","description":"Returns a batch payout fee-band and timing plan for a merchant payout run.","audience":"Bitcoin merchants, payment agents, API sellers","docsUrl":"https://x402.bitcoinsapi.com/x402-facilitator"},{"method":"GET","path":"/weather","url":"https://x402.bitcoinsapi.com/weather","title":"Minimal paid HTTP proof","priceUsd":"0.001","description":"Small paid JSON route used to verify the complete 402 challenge, payment, settle, and receipt flow.","audience":"x402 implementers","docsUrl":"https://x402.bitcoinsapi.com/x402-facilitator"}],"freeResources":[{"method":"GET","path":"/x402-facilitator/catalog.json","url":"https://x402.bitcoinsapi.com/x402-facilitator/catalog.json","title":"Public endpoint catalog","description":"Machine-readable surface with endpoint metadata, conventional launch channels, and proof targets."},{"method":"GET","path":"/x402-facilitator/tester.json","url":"https://x402.bitcoinsapi.com/x402-facilitator/tester.json","title":"External tester kit","description":"Single JSON handoff with the no-wallet 402 check, cheapest paid HTTP route, merchant paid route, and MCP health check."}],"mcp":{"origin":"https://mcp.bitcoinsapi.com","status":"https://mcp.bitcoinsapi.com/status","tools":[{"name":"get_current_fee_snapshot","access":"free","proof":"Entry point for agents that need a no-payment first call."},{"name":"plan_merchant_payout_batch","access":"paid once, then SIWX reuse for the same tool scope","proof":"Proves paid MCP monetization without making every reconnect repay."},{"name":"plan_expedited_payout_batch","access":"separate paid scope","proof":"Proves route/tool-specific access instead of account-global unlocks."}]},"verification":{"network":"eip155:84532","payTo":"0x2eDbF699657ae1A09D9C3833FD162A6b59344364","facilitator":"https://api.cdp.coinbase.com/platform/v2/x402","knownGoodHttpSettlementTx":"0x30ff7b33ec19dff3d77373794584b40315ce497942bfe6f2b064a28e7d56e7d5","knownGoodMcpSettlementTx":"0x27f2db0c850823bf1e6c4f35a589106e00f39cc96a5ecf68e9a164184c3d79f1"},"quickstart":[{"name":"Discover paid HTTP routes","purpose":"Proves the OpenAPI/agent-discovery surface is parseable.","command":"npx agentcash@latest discover https://x402.bitcoinsapi.com --format json","expected":"success: true with paid /weather and /merchant-payout-plan endpoints"},{"name":"No-wallet 402 challenge","purpose":"Checks payment metadata without spending anything.","command":"curl -i \"https://x402.bitcoinsapi.com/weather\"","expected":"HTTP 402 with a PAYMENT-REQUIRED header"},{"name":"Lowest-friction paid HTTP call","purpose":"Creates the cheapest external paid usage signal.","command":"npx agentcash@latest fetch \"https://x402.bitcoinsapi.com/weather\"","expected":"HTTP 200 paid JSON response after a $0.001 Base Sepolia x402 payment"},{"name":"Merchant paid HTTP call","purpose":"Tests the strongest Bitcoin merchant payout use case.","command":"npx agentcash@latest fetch \"https://x402.bitcoinsapi.com/merchant-payout-plan?batchSize=24\u0026targetBlocks=3\u0026urgency=balanced\"","expected":"HTTP 200 merchant payout plan after a $0.003 Base Sepolia x402 payment"},{"name":"MCP health check","purpose":"Verifies the public MCP surface is live before any paid tool call.","command":"curl https://mcp.bitcoinsapi.com/status","expected":"ok: true with plan_merchant_payout_batch and plan_expedited_payout_batch tools"}],"caveats":["The production mainnet surface is https://bitcoinsapi.com/x402; this proof origin is Base Sepolia.","On this Windows host, AgentCash discovery can print successful JSON and then exit nonzero with a libuv assertion.","CDP search and merchant discovery contain the proof origin; CDP resources visibility can lag behind them."]}