gauge
history
series
no-data-no-charge
record-hash

Full retained series for one signal and entity

[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. Also searched as: time series bundle; trend history; multi point history.

get/gauge/history-series

Request

  • Base URL: https://api.truthbear.co
  • URL: https://api.truthbear.co/gauge/history-series
  • Auth: none declared

Query parameters

signal_idstring required
Example:hydrology.river-level

required - line id, e.g. hydrology.river-level (see /gauge/coverage)

entitystring required
Example:07010000

required - object id within that line, e.g. 07010000 (see /gauge/coverage)

daysstring

optional - lookback window in days; default 400, minimum 1, capped at 1000. Windows are UTC days (snapshot_date), not local days

formatstring

optional - json (default) or csv

Response

Paid response

naturestring

Neutrality statement: GAUGE supplies observations and trend description only - no judgement, no prediction, no recommendation

tierstring

Always the literal "history-series"

format'json' | 'csv'
signal_idstring

Signal id in genus.species ASCII binomial form (e.g. crypto.spot / macro.unemployment / shipping.route-disruption); full list at free /gauge/catalog

entitystring

Monitored object id (e.g. btc / us / hormuz); full list at free /gauge/catalog or /gauge/preview

daysinteger

Days actually covered (capped at 1000)

countinteger required

Number of rows in series

seriesobject[] required

CORE DELIVERY: the full time series for this (signal_id, entity) pair, snapshot_date ascending; each row carries snapshot_date / observed_at / data_age_hours / current / band / record_hash

notestring

Conditional - endpoint-specific honest disclosure (limits, granularity, disclaimer); some endpoints omit it

gradestring nullable

Honest data-grade disclosure (e.g. "screening-level, not decision-grade")

scopestring nullable

Honest statement of scope and limits: monitoring is not forecasting, intelligence is not instruction, and the boundary of what is verifiable

_citationobject nullable

Offline-verifiable citation: {statement_type, not_advice:bool, claim, fact, source, record_hash, signature(Ed25519), key_id, issuer_DID(did:key), verify_url} - the trust root for zero-trust self-verification

decision_pointsobject nullable

{count, points:[{tag,current,swappable,how}], note} - decision points you can re-run with a swapped tag (one swapped tag = one call); leave it alone and the original context is the default, at no extra charge

Changes

No recorded changes to this operation across all 1 revision of this API.