Endpoints¶

API endpoints are auto-generated from dbt model metadata. Each dbt model tagged with production and an api:* tag becomes a REST endpoint. No Python code is needed to add or modify endpoints -- changes to dbt models are automatically reflected in the API after the next manifest refresh.

Base URL¶

All endpoints are served under a versioned base path:

https://api.analytics.gnosis.io/v1

URL Convention¶

Endpoint paths follow a three-segment structure:

/v1/{category}/{resource}/{granularity}

Path Examples¶

How Endpoints Are Generated¶

The API reads the dbt manifest.json file and discovers all models that meet two conditions:

1. The model has the production tag
2. The model has an api:{resource_name} tag

For each qualifying model, the API builds a route from the model's tags and registers it on the FastAPI router. The manifest is refreshed on a configurable interval (default: every 5 minutes), so newly deployed dbt models become API endpoints without restarting the service.

flowchart LR
    A[dbt model] -->|tags + meta.api| B[manifest.json]
    B -->|auto-discovery| C[FastAPI Router]
    C -->|serves| D[REST Endpoint]

Categories¶

Categories correspond to the first non-system tag on a dbt model. They serve as both the URL prefix and the grouping header in the Swagger UI. Common categories include:

Categories are dynamic -- any tag value that is not a system tag (production, view, table, incremental, staging, intermediate), not a tier tag (tier0-tier3), and not a prefixed tag (api:*, granularity:*) becomes the category. New categories appear automatically when dbt models use new tag values.

Supported Granularities¶

Granularity defines the time aggregation level of the data. It appears as the final URL segment and is set via the granularity:{period} dbt tag. Multiple granularities can exist for the same resource -- each is backed by a separate dbt model.

Granularity Ordering in Swagger UI¶

Endpoints in the Swagger UI are sorted deterministically within each resource group:

1. Endpoints without a granularity suffix appear first
2. Then: latest, daily, weekly, monthly, last_7d, last_30d, in_ranges, all_time
3. Unknown granularity values appear last, sorted alphabetically

Multiple Granularities for One Resource¶

A single resource often has multiple granularity endpoints, each backed by a separate dbt model with the same api: tag but different granularity: and tier tags:

GET /v1/consensus/blob_commitments/latest    (tier0 -- public)
GET /v1/consensus/blob_commitments/daily     (tier1 -- partner)
GET /v1/consensus/blob_commitments/last_30d  (tier1 -- partner)
GET /v1/consensus/blob_commitments/all_time  (tier2 -- premium)

A common pattern is to expose /latest at tier0 (free, no key needed) so anyone can check current values, while historical data at /daily or /all_time requires partner or premium access.

HTTP Methods¶

Each endpoint supports one or more HTTP methods as declared in the dbt model's meta.api.methods field:

When both GET and POST are enabled for an endpoint, the POST variant appears as a separate entry in the Swagger UI with a (POST) suffix in its summary.

curl "https://api.analytics.gnosis.io/v1/execution/token_balances/daily?symbol=GNO&limit=50" \
  -H "X-API-Key: YOUR_API_KEY"

curl -X POST "https://api.analytics.gnosis.io/v1/execution/token_balances/daily" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_API_KEY" \
  -d '{"symbol": "GNO", "limit": 50}'

See Filtering & Pagination for full details on request formats.

Legacy vs Metadata-Driven Endpoints¶

Endpoints fall into two categories based on whether the dbt model includes a meta.api configuration block:

Tag Reference¶

dbt tags control every aspect of how a model becomes an API endpoint:

Example dbt Model Configuration¶

{{
    config(
        materialized='view',
        tags=[
            'production',       -- Required: marks for API exposure
            'consensus',        -- Category: URL prefix + Swagger group
            'tier1',            -- Access: requires partner key or above
            'api:blob_commitments',    -- Resource: URL segment
            'granularity:daily'        -- Granularity: URL suffix
        ],
        meta={
            "api": {
                "methods": ["GET", "POST"],
                "allow_unfiltered": false,
                "parameters": [
                    {"name": "start_date", "column": "date", "operator": ">=", "type": "date"},
                    {"name": "end_date", "column": "date", "operator": "<=", "type": "date"}
                ],
                "pagination": {"enabled": true, "default_limit": 100, "max_limit": 5000},
                "sort": [{"column": "date", "direction": "DESC"}]
            }
        }
    )
}}

SELECT date, total_blob_commitments AS value
FROM {{ ref('int_consensus_blocks_daily') }}

Result:

• Endpoint: GET /v1/consensus/blob_commitments/daily and POST /v1/consensus/blob_commitments/daily
• Swagger Section: Consensus
• Access: tier1 (partner and above)
• Filters: start_date, end_date
• Pagination: default 100 rows, max 5000
• Sort: date DESC

System Endpoints¶

In addition to auto-generated data endpoints, the API provides built-in system routes:

Endpoint Catalog¶

The following table lists all auto-generated data endpoints currently exposed by the API. This section is regenerated from the dbt manifest by scripts/update_docs.py.

A Circles v2 personal mint is a Hub Transfer... | | /v1/execution/circles_v2_avatar_personal_token_supply_latest/latest | GET | tier1 | One-row-per-avatar summary of a Circles v2 avatar's own personal CRC token: total circulating sup... | | /v1/execution/circles_v2_avatar_search/snapshot | GET | tier1 | Lightweight (avatar, display_name) lookup used by the dashboard global filter to support searchin... | | /v1/execution/circles_v2_avatar_token_distribution/latest | GET | tier1 | Per-avatar distribution of holders of a Circles v2 personal CRC token (the ERC-1155 token whose t... | | /v1/execution/circles_v2_avatar_tokens_held_count/latest | GET | tier1 | Per-avatar count of distinct CRC tokens currently held with a balance above the 0.001 CRC dust th... | | /v1/execution/circles_v2_avatar_trust_network/snapshot | GET | tier1 | Trust-network edge list for the Circles v2 Avatar Trust Network panel.

