Consensus API Endpoints¶

The api_consensus_attestations_daily model provides a daily summary of consensus attestations, capturing key metrics for monitoring and analysis of attestation activity over time.

Model: api_consensus_attestations_daily — table dbt.api_consensus_attestations_daily

Legacy endpoint — GET only, no query parameters, returns the full table.

Columns

Example

curl "https://api.analytics.gnosis.io/v1/consensus/attestations/daily" \
  -H "X-API-Key: YOUR_API_KEY"

Public API view over fct_consensus_attestations_performance_daily. Network-wide daily attestation KPIs.

Model: api_consensus_attestations_performance_daily — table dbt.api_consensus_attestations_performance_daily

Declared filters

Filter policy: Unfiltered requests allowed.

Pagination: limit/offset — default 100, max 5000; response: envelope {items, pagination}

Sort: date DESC — user-sortable via sort_by: date, attestations_total, avg_inclusion_delay, p50_inclusion_delay

Columns

Example

curl "https://api.analytics.gnosis.io/v1/consensus/attestations_performance/daily?date_from=2026-01-01" \
  -H "X-API-Key: YOUR_API_KEY"

The api_consensus_blob_commitments_daily model provides a daily overview of total blob commitments within the consensus layer, supporting trend analysis and capacity planning.

Model: api_consensus_blob_commitments_daily — table dbt.api_consensus_blob_commitments_daily

Legacy endpoint — GET only, no query parameters, returns the full table.

Columns

Example

curl "https://api.analytics.gnosis.io/v1/consensus/blob_commitments/daily" \
  -H "X-API-Key: YOUR_API_KEY"

The api_consensus_blocks_daily model aggregates daily consensus block data, providing insights into blocks produced and missed each day for monitoring network performance.

Model: api_consensus_blocks_daily — table dbt.api_consensus_blocks_daily

Legacy endpoint — GET only, no query parameters, returns the full table.

Columns

Example

curl "https://api.analytics.gnosis.io/v1/consensus/blocks/daily" \
  -H "X-API-Key: YOUR_API_KEY"

This view provides daily aggregated counts of consensus blocks with and without zero blob commitments, aiding in monitoring blockchain data integrity and activity levels.

Model: api_consensus_zero_blob_commitments_daily — table dbt.api_consensus_zero_blob_commitments_daily

Legacy endpoint — GET only, no query parameters, returns the full table.

Columns

Example

curl "https://api.analytics.gnosis.io/v1/consensus/blocks_and_blobs/daily" \
  -H "X-API-Key: YOUR_API_KEY"

Public API view — SELECT * FROM fct_consensus_consolidations_daily. Filter/pagination metadata in model config.

Model: api_consensus_consolidations_daily — table dbt.api_consensus_consolidations_daily

Declared filters

Filter policy: Unfiltered requests allowed.

Pagination: limit/offset — default 5000, max 10000; response: envelope {items, pagination}

Sort: date DESC

Columns

Example

curl "https://api.analytics.gnosis.io/v1/consensus/consolidations/daily?date_from=2026-01-01" \
  -H "X-API-Key: YOUR_API_KEY"

The api_consensus_credentials_latest model provides a snapshot of the most recent count of different credential types used in the API consensus system, supporting real-time monitoring and analysis.

Model: api_consensus_credentials_latest — table dbt.api_consensus_credentials_latest

Legacy endpoint — GET only, no query parameters, returns the full table.

Columns

Example

curl "https://api.analytics.gnosis.io/v1/consensus/credentials/latest"

The api_consensus_credentials_daily model provides daily aggregated counts and percentage shares of different credential types used in the API, supporting operational and strategic analysis.

Model: api_consensus_credentials_daily — table dbt.api_consensus_credentials_daily

Legacy endpoint — GET only, no query parameters, returns the full table.

Columns

Example

curl "https://api.analytics.gnosis.io/v1/consensus/credentials/daily" \
  -H "X-API-Key: YOUR_API_KEY"

The model aggregates daily counts of consensus deposits and withdrawals to monitor transaction activity trends over time.

Model: api_consensus_deposits_withdrawls_cnt_daily — table dbt.api_consensus_deposits_withdrawls_cnt_daily

Legacy endpoint — GET only, no query parameters, returns the full table.

Columns

Example

