{"uid":"cap_K1f0E9WuOCQS4iAPuEsVG","slug":"prereason-single-metric-api-ba8143a9","name":"PreReason Single Metric API","description":"Single financial metric with pre-reasoned trend analysis (7d/30d/90d), signal, confidence score, momentum, and 90-day percentile. 293 metrics across bitcoin, calculated, eth, macro categories for AI agents.","url":"https://api.prereason.com/api/metrics/:metric?utm_source=zero.xyz","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":{"type":"string","pattern":"^[a-z0-9]+(-[a-z0-9]+)*$","description":"Metric name. 293 available across bitcoin, calculated, eth, macro categories, listed free at GET /api/metrics."}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"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_s0fHFccSZD3MucrxPukCt","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 a single financial or Bitcoin metric with pre-reasoned trend analysis, signal, confidence score, momentum, and 90-day percentile across 119 metrics spanning bitcoin, macro, and calculated categories.","exampleAgentPrompt":"Pull the bitcoin-dominance metric from PreReason and tell me the current signal, confidence score, and where it sits in the 90-day percentile along with the 7-day and 30-day trend direction.","exampleUseCases":[{"title":"Bitcoin on-chain momentum check","prompt":"Get me the bitcoin hash-ribbon metric with its trend signal, confidence score, and momentum — I want to know if it's bullish or bearish right now and how confident the model is."},{"title":"Macro rate environment analysis","prompt":"Fetch the yield-curve metric from PreReason and give me the current signal, the 7d/30d/90d trend breakdown, and where it sits in its 90-day percentile range."},{"title":"Commodity market regime detection","prompt":"Pull the copper-gold-ratio metric and tell me its current momentum, confidence score, and 90-day percentile — I'm trying to gauge global growth sentiment."}],"resultDescription":"A single metric object containing the current value, pre-reasoned trend direction over 7-day, 30-day, and 90-day windows, a directional signal (e.g. bullish/bearish/neutral), a confidence score, momentum indicator, and the metric's position in its 90-day historical percentile. Available in JSON or Markdown format.","failureModes":["Invalid or unsupported metric name returns an error — must use one of the 119 enumerated metric slugs","Payment failure if x402 USDC payment of $0.01 is not properly handled","Network timeout if the upstream data source for the metric is unavailable","Truncated schema means some metrics near the end of the enum list may need verification"],"whenToPreferThis":"Use this endpoint when you need deep pre-reasoned analysis (trend, signal, confidence, momentum, percentile) on a specific single metric rather than a broad multi-metric dashboard. Ideal for AI agents that need structured, actionable financial signals on one metric at a time without parsing raw data themselves. Prefer over broader endpoints when you want lightweight per-metric cost and targeted signal extraction.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-19T06:35:27.702Z","isFirstParty":false,"canonicalSlug":"prereason-single-metric-api-ba8143a9"}