# ADH Bitcoin On-Chain Intelligence — agentdatum.com

> ADH Bitcoin On-Chain Intelligence — agentdatum.com is a paid API for AI agents from agentdatum.com, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-15).

Returns cleaned, sourced Bitcoin on-chain metrics (nodes, blocks, difficulty, mempool, price, blockchain size) aggregated from multiple raw data sources.

## Facts

- Endpoint: GET https://agentdatum.com/api/v1/d/btc-onchain
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/adh-bitcoin-on-chain-intelligence-agentdatum-com-6d08ba2f
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_8bIOlX4LpHyHS0_tH7MJf

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 adh-bitcoin-on-chain-intelligence-agentdatum-com-6d08ba2f
```

Example prompt: Pull the latest Bitcoin on-chain stats for me — I need current block height, mempool size, 24-hour transaction count, mining difficulty, and the BTC price, all with source attribution and timestamp.

## When to prefer this

Choose this endpoint when you need a single, pre-aggregated, sourced snapshot of core Bitcoin on-chain metrics without building your own multi-source pipeline. Ideal for AI agents that need timestamped, provenance-tagged BTC network data at low cost ($0.01 USDC per call) via x402 micropayment — especially useful for trading bots, research dashboards, or monitoring workflows that need clean data rather than raw blockchain API responses.

## Known failure modes

- Payment not received or x402 settlement fails — endpoint returns 402 Payment Required
- Upstream Blockchair data source unavailable — may return stale or error response
- Network timeout — no response within expected fast-latency window
- Malformed request — non-GET method returns error

## How this service works

ADH 金融情报层：把 239 个原始数据源洗成带实体解析、时间同步、溯源与派生结论的情报（宏观regime / 加密尽调 / 事件窗口），免费注入你的 AI 上下文。Agent 走 x402 结算，人类订阅（PayPal）即将上线。

## Output

A JSON object containing raw Bitcoin on-chain metrics: total nodes, latest block height, blocks produced in the last 24h, current mining difficulty, BTC market price in USD, 24h transaction count, best block height, mempool transaction count, 24h price change percentage, and blockchain size in bytes. Also includes source identifier ('blockchair_btc'), data type label, and an ISO 8601 collection timestamp for provenance.

## 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": {}
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "raw": {
   "nodes": 299,
   "blocks": 961760,
   "blocks_24h": 141,
   "difficulty": 127479855693691.4,
   "market_price_usd": 65162,
   "transactions_24h": 718124,
   "best_block_height": 961759,
   "mempool_transactions": 4026,
   "price_change_24h_pct": 0.2,
   "blockchain_size_bytes": 760341235155
  },
  "source": "blockchair_btc",
  "data_type": "区块链",
  "collected_at": "2026-08-09T18:17:47Z"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/adh-bitcoin-on-chain-intelligence-agentdatum-com-6d08ba2f/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agentdatum.com](https://www.zero.xyz/host/agentdatum.com/llms.txt)
