Fresh Bitcoin price (30 sats L402 or $0.025 USDC x402)
get_btc_price_freshFresh BTC spot in USD/EUR with 24h change, cached at most 10 seconds — use this instead of btc_price when you need a tighter quote (btc_price is 10 sats and cached 60 seconds). Upstream gold-api.com typically prints about every 30 seconds; this tier returns the latest print within 10 seconds of it landing. Price: 30 sats (Lightning) or $0.025 USDC on Base (x402). Sample (illustrative, not live): {"status":"success","endpoint":"btc_price_fresh","data":{"price_usd":97500.0,"price_eur":90120.5,"change_24h_percent":1.23,"source":"gold-api.com","stale":false,"age_seconds":4.2,"timestamp":"2026-11-16T18:00:00Z"},"metadata":{"cost_sats":30}} 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_price_fresh"
}
}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. |