# ADH Bitcoin Stock-to-Flow (S2F) Intelligence Endpoint

> ADH Bitcoin Stock-to-Flow (S2F) Intelligence Endpoint 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 processed Bitcoin Stock-to-Flow ratio with circulating supply, annual issuance, historical S2F series, and a plain-language scarcity interpretation anchored to gold's S2F benchmark.

## Facts

- Endpoint: GET https://agentdatum.com/api/v1/d/processed-s2f
- 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-stock-to-flow-s2f-intelligence-endpoint-dc7782fb
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_mQbnrcNqe9ljeuXzOggdK

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-stock-to-flow-s2f-intelligence-endpoint-dc7782fb
```

Example prompt: What is Bitcoin's current Stock-to-Flow ratio and how does it compare to gold's scarcity level — give me the interpreted number with circulating supply and annual issuance breakdown?

## When to prefer this

Choose this endpoint when you need a pre-computed, interpreted Bitcoin Stock-to-Flow ratio with source attribution and a historical series, rather than computing it yourself from raw supply APIs. It is especially useful when you want the scarcity metric contextualized against gold's S2F benchmark in a single API call, and when your agent supports x402 micropayment settlement at $0.01 USDC per call.

## Known failure modes

- Payment not settled via x402 — returns 402 Payment Required before data is served
- CoinGecko upstream data unavailable — may return stale or delayed snapshot (delay_days field indicates lag)
- Malformed request with unsupported HTTP method — only GET/HEAD/DELETE accepted
- Network timeout on upstream data fetch — transient 5xx error possible

## How this service works

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

## Output

Returns a JSON object containing: current S2F ratio (e.g. 122.18), circulating supply, annual issuance, data date and delay in days, a historical time-series of S2F values, data source attribution (CoinGecko-derived), and a Chinese-language plain-English interpretation comparing BTC's S2F to gold's (~60), explaining what the ratio implies for scarcity.

## 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": {
  "source": "自算(CoinGecko)",
  "history": [
   {
    "s2f": 122.18,
    "date": "2026-07-28"
   },
   {
    "s2f": 122.18,
    "date": "2026-07-28"
   }
  ],
  "product": "processed-s2f",
  "snapshot": {
   "s2f": 122.18,
   "note": "自算: S2F=流通量/年产量; 黄金S2F≈60, BTC当前远高于黄金(稀缺性锚)",
   "data_date": "2026-08-09",
   "delay_days": 1,
   "annual_issued": 164250,
   "circulating_supply": 20067943
  },
  "data_type": "valuation",
  "collected_at": "2026-08-09T17:35:01Z",
  "interpretation": "BTC Stock-to-Flow = 122.2（流通量 20.1M / 年产量 0.16M）。黄金S2F≈60，BTC当前S2F远高于黄金，稀缺性极强。S2F越高代表新增供应相对存量越小、越稀缺。"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/adh-bitcoin-stock-to-flow-s2f-intelligence-endpoint-dc7782fb/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)