{"uid":"cap_KAeiCLEswZBklr4M9YKF7","slug":"api-carbon-cashmere-de-5ab7430a","name":"Bitcoin Ordinals & OP_RETURN Flow Analytics","description":"Hourly Bitcoin Ordinals inscriptions + OP_RETURN byte volume. Inscriptions detected via witness-envelope magic bytes (c\u0003ord). Window up to 7d.","url":"https://api.carbon-cashmere.de/v1/btc-derivatives/ordinals-flow","method":"GET","headers":{},"bodySchema":{"type":"object","properties":{"properties":{"type":"string"}}},"responseSchema":{"type":"json","example":{"window":"24h","buckets":[{"hour":"2026-05-17T14:00+00:00","inscriptions":1247,"op_return_bytes":142880,"op_return_count":8821}],"summary":{"total_inscriptions":31840,"avg_inscriptions_per_block":221}}},"example":{"request":{"input":{"type":"http","method":"GET","queryParams":{}}},"response":{"method":"witness_envelope_scan + scriptpubkey_opreturn_count","window":"24h","buckets":[{"hour":"2026-05-24T04:00:00+00:00","blocks":4,"inscriptions":381,"op_return_bytes":285272,"op_return_count":14640},{"hour":"2026-05-24T05:00:00+00:00","blocks":7,"inscriptions":555,"op_return_bytes":513387,"op_return_count":26541},{"hour":"2026-05-24T06:00:00+00:00","blocks":3,"inscriptions":297,"op_return_bytes":179745,"op_return_count":9219},{"hour":"2026-05-24T07:00:00+00:00","blocks":5,"inscriptions":233,"op_return_bytes":305578,"op_return_count":15720},{"hour":"2026-05-24T08:00:00+00:00","blocks":5,"inscriptions":494,"op_return_bytes":262937,"op_return_count":13332},{"hour":"2026-05-24T09:00:00+00:00","blocks":7,"inscriptions":310,"op_return_bytes":595653,"op_return_count":30804},{"hour":"2026-05-24T10:00:00+00:00","blocks":4,"inscriptions":869,"op_return_bytes":171412,"op_return_count":8567},{"hour":"2026-05-24T11:00:00+00:00","blocks":6,"inscriptions":416,"op_return_bytes":438446,"op_return_count":22398},{"hour":"2026-05-24T12:00:00+00:00","blocks":4,"inscriptions":163,"op_return_bytes":159265,"op_return_count":7854},{"hour":"2026-05-24T13:00:00+00:00","blocks":5,"inscriptions":939,"op_return_bytes":259571,"op_return_count":13035},{"hour":"2026-05-24T14:00:00+00:00","blocks":2,"inscriptions":35,"op_return_bytes":41154,"op_return_count":1977},{"hour":"2026-05-24T15:00:00+00:00","blocks":3,"inscriptions":217,"op_return_bytes":83379,"op_return_count":3952},{"hour":"2026-05-24T16:00:00+00:00","blocks":2,"inscriptions":29,"op_return_bytes":50802,"op_return_count":2454},{"hour":"2026-05-24T17:00:00+00:00","blocks":12,"inscriptions":1031,"op_return_bytes":855021,"op_return_count":43834},{"hour":"2026-05-24T18:00:00+00:00","blocks":7,"inscriptions":163,"op_return_bytes":391146,"op_return_count":19779},{"hour":"2026-05-24T19:00:00+00:00","blocks":10,"inscriptions":148,"op_return_bytes":986068,"op_return_count":51165},{"hour":"2026-05-24T20:00:00+00:00","blocks":3,"inscriptions":14,"op_return_bytes":97071,"op_return_count":4828},{"hour":"2026-05-24T21:00:00+00:00","blocks":3,"inscriptions":87,"op_return_bytes":82376,"op_return_count":4040},{"hour":"2026-05-24T22:00:00+00:00","blocks":10,"inscriptions":212,"op_return_bytes":623822,"op_return_count":32054},{"hour":"2026-05-24T23:00:00+00:00","blocks":10,"inscriptions":172,"op_return_bytes":820386,"op_return_count":42614},{"hour":"2026-05-25T00:00:00+00:00","blocks":5,"inscriptions":159,"op_return_bytes":351052,"op_return_count":18106},{"hour":"2026-05-25T01:00:00+00:00","blocks":5,"inscriptions":306,"op_return_bytes":339696,"op_return_count":17392},{"hour":"2026-05-25T02:00:00+00:00","blocks":9,"inscriptions":241,"op_return_bytes":929155,"op_return_count":48383},{"hour":"2026-05-25T03:00:00+00:00","blocks":4,"inscriptions":650,"op_return_bytes":220441,"op_return_count":11267},{"hour":"2026-05-25T04:00:00+00:00","blocks":5,"inscriptions":369,"op_return_bytes":362590,"op_return_count":18769}],"summary":{"blocks":140,"total_inscriptions":8490,"total_op_return_count":482724,"avg_inscriptions_per_block":60.6}}},"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","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.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_vgEtS5HSxD6dT3Mirpna7","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns hourly bucketed counts of Bitcoin Ordinals inscriptions (detected via witness-envelope magic bytes) and OP_RETURN byte volume over a configurable window up to 7 days.","exampleAgentPrompt":"Show me the hourly Bitcoin Ordinals inscription counts and OP_RETURN byte volume for the last 24 hours so I can see how active on-chain inscription activity has been today.","exampleUseCases":null,"resultDescription":"An array of hourly buckets, each containing: the ISO timestamp of the hour, number of Bitcoin blocks in that hour, number of Ordinals inscriptions detected via witness-envelope magic bytes, total OP_RETURN bytes, and total OP_RETURN transaction count. The response also reports the detection method (witness_envelope_scan + scriptpubkey_opreturn_count) and the query window.","failureModes":["Window parameter exceeds 7-day limit — API returns an error or truncates data","No blocks mined in a given hour — bucket may show zero values","Payment not included or insufficient USDC — x402 payment required error","Service unavailable or node sync lag — stale or missing recent hours","Invalid query parameter format — 400 bad request"],"whenToPreferThis":"Use this endpoint when you need time-series (hourly) granularity on Bitcoin Ordinals inscription activity and OP_RETURN usage, especially for trend analysis, monitoring inscription spikes, or correlating on-chain data payload volume with market events. Prefer this over generic block explorers when you need programmatic, structured hourly aggregates with both inscription counts and OP_RETURN byte metrics in a single call.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T18:45:55.629Z","isFirstParty":false}