# Satoshi API - Bitcoin Fee Intelligence (Current Fees)

> Satoshi API - Bitcoin Fee Intelligence (Current Fees) is a paid API for AI agents from bitcoinsapi.com, paid per call via x402, $0.001/call, status unknown (last checked 2026-10-11).

Returns live Bitcoin fee recommendations, mempool pressure, and cost estimates to help apps and agents decide whether to send now or wait

## Facts

- Endpoint: POST https://bitcoinsapi.com/api/v1/fees/now?utm_source=zero.xyz
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-11
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/satoshi-api-bitcoin-fee-intelligence-current-fees-4b1b5e4a
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_OWZ31u_ZXOOgsGszqU9sB

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-fee-intelligence-current-fees-4b1b5e4a -d '<json body>'
```

Example prompt: Should I send my Bitcoin payment right now, or is the mempool too congested? Give me a current fee recommendation with the fastest, half-hour, and economy sat/vB rates.

## When to prefer this

Choose this endpoint when an app or AI agent needs a real-time, opinionated send-or-wait verdict for Bitcoin transactions, especially when automating payment flows that should pause during high-fee periods. It is ideal over raw mempool data sources when you need a pre-digested recommendation rather than raw block data, and when cost is a concern ($0.001 USDC per call).

## Known failure modes

- Payment required (402) if x402 micropayment header is missing or invalid
- Stale or unavailable mempool data if Bitcoin node connection is disrupted
- Unexpected schema response if upstream fee estimation source changes
- Rate limiting or timeout if mempool is queried during high network load

## 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

A JSON object containing: a 'recommendation' field with a send-or-wait verdict, 'mempool_pressure' level (e.g. low/medium/high), 'fastest_fee_sat_vb' for next-block confirmation, 'half_hour_fee_sat_vb', 'hour_fee_sat_vb', 'economy_fee_sat_vb' for slow/cheap confirmation, a human-readable 'summary' string, and a 'source' field indicating data origin.

## Request schema (JSON Schema)

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

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "schema": {
  "type": "object",
  "required": [
   "recommendation",
   "mempool_pressure",
   "fastest_fee_sat_vb",
   "summary"
  ],
  "properties": {
   "source": {
    "type": "string"
   },
   "summary": {
    "type": "string"
   },
   "recommendation": {
    "type": "string",
    "description": "Send-or-wait verdict for the current Bitcoin fee market."
   },
   "hour_fee_sat_vb": {
    "type": "number"
   },
   "mempool_pressure": {
    "type": "string"
   },
   "economy_fee_sat_vb": {
    "type": "number"
   },
   "fastest_fee_sat_vb": {
    "type": "number"
   },
   "half_hour_fee_sat_vb": {
    "type": "number"
   }
  }
 },
 "example": {
  "source": "bitcoin-core-estimates",
  "summary": "Bitcoin fees look usable now at 12 sat/vB; use about 5 sat/vB if you can wait an hour.",
  "recommendation": "send",
  "hour_fee_sat_vb": 5,
  "mempool_pressure": "medium",
  "economy_fee_sat_vb": 3,
  "fastest_fee_sat_vb": 12,
  "half_hour_fee_sat_vb": 8
 },
 "mimeType": "application/json"
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/satoshi-api-bitcoin-fee-intelligence-current-fees-4b1b5e4a/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)