curl "https://api.analytics.gnosis.io/v1/consensus/deposits_and_withdrawals/daily" \
  -H "X-API-Key: YOUR_API_KEY"

The api_consensus_deposits_withdrawls_volume_daily model provides a daily summary of deposit and withdrawal volumes from the API, facilitating trend analysis and reporting.

Model: api_consensus_deposits_withdrawls_volume_daily — table dbt.api_consensus_deposits_withdrawls_volume_daily

Legacy endpoint — GET only, no query parameters, returns the full table.

Columns

Example

curl "https://api.analytics.gnosis.io/v1/consensus/deposits_and_withdrawals_volume/daily" \
  -H "X-API-Key: YOUR_API_KEY"

The model provides the latest consensus information on the total number of deposits, serving as a key metric for monitoring deposit activity trends.

Model: api_consensus_info_deposits_cnt_latest — table dbt.api_consensus_info_deposits_cnt_latest

Legacy endpoint — GET only, no query parameters, returns the full table.

Columns

Example

curl "https://api.analytics.gnosis.io/v1/consensus/deposits_cnt/latest"

The api_consensus_entry_queue_daily model provides daily aggregated statistics on the validator entry queue, enabling analysis of queue size and distribution over time for consensus monitoring.

Model: api_consensus_entry_queue_daily — table dbt.api_consensus_entry_queue_daily

Legacy endpoint — GET only, no query parameters, returns the full table.

Columns

Example

curl "https://api.analytics.gnosis.io/v1/consensus/entry_queue/daily" \
  -H "X-API-Key: YOUR_API_KEY"

The api_consensus_forks model provides a consolidated view of consensus fork information used in the blockchain network, facilitating analysis of fork versions and their identifiers.

Model: api_consensus_forks — table dbt.api_consensus_forks

Legacy endpoint — GET only, no query parameters, returns the full table.

Columns

Example

curl "https://api.analytics.gnosis.io/v1/consensus/forks_info/latest"

The api_consensus_graffiti_label_daily model aggregates daily counts of graffiti labels to support trend analysis and reporting for consensus graffiti labeling efforts.

Model: api_consensus_graffiti_label_daily — table dbt.api_consensus_graffiti_label_daily

Legacy endpoint — GET only, no query parameters, returns the full table.

Columns

Example

curl "https://api.analytics.gnosis.io/v1/consensus/graffities_labels/daily" \
  -H "X-API-Key: YOUR_API_KEY"

The api_consensus_graffiti_cloud model aggregates consensus data related to graffiti labels and their associated values, facilitating analysis of graffiti patterns and trends at a granular level.

Model: api_consensus_graffiti_cloud — table dbt.api_consensus_graffiti_cloud

Legacy endpoint — GET only, no query parameters, returns the full table.

Columns

Example

curl "https://api.analytics.gnosis.io/v1/consensus/graffities_labels/in_ranges"

The api_consensus_info_staked_latest model provides the most recent total staked GNO value and its percentage change, supporting real-time analysis of staking metrics in the GNO ecosystem.

Model: api_consensus_info_staked_latest — table dbt.api_consensus_info_staked_latest

Legacy endpoint — GET only, no query parameters, returns the full table.

Columns

Example

curl "https://api.analytics.gnosis.io/v1/consensus/staked_gno/latest"

The api_consensus_staked_daily model provides daily aggregated data on the effective staked GNO across validators, facilitating analysis of staking trends over time.

Model: api_consensus_staked_daily — table dbt.api_consensus_staked_daily

Legacy endpoint — GET only, no query parameters, returns the full table.

Columns

Example

curl "https://api.analytics.gnosis.io/v1/consensus/staked_gno/daily" \
  -H "X-API-Key: YOUR_API_KEY"

The model provides the latest consensus information on active and ongoing items, serving as a key reference for monitoring current operational states.

Model: api_consensus_info_active_ongoing_latest — table dbt.api_consensus_info_active_ongoing_latest

Legacy endpoint — GET only, no query parameters, returns the full table.

Columns

Example

curl "https://api.analytics.gnosis.io/v1/consensus/validators_active_ongoing/latest"

The api_consensus_validators_active_daily model provides a daily snapshot of the number of validators that are actively participating in the consensus process, supporting monitoring and analysis of validator activity trends.

Model: api_consensus_validators_active_daily — table dbt.api_consensus_validators_active_daily

