# Satoshi API - Bitcoin Payment Health Check

> Satoshi API - Bitcoin Payment Health Check is a paid API for AI agents from bitcoinsapi.com, paid per call via x402, $0.02/call, status unknown (last checked 2026-09-14).

Returns live Bitcoin fee recommendations, mempool health status, and cost estimates to help apps and AI agents decide when to send Bitcoin transactions.

## Facts

- Endpoint: POST https://bitcoinsapi.com/api/v1/x402/bitcoin-payment-health
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/satoshi-api-bitcoin-payment-health-check-11493d0d
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_6r3aqYXxV8k_02a9uN8MC

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability satoshi-api-bitcoin-payment-health-check-11493d0d -d '<json body>'
```

Example prompt: Check the current Bitcoin network health and tell me whether now is a good time to send a payment, or if I should wait for lower fees.

## When to prefer this

Choose this endpoint when an AI agent or application needs a real-time, opinionated recommendation on Bitcoin transaction timing — not just raw fee data. It is especially useful when you want a pre-interpreted 'proceed or wait' signal rather than raw mempool numbers, and when you need a lightweight $0.02 per-call cost model with no subscription required.

## Known failure modes

- Missing or invalid authentication/payment header returns 402 or 401
- Bitcoin node data unavailable results in degraded health status
- Network timeout on mempool data fetch returns error status
- Malformed request body returns 400 bad request
- Service downtime returns 503

## How this service works

Know when to send Bitcoin and when to wait. Satoshi API gives apps and AI agents live fee recommendations, mempool context, and cost estimates. Free, open source.

## Output

Returns a JSON object with a health status object (e.g. {status: 'ok'}), a human-readable briefing string describing current Bitcoin payment health, an agent_action object with a recommendation on whether to proceed or wait, a paid_resources object with resource count, and the price paid ($0.02 USDC).

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "properties": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "schema": {
  "type": "object",
  "required": [
   "briefing",
   "health",
   "paid_resources"
  ],
  "properties": {
   "health": {
    "type": "object"
   },
   "briefing": {
    "type": "string"
   },
   "agent_action": {
    "type": "object"
   },
   "paid_resources": {
    "type": "object"
   }
  }
 },
 "example": {
  "health": {
   "status": "ok"
  },
  "briefing": "Satoshi x402 Bitcoin payment health",
  "paid_resources": {
   "count": 14
  },
  "x402_price_usd": "$0.02"
 },
 "mimeType": "application/json"
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/satoshi-api-bitcoin-payment-health-check-11493d0d/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from bitcoinsapi.com](https://www.zero.xyz/host/bitcoinsapi.com/llms.txt)