Finalized Metrics

Santiment provides a way to access finalized metric data points through our API. Data points are flagged as final for a given interval, meaning no further backfills or adjustments will occur for that timestamp. This is especially useful when you need guaranteed consistency for analysis, dashboards, or reporting.

📖

Finalized here means the value is considered final for the requested interval. It does not change afterwards due to late-arriving data or corrections.

How to request finalized data

Set onlyFinalizedData: true in your GraphQL query. For example, requesting daily finalized Transaction Volume for Bitcoin Cash:

{
  getMetric(metric: "transaction_volume"){
    timeseriesDataJson(
      selector:{slug: "bitcoin-cash"}
      from: "utc_now-6h"
      to: "utc_now"
      interval: "5m"
      onlyFinalizedData: true
    )
  }
}
Run in Explorer
Supported scope (WIP)

This feature is currently in testing and implemented for Bitcoin Cash and for a limited subset of metrics:

  • active_addresses_1h
  • active_addresses_24h
  • active_addresses_30d
  • active_addresses_7d
  • active_addresses_delta_1h
  • active_addresses_delta_24h
  • active_addresses_delta_30d
  • active_addresses_delta_7d
  • nvt_transaction_volume
  • stack_age_consumed_5min
  • transaction_volume
  • transaction_volume_5min

The assets and metrics coverage will expand in the future.

❗

Requesting finalized data introduces additional latency.

Related reading

Talk to us in Discord

Still have some questions left? Join our Discord and get help from the Santiment team!