{"uid":"cap_8bWRm3qiOVGeeRnn48_KI","slug":"glassnode-bitcoin-stock-to-flow-ratio-98733963","name":"Glassnode Bitcoin Stock-to-Flow Ratio","description":"Stock-to-Flow Ratio — Stock-to-Flow (S/F) Ratio is a scarcity-based valuation model defined as the ratio of the current stock of a commodity (the circulating Bitcoin supply) to the flow of new production (newly mined bitcoins). The model assumes that scarcity drives value, and Bitcoin's price has historically followed the S/F Ratio, so it can be used to predict future Bitcoin valuations. Data by Glassnode.","url":"https://x402.glassnode.com/v1/metrics/indicators/stock_to_flow_ratio","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"],"type":"string"},"queryParams":{"type":"object","required":["a"],"properties":{"a":{"enum":["BTC"],"type":"string","description":"Asset symbol, e.g. BTC, ETH"},"c":{"enum":["native"],"type":"string","description":"Currency for denominated values, e.g. usd, native"},"f":{"enum":["csv","json"],"type":"string","description":"Response format: json or csv"},"i":{"enum":["24h"],"type":"string","description":"Time interval / resolution, e.g. 24h, 1w, 1month"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"array","items":{"type":"object","properties":{"o":{"type":"object"},"t":{"type":"number"}}}}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.05","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.05/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_f9m9iJTnINpY_W4NrOw-q","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.05","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns daily Bitcoin Stock-to-Flow (S/F) ratio time series data — a scarcity-based valuation metric comparing circulating BTC supply to newly mined supply.","exampleAgentPrompt":"Pull the latest Bitcoin Stock-to-Flow ratio data from Glassnode — I want the daily BTC values in JSON format to see where the scarcity model stands right now.","exampleUseCases":null,"resultDescription":"Returns an array of timestamped objects, each containing a Unix timestamp (t) and an object (o) with the stock-to-flow ratio value for Bitcoin at that point in time, at daily resolution.","failureModes":["Missing required 'a' query parameter (asset) returns a 400 error","Invalid asset symbol (anything other than BTC) returns an error due to enum constraint","Payment not included or insufficient USDC triggers 402 Payment Required","Network or upstream Glassnode data unavailability causes 5xx errors","Requesting an unsupported interval or format returns a validation error"],"whenToPreferThis":"Use this endpoint when you need Bitcoin-specific stock-to-flow ratio data backed by Glassnode's institutional-grade on-chain data. Prefer this over generic crypto price APIs when the task involves scarcity modeling, long-term valuation analysis, or comparing BTC price performance against the S/F model. Ideal for macro Bitcoin research, investment signal generation, or charting scarcity-driven price predictions.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T06:53:57.281Z","isFirstParty":false}