{"uid":"cap_mQbnrcNqe9ljeuXzOggdK","slug":"adh-bitcoin-stock-to-flow-s2f-intelligence-endpoint-dc7782fb","name":"ADH Bitcoin Stock-to-Flow (S2F) Intelligence Endpoint","description":"ADH 金融情报层：把 239 个原始数据源洗成带实体解析、时间同步、溯源与派生结论的情报（宏观regime / 加密尽调 / 事件窗口），免费注入你的 AI 上下文。Agent 走 x402 结算，人类订阅（PayPal）即将上线。","url":"https://agentdatum.com/api/v1/d/processed-s2f","method":"GET","headers":{},"bodySchema":{"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"}}}}},"responseSchema":{"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越高代表新增供应相对存量越小、越稀缺。"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_2_uPp80oHq4LxAOQkOP5v","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"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.","exampleAgentPrompt":"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?","exampleUseCases":[{"title":"Bitcoin scarcity signal for portfolio model","prompt":"Pull the latest Bitcoin Stock-to-Flow ratio with the circulating supply and annual issuance figures — I want to know how BTC's scarcity compares to gold right now and what the interpretation is."},{"title":"Crypto research report enrichment","prompt":"I'm writing a BTC valuation report — can you fetch the processed S2F data including the historical series and the plain-language scarcity interpretation so I can include it in the analysis section?"},{"title":"Automated macro regime dashboard","prompt":"For my daily crypto dashboard, grab the current Bitcoin S2F snapshot with the data date and delay so I can display whether BTC's scarcity metric is above or below gold's S2F of 60."}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T01:07:12.801Z","isFirstParty":false}