One row per directed trus... | | /v1/execution/circles_v2_avatar_trust_relations/snapshot | GET | tier1 | Current active trust relations pivoted to one row per (avatar, counterparty) pair with direction ... | | /v1/execution/circles_v2_avatar_trusts_daily/daily | GET | tier1 | Daily cumulative trusts given and received per avatar. | | /v1/execution/circles_v2_avatar_trusts_summary/latest | GET | tier1 | Latest snapshot of cumulative trusts given and received per avatar. | | /v1/execution/circles_v2_avatars/daily | GET | tier1 | API view of daily avatar type counts and cumulative totals. | | /v1/execution/circles_v2_avatars_current/snapshot | GET | tier1 | API view of current Circles v2 avatar registrations. | | /v1/execution/circles_v2_groups_cnt/latest | GET | tier1 | Latest count of group avatars and 7-day percentage change. | | /v1/execution/circles_v2_humans_cnt/latest | GET | tier1 | Latest count of human avatars and 7-day percentage change. | | /v1/execution/circles_v2_orgs_cnt/latest | GET | tier1 | Latest count of organization avatars and 7-day percentage change. | | /v1/execution/circles_v2_supply_by_holder_type/daily | GET | tier1 | API view of daily CRC supply breakdown by holder type (avatar type or Dune label sector). | | /v1/execution/circles_v2_total_supply/daily | GET | tier1 | API view of daily network-wide CRC supply. | | /v1/execution/circles_v2_trust_relations_current/snapshot | GET | tier1 | API view of current active Circles v2 trust relations. | | /v1/execution/execution_lending/daily | GET | tier1 | -- | | /v1/execution/execution_lending/snapshot | GET | tier1 | Latest lending TVL per reserve token on Gnosis (aggregated across Aave V3 and SparkLend) for pie ... | | /v1/execution/execution_lending_activity_counts/weekly | GET | tier1 | -- | | /v1/execution/execution_lending_activity_volumes/weekly | GET | tier1 | -- | | /v1/execution/execution_lending_balance_cohorts_holders/daily | GET | tier1 | Daily lender count by balance cohort per (protocol, token) across Aave V3 and SparkLend. Stacked ... | | /v1/execution/execution_lending_balance_cohorts_value/daily | GET | tier1 | Daily lender balance cohort values per (protocol, token) across Aave V3 and SparkLend. Stacked ba... | | /v1/execution/execution_lending_borrowers_count/last_7d | GET | tier0 | -- | | /v1/execution/execution_lending_lenders_count/latest | GET | tier0 | KPI view of currently-active lenders on Gnosis (Aave V3, SparkLend). "Active lenders" is a STOCK ... | | /v1/execution/execution_pools/daily | GET | tier1 | API view for daily trading volume (USD) by token and pool, sourced from fct_execution_pools_daily. | | /v1/execution/execution_pools/daily | GET | tier1 | API view for daily fee revenue (USD) by token and pool, sourced from fct_execution_pools_daily. | | /v1/execution/execution_pools/daily | GET | tier1 | API view for daily LP activity (Mint/Burn event counts) per pool per token, unpivoted into one ro... | | /v1/execution/execution_pools/daily | GET | tier1 | API view for fee APR (7D trailing) time series by token and pool label (Uniswap V3/Swapr V3 only)... | | /v1/execution/execution_pools/daily | GET | tier1 | API view for daily swap event count by token and pool, sourced from fct_execution_pools_daily. | | /v1/execution/execution_pools/daily | GET | tier1 | API view for net APR (fee APR plus LVR) time series by token and pool label, with fee APR and LVR... | | /v1/execution/execution_pools/daily | GET | tier1 | -- | | /v1/execution/execution_pools/daily | GET | tier1 | API view for pool TVL (USD) time series by token and pool label. | | /v1/execution/execution_pools/snapshot | GET | tier1 | -- | | /v1/execution/execution_pools/snapshot | GET | tier1 | -- | | /v1/execution/execution_pools/snapshot | GET | tier1 | API view for 7-day total trading volume per token (snapshot from fct_execution_pools_snapshots). | | /v1/execution/execution_pools/snapshot | GET | tier1 | -- | | /v1/execution/execution_pools_lps_count/last_7d | GET | tier1 | API view for unique LP provider count over the last 7 days per token. | | /v1/execution/gnosis_app_activity_by_action_daily/daily | GET | tier1 | FastAPI view over fct_execution_gnosis_app_activity_by_action_daily. Params: activity_kind, start... | | /v1/execution/gnosis_app_activity_by_action_monthly/monthly | GET | tier1 | FastAPI view over fct_execution_gnosis_app_activity_by_action_monthly. | | /v1/execution/gnosis_app_activity_by_action_weekly/weekly | GET | tier1 | FastAPI view over fct_execution_gnosis_app_activity_by_action_weekly. | | /v1/execution/gnosis_app_churn_monthly/monthly | GET | tier1 | FastAPI view over fct_execution_gnosis_app_churn_monthly. Params: scope, start_month, end_month. | | /v1/execution/gnosis_app_gpay_topups_by_token_daily/daily | GET | tier1 | FastAPI endpoint view of fct_execution_gnosis_app_gpay_topups_by_token_daily. Supports query para... | | /v1/execution/gnosis_app_gpay_topups_cohort_monthly/monthly | GET | tier1 | FastAPI view over fct_execution_gnosis_app_gpay_topups_cohort_monthly. Params: start_month, end_m... | | /v1/execution/gnosis_app_gpay_topups_monthly/monthly | GET | tier1 | FastAPI view over fct_execution_gnosis_app_gpay_topups_monthly. | | /v1/execution/gnosis_app_gpay_topups_weekly/weekly | GET | tier1 | FastAPI view over fct_execution_gnosis_app_gpay_topups_weekly. | | /v1/execution/gnosis_app_gpay_wallets_daily/daily | GET | tier1 | FastAPI endpoint view of fct_execution_gnosis_app_gpay_wallets_daily. Supports query params: onbo... | | /v1/execution/gnosis_app_kpi_churn_rate/last_month | GET | tier0 | KPI: latest-month 'Any'-scope churn rate. | | /v1/execution/gnosis_app_kpi_dau/last_day | GET | tier0 | KPI: DAU yesterday with pct change vs the day before. | | /v1/execution/gnosis_app_kpi_gp_wallets/snapshot | GET | tier0 | KPI: count of GP wallets currently GA-owned. | | /v1/execution/gnosis_app_kpi_gp_wallets_imported/snapshot | GET | tier0 | KPI: cumulative GP wallets imported (pre-existing GP users who added GA). | | /v1/execution/gnosis_app_kpi_gp_wallets_onboarded/snapshot | GET | tier0 | KPI: cumulative GP wallets onboarded via Gnosis App. | | /v1/execution/gnosis_app_kpi_marketplace_buys/last_7d | GET | tier0 | KPI: marketplace buys in the last 7 full days. | | /v1/execution/gnosis_app_kpi_marketplace_buys_total/snapshot | GET | tier0 | KPI: lifetime marketplace buys across all curated offers. | | /v1/execution/gnosis_app_kpi_marketplace_payers/last_7d | GET | tier0 | KPI: distinct marketplace payers in the last 7 full days. | | /v1/execution/gnosis_app_kpi_mau/last_month | GET | tier0 | KPI: MAU for the latest complete month with pct change vs prior. | | /v1/execution/gnosis_app_kpi_new_users/last_7d | GET | tier0 | KPI: new users in the last 7 full days with pct change vs prior 7d. | | /v1/execution/gnosis_app_kpi_repeat_purchase_rate/last_30d | GET | tier0 | KPI: share of last-30d active users with ≥2 swap_filled or marketplace_buy events. | | /v1/execution/gnosis_app_kpi_retention_pct/last_month | GET | tier0 | KPI: latest-cohort M1 retention %. | | /v1/execution/gnosis_app_kpi_swap_volume/last_7d | GET | tier0 | KPI: filled-swap USD volume in the last 7 full days. | | /v1/execution/gnosis_app_kpi_swaps/last_7d | GET | tier0 | KPI: signed swap count in the last 7 full days. | | /v1/execution/gnosis_app_kpi_token_offer_claimers/last_7d | GET | tier0 | KPI: distinct token-offer claimers in the last 7 full days. | | /v1/execution/gnosis_app_kpi_token_offer_claims/last_7d | GET | tier0 | KPI: token-offer claim count in the last 7 full days with pct change vs prior 7d. | | /v1/execution/gnosis_app_kpi_token_offer_volume/last_7d | GET | tier0 | KPI: token-offer received-side USD volume in the last 7 full days. | | /v1/execution/gnosis_app_kpi_topup_volume/last_7d | GET | tier0 | KPI: topup USD volume in the last 7 full days. | | /v1/execution/gnosis_app_kpi_topups/last_7d | GET | tier0 | KPI: topup count in the last 7 full days. | | /v1/execution/gnosis_app_kpi_total_users/snapshot | GET | tier0 | KPI: total distinct GA users to date. Returns (value, change_pct). | | /v1/execution/gnosis_app_marketplace_buys_cumulative_daily/daily | GET | tier1 | FastAPI endpoint view of fct_execution_gnosis_app_marketplace_buys_cumulative_daily. Supports que... | | /v1/execution/gnosis_app_marketplace_buys_daily/daily | GET | tier1 | FastAPI endpoint view of fct_execution_gnosis_app_marketplace_buys_daily. Supports query params: ... | | /v1/execution/gnosis_app_marketplace_offers_latest/snapshot | GET | tier1 | FastAPI endpoint view of fct_execution_gnosis_app_marketplace_offers_latest. Supports query param... | | /v1/execution/gnosis_app_retention_by_action_monthly/monthly | GET | tier1 | FastAPI view over fct_execution_gnosis_app_retention_by_action_monthly. Params: activity_kind, st... | | /v1/execution/gnosis_app_retention_monthly/monthly | GET | tier1 | FastAPI view over fct_execution_gnosis_app_retention_monthly. Params: start_month, end_month. | | /v1/execution/gnosis_app_swaps_by_pair_daily/daily | GET | tier1 | FastAPI view over fct_execution_gnosis_app_swaps_by_pair_daily. Params: pair, start_date, end_date. | | /v1/execution/gnosis_app_swaps_by_solver_daily/daily | GET | tier1 | FastAPI view over fct_execution_gnosis_app_swaps_by_solver_daily. Params: solver, start_date, end... | | /v1/execution/gnosis_app_swaps_daily/daily | GET | tier1 | FastAPI endpoint view of fct_execution_gnosis_app_swaps_daily. Supports query params: start_date,... | | /v1/execution/gnosis_app_swaps_monthly/monthly | GET | tier1 | FastAPI view over fct_execution_gnosis_app_swaps_monthly. | | /v1/execution/gnosis_app_swaps_weekly/weekly | GET | tier1 | FastAPI view over fct_execution_gnosis_app_swaps_weekly. | | /v1/execution/gnosis_app_token_offer_claims_by_offer_daily/daily | GET | tier1 | FastAPI view over fct_execution_gnosis_app_token_offer_claims_by_offer_daily. Params: offer_addre... | | /v1/execution/gnosis_app_token_offer_claims_cohort_monthly/monthly | GET | tier1 | FastAPI view over fct_execution_gnosis_app_token_offer_claims_cohort_monthly. Params: start_month... | | /v1/execution/gnosis_app_token_offer_claims_daily/daily | GET | tier1 | FastAPI view over fct_execution_gnosis_app_token_offer_claims_daily. Params: start_date, end_date. | | /v1/execution/gnosis_app_token_offer_claims_monthly/monthly | GET | tier1 | FastAPI view over fct_execution_gnosis_app_token_offer_claims_monthly. Params: start_date, end_date. | | /v1/execution/gnosis_app_token_offer_claims_weekly/weekly | GET | tier1 | FastAPI view over fct_execution_gnosis_app_token_offer_claims_weekly. Params: start_date, end_date. | | /v1/execution/gnosis_app_user_activity/daily | GET, POST | tier1 | Account-facing Gnosis App activity view. | | /v1/execution/gnosis_app_user_profile/latest | GET, POST | tier1 | Account-facing Gnosis App profile view from production current-user models. | | /v1/execution/gnosis_app_users_daily/daily | GET | tier1 | FastAPI view over fct_execution_gnosis_app_users_daily. Params: start_date, end_date. | | /v1/execution/gnosis_app_users_monthly/monthly | GET | tier1 | FastAPI view over fct_execution_gnosis_app_users_monthly. Params: start_month, end_month. | | /v1/execution/gnosis_app_users_weekly/weekly | GET | tier1 | FastAPI view over fct_execution_gnosis_app_users_weekly. Params: start_date, end_date. | | /v1/execution/gpay_active_users/last_7d | GET | tier0 | 7-day active user count with period-over-period change percentage for Gnosis Pay. | | /v1/execution/gpay_active_users_weekly/weekly | GET | tier1 | Weekly time series of Gnosis Pay active user counts. | | /v1/execution/gpay_activity_by_action_daily/daily | GET | tier1 | Daily Gnosis Pay activity metrics broken down by action type, with counts and volumes. | | /v1/execution/gpay_activity_by_action_monthly/monthly | GET | tier1 | Monthly Gnosis Pay activity metrics broken down by action type, with counts and volumes. | | /v1/execution/gpay_activity_by_action_weekly/weekly | GET | tier1 | Weekly Gnosis Pay activity metrics broken down by action type, with counts and volumes. | | /v1/execution/gpay_balance_cohorts_holders_daily/daily | GET | tier1 | Daily count of Gnosis Pay wallet holders in each balance cohort bucket by token. | | /v1/execution/gpay_balance_cohorts_value_daily/daily | GET | tier1 | Daily total value held in each balance cohort bucket by token, in native and USD. | | /v1/execution/gpay_balances_by_token_daily/daily | GET | tier1 | Daily total Gnosis Pay wallet balances by token in USD. | | /v1/execution/gpay_balances_native_daily/daily | GET | tier1 | Daily total Gnosis Pay wallet balances by token in native units. | | /v1/execution/gpay_balances_usd_daily/daily | GET | tier1 | Daily total Gnosis Pay wallet balances by token in USD. | | /v1/execution/gpay_cashback_7d/7d | GET | tier0 | 7-day cashback summary with unit breakdown and period-over-period change percentage. | | /v1/execution/gpay_cashback_cohort_retention_monthly/monthly | GET | tier1 | Monthly cashback cohort retention heatmap data showing retention and amount percentages across co... | | /v1/execution/gpay_cashback_cohort_retention_users_monthly/monthly | GET | tier1 | Monthly cashback cohort sizes over time, formatted for time series visualization. | | /v1/execution/gpay_cashback_cumulative/weekly | GET | tier1 | Cumulative cashback distributed over time by unit. | | /v1/execution/gpay_cashback_dist_weekly/weekly | GET | tier1 | Weekly cashback distribution percentiles for Gnosis Pay users. | | /v1/execution/gpay_cashback_impact_monthly/monthly | GET | tier1 | Monthly cashback impact analysis comparing payment behavior between user segments. Passes through... | | /v1/execution/gpay_cashback_recipients_7d/7d | GET | tier0 | 7-day unique cashback recipient count with period-over-period change percentage. | | /v1/execution/gpay_cashback_recipients_total/all_time | GET | tier0 | All-time total count of unique Gnosis Pay cashback recipients. | | /v1/execution/gpay_cashback_recipients_weekly/weekly | GET | tier1 | Weekly time series of unique Gnosis Pay cashback recipient counts. | | /v1/execution/gpay_cashback_total/all_time | GET | tier0 | All-time total cashback distributed by unit. | | /v1/execution/gpay_cashback_weekly/weekly | GET | tier1 | Weekly cashback amounts distributed by unit. | | /v1/execution/gpay_churn_monthly/monthly | GET | tier1 | Monthly user churn breakdown for Gnosis Pay showing user segments and rates by activity scope. | | /v1/execution/gpay_churn_rates_monthly/monthly | GET | tier1 | Monthly churn and retention rates for Gnosis Pay by activity scope. | | /v1/execution/gpay_flows_snapshots/in_ranges | GET | tier1 | Token flow patterns between Gnosis Pay wallet labels for API consumption. | | /v1/execution/gpay_funded_addresses_daily/daily | GET | tier1 | Daily time series of cumulative funded Gnosis Pay wallet addresses. | | /v1/execution/gpay_funded_addresses_monthly/monthly | GET | tier1 | Monthly time series of cumulative funded Gnosis Pay wallet addresses. | | /v1/execution/gpay_funded_addresses_weekly/weekly | GET | tier1 | Weekly time series of cumulative funded Gnosis Pay wallet addresses. | | /v1/execution/gpay_gno_balance_daily/daily | GET | tier1 | Daily total GNO token balance across all Gnosis Pay wallets. | | /v1/execution/gpay_gno_total_balance/all_time | GET | tier0 | Current total GNO token balance across all Gnosis Pay wallets. | | /v1/execution/gpay_kpi_monthly/monthly | GET | tier1 | Monthly KPIs for Gnosis Pay, passing through all columns from the fact model. | | /v1/execution/gpay_owner_balances_by_token_daily/daily | GET | tier1 | Daily total Gnosis Pay owner balances by token in USD. | | /v1/execution/gpay_owner_total_balance/all_time | GET | tier0 | Current total balance across all Gnosis Pay wallet owners in USD. | | /v1/execution/gpay_payments/last_7d | GET | tier0 | 7-day payment count with period-over-period change percentage. | | /v1/execution/gpay_payments_by_token_daily/daily | GET | tier1 | Daily payment counts by token for Gnosis Pay. | | /v1/execution/gpay_payments_by_token_monthly/monthly | GET | tier1 | Monthly payment counts by token for Gnosis Pay. | | /v1/execution/gpay_payments_by_token_weekly/weekly | GET | tier1 | Weekly payment counts by token for Gnosis Pay. | | /v1/execution/gpay_payments_hourly/hourly | GET | tier1 | Hourly payment counts by token for Gnosis Pay. | | /v1/execution/gpay_retention_by_action_monthly/monthly | GET | tier1 | Monthly cohort retention heatmap data for Gnosis Pay broken down by action type. | | /v1/execution/gpay_retention_by_action_users_monthly/monthly | GET | tier1 | Monthly cohort user counts over time by action type, formatted for time series visualization. | | /v1/execution/gpay_retention_monthly/monthly | GET | tier1 | Monthly cohort user counts over time, formatted for time series visualization. | | /v1/execution/gpay_retention_pct_monthly/monthly | GET | tier1 | Monthly cohort retention heatmap data for all Gnosis Pay activity. | | /v1/execution/gpay_retention_volume_monthly/monthly | GET | tier1 | Monthly cohort volume retention over time, formatted for time series visualization. | | /v1/execution/gpay_total_balance/all_time | GET | tier0 | Current total balance across all Gnosis Pay wallets in USD. | | /v1/execution/gpay_total_funded/all_time | GET | tier0 | All-time total count of funded Gnosis Pay wallets (users who made at least one payment). | | /v1/execution/gpay_total_payments/all_time | GET | tier0 | All-time total count of Gnosis Pay payments. | | /v1/execution/gpay_total_volume/all_time | GET | tier0 | All-time total payment volume for Gnosis Pay in USD. | | /v1/execution/gpay_user_activity | GET, POST | tier0 | Individual transaction-level activity for a specific Gnosis Pay user, filtered by wallet address. | | /v1/execution/gpay_user_balances_daily/daily | GET, POST | tier0 | Daily token balances for a specific Gnosis Pay user in native and USD values. | | /v1/execution/gpay_user_balances_latest/latest | GET, POST | tier0 | Simple API view over latest Gnosis Pay wallet balances. | | /v1/execution/gpay_user_cashback_daily/daily | GET, POST | tier0 | Daily cashback amounts for a specific Gnosis Pay user. | | /v1/execution/gpay_user_lifetime_metrics/all_time | GET, POST | tier0 | Lifetime metrics for a specific Gnosis Pay user, passing through all columns from the fact model. | | /v1/execution/gpay_user_payments_daily/daily | GET, POST | tier0 | Daily payment amounts by token for a specific Gnosis Pay user. | | /v1/execution/gpay_user_top_wallets/snapshot | GET | tier0 | -- | | /v1/execution/gpay_user_total_cashback/all_time | GET, POST | tier0 | All-time total cashback for a specific Gnosis Pay user. | | /v1/execution/gpay_user_total_payments/all_time | GET, POST | tier0 | All-time total payment count for a specific Gnosis Pay user. | | /v1/execution/gpay_user_total_volume/all_time | GET, POST | tier0 | All-time total payment volume for a specific Gnosis Pay user. | | /v1/execution/gpay_volume/last_7d | GET | tier0 | 7-day payment volume with period-over-period change percentage. | | /v1/execution/gpay_volume_payments_by_token_daily/daily | GET | tier1 | Daily payment volume by token in USD for Gnosis Pay. | | /v1/execution/gpay_volume_payments_by_token_monthly/monthly | GET | tier1 | Monthly payment volume by token in USD for Gnosis Pay. | | /v1/execution/gpay_volume_payments_by_token_weekly/weekly | GET | tier1 | Weekly payment volume by token in USD for Gnosis Pay. | | /v1/execution/gpay_wallet_balance_composition/latest | GET | tier1 | Current balance composition of a Gnosis Pay wallet by token. | | /v1/execution/holders_per_token/latest | GET | tier1 | This model provides the latest snapshot of the number of holders for each API token, aggregated b... | | /v1/execution/holders_per_token/daily | GET | tier1 | The api_execution_tokens_holders_daily model provides daily aggregated data on the number of uniq... | | /v1/execution/lending_top_lenders/latest | GET | tier1 | Thin API view over fct_execution_lending_top_lenders_latest. Dashboard applies token and protocol... | | /v1/execution/mixpanel_gpay_crossdomain_daily/daily | GET | tier3 | API view (tier3, internal) for Gnosis App Mixpanel to Gnosis Pay cross-domain daily metrics. | | /v1/execution/projects_and_sectors_count/total | GET | tier0 | This view aggregates the total number of distinct projects and sectors crawled, providing a high-... | | /v1/execution/rwa_backedfi_prices/daily | GET | tier1 | The api_execution_rwa_backedfi_prices_daily model provides daily pricing data for RWA-backed fina... | | /v1/execution/safe_details/latest | GET, POST | tier2 | One row per Safe contract with deployment metadata + current-owner-count + current-threshold. Pow... | | /v1/execution/safes_current_owners/latest | GET, POST | tier2 | Per-Safe owner list (add-only snapshot). One row per (safe, owner) pair where the last observed e... | | /v1/execution/state_size/daily | GET | tier1 | The api_execution_state_full_size_daily model provides daily aggregated data on the size of API e... | | /v1/execution/token_balances/daily | GET, POST | tier1 | -- | | /v1/execution/tokens_overview/latest | GET | tier1 | -- | | /v1/execution/tokens_supply/latest | GET | tier1 | This model provides the latest supply values for each API token based on daily recorded data, ena... | | /v1/execution/tokens_supply/daily | GET | tier1 | The api_execution_tokens_supply_daily model provides daily aggregated data on the supply of diffe... | | /v1/execution/tokens_supply_by_sector/latest | GET | tier1 | -- | | /v1/execution/tokens_supply_distribution/latest | GET | tier1 | -- | | /v1/execution/tokens_top_holders/latest | GET | tier1 | Thin API view over fct_execution_tokens_top_holders_latest. Returns all holders ranked by balance... | | /v1/execution/tokens_volume/daily | GET | tier1 | The api_execution_tokens_volume_daily model provides daily aggregated data on the trading volume ... | | /v1/execution/transactions_coun_per_project_top5/monthly | GET | tier1 | This view aggregates the top 5 projects by transaction count on a monthly basis, enabling analysi... | | /v1/execution/transactions_count/last_7d | GET | tier0 | The api_execution_transactions_7d model provides a snapshot of the total number of API execution ... | | /v1/execution/transactions_count/all_time | GET | tier0 | The api_execution_transactions_total model provides a consolidated count of API execution transac... | | /v1/execution/transactions_count_per_project/all_time | GET | tier0 | This view aggregates the total number of API execution transactions across all projects over the ... | | /v1/execution/transactions_count_per_project_top20/in_ranges | GET | tier0 | This view aggregates the top 20 API transaction counts per project within specified time ranges, ... | | /v1/execution/transactions_count_per_sector/daily | GET | tier1 | The api_execution_transactions_by_sector_daily model provides daily aggregated counts of API exec... | | /v1/execution/transactions_count_per_sector/weekly | GET | tier1 | The api_execution_transactions_by_sector_weekly model aggregates the number of API execution tran... | | /v1/execution/transactions_count_per_sector/hourly | GET | tier1 | This view aggregates the total number of API execution transactions per sector on an hourly basis... | | /v1/execution/transactions_count_per_type/daily | GET | tier1 | The api_execution_transactions_cnt_daily model provides a daily summary of successful API transac... | | /v1/execution/transactions_count_per_type/all_time | GET | tier0 | This view aggregates the total number of successful API transactions grouped by transaction type ... | | /v1/execution/transactions_fees/last_7d | GET | tier0 | The api_execution_transactions_fees_native_7d model provides a snapshot of native transaction fee... | | /v1/execution/transactions_fees/all_time | GET | tier0 | The api_execution_transactions_fees_native_total model aggregates total native execution transa... | | /v1/execution/transactions_fees_per_project/all_time | GET | tier0 | This view aggregates total native execution transaction fees per project over the entire availabl... | | /v1/execution/transactions_fees_per_project_top20/in_ranges | GET | tier0 | This view aggregates the top 20 native API transaction fee buckets by project for different time ... | | /v1/execution/transactions_fees_per_project_top5/monthly | GET | tier1 | This view aggregates the top 5 projects by native transaction fees on a monthly basis, providing ... | | /v1/execution/transactions_fees_per_sector/daily | GET | tier1 | This view aggregates daily native transaction fees by sector, providing insights into sector-spec... | | /v1/execution/transactions_fees_per_sector/weekly | GET | tier1 | This view aggregates native transaction fees by sector on a weekly basis to support analysis of f... | | /v1/execution/transactions_fees_per_sector/hourly | GET | tier1 | This view aggregates native transaction fees by sector on an hourly basis, providing insights int... | | /v1/execution/transactions_gas_share_per_project/daily | GET | tier1 | This view calculates the daily share of gas used by each project in relation to the total gas con... | | /v1/execution/transactions_gas_used/daily | GET | tier1 | This view aggregates daily gas consumption and pricing metrics for successful API transaction exe... | | /v1/execution/transactions_gas_used/weekly | GET | tier1 | This view aggregates weekly gas usage for successful API transactions, categorized by transaction... | | /v1/execution/transactions_initiators_count/last_7d | GET | tier0 | This view provides a snapshot of the number of active accounts involved in API transactions over ... | | /v1/execution/transactions_initiators_count/all_time | GET | tier0 | The api_execution_transactions_active_accounts_total model provides a snapshot of the total num... | | /v1/execution/transactions_initiators_count_per_project/all_time | GET | tier0 | This view provides a snapshot of the total number of active accounts involved in API execution tr... | | /v1/execution/transactions_initiators_count_per_project_top20/in_ranges | GET | tier0 | This model identifies the top 20 project ranges with the highest number of active accounts over d... | | /v1/execution/transactions_initiators_count_per_project_top5/monthly | GET | tier1 | This view aggregates the number of active accounts involved in API execution transactions, focusi... | | /v1/execution/transactions_initiators_count_per_sector/daily | GET | tier1 | This view provides daily counts of active accounts involved in API transaction initiations, segme... | | /v1/execution/transactions_initiators_count_per_sector/weekly | GET | tier1 | This view provides weekly counts of active accounts involved in API execution transactions, segme... | | /v1/execution/transactions_initiators_count_per_sector/hourly | GET | tier1 | This view aggregates the count of active accounts involved in API execution transactions, segment... | | /v1/execution/transactions_xdai_value/daily | GET | tier1 | This view aggregates daily transaction values for API executions on the xDai network, providing i... | | /v1/execution/yields_overview/latest | GET | tier0 | -- | | /v1/execution/yields_overview/latest | GET | tier0 | -- | | /v1/execution/yields_overview/latest | GET | tier0 | Overview KPI card for total Aave V3 lending TVL with 7-day change percentage. | | /v1/execution/yields_overview/latest | GET | tier0 | -- | | /v1/execution/yields_overview/latest | GET | tier0 | -- | | /v1/execution/yields_overview/latest | GET | tier0 | -- | | /v1/execution/yields_overview/latest | GET | tier0 | -- | | /v1/execution/yields_overview/latest | GET | tier0 | -- | | /v1/execution/yields_user_activity | GET | tier0 | -- | | /v1/execution/yields_user_fee_collections_daily/daily | GET | tier0 | -- | | /v1/execution/yields_user_kpis/all_time | GET | tier0 | -- | | /v1/execution/yields_user_lending_balances_daily/daily | GET | tier0 | -- | | /v1/execution/yields_user_lending_positions | GET | tier0 | -- | | /v1/execution/yields_user_lp_positions | GET | tier0 | -- | | /v1/execution/yields_user_top_wallets/snapshot | GET | tier0 | -- | | /v1/p2p/clients_count/latest | GET | tier0 | This view provides the latest counts and percentage changes of P2P clients for discv4 and discv5 ... | | /v1/p2p/discv4_clients_count/latest | GET | tier0 | The api_p2p_discv4_clients_latest view provides the most recent aggregated counts of Discv4 P2P c... | | /v1/p2p/discv4_clients_count/daily | GET | tier1 | The api_p2p_discv4_clients_daily view tracks daily metrics related to the number of Discv4 client... | | /v1/p2p/discv5_clients_count/latest | GET | tier0 | The api_p2p_discv5_clients_latest model provides a snapshot of the latest Discv5 peer-to-peer cli... | | /v1/p2p/discv5_clients_count/daily | GET | tier1 | The api_p2p_discv5_clients_daily model tracks daily metrics related to Discv5 clients in the P2P ... | | /v1/p2p/discv5_current_fork_count/daily | GET | tier1 | The api_p2p_discv5_current_fork_daily view tracks the daily count of current Discv5 network for... | | /v1/p2p/discv5_next_fork_count/daily | GET | tier1 | The api_p2p_discv5_next_fork_daily model provides daily counts of upcoming Discv5 network forks, ... | | /v1/p2p/network_topology/latest | GET | tier0 | The api_p2p_topology_latest model provides a real-time view of peer-to-peer network topology, cap... | | /v1/p2p/visits_per_protocol/latest | GET | tier0 | This view provides the latest daily visit metrics for P2P protocols (discv4 and discv5), includin... | | /v1/unknown/carbon_emissions/quarterly | GET, POST | tier0 | Quarterly annualised CO2 emissions (tonnes/yr) from end-of-quarter snapshot, with estimation flag... | | /v1/unknown/circles_active_trusts/quarterly | GET, POST | tier0 | End-of-quarter active trust links in Circles v2. | | /v1/unknown/circles_humans/quarterly | GET, POST | tier0 | End-of-quarter total registered human avatars in Circles v2. | | /v1/unknown/circles_total_supply/quarterly | GET, POST | tier0 | End-of-quarter Circles v2 token supply (raw and demurraged). | | /v1/unknown/energy_consumption/quarterly | GET, POST | tier0 | Quarterly annualised energy consumption (MWh/yr) from end-of-quarter snapshot, with estimation fl... | | /v1/unknown/gnosis_app_peak_swappers/quarterly | GET, POST | tier0 | Peak daily unique swappers on Gnosis App within the quarter. | | /v1/unknown/gnosis_app_swap_volume/quarterly | GET, POST | tier0 | Total swap volume in USD on Gnosis App per quarter. | | /v1/unknown/gnosis_app_swaps/quarterly | GET, POST | tier0 | Total swap transactions on Gnosis App per quarter. | | /v1/unknown/gnosis_app_swaps_filled/quarterly | GET, POST | tier0 | Total filled swap transactions on Gnosis App per quarter. | | /v1/unknown/gpay_active_users/quarterly | GET, POST | tier0 | Peak monthly active users for Gnosis Pay within the quarter. | | /v1/unknown/gpay_cashback/quarterly | GET, POST | tier0 | Total Gnosis Pay cashback in USD per quarter. | | /v1/unknown/gpay_payments/quarterly | GET, POST | tier0 | Total Gnosis Pay payment transactions per quarter. | | /v1/unknown/gpay_volume/quarterly | GET, POST | tier0 | Total Gnosis Pay payment volume in USD per quarter. | | /v1/unknown/mixpanel_events_daily/daily | GET | tier3 | API view (tier3, internal) for daily Gnosis App event counts by event_name. | | /v1/unknown/mixpanel_funnel_daily/daily | GET | tier3 | API view (tier3, internal) for Gnosis App daily funnel conversion metrics across onboarding, swap... | | /v1/unknown/mixpanel_geo_daily/daily | GET | tier3 | API view (tier3, internal) for daily Gnosis App geography (country-level only for privacy). | | /v1/unknown/mixpanel_modals_daily/daily | GET | tier3 | API view (tier3, internal) for daily Gnosis App modal/bottom-sheet open counts. Filter by bottom_... | | /v1/unknown/mixpanel_overview_daily/daily | GET | tier3 | API view (tier3, internal) wrapping fct_mixpanel_ga_overview_daily. Gnosis App web analytics KPIs... | | /v1/unknown/mixpanel_pages_daily/daily | GET | tier3 | API view (tier3, internal) for daily Gnosis App page-path analytics. | | /v1/unknown/mixpanel_tech_daily/daily | GET | tier3 | API view (tier3, internal) for daily Gnosis App browser/OS/device breakdown. | | /v1/unknown/mixpanel_traffic_daily/daily | GET | tier3 | API view (tier3, internal) for daily Gnosis App traffic by referring domain. | | /v1/unknown/mixpanel_usage_patterns_daily/daily | GET | tier3 | API view (tier3, internal) for Gnosis App hourly and day-of-week usage patterns. | | /v1/unknown/mixpanel_users_daily/daily | GET | tier3 | API view (tier3, internal) for per-user daily Gnosis App activity (hashed user IDs). | | /v1/unknown/nodes_estimated/quarterly | GET, POST | tier0 | Quarterly end-of-quarter estimated total node count (observed + unobserved) with 95% confidence i... | | /v1/unknown/nodes_observed/quarterly | GET, POST | tier0 | Quarterly end-of-quarter observed (directly reachable) node count from the node classification mo... | | /v1/unknown/revenue_active_users_cohorts_monthly/monthly | GET | tier0 | API view over fct_revenue_active_users_cohorts_monthly. | | /v1/unknown/revenue_active_users_cohorts_weekly/weekly | GET | tier0 | API view over fct_revenue_active_users_cohorts_weekly. | | /v1/unknown/revenue_active_users_totals_monthly/monthly | GET | tier0 | API view over fct_revenue_active_users_totals_monthly. | | /v1/unknown/revenue_active_users_totals_weekly/weekly | GET | tier0 | API view over fct_revenue_active_users_totals_weekly. | | /v1/unknown/revenue_gpay_cohorts_monthly/monthly | GET | tier0 | API view over fct_revenue_gpay_cohorts_monthly. | | /v1/unknown/revenue_gpay_cohorts_weekly/weekly | GET | tier0 | API view over fct_revenue_gpay_cohorts_weekly. | | /v1/unknown/revenue_gpay_eure_cohorts_monthly/monthly | GET | tier0 | EURe Gnosis Pay monthly cohort API view. | | /v1/unknown/revenue_gpay_eure_cohorts_weekly/weekly | GET | tier0 | EURe Gnosis Pay rolling-52w cohort API view. | | /v1/unknown/revenue_gpay_gbpe_cohorts_monthly/monthly | GET | tier0 | GBPe Gnosis Pay monthly cohort API view. | | /v1/unknown/revenue_gpay_gbpe_cohorts_weekly/weekly | GET | tier0 | GBPe Gnosis Pay rolling-52w cohort API view. | | /v1/unknown/revenue_gpay_usdce_cohorts_monthly/monthly | GET | tier0 | USDC.e Gnosis Pay monthly cohort API view. | | /v1/unknown/revenue_gpay_usdce_cohorts_weekly/weekly | GET | tier0 | USDC.e Gnosis Pay rolling-52w cohort API view. | | /v1/unknown/revenue_holdings_brla_cohorts_monthly/monthly | GET | tier0 | BRLA holdings monthly cohort API view. | | /v1/unknown/revenue_holdings_brla_cohorts_weekly/weekly | GET | tier0 | BRLA holdings rolling-52w cohort API view. | | /v1/unknown/revenue_holdings_cohorts_monthly/monthly | GET | tier0 | API view over fct_revenue_holdings_cohorts_monthly. | | /v1/unknown/revenue_holdings_cohorts_weekly/weekly | GET | tier0 | API view over fct_revenue_holdings_cohorts_weekly. | | /v1/unknown/revenue_holdings_eure_cohorts_monthly/monthly | GET | tier0 | EURe holdings monthly cohort API view. | | /v1/unknown/revenue_holdings_eure_cohorts_weekly/weekly | GET | tier0 | EURe holdings rolling-52w cohort API view. | | /v1/unknown/revenue_holdings_usdce_cohorts_monthly/monthly | GET | tier0 | USDC.e holdings monthly cohort API view. | | /v1/unknown/revenue_holdings_usdce_cohorts_weekly/weekly | GET | tier0 | USDC.e holdings rolling-52w cohort API view. | | /v1/unknown/revenue_holdings_zchf_cohorts_monthly/monthly | GET | tier0 | ZCHF holdings monthly cohort API view. | | /v1/unknown/revenue_holdings_zchf_cohorts_weekly/weekly | GET | tier0 | ZCHF holdings rolling-52w cohort API view. | | /v1/unknown/revenue_sdai_cohorts_monthly/monthly | GET | tier0 | API view over fct_revenue_sdai_cohorts_monthly. | | /v1/unknown/revenue_sdai_cohorts_weekly/weekly | GET | tier0 | API view over fct_revenue_sdai_cohorts_weekly. | | /v1/unknown/stablecoin_holder_cohorts/quarterly | GET, POST | tier0 | End-of-quarter stablecoin holder distribution by USD balance bucket, split into USD-pegged (WxDAI... | | /v1/unknown/stablecoin_holders/quarterly | GET, POST | tier0 | Quarterly stablecoin holder statistics on Gnosis Chain, split by peg class. Shows median, max, an... | | /v1/unknown/stablecoin_supply/quarterly | GET, POST | tier0 | Quarterly stablecoin supply statistics on Gnosis Chain, split by peg class (USD-pegged vs non-USD... | | /v1/unknown/stablecoin_transfers/quarterly | GET, POST | tier0 | Quarterly stablecoin transfer count and volume on Gnosis Chain, split by peg class (USD-pegged vs... | | /v1/unknown/staked_gno/quarterly | GET, POST | tier0 | End-of-quarter GNO staked on Gnosis Chain (effective balance / 32). | | /v1/unknown/transactions_count/quarterly | GET, POST | tier0 | Total successful transactions per quarter on Gnosis Chain. | | /v1/unknown/validators_active/quarterly | GET, POST | tier0 | End-of-quarter count of active validators on Gnosis Chain. |

Next Steps¶

• Filtering & Pagination -- Learn how to query endpoints with filters, pagination, and sort.
• Authentication -- Understand the tier system and API key usage.
• Swagger UI -- Explore endpoints interactively in the browser.