Bitcoin oracle (50 sats L402 or $0.05 USDC x402)
get_btc_oracleBTC price plus hash rate, mempool, difficulty, fees and block height — use this for a compact network snapshot. Price: 50 sats (Lightning) or $0.05 USDC on Base (x402). Sample (illustrative, not live): {"status":"success","endpoint":"btc_oracle","data":{"market":{"price_usd":97500.0,"price_eur":90120.5,"change_24h_percent":1.23,"stale":false},"on_chain":{"hash_rate_eh":750.0,"mempool_size_tx":15000,"difficulty":110000000000000.0,"block_height":920000},"fees":{"avg_fee_sat_vbyte":8,"fast_fee_sat_vbyte":14,"slow_fee_sat_vbyte":2}},"metadata":{"cost_sats":50}} Pay: Call it, get HTTP 402 (or MCP payment_required) with a Lightning invoice and macaroon, pay the invoice, then retry with Authorization: L402 <macaroon>:<preimage>. Or pay in USDC on Base via x402: sign the 402's x402 requirement (PAYMENT-REQUIRED header, or accepts in the JSON body) and retry with the PAYMENT-SIGNATURE (x402 v2) or X-PAYMENT (v1) header; only a 200 is settled.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "get_btc_oracle"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| x402_payment | No | Optional x402 payment (USDC on Base): base64 PaymentPayload (v2, or v1 X-PAYMENT format) signed for accepts[0] of this tool's payment_required result. Alternative to params._meta['x402/payment']. Omit both to receive the payment requirements. | |
| l402_credential | No | Optional L402 credential '<macaroon>:<preimage_hex>' (or 'L402 <macaroon>:<preimage>') from a paid invoice or an active subscription. Omit it to receive the Lightning invoice and macaroon. |