Legacy endpoint — GET only, no query parameters, returns the full table.

Columns

Example

curl "https://api.analytics.gnosis.io/v1/consensus/validators_active_ongoing/daily" \
  -H "X-API-Key: YOUR_API_KEY"

The api_consensus_info_apy_latest model provides the most recent annual percentage yield (APY) data from consensus sources, enabling analysis of current yield trends.

Model: api_consensus_info_apy_latest — table dbt.api_consensus_info_apy_latest

Legacy endpoint — GET only, no query parameters, returns the full table.

Columns

Example

curl "https://api.analytics.gnosis.io/v1/consensus/validators_apy/latest"

Public API view — SELECT * FROM fct_consensus_validators_apy_mean_daily. Filter/pagination metadata in model config.

Model: api_consensus_validators_apy_mean_daily — table dbt.api_consensus_validators_apy_mean_daily

Declared filters

Filter policy: Unfiltered requests allowed.

Pagination: limit/offset — default 2000, max 10000; response: envelope {items, pagination}

Sort: date DESC

Columns

Example

curl "https://api.analytics.gnosis.io/v1/consensus/validators_apy/daily?date_from=2026-01-01" \
  -H "X-API-Key: YOUR_API_KEY"

This view provides daily distribution metrics of validator APYs, enabling analysis of validator performance variability over time.

Model: api_consensus_validators_apy_dist_daily — table dbt.api_consensus_validators_apy_dist_daily

Legacy endpoint — GET only, no query parameters, returns the full table.

Columns

Example

curl "https://api.analytics.gnosis.io/v1/consensus/validators_apy_distribution/daily" \
  -H "X-API-Key: YOUR_API_KEY"

This view provides a distribution of validator APYs over the last 30 days, enabling analysis of APY variability and trends within the validator set.

Model: api_consensus_validators_apy_dist_last_30_days — table dbt.api_consensus_validators_apy_dist_last_30_days

Legacy endpoint — GET only, no query parameters, returns the full table.

Columns

Example

curl "https://api.analytics.gnosis.io/v1/consensus/validators_apy_distribution/last_30d"

Public API view — SELECT * FROM int_consensus_validators_apy_dist_income_daily. Filter/pagination metadata in model config.

Model: api_consensus_validators_apy_dist_income_daily — table dbt.api_consensus_validators_apy_dist_income_daily

Declared filters

Filter policy: Unfiltered requests allowed.

Pagination: limit/offset — default 2000, max 10000; response: envelope {items, pagination}

Sort: date DESC

Columns

Example

curl "https://api.analytics.gnosis.io/v1/consensus/validators_apy_income_dist/daily?date_from=2026-01-01" \
  -H "X-API-Key: YOUR_API_KEY"

This view provides the distribution of validator balances over the last 30 days, summarized through various quantiles to analyze balance spread and trends.

Model: api_consensus_validators_balance_dist_last_30_days — table dbt.api_consensus_validators_balance_dist_last_30_days

Legacy endpoint — GET only, no query parameters, returns the full table.

Columns

Example

curl "https://api.analytics.gnosis.io/v1/consensus/validators_balance_distribution/last_30d"

The api_consensus_validators_balances_daily model provides a daily overview of validator balances and effective balances to support consensus and validator health analysis.

Model: api_consensus_validators_balances_daily — table dbt.api_consensus_validators_balances_daily

Legacy endpoint — GET only, no query parameters, returns the full table.

Columns

Example

curl "https://api.analytics.gnosis.io/v1/consensus/validators_balances/daily" \
  -H "X-API-Key: YOUR_API_KEY"

This view provides daily distribution percentiles of validator balances in GNO, enabling analysis of validator balance variability over time.

Model: api_consensus_validators_balances_dist_daily — table dbt.api_consensus_validators_balances_dist_daily

Legacy endpoint — GET only, no query parameters, returns the full table.

Columns

Example

curl "https://api.analytics.gnosis.io/v1/consensus/validators_balances_distribution/daily" \
  -H "X-API-Key: YOUR_API_KEY"

Public API view — SELECT * FROM fct_consensus_validators_explorer_latest. Requires withdrawal_credentials filter; see model config.

Model: api_consensus_validators_explorer_latest — table dbt.api_consensus_validators_explorer_latest

Declared filters

