{"uid":"cap_fe5FRjUah9ViZLgUV3rV0","slug":"prereason-market-context-api-e831e9ab","name":"PreReason Market Context API","description":"PreReason delivers market context for financial agents. Bitcoin on-chain metrics, macro indicators, and reasoning context in one API call.","url":"https://api.prereason.com/api/metrics/%7Bmetric%7D","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"},"pathParams":{"type":"object"},"queryParams":{"type":"object","required":["metric"],"properties":{"format":{"enum":["json","markdown"],"type":"string","description":"Response format: markdown (default) or json."},"metric":{"enum":["bitcoin-price","bitcoin-market-cap","bitcoin-volume-24h","bitcoin-change-24h","bitcoin-dominance","bitcoin-hash-rate","bitcoin-difficulty","bitcoin-tx-count","bitcoin-tx-volume","bitcoin-active-addresses","fed-balance","m2-supply","treasury-10y","rrp","eur-usd","cny-usd","yield-curve","tga","treasury-3mo","treasury-2y","treasury-5y","treasury-30y","breakeven-5y","breakeven-10y","t5yifr","mortgage-30y","t10y3m-spread","auction-bid-to-cover-10y","auction-bid-to-cover-30y","indirect-bidder-pct","dealer-takedown-pct","next-treasury-auction-days","fed-funds-rate","ecb-deposit-rate","boj-policy-rate","fed-ecb-spread","fed-boj-spread","carry-trade-returns-proxy","carry-trade-velocity-1d","mortgage-treasury-spread","iwm-spy-credit-spread","spy-vxx-correlation-30d","regime-stability-flag","jpy-usd","oil-brent","oil-wti","ovx","real-rate-10y","gld-gdx-ratio","copper-gold-ratio","slv-sil-ratio","gdxj-gdx-ratio","gold-silver-ratio","brent-wti-spread","etf-gld-1h-velocity","etf-cper-1h-velocity","etf-uso-1h-velocity","etf-uup-velocity-1h","crude-oil-stocks","natgas-storage","oil-inventory-zscore","natgas-storage-zscore","ecb-boj-spread","etf-gld-volume","etf-uso-volume","etf-uup-volume","etf-gld-volume-zscore-30d","etf-uso-volume-zscore-30d","etf-uup-volume-zscore-30d","net-liquidity","hash-ribbon","mvrv-proxy","etf-spy","etf-qqq","etf-iwm","etf-vxx","etf-uup","etf-gld","etf-gdx","etf-gdxj","etf-slv","etf-sil","etf-uso","etf-ung","etf-cper","etf-weat","etf-tlt","etf-ibit","etf-fxe","etf-fxy","usdt-market-cap","usdt-dominance","btc-price-200d-ma","btc-price-200d-distance","btc-etf-net-flow","btc-etf-cumulative-flow","btc-etf-aum","btc-etf-ibit-flow","btc-etf-fbtc-flow","btc-etf-gbtc-flow","btc-etf-other-flow","btc-etf-ibit-aum","btc-etf-fbtc-aum","btc-etf-bitb-aum","btc-etf-arkb-aum","btc-etf-btco-aum","btc-etf-ezbc-aum","btc-etf-brrr-aum","btc-etf-hodl-aum","btc-etf-btcw-aum","btc-etf-gbtc-aum","btc-etf-btc-aum","bitcoin-price-1h-change-pct","raw-hashprice-tick","on-chain-velocity-30d","bitcoin-volume-zscore-30d","btc-perp-oi-contracts","btc-perp-positioning-regime","btc-perp-funding-zscore-30d"],"type":"string","description":"Metric name. 119 available across bitcoin, macro, calculated, and treasury categories."}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"trend":{"momentum":"accelerating","change_7d":4.2,"direction":"up","change_30d":12.1,"percentile":78},"metric":"bitcoin-price","context":"Bitcoin at $84,200, upper range of 90-day distribution...","interpretation":{"signal":"bullish","confidence":82,"confidence_label":"high"}}},"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_Bmv5cdlpygZNN4G8qojOH","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":"Fetches AI-ready market context for a single Bitcoin on-chain, macro, or calculated financial metric, returning trend analysis, interpretation signals, and confidence scores.","exampleAgentPrompt":"What is the current Bitcoin MVRV proxy signal — is it bullish or bearish, and how confident is the reading?","exampleUseCases":[{"title":"Bitcoin price trend for trading bot","prompt":"Pull the bitcoin-price metric and tell me the trend direction, 30-day change, and whether the signal is bullish or bearish with a confidence score."},{"title":"Macro liquidity check for portfolio agent","prompt":"What does the net-liquidity metric look like right now — is it trending up or down, and what percentile is it in relative to recent history?"},{"title":"Hash ribbon miner signal check","prompt":"Check the hash-ribbon metric for me and explain whether it's signaling a potential Bitcoin buy zone and how confident that interpretation is."}],"resultDescription":"Returns a JSON or markdown object containing the requested metric's current trend (direction, momentum, 7-day and 30-day change, percentile), a human-readable context narrative, and an interpretation block with a signal label (e.g. bullish/bearish), a numeric confidence score (0-100), and a confidence label (e.g. high/medium/low).","failureModes":["Invalid or misspelled metric name returns an error — must use one of 30 exact enum values","Missing metric parameter causes a 400-level error","Payment not included or insufficient USDC triggers a 402 Payment Required response","Network timeout if the upstream data provider is unavailable","Stale data if source feeds have not refreshed recently"],"whenToPreferThis":"Choose this endpoint when an AI agent needs pre-interpreted, reasoning-ready financial context — not raw price feeds — for Bitcoin on-chain metrics, macro indicators, or calculated signals like hash ribbon or MVRV proxy. It is especially valuable when you want a confidence score and directional signal bundled with the data rather than having to compute interpretation yourself. Prefer it over generic crypto price APIs when you need trend percentiles, momentum labels, or macro context like M2 supply, net liquidity, or yield curve in a single call.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-12T06:42:27.976Z","isFirstParty":false}