# Bitcoin Mining Economics API

> Bitcoin Mining Economics API is a paid API for AI agents from api.carbon-cashmere.de, paid per call via x402, $0.05/call, status unknown (last checked 2026-09-14).

Returns real-time Bitcoin mining profitability metrics including hashprice, block reward breakdown, difficulty-adjusted hashrate, and configurable profit margin based on ASIC efficiency and electricity cost.

## Facts

- Endpoint: GET https://api.carbon-cashmere.de/v1/btc-derivatives/mining-economics
- Price: $0.05/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/bitcoin-mining-economics-api-65137a85
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_pMeXbZgGGmVvfkip5XkUT

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 bitcoin-mining-economics-api-65137a85
```

Example prompt: What's the current Bitcoin hashprice and profit margin for a miner running at 22 W/TH with electricity at $0.07 per kWh — including the breakeven BTC price?

## When to prefer this

Choose this endpoint when you need real-time, full-node-verified Bitcoin mining economics with configurable ASIC efficiency and electricity cost parameters. It is especially useful when you need accurate fee revenue data (measured from actual 24h blocks, not estimates), difficulty-cross-checked hashrate, and a combined profit margin and breakeven price in a single call — rather than assembling these from multiple generic crypto data APIs.

## Known failure modes

- Invalid watts_per_th value outside 5–100 range returns 422 validation error
- Invalid electricity_cost_kwh outside 0–1 range returns 422 validation error
- Payment not provided or invalid returns 402 Payment Required
- Full node temporarily unreachable may return 503 or stale data
- Rate limiting may return 429 if called too frequently

## How this service works

Bitcoin mining economics from our own full node: hashprice (sats + USD per TH/s/day), subsidy plus measured 24h fee revenue per block, difficulty-cross-checked hashrate, configurable ASIC efficiency and electricity cost, profit margin and breakeven price. Informational research data — not investment advice.

## Output

Returns a JSON object with network state (hashrate, difficulty), block reward breakdown (subsidy + 24h average fee revenue), miner economics per TH/s (hashprice in sats and USD, profit margin), breakeven BTC price, and data freshness metadata — all computed from a live Bitcoin full node.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [],
     "properties": {
      "watts_per_th": {
       "type": "number",
       "maximum": 100,
       "minimum": 5,
       "description": "ASIC efficiency in W per TH/s (default 20)"
      },
      "electricity_cost_kwh": {
       "type": "number",
       "maximum": 1,
       "minimum": 0,
       "description": "Electricity cost in USD per kWh (default 0.08)"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "properties": {
      "breakeven": {
       "type": "object"
      },
      "freshness": {
       "type": "object"
      },
      "block_reward": {
       "type": "object"
      },
      "network_state": {
       "type": "object"
      },
      "miner_economics_per_thash": {
       "type": "object"
      }
     }
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/bitcoin-mining-economics-api-65137a85/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.carbon-cashmere.de](https://www.zero.xyz/host/api.carbon-cashmere.de/llms.txt)