Filter policy: At least one filter required. Must provide one of: withdrawal_credentials.

Pagination: limit/offset — default 100, max 1000; response: envelope {items, pagination}

Columns

Example

curl "https://api.analytics.gnosis.io/v1/consensus/validators_explorer/latest?withdrawal_credentials=VALUE" \
  -H "X-API-Key: YOUR_API_KEY"

Public API view — SELECT * FROM fct_consensus_validators_explorer_daily. Requires withdrawal_credentials filter; see model config.

Model: api_consensus_validators_explorer_daily — table dbt.api_consensus_validators_explorer_daily

Declared filters

Filter policy: At least one filter required. Must provide one of: withdrawal_credentials.

Pagination: limit/offset — default 1000, max 10000; response: envelope {items, pagination}

Sort: date DESC

Columns

Example

curl "https://api.analytics.gnosis.io/v1/consensus/validators_explorer/daily?date_from=2026-01-01" \
  -H "X-API-Key: YOUR_API_KEY"

Public API view — SELECT * FROM int_consensus_validators_explorer_apy_dist_daily. Requires withdrawal_credentials filter; see model config.

Model: api_consensus_validators_explorer_apy_dist_daily — table dbt.api_consensus_validators_explorer_apy_dist_daily

Declared filters

Filter policy: At least one filter required. Must provide one of: withdrawal_credentials.

Pagination: limit/offset — default 1000, max 10000; response: envelope {items, pagination}

Sort: date DESC

Columns

Example

curl "https://api.analytics.gnosis.io/v1/consensus/validators_explorer_apy_dist/daily?date_from=2026-01-01" \
  -H "X-API-Key: YOUR_API_KEY"

Balance-distribution histogram across co-validators sharing a withdrawal credential. Light view over fct_consensus_validators_status_latest (~558k rows); the API prunes by withdrawal_credentials before the bucketing runs so the query is cheap even without a physical index on credentials. Bucket e...

Model: api_consensus_validators_explorer_balance_dist — table dbt.api_consensus_validators_explorer_balance_dist

Declared filters

Filter policy: At least one filter required. Must provide one of: withdrawal_credentials.

Pagination: limit/offset — default 16, max 64; response: envelope {items, pagination}

Sort: bucket_order ASC

Columns

Example

curl "https://api.analytics.gnosis.io/v1/consensus/validators_explorer_balance_dist/latest?withdrawal_credentials=VALUE" \
  -H "X-API-Key: YOUR_API_KEY"

Public API view — SELECT * FROM fct_consensus_validators_explorer_members_table. Requires withdrawal_credentials filter; see model config.

Model: api_consensus_validators_explorer_members_table — table dbt.api_consensus_validators_explorer_members_table

Declared filters

Filter policy: At least one filter required. Must provide one of: withdrawal_credentials.

Pagination: limit/offset — default 100, max 5000; response: envelope {items, pagination}

Sort: validator_index ASC — user-sortable via sort_by: validator_index, balance_gno, consensus_income_amount_30d_gno, proposed_blocks_count_lifetime, total_income_estimated_gno

Columns

Example

curl "https://api.analytics.gnosis.io/v1/consensus/validators_explorer_members/latest?withdrawal_credentials=VALUE" \
  -H "X-API-Key: YOUR_API_KEY"

Public API view — SELECT * FROM fct_consensus_validators_income_total_daily. Filter/pagination metadata in model config.

Model: api_consensus_validators_income_total_daily — table dbt.api_consensus_validators_income_total_daily

Declared filters

Filter policy: Unfiltered requests allowed.

Pagination: limit/offset — default 2000, max 10000; response: envelope {items, pagination}

Sort: date DESC

Columns

Example

curl "https://api.analytics.gnosis.io/v1/consensus/validators_income/daily?date_from=2026-01-01" \
  -H "X-API-Key: YOUR_API_KEY"

Public API view — one row per validator with latest snapshot fields plus 30-day and lifetime aggregates.

Model: api_consensus_validators_performance_latest — table dbt.api_consensus_validators_performance_latest

Declared filters

Filter policy: At least one filter required. Must provide one of: validator_index, pubkey, withdrawal_credentials, withdrawal_address.

Pagination: limit/offset — default 100, max 5000; response: envelope {items, pagination}

