{"uid":"cap_F0YXU9PZqBbFLJ-SPQc4X","slug":"truthbear-gauge-statistical-strata-25aec21a","name":"TruthBear Gauge Statistical Strata","description":"Add-on, statistical strata: share of the last 5 years spent in each official band for this day-of-year, the percentile bands, and where the current reading falls. Backtestable, and stated as approximate. Descriptive only, never a forecast or advice. No data -> 422 no_charge, not billed. $0.0050 per call.","url":"https://api.truthbear.co/gauge/strata","method":"GET","headers":{},"bodySchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"input":{"type":"object","required":["type","method","queryParams"],"properties":{"type":{"const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","required":["signal_id","entity"],"properties":{"entity":{"type":"string","examples":["07010000"],"description":"required - monitored object id, paired with signal_id; free list at GET /gauge/catalog?signal_id=<signal_id> -> signals[0].entities[]"},"signal_id":{"type":"string","examples":["hydrology.river-level"],"description":"required - signal id (genus.species); free list at GET /gauge/catalog (paged; ?all=1 for every line)"}},"additionalProperties":false}}},"output":{"type":"object","required":["type"],"properties":{"type":{"const":"json"}}}}},"responseSchema":{"type":"json"},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","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.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_l-liTqN7eTA3a8-FGqLDf","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns historical percentile bands showing what share of the last 5 years a signal spent in each official level band for today's day-of-year, plus where the current reading falls.","exampleAgentPrompt":"For the river level signal 'hydrology.river-level' at gauge station 07010000, show me the historical percentile strata — what share of the last 5 years was spent in each band for today's day-of-year, and where does the current reading fall?","exampleUseCases":[{"title":"River flood risk contextualization","prompt":"For gauge station 07010000 using the hydrology.river-level signal, tell me what percentile band today's reading falls in and how much time over the last 5 years this station spent at that level for this day of year."},{"title":"ESG greenwash signal benchmarking","prompt":"Using the gauge strata add-on for the blackrock-art9-downgrade entity and the relevant ESG signal, show me the historical percentile distribution and where today's label-pressure reading ranks compared to the same day in prior years."},{"title":"DeFi utilization historical context","prompt":"Pull the statistical strata for the euler-v1 entity on the DeFi utilization signal — I want to see what percentile the current utilization sits at and how the last 5 years' readings are distributed across bands for today's date."}],"resultDescription":"A JSON object containing the share of the last 5 years spent in each official level band (as fractions), the percentile band boundaries, and the position of the current reading within those bands — all specific to the current day-of-year. Descriptive and approximate; not a forecast. Returns a 422 no_charge error with no billing if no data is available.","failureModes":["422 no_charge: no historical data available for the requested signal_id and entity combination — call is not billed","Missing required query parameters signal_id or entity returns a 4xx validation error","Invalid signal_id or entity values return an error; use /gauge/catalog to discover valid combinations","Strata are approximate and stated as such; not suitable for precision-critical applications"],"whenToPreferThis":"Choose this endpoint when you need to contextualize a current sensor or signal reading against its own historical distribution for the same day-of-year — not for raw time series data (use gauge/history-series) or normalized cross-station comparison (use gauge/calibrated). Ideal for adding statistical context to environmental, financial, or operational dashboards where understanding 'is this reading unusual for this time of year?' matters.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T12:58:31.445Z","isFirstParty":false}