{"uid":"cap_T1lza6CNqOF9v74XxAwUe","slug":"truthbear-gauge-history-series-c137ad9e","name":"TruthBear Gauge History Series","description":"[TIME SERIES EXPORT] Full retained series for one signal and entity (?days=, ?format=json or csv): every snapshot up to days (default 400, cap 1000) with snapshot_date, observed_at, data_age_hours, current, band and record_hash. For research, actuarial and base-rate work. Free 7-snapshot shape preview at /gauge/history-preview. Descriptive only, never a forecast or advice. No data -> 422 no_charge, not billed. $0.09 per call.","url":"https://api.truthbear.co/gauge/history-series","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":{"days":{"type":"string","description":"optional - lookback window in days; default 400, minimum 1, capped at 1000. Windows are UTC days (snapshot_date), not local days"},"entity":{"type":"string","examples":["07010000"],"description":"required - object id within that line, e.g. 07010000 (see /gauge/coverage)"},"format":{"type":"string","description":"optional - json (default) or csv"},"signal_id":{"type":"string","examples":["hydrology.river-level"],"description":"required - line id, e.g. hydrology.river-level (see /gauge/coverage)"}},"additionalProperties":false}}},"output":{"type":"object","required":["type"],"properties":{"type":{"const":"json"}}}}},"responseSchema":{"type":"json"},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.09","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.09/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.09","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.09","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_pU5MprzGkuwWV6JvxDqun","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.09","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the full retained time-series of snapshots for a specific signal and entity, including snapshot date, observation time, data age, current value, band, and record hash.","exampleAgentPrompt":"Pull the full history series for the hydrology.river-level signal on entity 07010000 going back 365 days and give it to me as JSON so I can run base-rate analysis.","exampleUseCases":[{"title":"Actuarial base-rate research on river levels","prompt":"Get me the complete snapshot history for the hydrology.river-level signal on entity 07010000 for the last 400 days in CSV format — I need every snapshot_date, current value, and band for actuarial modeling."},{"title":"Stablecoin depeg pressure historical audit","prompt":"Retrieve the full retained time series for the stablecoin depeg pressure signal on entity terrausd-ust over the past 1000 days as JSON so I can study how the band and current readings evolved over time."},{"title":"Supply chain chokepoint long-run trend analysis","prompt":"Can you export the entire history series for the shipping chokepoint signal on the Malacca entity for the last 600 days? I want to see every observed_at timestamp, data_age_hours, and record_hash to cross-reference with incident reports."}],"resultDescription":"Returns a JSON or CSV array of time-ordered snapshots for the requested signal and entity. Each record includes snapshot_date, observed_at, data_age_hours, current (the signal value), band (risk tier), and record_hash (integrity identifier). The lookback window defaults to 400 days and is capped at 1000 days. If no data is available, returns a 422 no_charge error without billing.","failureModes":["422 no_charge returned when no data exists for the specified signal_id and entity combination — call is not billed","Invalid signal_id or entity returns an error — check /gauge/coverage for valid identifiers","Days parameter below 1 or above 1000 may be rejected or clamped","Unsupported format value (not json or csv) may return an error","Network timeout on very large day windows approaching the 1000-day cap"],"whenToPreferThis":"Use this endpoint when you need the complete retained historical record of a signal for research, actuarial, or base-rate work — not just the current reading or a preview. Prefer this over /gauge/history-preview when you need more than 7 snapshots. Use when you need CSV export for downstream statistical tooling. Do not use if you need a forecast, advice, or calibrated normalized index (use gauge/calibrated for normalization).","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T12:57:12.251Z","isFirstParty":false}