Sort: validator_index ASC — user-sortable via sort_by: validator_index, balance_gno, effective_balance_gno, total_income_estimated_gno, consensus_income_amount_30d_gno, proposer_reward_total_30d_gno, proposed_blocks_count_lifetime

Columns

Example

curl "https://api.analytics.gnosis.io/v1/consensus/validators_performance/latest?validator_index=VALUE1,VALUE2" \
  -H "X-API-Key: YOUR_API_KEY"

Public API view joining daily income and proposer-reward facts at (date, validator_index). Filterable by validator_index, pubkey, withdrawal_credentials, withdrawal_address, date_from, date_to.

Model: api_consensus_validators_performance_daily — table dbt.api_consensus_validators_performance_daily

Declared filters

Filter policy: At least one filter required. Must provide one of: validator_index, pubkey, withdrawal_credentials, withdrawal_address.

Pagination: limit/offset — default 100, max 5000; response: envelope {items, pagination}

Sort: date DESC, validator_index ASC — user-sortable via sort_by: date, validator_index, balance_gno, consensus_income_amount_gno, apy, proposer_reward_total_gno, proposed_blocks_count

Columns

Example

curl "https://api.analytics.gnosis.io/v1/consensus/validators_performance/daily?date_from=2026-01-01" \
  -H "X-API-Key: YOUR_API_KEY"

Dropdown source for the Validator Explorer tab. Grain is one row per WITHDRAWAL_CREDENTIALS (not per validator) — on Gnosis today this is ~3,400 rows vs 558k at validator-grain, so the dashboard can load the full list in a single request (a few hundred KB on the wire) without 30s timeouts. Collap...

Model: api_consensus_validators_search — table dbt.api_consensus_validators_search

Filter policy: Unfiltered requests allowed.

Pagination: limit/offset — default 5000, max 10000; response: envelope {items, pagination}

Sort: validator_count DESC — user-sortable via sort_by: validator_count, withdrawal_credentials, display_name

Columns

Example

curl "https://api.analytics.gnosis.io/v1/consensus/validators_search/latest" \
  -H "X-API-Key: YOUR_API_KEY"

The api_consensus_validators_status_latest model provides the latest validator-level consensus status snapshot and supports filtered lookup by withdrawal credentials or validator pubkey.

Model: api_consensus_validators_status_latest — table dbt.api_consensus_validators_status_latest

Declared filters

Filter policy: At least one filter required. Must provide one of: withdrawal_credentials, pubkey, validator_index, withdrawal_address.

Pagination: limit/offset — default 100, max 5000; response: envelope {items, pagination}

Sort: validator_index ASC — user-sortable via sort_by: validator_index, balance, effective_balance, status, activation_epoch, exit_epoch, withdrawable_epoch

Columns

Example

curl "https://api.analytics.gnosis.io/v1/consensus/validators_status/latest?withdrawal_credentials=VALUE1,VALUE2" \
  -H "X-API-Key: YOUR_API_KEY"

The api_consensus_validators_status_daily model provides a daily summary of validator statuses, excluding ongoing active and withdrawal completed states, to monitor validator health and transitions over time.

Model: api_consensus_validators_status_daily — table dbt.api_consensus_validators_status_daily

Legacy endpoint — GET only, no query parameters, returns the full table.

Columns

Example

curl "https://api.analytics.gnosis.io/v1/consensus/validators_status/daily" \
  -H "X-API-Key: YOUR_API_KEY"

This view aggregates daily counts of validators categorized by their withdrawal credentials frequency, supporting analysis of validator credential patterns over time.

Model: api_consensus_withdrawal_credentials_freq_daily — table dbt.api_consensus_withdrawal_credentials_freq_daily

Legacy endpoint — GET only, no query parameters, returns the full table.

Columns

Example

curl "https://api.analytics.gnosis.io/v1/consensus/withdrawal_credentials_frequency/daily" \
  -H "X-API-Key: YOUR_API_KEY"

This view provides the latest count of withdrawal events from the consensus API, enabling monitoring of withdrawal activity trends over time.

Model: api_consensus_info_withdrawls_cnt_latest — table dbt.api_consensus_info_withdrawls_cnt_latest

Legacy endpoint — GET only, no query parameters, returns the full table.

Columns

Example

curl "https://api.analytics.gnosis.io/v1/consensus/withdrawls_cnt/latest"