{"openapi":"3.1.0","info":{"title":"Gnosis Cerebro Data API","description":"\n**Gnosis Cerebro API** - Data API dynamically generated from the `dbt-cerebro` manifest.\nServes data directly from ClickHouse with authentication and tier-based access control.\n\n---\n\n**Authentication:** Tier1+ endpoints require the header `X-API-Key: <your_key>`.\nTier0 endpoints are publicly accessible without authentication.\n\n**Access Tiers:**\n\n    - tier0 → Public   (100/min, no key required)\n    - tier1 → Partner  (500/min)\n    - tier2 → Premium  (1000/min)\n    - tier3 → Internal (10k/min)\n","version":"v1"},"paths":{"/":{"get":{"tags":["System"],"summary":"Root","operationId":"root__get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/system/manifest/refresh":{"post":{"tags":["System"],"summary":"Refresh Manifest","operationId":"refresh_manifest_v1_system_manifest_refresh_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/bridges/bridges_count/latest":{"get":{"tags":["Bridges"],"summary":"Bridges Count (latest)","description":"**Required Access:** `tier0` (no API key required)\n\nThis model provides the most recent count of distinct bridges tracked over time, serving as a key performance indicator for bridge coverage analysis.\n\n**Columns:**\n- **value** (`UInt64`): The latest number of unique bridges identified, representing the total count at the most recent snapshot.\n- **as_of_date** (`Date`): Date the snapshot is computed as of (max date in the underlying data).","operationId":"api_bridges_kpi_distinct_bridges_all_time_get_v1_bridges_bridges_count_latest_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"value":{"type":"integer","description":"The latest number of unique bridges identified, representing the total count at the most recent snapshot."},"as_of_date":{"type":"string","format":"date","description":"Date the snapshot is computed as of (max date in the underlying data)."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/bridges/chains_count/latest":{"get":{"tags":["Bridges"],"summary":"Chains Count (latest)","description":"**Required Access:** `tier0` (no API key required)\n\nThis dbt view provides the most recent count of distinct API bridge chains, serving as a key performance indicator for monitoring API connectivity and diversity over time.\n\n**Columns:**\n- **value** (`UInt64`): The total number of distinct API bridge chains as of the latest snapshot, representing a count metric.\n- **as_of_date** (`Date`): Date the snapshot is computed as of (max date in the underlying data).","operationId":"api_bridges_kpi_distinct_chains_all_time_get_v1_bridges_chains_count_latest_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"value":{"type":"integer","description":"The total number of distinct API bridge chains as of the latest snapshot, representing a count metric."},"as_of_date":{"type":"string","format":"date","description":"Date the snapshot is computed as of (max date in the underlying data)."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/bridges/cum_netflow_per_bridge/weekly":{"get":{"tags":["Bridges"],"summary":"Cum Netflow Per Bridge (weekly)","description":"**Required Access:** `tier1`\n\nThis view aggregates cumulative net flow in USD per bridge on a weekly basis, supporting trend analysis and reporting for infrastructure financial flows.\n\n**Columns:**\n- **date** (`Date`): The starting date of the week for which the net flow data is aggregated, formatted as a date.\n- **series** (`String`): Identifier for the specific bridge associated with the net flow data.\n- **value** (`Float64`): Cumulative net flow in USD for the specified bridge during the week.","operationId":"api_bridges_cum_netflow_weekly_by_bridge_get_v1_bridges_cum_netflow_per_bridge_weekly_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"date":{"type":"string","format":"date","description":"The starting date of the week for which the net flow data is aggregated, formatted as a date."},"series":{"type":"string","description":"Identifier for the specific bridge associated with the net flow data."},"value":{"type":"number","description":"Cumulative net flow in USD for the specified bridge during the week."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/bridges/inflow/in_ranges":{"get":{"tags":["Bridges"],"summary":"Inflow (in_ranges)","description":"**Required Access:** `tier0` (no API key required)\n\nThis view aggregates inbound token transfer flows between sources and targets over specified time ranges, supporting analysis of token inflow patterns in the Gnosis ecosystem.\n\n**Columns:**\n- **d** (`DateTime64(0, 'UTC')`): The date associated with the data, representing the latest date in the dataset for the respective range.\n- **range** (`String`): The time range over which the transactions are aggregated. Possible values include '1D', '7D', '30D', '90D', and 'All'.\n- **source** (`String`): The originating address or identifier from which the value is transferred.\n- **target** (`String`): The destination address or identifier to which the value is transferred.\n- **value** (`UInt64`): The total value transferred from source to target within the specified range. Measured in wei.\n- **as_of_date** (`Date`): Date the snapshot is computed as of (max date in the underlying data).","operationId":"api_bridges_sankey_gnosis_in_ranges_get_v1_bridges_inflow_in_ranges_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"d":{"type":"string","format":"date-time","description":"The date associated with the data, representing the latest date in the dataset for the respective range."},"range":{"type":"string","description":"The time range over which the transactions are aggregated. Possible values include '1D', '7D', '30D', '90D', and 'All'."},"source":{"type":"string","description":"The originating address or identifier from which the value is transferred."},"target":{"type":"string","description":"The destination address or identifier to which the value is transferred."},"value":{"type":"integer","description":"The total value transferred from source to target within the specified range. Measured in wei."},"as_of_date":{"type":"string","format":"date","description":"Date the snapshot is computed as of (max date in the underlying data)."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/bridges/inflow_per_token/last_7d":{"get":{"tags":["Bridges"],"summary":"Inflow Per Token (last_7d)","description":"**Required Access:** `tier0` (no API key required)\n\nThis model aggregates inbound transfer values for each token over the last 7 days, facilitating analysis of token inflows in bridge operations.\n\n**Columns:**\n- **d** (`DateTime64(0, 'UTC')`): The most recent date in the dataset, representing the end of the 7-day aggregation window.\n- **token** (`String`): The token involved in the bridge transaction, represented by its symbol or contract address.\n- **source** (`String`): The originating source of the token flow in the bridge transaction.\n- **target** (`String`): The destination target of the token flow in the bridge transaction.\n- **value** (`UInt64`): The total value of the token flow in the bridge transaction over the past 7 days, measured in the smallest unit of the token.\n- **as_of_date** (`Date`): Date the snapshot is computed as of (max date in the underlying data).","operationId":"api_bridges_sankey_gnosis_in_by_token_7d_get_v1_bridges_inflow_per_token_last_7d_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"d":{"type":"string","format":"date-time","description":"The most recent date in the dataset, representing the end of the 7-day aggregation window."},"token":{"type":"string","description":"The token involved in the bridge transaction, represented by its symbol or contract address."},"source":{"type":"string","description":"The originating source of the token flow in the bridge transaction."},"target":{"type":"string","description":"The destination target of the token flow in the bridge transaction."},"value":{"type":"integer","description":"The total value of the token flow in the bridge transaction over the past 7 days, measured in the smallest unit of the token."},"as_of_date":{"type":"string","format":"date","description":"Date the snapshot is computed as of (max date in the underlying data)."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/bridges/netflow/last_7d":{"get":{"tags":["Bridges"],"summary":"Netflow (last_7d)","description":"**Required Access:** `tier0` (no API key required)\n\nThe api_bridges_kpi_netflow_7d model provides a snapshot of net flow metrics over the last 7 days, enabling trend analysis and performance monitoring for API bridge operations.\n\n**Columns:**\n- **value** (`Float64`): The net flow value over the last 7 days, rounded to two decimal places.\n- **prev_value** (`Float64`): The net flow value for the previous 7-day period, rounded to two decimal places.\n- **change_pct** (`Float64`): The percentage change in net flow between the current and previous 7-day periods.\n- **as_of_date** (`Date`): Date the snapshot is computed as of (max date in the underlying data).","operationId":"api_bridges_kpi_netflow_7d_get_v1_bridges_netflow_last_7d_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"value":{"type":"number","description":"The net flow value over the last 7 days, rounded to two decimal places."},"prev_value":{"type":"number","description":"The net flow value for the previous 7-day period, rounded to two decimal places."},"change_pct":{"type":"number","description":"The percentage change in net flow between the current and previous 7-day periods."},"as_of_date":{"type":"string","format":"date","description":"Date the snapshot is computed as of (max date in the underlying data)."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/bridges/netflow/all_time":{"get":{"tags":["Bridges"],"summary":"Netflow (all_time)","description":"**Required Access:** `tier0` (no API key required)\n\nThis dbt view aggregates the total net flow in USD over all time periods, providing a comprehensive KPI snapshot for API bridge performance.\n\n**Columns:**\n- **value** (`Float64`): The total net flow in USD, rounded to two decimal places, representing the cumulative net flow across all time.\n- **as_of_date** (`Date`): Date the snapshot is computed as of (max date in the underlying data).","operationId":"api_bridges_kpi_total_netflow_all_time_get_v1_bridges_netflow_all_time_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"value":{"type":"number","description":"The total net flow in USD, rounded to two decimal places, representing the cumulative net flow across all time."},"as_of_date":{"type":"string","format":"date","description":"Date the snapshot is computed as of (max date in the underlying data)."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/bridges/netflow_per_token_per_bridge/daily":{"get":{"tags":["Bridges"],"summary":"Netflow Per Token Per Bridge (daily)","description":"**Required Access:** `tier1`\n\nThis view aggregates daily net flow values for each token across individual bridges and provides a combined total for all bridges, supporting analysis of token movement at a daily granularity.\n\n**Columns:**\n- **date** (`Date`): The specific calendar date for the recorded net flow data.\n- **bridge** (`String`): The name or identifier of the bridge; 'All' indicates the aggregate across all bridges.\n- **token** (`String`): The identifier of the token involved in the net flow calculation.\n- **value** (`UInt64`): The net flow value for the token on the given date, representing the total transfer amount.\n- **bridge_order** (`UInt64`): An order indicator used to prioritize specific bridge data over the 'All' category in sorting operations.","operationId":"api_bridges_token_netflow_daily_by_bridge_get_v1_bridges_netflow_per_token_per_bridge_daily_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"date":{"type":"string","format":"date","description":"The specific calendar date for the recorded net flow data."},"bridge":{"type":"string","description":"The name or identifier of the bridge; 'All' indicates the aggregate across all bridges."},"token":{"type":"string","description":"The identifier of the token involved in the net flow calculation."},"value":{"type":"integer","description":"The net flow value for the token on the given date, representing the total transfer amount."},"bridge_order":{"type":"integer","description":"An order indicator used to prioritize specific bridge data over the 'All' category in sorting operations."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/bridges/outflow/in_ranges":{"get":{"tags":["Bridges"],"summary":"Outflow (in_ranges)","description":"**Required Access:** `tier0` (no API key required)\n\nThis view aggregates outflow token transfer data across different time ranges for API bridges, supporting analysis of token flow patterns over specified periods.\n\n**Columns:**\n- **d** (`Date`): Represents the date range label (e.g., 1D, 7D, 30D, 90D, All) corresponding to the aggregation period.\n- **range** (`String`): The time range for which the transaction data is aggregated. Possible values include '1D', '7D', '30D', '90D', and 'All'.\n- **source** (`String`): The originating point of the bridge transaction, typically an address or identifier for the source network or entity.\n- **target** (`String`): The destination point of the bridge transaction, typically an address or identifier for the target network or entity.\n- **value** (`UInt64`): The total value of transactions from the source to the target within the specified range, measured in the smallest unit of the currency.\n- **as_of_date** (`Date`): Date the snapshot is computed as of (max date in the underlying data).","operationId":"api_bridges_sankey_gnosis_out_ranges_get_v1_bridges_outflow_in_ranges_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"d":{"type":"string","format":"date","description":"Represents the date range label (e.g., 1D, 7D, 30D, 90D, All) corresponding to the aggregation period."},"range":{"type":"string","description":"The time range for which the transaction data is aggregated. Possible values include '1D', '7D', '30D', '90D', and 'All'."},"source":{"type":"string","description":"The originating point of the bridge transaction, typically an address or identifier for the source network or entity."},"target":{"type":"string","description":"The destination point of the bridge transaction, typically an address or identifier for the target network or entity."},"value":{"type":"integer","description":"The total value of transactions from the source to the target within the specified range, measured in the smallest unit of the currency."},"as_of_date":{"type":"string","format":"date","description":"Date the snapshot is computed as of (max date in the underlying data)."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/bridges/outflow_per_token/last_7d":{"get":{"tags":["Bridges"],"summary":"Outflow Per Token (last_7d)","description":"**Required Access:** `tier0` (no API key required)\n\nThis view aggregates the total outflow values of tokens between sources and targets over the last 7 days, providing insights into token transfer flows within the system.\n\n**Columns:**\n- **d** (`DateTime64(0, 'UTC')`): The most recent date in the dataset, representing the end of the 7-day aggregation window.\n- **token** (`String`): The token involved in the bridge transaction, identified by its symbol.\n- **source** (`String`): The originating bridge or network of the transaction.\n- **target** (`String`): The destination bridge or network of the transaction.\n- **value** (`UInt64`): The total value of the transactions in the smallest unit of the token, aggregated over the past seven days.\n- **as_of_date** (`Date`): Date the snapshot is computed as of (max date in the underlying data).","operationId":"api_bridges_sankey_gnosis_out_by_token_7d_get_v1_bridges_outflow_per_token_last_7d_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"d":{"type":"string","format":"date-time","description":"The most recent date in the dataset, representing the end of the 7-day aggregation window."},"token":{"type":"string","description":"The token involved in the bridge transaction, identified by its symbol."},"source":{"type":"string","description":"The originating bridge or network of the transaction."},"target":{"type":"string","description":"The destination bridge or network of the transaction."},"value":{"type":"integer","description":"The total value of the transactions in the smallest unit of the token, aggregated over the past seven days."},"as_of_date":{"type":"string","format":"date","description":"Date the snapshot is computed as of (max date in the underlying data)."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/bridges/volume/last_7d":{"get":{"tags":["Bridges"],"summary":"Volume (last_7d)","description":"**Required Access:** `tier0` (no API key required)\n\nThe api_bridges_kpi_volume_7d model provides a snapshot of API volume metrics over the last 7 days, enabling trend analysis and performance monitoring.\n\n**Columns:**\n- **value** (`Float64`): The total API volume over the most recent 7-day period, rounded to two decimal places.\n- **prev_value** (`Float64`): The API volume for the previous 7-day period, rounded to two decimal places.\n- **change_pct** (`Float64`): The percentage change in API volume between the current and previous 7-day periods.\n- **as_of_date** (`Date`): Date the snapshot is computed as of (max date in the underlying data).","operationId":"api_bridges_kpi_volume_7d_get_v1_bridges_volume_last_7d_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"value":{"type":"number","description":"The total API volume over the most recent 7-day period, rounded to two decimal places."},"prev_value":{"type":"number","description":"The API volume for the previous 7-day period, rounded to two decimal places."},"change_pct":{"type":"number","description":"The percentage change in API volume between the current and previous 7-day periods."},"as_of_date":{"type":"string","format":"date","description":"Date the snapshot is computed as of (max date in the underlying data)."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/bridges/volume/all_time":{"get":{"tags":["Bridges"],"summary":"Volume (all_time)","description":"**Required Access:** `tier0` (no API key required)\n\nThe `api_bridges_kpi_total_volume_all_time` model provides the most recent total volume in USD across all bridges, serving as a key metric for overall bridge activity over time.\n\n**Columns:**\n- **value** (`Float64`): The cumulative total volume in USD, rounded to two decimal places, representing the all-time total transaction volume.\n- **as_of_date** (`Date`): Date the snapshot is computed as of (max date in the underlying data).","operationId":"api_bridges_kpi_total_volume_all_time_get_v1_bridges_volume_all_time_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"value":{"type":"number","description":"The cumulative total volume in USD, rounded to two decimal places, representing the all-time total transaction volume."},"as_of_date":{"type":"string","format":"date","description":"Date the snapshot is computed as of (max date in the underlying data)."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/celo/celo_gpay_active_users/last_7d":{"get":{"tags":["Celo"],"summary":"Celo Gpay Active Users (last_7d)","description":"**Required Access:** `tier3`\n\nTrailing-7D distinct paying Safes with WoW change_pct. Counter tile.\n\n**Columns:**\n- **value** (`Nullable(Float64)`): The number of active users in the last 7 days.\n- **change_pct** (`Nullable(Float64)`): The percentage change compared to the previous 7-day period.\n- **as_of_date** (`Nullable(Date)`): Date the snapshot is computed as of (max date in the underlying data).","operationId":"api_celo_gpay_active_users_7d_get_v1_celo_celo_gpay_active_users_last_7d_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"value":{"type":"number","description":"The number of active users in the last 7 days."},"change_pct":{"type":"number","description":"The percentage change compared to the previous 7-day period."},"as_of_date":{"type":"string","format":"date","description":"Date the snapshot is computed as of (max date in the underlying data)."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/celo/celo_gpay_activity_by_action/daily":{"get":{"tags":["Celo"],"summary":"Celo Gpay Activity By Action (daily)","description":"**Required Access:** `tier3`\n\nDaily count/USD/native volume per action (Payment, Top-up, Withdrawal, Reversal).\n\n**Declared Filters:**\n- **action**: = on `action` (Action type (Payment, Top-up, Withdrawal, Reversal))\n- **start_date**: >= on `date` (Inclusive start date)\n- **end_date**: <= on `date` (Inclusive end date)\n\n**Sort:**\n- `date DESC`\n\n**Columns:**\n- **date** (`Date`): The calendar date.\n- **action** (`Nullable(String)`): The activity type (e.g., Payment, Deposit, Withdrawal, Cashback).\n- **activity_count** (`UInt64`): The number of transactions for this action on this date.\n- **volume_usd** (`Nullable(Float64)`): The total USD volume for this action on this date.\n- **volume_native** (`Float64`): The total native token volume for this action on this date.","operationId":"api_celo_gpay_activity_by_action_daily_get_v1_celo_celo_gpay_activity_by_action_daily_get","security":[{"APIKeyHeader":[]}],"responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"date":{"type":"string","format":"date","description":"The calendar date."},"action":{"type":"string","description":"The activity type (e.g., Payment, Deposit, Withdrawal, Cashback)."},"activity_count":{"type":"integer","description":"The number of transactions for this action on this date."},"volume_usd":{"type":"number","description":"The total USD volume for this action on this date."},"volume_native":{"type":"number","description":"The total native token volume for this action on this date."}}}}}}}},"parameters":[{"name":"action","in":"query","required":false,"description":"Action type (Payment, Top-up, Withdrawal, Reversal)","schema":{"type":"string"}},{"name":"start_date","in":"query","required":false,"description":"Inclusive start date","schema":{"type":"string","format":"date"}},{"name":"end_date","in":"query","required":false,"description":"Inclusive end date","schema":{"type":"string","format":"date"}}]}},"/v1/celo/celo_gpay_activity_by_action/weekly":{"get":{"tags":["Celo"],"summary":"Celo Gpay Activity By Action (weekly)","description":"**Required Access:** `tier3`\n\nWeekly count/USD/native volume per action.\n\n**Declared Filters:**\n- **action**: = on `action` (Action type (Payment, Top-up, Withdrawal, Reversal))\n- **start_date**: >= on `week` (Inclusive start date)\n- **end_date**: <= on `week` (Inclusive end date)\n\n**Sort:**\n- `week DESC`\n\n**Columns:**\n- **week** (`Date`): The first day of the ISO week.\n- **action** (`Nullable(String)`): The activity type (e.g., Payment, Deposit, Withdrawal, Cashback).\n- **activity_count** (`UInt64`): The number of transactions for this action in this week.\n- **volume_usd** (`Nullable(Float64)`): The total USD volume for this action in this week.\n- **volume_native** (`Float64`): The total native token volume for this action in this week.","operationId":"api_celo_gpay_activity_by_action_weekly_get_v1_celo_celo_gpay_activity_by_action_weekly_get","security":[{"APIKeyHeader":[]}],"responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"week":{"type":"string","format":"date","description":"The first day of the ISO week."},"action":{"type":"string","description":"The activity type (e.g., Payment, Deposit, Withdrawal, Cashback)."},"activity_count":{"type":"integer","description":"The number of transactions for this action in this week."},"volume_usd":{"type":"number","description":"The total USD volume for this action in this week."},"volume_native":{"type":"number","description":"The total native token volume for this action in this week."}}}}}}}},"parameters":[{"name":"action","in":"query","required":false,"description":"Action type (Payment, Top-up, Withdrawal, Reversal)","schema":{"type":"string"}},{"name":"start_date","in":"query","required":false,"description":"Inclusive start date","schema":{"type":"string","format":"date"}},{"name":"end_date","in":"query","required":false,"description":"Inclusive end date","schema":{"type":"string","format":"date"}}]}},"/v1/celo/celo_gpay_activity_by_action/monthly":{"get":{"tags":["Celo"],"summary":"Celo Gpay Activity By Action (monthly)","description":"**Required Access:** `tier3`\n\nMonthly count/USD/native volume per action.\n\n**Declared Filters:**\n- **action**: = on `action` (Action type (Payment, Top-up, Withdrawal, Reversal))\n- **start_date**: >= on `month` (Inclusive start date)\n- **end_date**: <= on `month` (Inclusive end date)\n\n**Sort:**\n- `month DESC`\n\n**Columns:**\n- **month** (`Date`): The first day of the month.\n- **action** (`Nullable(String)`): The activity type (e.g., Payment, Deposit, Withdrawal, Cashback).\n- **activity_count** (`UInt64`): The number of transactions for this action in this month.\n- **volume_usd** (`Nullable(Float64)`): The total USD volume for this action in this month.\n- **volume_native** (`Float64`): The total native token volume for this action in this month.","operationId":"api_celo_gpay_activity_by_action_monthly_get_v1_celo_celo_gpay_activity_by_action_monthly_get","security":[{"APIKeyHeader":[]}],"responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"month":{"type":"string","format":"date","description":"The first day of the month."},"action":{"type":"string","description":"The activity type (e.g., Payment, Deposit, Withdrawal, Cashback)."},"activity_count":{"type":"integer","description":"The number of transactions for this action in this month."},"volume_usd":{"type":"number","description":"The total USD volume for this action in this month."},"volume_native":{"type":"number","description":"The total native token volume for this action in this month."}}}}}}}},"parameters":[{"name":"action","in":"query","required":false,"description":"Action type (Payment, Top-up, Withdrawal, Reversal)","schema":{"type":"string"}},{"name":"start_date","in":"query","required":false,"description":"Inclusive start date","schema":{"type":"string","format":"date"}},{"name":"end_date","in":"query","required":false,"description":"Inclusive end date","schema":{"type":"string","format":"date"}}]}},"/v1/celo/celo_gpay_balance_cohorts_holders/daily":{"get":{"tags":["Celo"],"summary":"Celo Gpay Balance Cohorts Holders (daily)","description":"**Required Access:** `tier3`\n\nDaily holder counts per balance bucket, by token and unit (usd/native).\n\n**Declared Filters:**\n- **token**: = on `token` (Token symbol)\n- **start_date**: >= on `date` (Inclusive start date)\n- **end_date**: <= on `date` (Inclusive end date)\n\n**Sort:**\n- `date DESC`\n\n**Columns:**\n- **date** (`Nullable(Date)`): The calendar date of the balance snapshot.\n- **token** (`LowCardinality(String)`): The token symbol.\n- **cohort_unit** (`String`): The unit used for cohort bucketing (e.g., USD, native).\n- **label** (`String`): The balance range bucket label.\n- **value** (`UInt64`): The number of holders in this cohort bucket.","operationId":"api_celo_gpay_balance_cohorts_holders_daily_get_v1_celo_celo_gpay_balance_cohorts_holders_daily_get","security":[{"APIKeyHeader":[]}],"responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"date":{"type":"string","format":"date","description":"The calendar date of the balance snapshot."},"token":{"type":"string","description":"The token symbol."},"cohort_unit":{"type":"string","description":"The unit used for cohort bucketing (e.g., USD, native)."},"label":{"type":"string","description":"The balance range bucket label."},"value":{"type":"integer","description":"The number of holders in this cohort bucket."}}}}}}}},"parameters":[{"name":"token","in":"query","required":false,"description":"Token symbol","schema":{"type":"string"}},{"name":"start_date","in":"query","required":false,"description":"Inclusive start date","schema":{"type":"string","format":"date"}},{"name":"end_date","in":"query","required":false,"description":"Inclusive end date","schema":{"type":"string","format":"date"}}]}},"/v1/celo/celo_gpay_balance_cohorts_value/daily":{"get":{"tags":["Celo"],"summary":"Celo Gpay Balance Cohorts Value (daily)","description":"**Required Access:** `tier3`\n\nDaily summed balance (native + USD) per balance bucket, by token and unit.\n\n**Declared Filters:**\n- **token**: = on `token` (Token symbol)\n- **start_date**: >= on `date` (Inclusive start date)\n- **end_date**: <= on `date` (Inclusive end date)\n\n**Sort:**\n- `date DESC`\n\n**Columns:**\n- **date** (`Nullable(Date)`): The calendar date of the balance snapshot.\n- **token** (`LowCardinality(String)`): The token symbol.\n- **cohort_unit** (`String`): The unit used for cohort bucketing.\n- **label** (`String`): The balance range bucket label.\n- **value_native** (`Float64`): The total native token value in this bucket.\n- **value_usd** (`Float64`): The total USD value in this bucket.","operationId":"api_celo_gpay_balance_cohorts_value_daily_get_v1_celo_celo_gpay_balance_cohorts_value_daily_get","security":[{"APIKeyHeader":[]}],"responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"date":{"type":"string","format":"date","description":"The calendar date of the balance snapshot."},"token":{"type":"string","description":"The token symbol."},"cohort_unit":{"type":"string","description":"The unit used for cohort bucketing."},"label":{"type":"string","description":"The balance range bucket label."},"value_native":{"type":"number","description":"The total native token value in this bucket."},"value_usd":{"type":"number","description":"The total USD value in this bucket."}}}}}}}},"parameters":[{"name":"token","in":"query","required":false,"description":"Token symbol","schema":{"type":"string"}},{"name":"start_date","in":"query","required":false,"description":"Inclusive start date","schema":{"type":"string","format":"date"}},{"name":"end_date","in":"query","required":false,"description":"Inclusive end date","schema":{"type":"string","format":"date"}}]}},"/v1/celo/celo_gpay_balances_native/daily":{"get":{"tags":["Celo"],"summary":"Celo Gpay Balances Native (daily)","description":"**Required Access:** `tier3`\n\nDaily total net-flow balance (native units) by token. USDC/USDT only.\n\n**Declared Filters:**\n- **token**: = on `label` (Token symbol)\n- **start_date**: >= on `date` (Inclusive start date)\n- **end_date**: <= on `date` (Inclusive end date)\n\n**Sort:**\n- `date DESC`\n\n**Columns:**\n- **date** (`Nullable(Date)`): The calendar date of the balance snapshot.\n- **label** (`LowCardinality(String)`): The token symbol.\n- **value** (`Float64`): The total balance in native token units.","operationId":"api_celo_gpay_balances_native_daily_get_v1_celo_celo_gpay_balances_native_daily_get","security":[{"APIKeyHeader":[]}],"responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"date":{"type":"string","format":"date","description":"The calendar date of the balance snapshot."},"label":{"type":"string","description":"The token symbol."},"value":{"type":"number","description":"The total balance in native token units."}}}}}}}},"parameters":[{"name":"token","in":"query","required":false,"description":"Token symbol","schema":{"type":"string"}},{"name":"start_date","in":"query","required":false,"description":"Inclusive start date","schema":{"type":"string","format":"date"}},{"name":"end_date","in":"query","required":false,"description":"Inclusive end date","schema":{"type":"string","format":"date"}}]}},"/v1/celo/celo_gpay_balances_usd/daily":{"get":{"tags":["Celo"],"summary":"Celo Gpay Balances Usd (daily)","description":"**Required Access:** `tier3`\n\nDaily total net-flow balance (USD) by token. USDC/USDT only.\n\n**Declared Filters:**\n- **token**: = on `label` (Token symbol)\n- **start_date**: >= on `date` (Inclusive start date)\n- **end_date**: <= on `date` (Inclusive end date)\n\n**Sort:**\n- `date DESC`\n\n**Columns:**\n- **date** (`Nullable(Date)`): The calendar date of the balance snapshot.\n- **label** (`LowCardinality(String)`): The token symbol.\n- **value** (`Float64`): The total balance in USD for this token.","operationId":"api_celo_gpay_balances_usd_daily_get_v1_celo_celo_gpay_balances_usd_daily_get","security":[{"APIKeyHeader":[]}],"responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"date":{"type":"string","format":"date","description":"The calendar date of the balance snapshot."},"label":{"type":"string","description":"The token symbol."},"value":{"type":"number","description":"The total balance in USD for this token."}}}}}}}},"parameters":[{"name":"token","in":"query","required":false,"description":"Token symbol","schema":{"type":"string"}},{"name":"start_date","in":"query","required":false,"description":"Inclusive start date","schema":{"type":"string","format":"date"}},{"name":"end_date","in":"query","required":false,"description":"Inclusive end date","schema":{"type":"string","format":"date"}}]}},"/v1/celo/celo_gpay_churn/monthly":{"get":{"tags":["Celo"],"summary":"Celo Gpay Churn (monthly)","description":"**Required Access:** `tier3`\n\nMonthly new/retained/returning/churned segmentation by scope (Payment, Any).\n\n**Declared Filters:**\n- **scope**: = on `scope` (Churn scope)\n- **start_date**: >= on `month` (Inclusive start month)\n- **end_date**: <= on `month` (Inclusive end month)\n\n**Sort:**\n- `month DESC`\n\n**Columns:**\n- **scope** (`String`): The activity scope for churn calculation (e.g., all, payment).\n- **month** (`String`): The first day of the month.\n- **new_users** (`UInt64`): Users active for the first time this month.\n- **retained_users** (`UInt64`): Users active in both this and the previous month.\n- **returning_users** (`UInt64`): Users returning after a period of inactivity.\n- **churned_users** (`UInt64`): Users active last month but not this month.\n- **total_active** (`UInt64`): Total active users this month.\n- **churn_rate** (`Float64`): The percentage of last month's users who churned.\n- **retention_rate** (`Float64`): The percentage of last month's users who were retained.","operationId":"api_celo_gpay_churn_monthly_get_v1_celo_celo_gpay_churn_monthly_get","security":[{"APIKeyHeader":[]}],"responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"scope":{"type":"string","description":"The activity scope for churn calculation (e.g., all, payment)."},"month":{"type":"string","description":"The first day of the month."},"new_users":{"type":"integer","description":"Users active for the first time this month."},"retained_users":{"type":"integer","description":"Users active in both this and the previous month."},"returning_users":{"type":"integer","description":"Users returning after a period of inactivity."},"churned_users":{"type":"integer","description":"Users active last month but not this month."},"total_active":{"type":"integer","description":"Total active users this month."},"churn_rate":{"type":"number","description":"The percentage of last month's users who churned."},"retention_rate":{"type":"number","description":"The percentage of last month's users who were retained."}}}}}}}},"parameters":[{"name":"scope","in":"query","required":false,"description":"Churn scope","schema":{"type":"string"}},{"name":"start_date","in":"query","required":false,"description":"Inclusive start month","schema":{"type":"string","format":"date"}},{"name":"end_date","in":"query","required":false,"description":"Inclusive end month","schema":{"type":"string","format":"date"}}]}},"/v1/celo/celo_gpay_churn_rates/monthly":{"get":{"tags":["Celo"],"summary":"Celo Gpay Churn Rates (monthly)","description":"**Required Access:** `tier3`\n\nMonthly churn and retention rates by scope (Payment, Any).\n\n**Declared Filters:**\n- **scope**: = on `scope` (Churn scope)\n- **start_date**: >= on `month` (Inclusive start month)\n- **end_date**: <= on `month` (Inclusive end month)\n\n**Sort:**\n- `month DESC`\n\n**Columns:**\n- **scope** (`String`): The activity scope (e.g., all, payment).\n- **month** (`String`): The first day of the month.\n- **churn_rate** (`Float64`): The churn rate for the month.\n- **retention_rate** (`Float64`): The retention rate for the month.","operationId":"api_celo_gpay_churn_rates_monthly_get_v1_celo_celo_gpay_churn_rates_monthly_get","security":[{"APIKeyHeader":[]}],"responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"scope":{"type":"string","description":"The activity scope (e.g., all, payment)."},"month":{"type":"string","description":"The first day of the month."},"churn_rate":{"type":"number","description":"The churn rate for the month."},"retention_rate":{"type":"number","description":"The retention rate for the month."}}}}}}}},"parameters":[{"name":"scope","in":"query","required":false,"description":"Churn scope","schema":{"type":"string"}},{"name":"start_date","in":"query","required":false,"description":"Inclusive start month","schema":{"type":"string","format":"date"}},{"name":"end_date","in":"query","required":false,"description":"Inclusive end month","schema":{"type":"string","format":"date"}}]}},"/v1/celo/celo_gpay_funded_addresses/daily":{"get":{"tags":["Celo"],"summary":"Celo Gpay Funded Addresses (daily)","description":"**Required Access:** `tier3`\n\nCumulative funded (ever-paid) Safes by day.\n\n**Columns:**\n- **date** (`Date`): The calendar date.\n- **value** (`UInt64`): The cumulative number of funded wallet addresses.","operationId":"api_celo_gpay_funded_addresses_daily_get_v1_celo_celo_gpay_funded_addresses_daily_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"date":{"type":"string","format":"date","description":"The calendar date."},"value":{"type":"integer","description":"The cumulative number of funded wallet addresses."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/celo/celo_gpay_funded_addresses/weekly":{"get":{"tags":["Celo"],"summary":"Celo Gpay Funded Addresses (weekly)","description":"**Required Access:** `tier3`\n\nCumulative funded Safes by week.\n\n**Columns:**\n- **date** (`Date`): The first day of the ISO week.\n- **value** (`UInt64`): The cumulative number of funded wallet addresses.","operationId":"api_celo_gpay_funded_addresses_weekly_get_v1_celo_celo_gpay_funded_addresses_weekly_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"date":{"type":"string","format":"date","description":"The first day of the ISO week."},"value":{"type":"integer","description":"The cumulative number of funded wallet addresses."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/celo/celo_gpay_funded_addresses/monthly":{"get":{"tags":["Celo"],"summary":"Celo Gpay Funded Addresses (monthly)","description":"**Required Access:** `tier3`\n\nCumulative funded Safes by month.\n\n**Columns:**\n- **date** (`Date`): The first day of the month.\n- **value** (`UInt64`): The cumulative number of funded wallet addresses.","operationId":"api_celo_gpay_funded_addresses_monthly_get_v1_celo_celo_gpay_funded_addresses_monthly_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"date":{"type":"string","format":"date","description":"The first day of the month."},"value":{"type":"integer","description":"The cumulative number of funded wallet addresses."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/celo/celo_gpay_kpi/monthly":{"get":{"tags":["Celo"],"summary":"Celo Gpay Kpi (monthly)","description":"**Required Access:** `tier3`\n\nMonthly KPI table (MAU, volumes, net flow, ARPU, repeat rate). Backs the KPI tiles and monthly KPI charts. USDC/USDT only.\n\n**Columns:**\n- **month** (`Date`): The first day of the month.\n- **mau** (`UInt64`): Monthly active users across all activity types.\n- **payment_mau** (`UInt64`): Monthly active users who made payments.\n- **deposit_mau** (`UInt64`): Monthly active users who made deposits.\n- **withdrawal_mau** (`UInt64`): Monthly active users who made withdrawals.\n- **total_payment_volume_usd** (`Nullable(Float64)`): Total payment volume in USD for the month.\n- **total_payment_count** (`UInt64`): Total number of payments in the month.\n- **total_deposit_volume_usd** (`Nullable(Float64)`): Total deposit volume in USD for the month.\n- **total_withdrawal_volume_usd** (`Nullable(Float64)`): Total withdrawal volume in USD for the month.\n- **net_flow_usd** (`Nullable(Float64)`): Net flow (deposits minus withdrawals) in USD for the month.\n- **reversal_total_usd** (`Nullable(Float64)`): Total reversal value in USD for the month.\n- **arpu** (`Nullable(Float64)`): Average revenue per user in USD.\n- **avg_tx_per_user** (`Float64`): Average number of transactions per active user.\n- **repeat_purchase_rate** (`Float64`): Percentage of users who made more than one payment.","operationId":"api_celo_gpay_kpi_monthly_get_v1_celo_celo_gpay_kpi_monthly_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"month":{"type":"string","format":"date","description":"The first day of the month."},"mau":{"type":"integer","description":"Monthly active users across all activity types."},"payment_mau":{"type":"integer","description":"Monthly active users who made payments."},"deposit_mau":{"type":"integer","description":"Monthly active users who made deposits."},"withdrawal_mau":{"type":"integer","description":"Monthly active users who made withdrawals."},"total_payment_volume_usd":{"type":"number","description":"Total payment volume in USD for the month."},"total_payment_count":{"type":"integer","description":"Total number of payments in the month."},"total_deposit_volume_usd":{"type":"number","description":"Total deposit volume in USD for the month."},"total_withdrawal_volume_usd":{"type":"number","description":"Total withdrawal volume in USD for the month."},"net_flow_usd":{"type":"number","description":"Net flow (deposits minus withdrawals) in USD for the month."},"reversal_total_usd":{"type":"number","description":"Total reversal value in USD for the month."},"arpu":{"type":"number","description":"Average revenue per user in USD."},"avg_tx_per_user":{"type":"number","description":"Average number of transactions per active user."},"repeat_purchase_rate":{"type":"number","description":"Percentage of users who made more than one payment."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/celo/celo_gpay_payments/last_7d":{"get":{"tags":["Celo"],"summary":"Celo Gpay Payments (last_7d)","description":"**Required Access:** `tier3`\n\nTrailing-7D payment count with WoW change_pct. Counter tile.\n\n**Columns:**\n- **value** (`Nullable(Float64)`): The total number of payments in the last 7 days.\n- **change_pct** (`Nullable(Float64)`): The percentage change compared to the previous 7-day period.\n- **as_of_date** (`Nullable(Date)`): Date the snapshot is computed as of (max date in the underlying data).","operationId":"api_celo_gpay_payments_7d_get_v1_celo_celo_gpay_payments_last_7d_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"value":{"type":"number","description":"The total number of payments in the last 7 days."},"change_pct":{"type":"number","description":"The percentage change compared to the previous 7-day period."},"as_of_date":{"type":"string","format":"date","description":"Date the snapshot is computed as of (max date in the underlying data)."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/celo/celo_gpay_payments/hourly":{"get":{"tags":["Celo"],"summary":"Celo Gpay Payments (hourly)","description":"**Required Access:** `tier3`\n\nHourly payment counts by token over the trailing 14 days.\n\n**Declared Filters:**\n- **token**: = on `label` (Token symbol)\n- **start_date**: >= on `date` (Inclusive start date)\n- **end_date**: <= on `date` (Inclusive end date)\n\n**Sort:**\n- `date DESC`\n\n**Columns:**\n- **date** (`DateTime`): The hour timestamp of the payment activity.\n- **label** (`String`): The token symbol.\n- **value** (`UInt64`): The number of payments in this hour for this token.","operationId":"api_celo_gpay_payments_hourly_get_v1_celo_celo_gpay_payments_hourly_get","security":[{"APIKeyHeader":[]}],"responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"date":{"type":"string","format":"date-time","description":"The hour timestamp of the payment activity."},"label":{"type":"string","description":"The token symbol."},"value":{"type":"integer","description":"The number of payments in this hour for this token."}}}}}}}},"parameters":[{"name":"token","in":"query","required":false,"description":"Token symbol","schema":{"type":"string"}},{"name":"start_date","in":"query","required":false,"description":"Inclusive start date","schema":{"type":"string","format":"date"}},{"name":"end_date","in":"query","required":false,"description":"Inclusive end date","schema":{"type":"string","format":"date"}}]}},"/v1/celo/celo_gpay_payments_by_token/daily":{"get":{"tags":["Celo"],"summary":"Celo Gpay Payments By Token (daily)","description":"**Required Access:** `tier3`\n\nDaily payment count split by token (USDC/USDT).\n\n**Declared Filters:**\n- **token**: = on `label` (Token symbol)\n- **start_date**: >= on `date` (Inclusive start date)\n- **end_date**: <= on `date` (Inclusive end date)\n\n**Sort:**\n- `date DESC`\n\n**Columns:**\n- **date** (`Date`): The calendar date.\n- **label** (`LowCardinality(String)`): The token symbol.\n- **value** (`UInt64`): The number of payments for this token on this date.","operationId":"api_celo_gpay_payments_by_token_daily_get_v1_celo_celo_gpay_payments_by_token_daily_get","security":[{"APIKeyHeader":[]}],"responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"date":{"type":"string","format":"date","description":"The calendar date."},"label":{"type":"string","description":"The token symbol."},"value":{"type":"integer","description":"The number of payments for this token on this date."}}}}}}}},"parameters":[{"name":"token","in":"query","required":false,"description":"Token symbol","schema":{"type":"string"}},{"name":"start_date","in":"query","required":false,"description":"Inclusive start date","schema":{"type":"string","format":"date"}},{"name":"end_date","in":"query","required":false,"description":"Inclusive end date","schema":{"type":"string","format":"date"}}]}},"/v1/celo/celo_gpay_payments_by_token/weekly":{"get":{"tags":["Celo"],"summary":"Celo Gpay Payments By Token (weekly)","description":"**Required Access:** `tier3`\n\nWeekly payment count split by token (USDC/USDT).\n\n**Declared Filters:**\n- **token**: = on `label` (Token symbol)\n- **start_date**: >= on `date` (Inclusive start date)\n- **end_date**: <= on `date` (Inclusive end date)\n\n**Sort:**\n- `date DESC`\n\n**Columns:**\n- **date** (`Date`): The first day of the ISO week.\n- **label** (`LowCardinality(String)`): The token symbol.\n- **value** (`UInt64`): The number of payments for this token in this week.","operationId":"api_celo_gpay_payments_by_token_weekly_get_v1_celo_celo_gpay_payments_by_token_weekly_get","security":[{"APIKeyHeader":[]}],"responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"date":{"type":"string","format":"date","description":"The first day of the ISO week."},"label":{"type":"string","description":"The token symbol."},"value":{"type":"integer","description":"The number of payments for this token in this week."}}}}}}}},"parameters":[{"name":"token","in":"query","required":false,"description":"Token symbol","schema":{"type":"string"}},{"name":"start_date","in":"query","required":false,"description":"Inclusive start date","schema":{"type":"string","format":"date"}},{"name":"end_date","in":"query","required":false,"description":"Inclusive end date","schema":{"type":"string","format":"date"}}]}},"/v1/celo/celo_gpay_payments_by_token/monthly":{"get":{"tags":["Celo"],"summary":"Celo Gpay Payments By Token (monthly)","description":"**Required Access:** `tier3`\n\nMonthly payment count split by token (USDC/USDT).\n\n**Declared Filters:**\n- **token**: = on `label` (Token symbol)\n- **start_date**: >= on `date` (Inclusive start date)\n- **end_date**: <= on `date` (Inclusive end date)\n\n**Sort:**\n- `date DESC`\n\n**Columns:**\n- **date** (`Date`): The first day of the month.\n- **label** (`LowCardinality(String)`): The token symbol.\n- **value** (`UInt64`): The number of payments for this token in this month.","operationId":"api_celo_gpay_payments_by_token_monthly_get_v1_celo_celo_gpay_payments_by_token_monthly_get","security":[{"APIKeyHeader":[]}],"responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"date":{"type":"string","format":"date","description":"The first day of the month."},"label":{"type":"string","description":"The token symbol."},"value":{"type":"integer","description":"The number of payments for this token in this month."}}}}}}}},"parameters":[{"name":"token","in":"query","required":false,"description":"Token symbol","schema":{"type":"string"}},{"name":"start_date","in":"query","required":false,"description":"Inclusive start date","schema":{"type":"string","format":"date"}},{"name":"end_date","in":"query","required":false,"description":"Inclusive end date","schema":{"type":"string","format":"date"}}]}},"/v1/celo/celo_gpay_retention/monthly":{"get":{"tags":["Celo"],"summary":"Celo Gpay Retention (monthly)","description":"**Required Access:** `tier3`\n\nMonthly payment-cohort retention (absolute users) in date/label/value shape.\n\n**Columns:**\n- **date** (`String`): The activity month.\n- **label** (`String`): The cohort month label.\n- **value** (`UInt64`): The number of active users from this cohort.","operationId":"api_celo_gpay_retention_monthly_get_v1_celo_celo_gpay_retention_monthly_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"date":{"type":"string","description":"The activity month."},"label":{"type":"string","description":"The cohort month label."},"value":{"type":"integer","description":"The number of active users from this cohort."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/celo/celo_gpay_retention_by_action/monthly":{"get":{"tags":["Celo"],"summary":"Celo Gpay Retention By Action (monthly)","description":"**Required Access:** `tier3`\n\nPer-action monthly cohort retention heatmap.\n\n**Declared Filters:**\n- **action**: = on `action` (Action type)\n\n**Columns:**\n- **x** (`String`): The activity month (x-axis of the heatmap).\n- **y** (`String`): The cohort month (y-axis of the heatmap).\n- **action** (`Nullable(String)`): The activity type (e.g., Payment, Deposit, Withdrawal).\n- **retention_pct** (`Float64`): The user retention percentage.\n- **value_abs** (`UInt64`): The absolute number of retained users.\n- **amount_retention_pct** (`Nullable(Float64)`): The amount retention percentage.\n- **value_usd** (`Nullable(Float64)`): The total USD amount for the cohort in this month.","operationId":"api_celo_gpay_retention_by_action_monthly_get_v1_celo_celo_gpay_retention_by_action_monthly_get","security":[{"APIKeyHeader":[]}],"responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"x":{"type":"string","description":"The activity month (x-axis of the heatmap)."},"y":{"type":"string","description":"The cohort month (y-axis of the heatmap)."},"action":{"type":"string","description":"The activity type (e.g., Payment, Deposit, Withdrawal)."},"retention_pct":{"type":"number","description":"The user retention percentage."},"value_abs":{"type":"integer","description":"The absolute number of retained users."},"amount_retention_pct":{"type":"number","description":"The amount retention percentage."},"value_usd":{"type":"number","description":"The total USD amount for the cohort in this month."}}}}}}}},"parameters":[{"name":"action","in":"query","required":false,"description":"Action type","schema":{"type":"string"}}]}},"/v1/celo/celo_gpay_retention_by_action_users/monthly":{"get":{"tags":["Celo"],"summary":"Celo Gpay Retention By Action Users (monthly)","description":"**Required Access:** `tier3`\n\nPer-action monthly cohort retention (absolute users).\n\n**Declared Filters:**\n- **action**: = on `action` (Action type)\n\n**Columns:**\n- **action** (`Nullable(String)`): The activity type (e.g., Payment, Deposit, Withdrawal).\n- **date** (`String`): The activity month.\n- **label** (`String`): The cohort month label.\n- **value** (`UInt64`): The number of active users from this cohort.","operationId":"api_celo_gpay_retention_by_action_users_monthly_get_v1_celo_celo_gpay_retention_by_action_users_monthly_get","security":[{"APIKeyHeader":[]}],"responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"action":{"type":"string","description":"The activity type (e.g., Payment, Deposit, Withdrawal)."},"date":{"type":"string","description":"The activity month."},"label":{"type":"string","description":"The cohort month label."},"value":{"type":"integer","description":"The number of active users from this cohort."}}}}}}}},"parameters":[{"name":"action","in":"query","required":false,"description":"Action type","schema":{"type":"string"}}]}},"/v1/celo/celo_gpay_retention_pct/monthly":{"get":{"tags":["Celo"],"summary":"Celo Gpay Retention Pct (monthly)","description":"**Required Access:** `tier3`\n\nMonthly payment-cohort retention heatmap (x/y/retention_pct/value_abs/value_usd).\n\n**Columns:**\n- **x** (`String`): The activity month (x-axis of the heatmap).\n- **y** (`String`): The cohort month (y-axis of the heatmap).\n- **retention_pct** (`Float64`): The user retention percentage.\n- **value_abs** (`UInt64`): The absolute number of retained users.\n- **amount_retention_pct** (`Nullable(Float64)`): The amount retention percentage.\n- **value_usd** (`Nullable(Float64)`): The total USD amount for the cohort in this month.","operationId":"api_celo_gpay_retention_pct_monthly_get_v1_celo_celo_gpay_retention_pct_monthly_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"x":{"type":"string","description":"The activity month (x-axis of the heatmap)."},"y":{"type":"string","description":"The cohort month (y-axis of the heatmap)."},"retention_pct":{"type":"number","description":"The user retention percentage."},"value_abs":{"type":"integer","description":"The absolute number of retained users."},"amount_retention_pct":{"type":"number","description":"The amount retention percentage."},"value_usd":{"type":"number","description":"The total USD amount for the cohort in this month."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/celo/celo_gpay_retention_volume/monthly":{"get":{"tags":["Celo"],"summary":"Celo Gpay Retention Volume (monthly)","description":"**Required Access:** `tier3`\n\nMonthly payment-cohort retention by USD volume.\n\n**Columns:**\n- **date** (`String`): The activity month.\n- **label** (`String`): The cohort month label.\n- **value** (`Nullable(Float64)`): The total USD volume for this cohort in this month.","operationId":"api_celo_gpay_retention_volume_monthly_get_v1_celo_celo_gpay_retention_volume_monthly_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"date":{"type":"string","description":"The activity month."},"label":{"type":"string","description":"The cohort month label."},"value":{"type":"number","description":"The total USD volume for this cohort in this month."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/celo/celo_gpay_total_balance/all_time":{"get":{"tags":["Celo"],"summary":"Celo Gpay Total Balance (all_time)","description":"**Required Access:** `tier3`\n\nLatest-day net-flow USDC+USDT float held across all GP Safes. Counter tile.\n\n**Columns:**\n- **value** (`Nullable(Float64)`): The total balance in USD.\n- **as_of_date** (`Nullable(Date)`): Date the snapshot is computed as of (max date in the underlying data).","operationId":"api_celo_gpay_total_balance_get_v1_celo_celo_gpay_total_balance_all_time_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"value":{"type":"number","description":"The total balance in USD."},"as_of_date":{"type":"string","format":"date","description":"Date the snapshot is computed as of (max date in the underlying data)."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/celo/celo_gpay_total_funded/all_time":{"get":{"tags":["Celo"],"summary":"Celo Gpay Total Funded (all_time)","description":"**Required Access:** `tier3`\n\nAll-time distinct funded (ever-paid) Safes. Counter tile.\n\n**Columns:**\n- **value** (`Nullable(Float64)`): The total number of funded wallets.\n- **as_of_date** (`Nullable(Date)`): Date the snapshot is computed as of (max date in the underlying data).","operationId":"api_celo_gpay_total_funded_get_v1_celo_celo_gpay_total_funded_all_time_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"value":{"type":"number","description":"The total number of funded wallets."},"as_of_date":{"type":"string","format":"date","description":"Date the snapshot is computed as of (max date in the underlying data)."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/celo/celo_gpay_total_payments/all_time":{"get":{"tags":["Celo"],"summary":"Celo Gpay Total Payments (all_time)","description":"**Required Access:** `tier3`\n\nAll-time payment count. Counter tile.\n\n**Columns:**\n- **value** (`Nullable(Float64)`): The total number of payments.\n- **as_of_date** (`Nullable(Date)`): Date the snapshot is computed as of (max date in the underlying data).","operationId":"api_celo_gpay_total_payments_get_v1_celo_celo_gpay_total_payments_all_time_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"value":{"type":"number","description":"The total number of payments."},"as_of_date":{"type":"string","format":"date","description":"Date the snapshot is computed as of (max date in the underlying data)."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/celo/celo_gpay_total_volume/all_time":{"get":{"tags":["Celo"],"summary":"Celo Gpay Total Volume (all_time)","description":"**Required Access:** `tier3`\n\nAll-time card payment volume in USD (USDC + USDT). Counter tile.\n\n**Columns:**\n- **value** (`Nullable(Float64)`): The total payment volume in USD.\n- **as_of_date** (`Nullable(Date)`): Date the snapshot is computed as of (max date in the underlying data).","operationId":"api_celo_gpay_total_volume_get_v1_celo_celo_gpay_total_volume_all_time_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"value":{"type":"number","description":"The total payment volume in USD."},"as_of_date":{"type":"string","format":"date","description":"Date the snapshot is computed as of (max date in the underlying data)."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/celo/celo_gpay_volume/last_7d":{"get":{"tags":["Celo"],"summary":"Celo Gpay Volume (last_7d)","description":"**Required Access:** `tier3`\n\nTrailing-7D payment volume (USD) with WoW change_pct. Counter tile.\n\n**Columns:**\n- **value** (`Nullable(Float64)`): The total payment volume in USD in the last 7 days.\n- **change_pct** (`Nullable(Float64)`): The percentage change compared to the previous 7-day period.\n- **as_of_date** (`Nullable(Date)`): Date the snapshot is computed as of (max date in the underlying data).","operationId":"api_celo_gpay_volume_7d_get_v1_celo_celo_gpay_volume_last_7d_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"value":{"type":"number","description":"The total payment volume in USD in the last 7 days."},"change_pct":{"type":"number","description":"The percentage change compared to the previous 7-day period."},"as_of_date":{"type":"string","format":"date","description":"Date the snapshot is computed as of (max date in the underlying data)."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/celo/celo_gpay_volume_payments_by_token/daily":{"get":{"tags":["Celo"],"summary":"Celo Gpay Volume Payments By Token (daily)","description":"**Required Access:** `tier3`\n\nDaily payment volume (USD) split by token (USDC/USDT).\n\n**Declared Filters:**\n- **token**: = on `label` (Token symbol)\n- **start_date**: >= on `date` (Inclusive start date)\n- **end_date**: <= on `date` (Inclusive end date)\n\n**Sort:**\n- `date DESC`\n\n**Columns:**\n- **date** (`Date`): The calendar date.\n- **label** (`LowCardinality(String)`): The token symbol.\n- **value** (`Nullable(Float64)`): The payment volume in USD for this token on this date.","operationId":"api_celo_gpay_volume_payments_by_token_daily_get_v1_celo_celo_gpay_volume_payments_by_token_daily_get","security":[{"APIKeyHeader":[]}],"responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"date":{"type":"string","format":"date","description":"The calendar date."},"label":{"type":"string","description":"The token symbol."},"value":{"type":"number","description":"The payment volume in USD for this token on this date."}}}}}}}},"parameters":[{"name":"token","in":"query","required":false,"description":"Token symbol","schema":{"type":"string"}},{"name":"start_date","in":"query","required":false,"description":"Inclusive start date","schema":{"type":"string","format":"date"}},{"name":"end_date","in":"query","required":false,"description":"Inclusive end date","schema":{"type":"string","format":"date"}}]}},"/v1/celo/celo_gpay_volume_payments_by_token/weekly":{"get":{"tags":["Celo"],"summary":"Celo Gpay Volume Payments By Token (weekly)","description":"**Required Access:** `tier3`\n\nWeekly payment volume (USD) split by token (USDC/USDT).\n\n**Declared Filters:**\n- **token**: = on `label` (Token symbol)\n- **start_date**: >= on `date` (Inclusive start date)\n- **end_date**: <= on `date` (Inclusive end date)\n\n**Sort:**\n- `date DESC`\n\n**Columns:**\n- **date** (`Date`): The first day of the ISO week.\n- **label** (`LowCardinality(String)`): The token symbol.\n- **value** (`Nullable(Float64)`): The payment volume in USD for this token in this week.","operationId":"api_celo_gpay_volume_payments_by_token_weekly_get_v1_celo_celo_gpay_volume_payments_by_token_weekly_get","security":[{"APIKeyHeader":[]}],"responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"date":{"type":"string","format":"date","description":"The first day of the ISO week."},"label":{"type":"string","description":"The token symbol."},"value":{"type":"number","description":"The payment volume in USD for this token in this week."}}}}}}}},"parameters":[{"name":"token","in":"query","required":false,"description":"Token symbol","schema":{"type":"string"}},{"name":"start_date","in":"query","required":false,"description":"Inclusive start date","schema":{"type":"string","format":"date"}},{"name":"end_date","in":"query","required":false,"description":"Inclusive end date","schema":{"type":"string","format":"date"}}]}},"/v1/celo/celo_gpay_volume_payments_by_token/monthly":{"get":{"tags":["Celo"],"summary":"Celo Gpay Volume Payments By Token (monthly)","description":"**Required Access:** `tier3`\n\nMonthly payment volume (USD) split by token (USDC/USDT).\n\n**Declared Filters:**\n- **token**: = on `label` (Token symbol)\n- **start_date**: >= on `date` (Inclusive start date)\n- **end_date**: <= on `date` (Inclusive end date)\n\n**Sort:**\n- `date DESC`\n\n**Columns:**\n- **date** (`Date`): The first day of the month.\n- **label** (`LowCardinality(String)`): The token symbol.\n- **value** (`Nullable(Float64)`): The payment volume in USD for this token in this month.","operationId":"api_celo_gpay_volume_payments_by_token_monthly_get_v1_celo_celo_gpay_volume_payments_by_token_monthly_get","security":[{"APIKeyHeader":[]}],"responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"date":{"type":"string","format":"date","description":"The first day of the month."},"label":{"type":"string","description":"The token symbol."},"value":{"type":"number","description":"The payment volume in USD for this token in this month."}}}}}}}},"parameters":[{"name":"token","in":"query","required":false,"description":"Token symbol","schema":{"type":"string"}},{"name":"start_date","in":"query","required":false,"description":"Inclusive start date","schema":{"type":"string","format":"date"}},{"name":"end_date","in":"query","required":false,"description":"Inclusive end date","schema":{"type":"string","format":"date"}}]}},"/v1/celo/celo_gpay_wallet_balance_composition/latest":{"get":{"tags":["Celo"],"summary":"Celo Gpay Wallet Balance Composition (latest)","description":"**Required Access:** `tier3`\n\nLatest-day USD balance composition across tokens (USDC/USDT); sub-1% folded into Other.\n\n**Columns:**\n- **name** (`String`): The token symbol or name.\n- **value** (`Float64`): The balance amount in USD.\n- **as_of_date** (`Nullable(Date)`): Date the snapshot is computed as of (max date in the underlying data).","operationId":"api_celo_gpay_wallet_balance_composition_get_v1_celo_celo_gpay_wallet_balance_composition_latest_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"name":{"type":"string","description":"The token symbol or name."},"value":{"type":"number","description":"The balance amount in USD."},"as_of_date":{"type":"string","format":"date","description":"Date the snapshot is computed as of (max date in the underlying data)."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/consensus/attestations/daily":{"get":{"tags":["Consensus"],"summary":"Attestations (daily)","description":"**Required Access:** `tier1`\n\nThe api_consensus_attestations_daily model provides a daily summary of consensus attestations, capturing key metrics for monitoring and analysis of attestation activity over time.\n\n**Columns:**\n- **date** (`Date`): The specific calendar date for the recorded attestation data.\n- **inclusion_delay** (`UInt64`): The number of blocks or time units between the attestation event and its inclusion in the blockchain.\n- **cnt** (`UInt64`): The total count of attestations recorded on the given date with the specified inclusion delay.","operationId":"api_consensus_attestations_daily_get_v1_consensus_attestations_daily_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"date":{"type":"string","format":"date","description":"The specific calendar date for the recorded attestation data."},"inclusion_delay":{"type":"integer","description":"The number of blocks or time units between the attestation event and its inclusion in the blockchain."},"cnt":{"type":"integer","description":"The total count of attestations recorded on the given date with the specified inclusion delay."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/consensus/attestations_performance/daily":{"get":{"tags":["Consensus"],"summary":"Attestations Performance (daily)","description":"**Required Access:** `tier1`\n\nPublic API view over fct_consensus_attestations_performance_daily. Network-wide daily attestation KPIs.\n\n**Declared Filters:**\n- **date_from**: >= on `date` (Inclusive lower bound on date)\n- **date_to**: <= on `date` (Inclusive upper bound on date)\n\n**Pagination:**\n- **limit**: default `100`, max `5000`\n- **offset**: default `0`\n\n**Sort:**\n- `date DESC`\n\n**User Sort:**\n- **sort_by**: one of `date`, `attestations_total`, `avg_inclusion_delay`, `p50_inclusion_delay`\n- **sort_direction**: `ASC` or `DESC` (defaults to `ASC` when `sort_by` is provided)\n\n**Columns:**\n- **date** (`DateTime64`): Start-of-day UTC for the network-wide attestation KPIs. One row per day.\n- **attestations_total** (`UInt64`): Total attestations included on the date.\n- **avg_inclusion_delay** (`Float64`): Weighted mean inclusion delay (in slots).\n- **p50_inclusion_delay** (`Float64`): Weighted median inclusion delay (in slots).\n- **pct_inclusion_distance_1** (`Float64`): Share of attestations included with inclusion_delay = 1. Range [0, 1].","operationId":"api_consensus_attestations_performance_daily_get_v1_consensus_attestations_performance_daily_get","security":[{"APIKeyHeader":[]}],"responses":{"200":{"description":"Paginated response","content":{"application/json":{"schema":{"type":"object","required":["items","pagination"],"properties":{"items":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"date":{"type":"string","format":"date-time","description":"Start-of-day UTC for the network-wide attestation KPIs. One row per day."},"attestations_total":{"type":"integer","description":"Total attestations included on the date."},"avg_inclusion_delay":{"type":"number","description":"Weighted mean inclusion delay (in slots)."},"p50_inclusion_delay":{"type":"number","description":"Weighted median inclusion delay (in slots)."},"pct_inclusion_distance_1":{"type":"number","description":"Share of attestations included with inclusion_delay = 1. Range [0, 1]."}}}},"pagination":{"type":"object","required":["limit","offset","returned","has_more"],"properties":{"limit":{"type":"integer","minimum":1},"offset":{"type":"integer","minimum":0},"returned":{"type":"integer","minimum":0},"has_more":{"type":"boolean"}}}}}}}}},"parameters":[{"name":"date_from","in":"query","required":false,"description":"Inclusive lower bound on date","schema":{"type":"string","format":"date"}},{"name":"date_to","in":"query","required":false,"description":"Inclusive upper bound on date","schema":{"type":"string","format":"date"}},{"name":"limit","in":"query","required":false,"description":"Row limit","schema":{"type":"integer","minimum":1,"maximum":5000,"default":100}},{"name":"offset","in":"query","required":false,"description":"Row offset","schema":{"type":"integer","minimum":0,"default":0}},{"name":"sort_by","in":"query","required":false,"description":"Sort column","schema":{"type":"string","enum":["date","attestations_total","avg_inclusion_delay","p50_inclusion_delay"]}},{"name":"sort_direction","in":"query","required":false,"description":"Sort direction. Defaults to ASC when sort_by is provided.","schema":{"type":"string","enum":["ASC","DESC"],"default":"ASC"}}]},"post":{"tags":["Consensus"],"summary":"Attestations Performance (daily) (POST)","description":"**Required Access:** `tier1`\n\nPublic API view over fct_consensus_attestations_performance_daily. Network-wide daily attestation KPIs.\n\n**Declared Filters:**\n- **date_from**: >= on `date` (Inclusive lower bound on date)\n- **date_to**: <= on `date` (Inclusive upper bound on date)\n\n**Pagination:**\n- **limit**: default `100`, max `5000`\n- **offset**: default `0`\n\n**Sort:**\n- `date DESC`\n\n**User Sort:**\n- **sort_by**: one of `date`, `attestations_total`, `avg_inclusion_delay`, `p50_inclusion_delay`\n- **sort_direction**: `ASC` or `DESC` (defaults to `ASC` when `sort_by` is provided)\n\n**Columns:**\n- **date** (`DateTime64`): Start-of-day UTC for the network-wide attestation KPIs. One row per day.\n- **attestations_total** (`UInt64`): Total attestations included on the date.\n- **avg_inclusion_delay** (`Float64`): Weighted mean inclusion delay (in slots).\n- **p50_inclusion_delay** (`Float64`): Weighted median inclusion delay (in slots).\n- **pct_inclusion_distance_1** (`Float64`): Share of attestations included with inclusion_delay = 1. Range [0, 1].","operationId":"api_consensus_attestations_performance_daily_post_v1_consensus_attestations_performance_daily_post","security":[{"APIKeyHeader":[]}],"requestBody":{"content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/api_consensus_attestations_performance_daily_PostBody"},{"type":"null"}],"title":" Body"}}}},"responses":{"200":{"description":"Paginated response","content":{"application/json":{"schema":{"type":"object","required":["items","pagination"],"properties":{"items":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"date":{"type":"string","format":"date-time","description":"Start-of-day UTC for the network-wide attestation KPIs. One row per day."},"attestations_total":{"type":"integer","description":"Total attestations included on the date."},"avg_inclusion_delay":{"type":"number","description":"Weighted mean inclusion delay (in slots)."},"p50_inclusion_delay":{"type":"number","description":"Weighted median inclusion delay (in slots)."},"pct_inclusion_distance_1":{"type":"number","description":"Share of attestations included with inclusion_delay = 1. Range [0, 1]."}}}},"pagination":{"type":"object","required":["limit","offset","returned","has_more"],"properties":{"limit":{"type":"integer","minimum":1},"offset":{"type":"integer","minimum":0},"returned":{"type":"integer","minimum":0},"has_more":{"type":"boolean"}}}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/consensus/blob_commitments/daily":{"get":{"tags":["Consensus"],"summary":"Blob Commitments (daily)","description":"**Required Access:** `tier1`\n\nThe api_consensus_blob_commitments_daily model provides a daily overview of total blob commitments within the consensus layer, supporting trend analysis and capacity planning.\n\n**Columns:**\n- **date** (`Date`): The specific calendar date for the recorded blob commitments, formatted as YYYY-MM-DD.\n- **value** (`UInt64`): The total number of blob commitments made on the given date.","operationId":"api_consensus_blob_commitments_daily_get_v1_consensus_blob_commitments_daily_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"date":{"type":"string","format":"date","description":"The specific calendar date for the recorded blob commitments, formatted as YYYY-MM-DD."},"value":{"type":"integer","description":"The total number of blob commitments made on the given date."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/consensus/blocks/daily":{"get":{"tags":["Consensus"],"summary":"Blocks (daily)","description":"**Required Access:** `tier1`\n\nThe api_consensus_blocks_daily model aggregates daily consensus block data, providing insights into blocks produced and missed each day for monitoring network performance.\n\n**Columns:**\n- **date** (`Date`): The specific calendar date for the recorded metrics.\n- **label** (`String`): Indicator specifying whether the row represents 'produced' or 'missed' blocks.\n- **value** (`UInt64`): Count of consensus blocks, representing either produced or missed blocks on the given date.","operationId":"api_consensus_blocks_daily_get_v1_consensus_blocks_daily_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"date":{"type":"string","format":"date","description":"The specific calendar date for the recorded metrics."},"label":{"type":"string","description":"Indicator specifying whether the row represents 'produced' or 'missed' blocks."},"value":{"type":"integer","description":"Count of consensus blocks, representing either produced or missed blocks on the given date."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/consensus/blocks_and_blobs/daily":{"get":{"tags":["Consensus"],"summary":"Blocks And Blobs (daily)","description":"**Required Access:** `tier1`\n\nThis view provides daily aggregated counts of consensus blocks with and without zero blob commitments, aiding in monitoring blockchain data integrity and activity levels.\n\n**Columns:**\n- **date** (`Date`): The date for which the block commitment data is recorded, formatted as YYYY-MM-DD.\n- **label** (`String`): A categorical label indicating whether the count pertains to blocks with or without zero blob commitments.\n- **value** (`Int64`): The numerical count of blocks, represented as a 64-bit integer, corresponding to the specified label and date.","operationId":"api_consensus_zero_blob_commitments_daily_get_v1_consensus_blocks_and_blobs_daily_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"date":{"type":"string","format":"date","description":"The date for which the block commitment data is recorded, formatted as YYYY-MM-DD."},"label":{"type":"string","description":"A categorical label indicating whether the count pertains to blocks with or without zero blob commitments."},"value":{"type":"integer","description":"The numerical count of blocks, represented as a 64-bit integer, corresponding to the specified label and date."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/consensus/consolidations/daily":{"get":{"tags":["Consensus"],"summary":"Consolidations (daily)","description":"**Required Access:** `tier1`\n\nPublic API view — SELECT * FROM fct_consensus_consolidations_daily. Filter/pagination metadata in model config.\n\n**Declared Filters:**\n- **date_from**: >= on `date` (Inclusive lower bound on date)\n- **date_to**: <= on `date` (Inclusive upper bound on date)\n- **role**: = on `role` (One of self / source / target)\n\n**Pagination:**\n- **limit**: default `5000`, max `10000`\n- **offset**: default `0`\n\n**Sort:**\n- `date DESC`\n\n**Columns:**\n- **date** (`DateTime64`): Application date of the consolidation events (start-of-day UTC).\n- **role** (`String`): One of 'self' / 'source' / 'target'.\n- **cnt** (`UInt64`): Number of consolidation events on the date for the role.\n- **transferred_amount_gno** (`Float64`): 0 for 'self' rows; positive for source/target.","operationId":"api_consensus_consolidations_daily_get_v1_consensus_consolidations_daily_get","security":[{"APIKeyHeader":[]}],"responses":{"200":{"description":"Paginated response","content":{"application/json":{"schema":{"type":"object","required":["items","pagination"],"properties":{"items":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"date":{"type":"string","format":"date-time","description":"Application date of the consolidation events (start-of-day UTC)."},"role":{"type":"string","description":"One of 'self' / 'source' / 'target'."},"cnt":{"type":"integer","description":"Number of consolidation events on the date for the role."},"transferred_amount_gno":{"type":"number","description":"0 for 'self' rows; positive for source/target."}}}},"pagination":{"type":"object","required":["limit","offset","returned","has_more"],"properties":{"limit":{"type":"integer","minimum":1},"offset":{"type":"integer","minimum":0},"returned":{"type":"integer","minimum":0},"has_more":{"type":"boolean"}}}}}}}}},"parameters":[{"name":"date_from","in":"query","required":false,"description":"Inclusive lower bound on date","schema":{"type":"string","format":"date"}},{"name":"date_to","in":"query","required":false,"description":"Inclusive upper bound on date","schema":{"type":"string","format":"date"}},{"name":"role","in":"query","required":false,"description":"One of self / source / target","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"Row limit","schema":{"type":"integer","minimum":1,"maximum":10000,"default":5000}},{"name":"offset","in":"query","required":false,"description":"Row offset","schema":{"type":"integer","minimum":0,"default":0}}]},"post":{"tags":["Consensus"],"summary":"Consolidations (daily) (POST)","description":"**Required Access:** `tier1`\n\nPublic API view — SELECT * FROM fct_consensus_consolidations_daily. Filter/pagination metadata in model config.\n\n**Declared Filters:**\n- **date_from**: >= on `date` (Inclusive lower bound on date)\n- **date_to**: <= on `date` (Inclusive upper bound on date)\n- **role**: = on `role` (One of self / source / target)\n\n**Pagination:**\n- **limit**: default `5000`, max `10000`\n- **offset**: default `0`\n\n**Sort:**\n- `date DESC`\n\n**Columns:**\n- **date** (`DateTime64`): Application date of the consolidation events (start-of-day UTC).\n- **role** (`String`): One of 'self' / 'source' / 'target'.\n- **cnt** (`UInt64`): Number of consolidation events on the date for the role.\n- **transferred_amount_gno** (`Float64`): 0 for 'self' rows; positive for source/target.","operationId":"api_consensus_consolidations_daily_post_v1_consensus_consolidations_daily_post","security":[{"APIKeyHeader":[]}],"requestBody":{"content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/api_consensus_consolidations_daily_PostBody"},{"type":"null"}],"title":" Body"}}}},"responses":{"200":{"description":"Paginated response","content":{"application/json":{"schema":{"type":"object","required":["items","pagination"],"properties":{"items":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"date":{"type":"string","format":"date-time","description":"Application date of the consolidation events (start-of-day UTC)."},"role":{"type":"string","description":"One of 'self' / 'source' / 'target'."},"cnt":{"type":"integer","description":"Number of consolidation events on the date for the role."},"transferred_amount_gno":{"type":"number","description":"0 for 'self' rows; positive for source/target."}}}},"pagination":{"type":"object","required":["limit","offset","returned","has_more"],"properties":{"limit":{"type":"integer","minimum":1},"offset":{"type":"integer","minimum":0},"returned":{"type":"integer","minimum":0},"has_more":{"type":"boolean"}}}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/consensus/credentials/latest":{"get":{"tags":["Consensus"],"summary":"Credentials (latest)","description":"**Required Access:** `tier0` (no API key required)\n\nThe 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.\n\n**Columns:**\n- **credentials_type** (`String`): The category or type of API credential, such as API key or OAuth token.\n- **cnt** (`UInt64`): The number of credentials of the specified type at the latest date, representing a count.\n- **as_of_date** (`Date`): Date the snapshot is computed as of (max date in the underlying data).","operationId":"api_consensus_credentials_latest_get_v1_consensus_credentials_latest_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"credentials_type":{"type":"string","description":"The category or type of API credential, such as API key or OAuth token."},"cnt":{"type":"integer","description":"The number of credentials of the specified type at the latest date, representing a count."},"as_of_date":{"type":"string","format":"date","description":"Date the snapshot is computed as of (max date in the underlying data)."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/consensus/credentials/daily":{"get":{"tags":["Consensus"],"summary":"Credentials (daily)","description":"**Required Access:** `tier1`\n\nThe 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.\n\n**Columns:**\n- **date** (`Date`): The specific calendar date for the recorded credential data.\n- **credentials_type** (`String`): The category or type of credentials used in the API during the specified date.\n- **cnt** (`UInt64`): The total number of credentials of a specific type recorded on the given date.\n- **pct** (`UInt64`): The percentage share of each credential type relative to the total credentials on that date, rounded to two decimal places.","operationId":"api_consensus_credentials_daily_get_v1_consensus_credentials_daily_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"date":{"type":"string","format":"date","description":"The specific calendar date for the recorded credential data."},"credentials_type":{"type":"string","description":"The category or type of credentials used in the API during the specified date."},"cnt":{"type":"integer","description":"The total number of credentials of a specific type recorded on the given date."},"pct":{"type":"integer","description":"The percentage share of each credential type relative to the total credentials on that date, rounded to two decimal places."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/consensus/deposits_and_withdrawals/daily":{"get":{"tags":["Consensus"],"summary":"Deposits And Withdrawals (daily)","description":"**Required Access:** `tier1`\n\nThe model aggregates daily counts of consensus deposits and withdrawals to monitor transaction activity trends over time.\n\n**Columns:**\n- **date** (`Date`): The specific calendar date for the recorded counts, formatted as YYYY-MM-DD.\n- **label** (`String`): A categorical indicator distinguishing between deposit and withdrawal counts.\n- **value** (`UInt64`): The number of deposits or withdrawals recorded on the given date, representing transaction volume.","operationId":"api_consensus_deposits_withdrawls_cnt_daily_get_v1_consensus_deposits_and_withdrawals_daily_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"date":{"type":"string","format":"date","description":"The specific calendar date for the recorded counts, formatted as YYYY-MM-DD."},"label":{"type":"string","description":"A categorical indicator distinguishing between deposit and withdrawal counts."},"value":{"type":"integer","description":"The number of deposits or withdrawals recorded on the given date, representing transaction volume."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/consensus/deposits_and_withdrawals_volume/daily":{"get":{"tags":["Consensus"],"summary":"Deposits And Withdrawals Volume (daily)","description":"**Required Access:** `tier1`\n\nThe api_consensus_deposits_withdrawls_volume_daily model provides a daily summary of deposit and withdrawal volumes from the API, facilitating trend analysis and reporting.\n\n**Columns:**\n- **date** (`Date`): The specific calendar date for the recorded deposit or withdrawal volume.\n- **label** (`String`): A categorical identifier indicating the type or source of the deposit or withdrawal event.\n- **value** (`UInt64`): The total amount of deposits or withdrawals in the specified category on the given date, measured in the relevant currency units.","operationId":"api_consensus_deposits_withdrawls_volume_daily_get_v1_consensus_deposits_and_withdrawals_volume_daily_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"date":{"type":"string","format":"date","description":"The specific calendar date for the recorded deposit or withdrawal volume."},"label":{"type":"string","description":"A categorical identifier indicating the type or source of the deposit or withdrawal event."},"value":{"type":"integer","description":"The total amount of deposits or withdrawals in the specified category on the given date, measured in the relevant currency units."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/consensus/deposits_cnt/latest":{"get":{"tags":["Consensus"],"summary":"Deposits Cnt (latest)","description":"**Required Access:** `tier0` (no API key required)\n\nThe model provides the latest consensus information on the total number of deposits, serving as a key metric for monitoring deposit activity trends.\n\n**Columns:**\n- **value** (`Float64`): The current total count of deposits, representing the latest available figure.\n- **change_pct** (`Float64`): The percentage change in the deposit count compared to the previous measurement period.\n- **as_of_date** (`Date`): Date the snapshot is computed as of (max date in the underlying data).","operationId":"api_consensus_info_deposits_cnt_latest_get_v1_consensus_deposits_cnt_latest_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"value":{"type":"number","description":"The current total count of deposits, representing the latest available figure."},"change_pct":{"type":"number","description":"The percentage change in the deposit count compared to the previous measurement period."},"as_of_date":{"type":"string","format":"date","description":"Date the snapshot is computed as of (max date in the underlying data)."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/consensus/entry_queue/daily":{"get":{"tags":["Consensus"],"summary":"Entry Queue (daily)","description":"**Required Access:** `tier1`\n\nThe 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.\n\n**Columns:**\n- **date** (`Date`): The specific calendar date for the recorded metrics.\n- **validator_count** (`UInt64`): Number of validators active on the given date.\n- **q05** (`Float64`): 5th percentile of the entry queue size, indicating the lower bound of queue length distribution.\n- **q10** (`Float64`): 10th percentile of the entry queue size, representing the lower tail of the distribution.\n- **q25** (`Float64`): 25th percentile (first quartile) of the queue size distribution.\n- **q50** (`Float64`): Median queue size, representing the middle value of the distribution.\n- **q75** (`Float64`): 75th percentile (third quartile) of the queue size, indicating the upper quartile.\n- **q90** (`Float64`): 90th percentile of the queue size, showing the upper tail of the distribution.\n- **q95** (`Float64`): 95th percentile of the queue size, highlighting the extreme upper values.\n- **mean** (`Float64`): Average queue size across all validators for the given date.","operationId":"api_consensus_entry_queue_daily_get_v1_consensus_entry_queue_daily_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"date":{"type":"string","format":"date","description":"The specific calendar date for the recorded metrics."},"validator_count":{"type":"integer","description":"Number of validators active on the given date."},"q05":{"type":"number","description":"5th percentile of the entry queue size, indicating the lower bound of queue length distribution."},"q10":{"type":"number","description":"10th percentile of the entry queue size, representing the lower tail of the distribution."},"q25":{"type":"number","description":"25th percentile (first quartile) of the queue size distribution."},"q50":{"type":"number","description":"Median queue size, representing the middle value of the distribution."},"q75":{"type":"number","description":"75th percentile (third quartile) of the queue size, indicating the upper quartile."},"q90":{"type":"number","description":"90th percentile of the queue size, showing the upper tail of the distribution."},"q95":{"type":"number","description":"95th percentile of the queue size, highlighting the extreme upper values."},"mean":{"type":"number","description":"Average queue size across all validators for the given date."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/consensus/forks_info/latest":{"get":{"tags":["Consensus"],"summary":"Forks Info (latest)","description":"**Required Access:** `tier0` (no API key required)\n\nThe 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.\n\n**Columns:**\n- **fork_name** (`String`): The human-readable name identifying the specific consensus fork.\n- **fork_version** (`String`): The numeric version identifier of the fork, used for ordering and comparison.\n- **fork_digest** (`String`): A unique cryptographic digest representing the fork's specific state or configuration.\n- **fork_epoch** (`UInt64`): The epoch number indicating the activation point of the fork within the blockchain's timeline.\n- **as_of_date** (`Date`): Date the snapshot is computed as of (max date in the underlying data).","operationId":"api_consensus_forks_get_v1_consensus_forks_info_latest_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"fork_name":{"type":"string","description":"The human-readable name identifying the specific consensus fork."},"fork_version":{"type":"string","description":"The numeric version identifier of the fork, used for ordering and comparison."},"fork_digest":{"type":"string","description":"A unique cryptographic digest representing the fork's specific state or configuration."},"fork_epoch":{"type":"integer","description":"The epoch number indicating the activation point of the fork within the blockchain's timeline."},"as_of_date":{"type":"string","format":"date","description":"Date the snapshot is computed as of (max date in the underlying data)."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/consensus/graffities_labels/daily":{"get":{"tags":["Consensus"],"summary":"Graffities Labels (daily)","description":"**Required Access:** `tier1`\n\nThe api_consensus_graffiti_label_daily model aggregates daily counts of graffiti labels to support trend analysis and reporting for consensus graffiti labeling efforts.\n\n**Columns:**\n- **date** (`Date`): The specific calendar date for the aggregated data, formatted as YYYY-MM-DD.\n- **label** (`String`): The identifier or category of the graffiti label being counted.\n- **value** (`UInt64`): The total count of occurrences for the given label on the specified date.","operationId":"api_consensus_graffiti_label_daily_get_v1_consensus_graffities_labels_daily_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"date":{"type":"string","format":"date","description":"The specific calendar date for the aggregated data, formatted as YYYY-MM-DD."},"label":{"type":"string","description":"The identifier or category of the graffiti label being counted."},"value":{"type":"integer","description":"The total count of occurrences for the given label on the specified date."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/consensus/graffities_labels/in_ranges":{"get":{"tags":["Consensus"],"summary":"Graffities Labels (in_ranges)","description":"**Required Access:** `tier0` (no API key required)\n\nThe 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.\n\n**Columns:**\n- **label** (`String`): The category or type of graffiti label being analyzed.\n- **graffiti** (`String`): The specific graffiti instance or identifier associated with the label.\n- **value** (`Float64`): Numerical score or metric representing the consensus or confidence level for the graffiti label, typically within a defined range.\n- **as_of_date** (`Date`): Date the snapshot is computed as of (max date in the underlying data).","operationId":"api_consensus_graffiti_cloud_get_v1_consensus_graffities_labels_in_ranges_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"label":{"type":"string","description":"The category or type of graffiti label being analyzed."},"graffiti":{"type":"string","description":"The specific graffiti instance or identifier associated with the label."},"value":{"type":"number","description":"Numerical score or metric representing the consensus or confidence level for the graffiti label, typically within a defined range."},"as_of_date":{"type":"string","format":"date","description":"Date the snapshot is computed as of (max date in the underlying data)."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/consensus/staked_gno/latest":{"get":{"tags":["Consensus"],"summary":"Staked Gno (latest)","description":"**Required Access:** `tier0` (no API key required)\n\nThe 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.\n\n**Columns:**\n- **value** (`Float64`): The total amount of GNO currently staked, represented as an unsigned 32-bit integer.\n- **change_pct** (`Float64`): The percentage change in the staked GNO amount compared to the previous measurement.\n- **as_of_date** (`Date`): Date the snapshot is computed as of (max date in the underlying data).","operationId":"api_consensus_info_staked_latest_get_v1_consensus_staked_gno_latest_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"value":{"type":"number","description":"The total amount of GNO currently staked, represented as an unsigned 32-bit integer."},"change_pct":{"type":"number","description":"The percentage change in the staked GNO amount compared to the previous measurement."},"as_of_date":{"type":"string","format":"date","description":"Date the snapshot is computed as of (max date in the underlying data)."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/consensus/staked_gno/daily":{"get":{"tags":["Consensus"],"summary":"Staked Gno (daily)","description":"**Required Access:** `tier1`\n\nThe api_consensus_staked_daily model provides daily aggregated data on the effective staked GNO across validators, facilitating analysis of staking trends over time.\n\n**Columns:**\n- **date** (`Date`): The specific calendar date for the recorded staked balance.\n- **value** (`Float64`): The network's total effective balance in real GNO (mGNO->GNO conversion happens upstream in int_consensus_validators_balances_daily).","operationId":"api_consensus_staked_daily_get_v1_consensus_staked_gno_daily_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"date":{"type":"string","format":"date","description":"The specific calendar date for the recorded staked balance."},"value":{"type":"number","description":"The network's total effective balance in real GNO (mGNO->GNO conversion happens upstream in int_consensus_validators_balances_daily)."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/consensus/validators_active_ongoing/latest":{"get":{"tags":["Consensus"],"summary":"Validators Active Ongoing (latest)","description":"**Required Access:** `tier0` (no API key required)\n\nThe model provides the latest consensus information on active and ongoing items, serving as a key reference for monitoring current operational states.\n\n**Columns:**\n- **value** (`Float64`): The numeric value representing the current measurement or count related to active and ongoing consensus data.\n- **change_pct** (`Float64`): The percentage change in the value compared to the previous measurement, indicating the trend or variation over time.\n- **as_of_date** (`Date`): Date the snapshot is computed as of (max date in the underlying data).","operationId":"api_consensus_info_active_ongoing_latest_get_v1_consensus_validators_active_ongoing_latest_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"value":{"type":"number","description":"The numeric value representing the current measurement or count related to active and ongoing consensus data."},"change_pct":{"type":"number","description":"The percentage change in the value compared to the previous measurement, indicating the trend or variation over time."},"as_of_date":{"type":"string","format":"date","description":"Date the snapshot is computed as of (max date in the underlying data)."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/consensus/validators_active_ongoing/daily":{"get":{"tags":["Consensus"],"summary":"Validators Active Ongoing (daily)","description":"**Required Access:** `tier1`\n\nThe 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.\n\n**Columns:**\n- **date** (`Date`): The specific calendar date for the recorded validator activity count.\n- **cnt** (`UInt64`): The total number of validators actively participating on the given date.","operationId":"api_consensus_validators_active_daily_get_v1_consensus_validators_active_ongoing_daily_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"date":{"type":"string","format":"date","description":"The specific calendar date for the recorded validator activity count."},"cnt":{"type":"integer","description":"The total number of validators actively participating on the given date."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/consensus/validators_apy/latest":{"get":{"tags":["Consensus"],"summary":"Validators Apy (latest)","description":"**Required Access:** `tier0` (no API key required)\n\nThe api_consensus_info_apy_latest model provides the most recent annual percentage yield (APY) data from consensus sources, enabling analysis of current yield trends.\n\n**Columns:**\n- **value** (`Float64`): The latest APY value, representing the annual percentage yield as a decimal or percentage.\n- **change_pct** (`Float64`): The percentage change in APY compared to the previous measurement period.\n- **as_of_date** (`Date`): Date the snapshot is computed as of (max date in the underlying data).","operationId":"api_consensus_info_apy_latest_get_v1_consensus_validators_apy_latest_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"value":{"type":"number","description":"The latest APY value, representing the annual percentage yield as a decimal or percentage."},"change_pct":{"type":"number","description":"The percentage change in APY compared to the previous measurement period."},"as_of_date":{"type":"string","format":"date","description":"Date the snapshot is computed as of (max date in the underlying data)."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/consensus/validators_apy/daily":{"get":{"tags":["Consensus"],"summary":"Validators Apy (daily)","description":"**Required Access:** `tier1`\n\nPublic API view — SELECT * FROM fct_consensus_validators_apy_mean_daily. Filter/pagination metadata in model config.\n\n**Declared Filters:**\n- **date_from**: >= on `date` (Inclusive lower bound on date)\n- **date_to**: <= on `date` (Inclusive upper bound on date)\n\n**Pagination:**\n- **limit**: default `2000`, max `10000`\n- **offset**: default `0`\n\n**Sort:**\n- `date DESC`\n\n**Columns:**\n- **date** (`DateTime64`): Start-of-day UTC for the network-wide daily mean APY. One row per day.\n- **apy** (`Float64`): Average APY (%) across all validators on the date, outliers filtered.\n- **apy_rolling_7d_median** (`Float64`): 7-day trailing median of apy. Smoothing overlay for the dashboard band chart.\n- **apy_rolling_30d_median** (`Float64`): 30-day trailing median of apy.","operationId":"api_consensus_validators_apy_mean_daily_get_v1_consensus_validators_apy_daily_get","security":[{"APIKeyHeader":[]}],"responses":{"200":{"description":"Paginated response","content":{"application/json":{"schema":{"type":"object","required":["items","pagination"],"properties":{"items":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"date":{"type":"string","format":"date-time","description":"Start-of-day UTC for the network-wide daily mean APY. One row per day."},"apy":{"type":"number","description":"Average APY (%) across all validators on the date, outliers filtered."},"apy_rolling_7d_median":{"type":"number","description":"7-day trailing median of apy. Smoothing overlay for the dashboard band chart."},"apy_rolling_30d_median":{"type":"number","description":"30-day trailing median of apy."}}}},"pagination":{"type":"object","required":["limit","offset","returned","has_more"],"properties":{"limit":{"type":"integer","minimum":1},"offset":{"type":"integer","minimum":0},"returned":{"type":"integer","minimum":0},"has_more":{"type":"boolean"}}}}}}}}},"parameters":[{"name":"date_from","in":"query","required":false,"description":"Inclusive lower bound on date","schema":{"type":"string","format":"date"}},{"name":"date_to","in":"query","required":false,"description":"Inclusive upper bound on date","schema":{"type":"string","format":"date"}},{"name":"limit","in":"query","required":false,"description":"Row limit","schema":{"type":"integer","minimum":1,"maximum":10000,"default":2000}},{"name":"offset","in":"query","required":false,"description":"Row offset","schema":{"type":"integer","minimum":0,"default":0}}]},"post":{"tags":["Consensus"],"summary":"Validators Apy (daily) (POST)","description":"**Required Access:** `tier1`\n\nPublic API view — SELECT * FROM fct_consensus_validators_apy_mean_daily. Filter/pagination metadata in model config.\n\n**Declared Filters:**\n- **date_from**: >= on `date` (Inclusive lower bound on date)\n- **date_to**: <= on `date` (Inclusive upper bound on date)\n\n**Pagination:**\n- **limit**: default `2000`, max `10000`\n- **offset**: default `0`\n\n**Sort:**\n- `date DESC`\n\n**Columns:**\n- **date** (`DateTime64`): Start-of-day UTC for the network-wide daily mean APY. One row per day.\n- **apy** (`Float64`): Average APY (%) across all validators on the date, outliers filtered.\n- **apy_rolling_7d_median** (`Float64`): 7-day trailing median of apy. Smoothing overlay for the dashboard band chart.\n- **apy_rolling_30d_median** (`Float64`): 30-day trailing median of apy.","operationId":"api_consensus_validators_apy_mean_daily_post_v1_consensus_validators_apy_daily_post","security":[{"APIKeyHeader":[]}],"requestBody":{"content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/api_consensus_validators_apy_mean_daily_PostBody"},{"type":"null"}],"title":" Body"}}}},"responses":{"200":{"description":"Paginated response","content":{"application/json":{"schema":{"type":"object","required":["items","pagination"],"properties":{"items":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"date":{"type":"string","format":"date-time","description":"Start-of-day UTC for the network-wide daily mean APY. One row per day."},"apy":{"type":"number","description":"Average APY (%) across all validators on the date, outliers filtered."},"apy_rolling_7d_median":{"type":"number","description":"7-day trailing median of apy. Smoothing overlay for the dashboard band chart."},"apy_rolling_30d_median":{"type":"number","description":"30-day trailing median of apy."}}}},"pagination":{"type":"object","required":["limit","offset","returned","has_more"],"properties":{"limit":{"type":"integer","minimum":1},"offset":{"type":"integer","minimum":0},"returned":{"type":"integer","minimum":0},"has_more":{"type":"boolean"}}}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/consensus/validators_apy_distribution/daily":{"get":{"tags":["Consensus"],"summary":"Validators Apy Distribution (daily)","description":"**Required Access:** `tier1`\n\nThis view provides daily distribution metrics of validator APYs, enabling analysis of validator performance variability over time.\n\n**Columns:**\n- **date** (`Date`): The specific day for which the APY distribution data is recorded.\n- **q05** (`Float64`): The 5th percentile of validator APYs on the given date, indicating the lower tail of the distribution.\n- **q10** (`Float64`): The 10th percentile of validator APYs, representing the lower decile of the distribution.\n- **q25** (`Float64`): The 25th percentile (first quartile) of validator APYs, marking the lower quartile boundary.\n- **q50** (`Float64`): The median validator APY for the date, dividing the distribution into two equal halves.\n- **q75** (`Float64`): The 75th percentile (third quartile) of validator APYs, indicating the upper quartile boundary.\n- **q90** (`Float64`): The 90th percentile of validator APYs, representing the upper decile of the distribution.\n- **q95** (`Float64`): The 95th percentile of validator APYs, indicating the upper tail of the distribution.\n- **average** (`Float64`): The mean validator APY for the date, providing an overall average across validators.","operationId":"api_consensus_validators_apy_dist_daily_get_v1_consensus_validators_apy_distribution_daily_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"date":{"type":"string","format":"date","description":"The specific day for which the APY distribution data is recorded."},"q05":{"type":"number","description":"The 5th percentile of validator APYs on the given date, indicating the lower tail of the distribution."},"q10":{"type":"number","description":"The 10th percentile of validator APYs, representing the lower decile of the distribution."},"q25":{"type":"number","description":"The 25th percentile (first quartile) of validator APYs, marking the lower quartile boundary."},"q50":{"type":"number","description":"The median validator APY for the date, dividing the distribution into two equal halves."},"q75":{"type":"number","description":"The 75th percentile (third quartile) of validator APYs, indicating the upper quartile boundary."},"q90":{"type":"number","description":"The 90th percentile of validator APYs, representing the upper decile of the distribution."},"q95":{"type":"number","description":"The 95th percentile of validator APYs, indicating the upper tail of the distribution."},"average":{"type":"number","description":"The mean validator APY for the date, providing an overall average across validators."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/consensus/validators_apy_distribution/last_30d":{"get":{"tags":["Consensus"],"summary":"Validators Apy Distribution (last_30d)","description":"**Required Access:** `tier0` (no API key required)\n\nThis view provides a distribution of validator APYs over the last 30 days, enabling analysis of APY variability and trends within the validator set.\n\n**Columns:**\n- **date** (`Date`): The specific date for which the APY distribution data is aggregated.\n- **q05** (`Float64`): The 5th percentile of validator APYs, indicating the lower bound of the APY distribution.\n- **q10** (`Float64`): The 10th percentile of validator APYs, representing the lower tail of the distribution.\n- **q25** (`Float64`): The 25th percentile (first quartile) of validator APYs, marking the lower quartile boundary.\n- **q50** (`Float64`): The median APY value, dividing the distribution into two equal halves.\n- **q75** (`Float64`): The 75th percentile (third quartile) of validator APYs, indicating the upper quartile boundary.\n- **q90** (`Float64`): The 90th percentile of validator APYs, representing the upper tail of the distribution.\n- **q95** (`Float64`): The 95th percentile of validator APYs, capturing the highest APYs within the distribution.","operationId":"api_consensus_validators_apy_dist_last_30_days_get_v1_consensus_validators_apy_distribution_last_30d_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"date":{"type":"string","format":"date","description":"The specific date for which the APY distribution data is aggregated."},"q05":{"type":"number","description":"The 5th percentile of validator APYs, indicating the lower bound of the APY distribution."},"q10":{"type":"number","description":"The 10th percentile of validator APYs, representing the lower tail of the distribution."},"q25":{"type":"number","description":"The 25th percentile (first quartile) of validator APYs, marking the lower quartile boundary."},"q50":{"type":"number","description":"The median APY value, dividing the distribution into two equal halves."},"q75":{"type":"number","description":"The 75th percentile (third quartile) of validator APYs, indicating the upper quartile boundary."},"q90":{"type":"number","description":"The 90th percentile of validator APYs, representing the upper tail of the distribution."},"q95":{"type":"number","description":"The 95th percentile of validator APYs, capturing the highest APYs within the distribution."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/consensus/validators_apy_income_dist/daily":{"get":{"tags":["Consensus"],"summary":"Validators Apy Income Dist (daily)","description":"**Required Access:** `tier1`\n\nPublic API view — SELECT * FROM int_consensus_validators_apy_dist_income_daily. Filter/pagination metadata in model config.\n\n**Declared Filters:**\n- **date_from**: >= on `date` (Inclusive lower bound on date)\n- **date_to**: <= on `date` (Inclusive upper bound on date)\n\n**Pagination:**\n- **limit**: default `2000`, max `10000`\n- **offset**: default `0`\n\n**Sort:**\n- `date DESC`\n\n**Columns:**\n- **date** (`DateTime`): Start-of-day UTC for the network-wide APY distribution.\n- **q05_apy** (`Float64`): 5th-percentile (T-Digest) validator APY across active validators on the date.\n- **q10_apy** (`Float64`): 10th-percentile (T-Digest) validator APY across active validators on the date.\n- **q25_apy** (`Float64`): 25th-percentile (T-Digest) validator APY across active validators on the date.\n- **q50_apy** (`Float64`): Median (T-Digest) validator APY across active validators on the date.\n- **q75_apy** (`Float64`): 75th-percentile (T-Digest) validator APY across active validators on the date.\n- **q90_apy** (`Float64`): 90th-percentile (T-Digest) validator APY across active validators on the date.\n- **q95_apy** (`Float64`): 95th-percentile (T-Digest) validator APY across active validators on the date.\n- **avg_apy_weighted** (`Float64`): Balance-weighted mean APY on the date. Matches fct_consensus_validators_apy_mean_daily.apy.\n- **validators_included** (`UInt64`): Count of (date, validator_index) rows that passed the outlier+active filters.","operationId":"api_consensus_validators_apy_dist_income_daily_get_v1_consensus_validators_apy_income_dist_daily_get","security":[{"APIKeyHeader":[]}],"responses":{"200":{"description":"Paginated response","content":{"application/json":{"schema":{"type":"object","required":["items","pagination"],"properties":{"items":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"date":{"type":"string","format":"date-time","description":"Start-of-day UTC for the network-wide APY distribution."},"q05_apy":{"type":"number","description":"5th-percentile (T-Digest) validator APY across active validators on the date."},"q10_apy":{"type":"number","description":"10th-percentile (T-Digest) validator APY across active validators on the date."},"q25_apy":{"type":"number","description":"25th-percentile (T-Digest) validator APY across active validators on the date."},"q50_apy":{"type":"number","description":"Median (T-Digest) validator APY across active validators on the date."},"q75_apy":{"type":"number","description":"75th-percentile (T-Digest) validator APY across active validators on the date."},"q90_apy":{"type":"number","description":"90th-percentile (T-Digest) validator APY across active validators on the date."},"q95_apy":{"type":"number","description":"95th-percentile (T-Digest) validator APY across active validators on the date."},"avg_apy_weighted":{"type":"number","description":"Balance-weighted mean APY on the date. Matches fct_consensus_validators_apy_mean_daily.apy."},"validators_included":{"type":"integer","description":"Count of (date, validator_index) rows that passed the outlier+active filters."}}}},"pagination":{"type":"object","required":["limit","offset","returned","has_more"],"properties":{"limit":{"type":"integer","minimum":1},"offset":{"type":"integer","minimum":0},"returned":{"type":"integer","minimum":0},"has_more":{"type":"boolean"}}}}}}}}},"parameters":[{"name":"date_from","in":"query","required":false,"description":"Inclusive lower bound on date","schema":{"type":"string","format":"date"}},{"name":"date_to","in":"query","required":false,"description":"Inclusive upper bound on date","schema":{"type":"string","format":"date"}},{"name":"limit","in":"query","required":false,"description":"Row limit","schema":{"type":"integer","minimum":1,"maximum":10000,"default":2000}},{"name":"offset","in":"query","required":false,"description":"Row offset","schema":{"type":"integer","minimum":0,"default":0}}]},"post":{"tags":["Consensus"],"summary":"Validators Apy Income Dist (daily) (POST)","description":"**Required Access:** `tier1`\n\nPublic API view — SELECT * FROM int_consensus_validators_apy_dist_income_daily. Filter/pagination metadata in model config.\n\n**Declared Filters:**\n- **date_from**: >= on `date` (Inclusive lower bound on date)\n- **date_to**: <= on `date` (Inclusive upper bound on date)\n\n**Pagination:**\n- **limit**: default `2000`, max `10000`\n- **offset**: default `0`\n\n**Sort:**\n- `date DESC`\n\n**Columns:**\n- **date** (`DateTime`): Start-of-day UTC for the network-wide APY distribution.\n- **q05_apy** (`Float64`): 5th-percentile (T-Digest) validator APY across active validators on the date.\n- **q10_apy** (`Float64`): 10th-percentile (T-Digest) validator APY across active validators on the date.\n- **q25_apy** (`Float64`): 25th-percentile (T-Digest) validator APY across active validators on the date.\n- **q50_apy** (`Float64`): Median (T-Digest) validator APY across active validators on the date.\n- **q75_apy** (`Float64`): 75th-percentile (T-Digest) validator APY across active validators on the date.\n- **q90_apy** (`Float64`): 90th-percentile (T-Digest) validator APY across active validators on the date.\n- **q95_apy** (`Float64`): 95th-percentile (T-Digest) validator APY across active validators on the date.\n- **avg_apy_weighted** (`Float64`): Balance-weighted mean APY on the date. Matches fct_consensus_validators_apy_mean_daily.apy.\n- **validators_included** (`UInt64`): Count of (date, validator_index) rows that passed the outlier+active filters.","operationId":"api_consensus_validators_apy_dist_income_daily_post_v1_consensus_validators_apy_income_dist_daily_post","security":[{"APIKeyHeader":[]}],"requestBody":{"content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/api_consensus_validators_apy_dist_income_daily_PostBody"},{"type":"null"}],"title":" Body"}}}},"responses":{"200":{"description":"Paginated response","content":{"application/json":{"schema":{"type":"object","required":["items","pagination"],"properties":{"items":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"date":{"type":"string","format":"date-time","description":"Start-of-day UTC for the network-wide APY distribution."},"q05_apy":{"type":"number","description":"5th-percentile (T-Digest) validator APY across active validators on the date."},"q10_apy":{"type":"number","description":"10th-percentile (T-Digest) validator APY across active validators on the date."},"q25_apy":{"type":"number","description":"25th-percentile (T-Digest) validator APY across active validators on the date."},"q50_apy":{"type":"number","description":"Median (T-Digest) validator APY across active validators on the date."},"q75_apy":{"type":"number","description":"75th-percentile (T-Digest) validator APY across active validators on the date."},"q90_apy":{"type":"number","description":"90th-percentile (T-Digest) validator APY across active validators on the date."},"q95_apy":{"type":"number","description":"95th-percentile (T-Digest) validator APY across active validators on the date."},"avg_apy_weighted":{"type":"number","description":"Balance-weighted mean APY on the date. Matches fct_consensus_validators_apy_mean_daily.apy."},"validators_included":{"type":"integer","description":"Count of (date, validator_index) rows that passed the outlier+active filters."}}}},"pagination":{"type":"object","required":["limit","offset","returned","has_more"],"properties":{"limit":{"type":"integer","minimum":1},"offset":{"type":"integer","minimum":0},"returned":{"type":"integer","minimum":0},"has_more":{"type":"boolean"}}}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/consensus/validators_balance_distribution/last_30d":{"get":{"tags":["Consensus"],"summary":"Validators Balance Distribution (last_30d)","description":"**Required Access:** `tier0` (no API key required)\n\nThis view provides the distribution of validator balances over the last 30 days, summarized through various quantiles to analyze balance spread and trends.\n\n**Columns:**\n- **date** (`Date`): The date corresponding to the balance distribution snapshot.\n- **q05** (`Float64`): The 5th percentile of validator balances, indicating the lower tail of the distribution.\n- **q10** (`Float64`): The 10th percentile of validator balances, representing the lower decile of the distribution.\n- **q25** (`Float64`): The 25th percentile (first quartile) of validator balances, marking the lower quartile boundary.\n- **q50** (`Float64`): The median validator balance, dividing the distribution into two equal halves.\n- **q75** (`Float64`): The 75th percentile (third quartile) of validator balances, marking the upper quartile boundary.\n- **q90** (`Float64`): The 90th percentile of validator balances, indicating the upper tail of the distribution.\n- **q95** (`Float64`): The 95th percentile of validator balances, representing the upper extreme of the distribution.","operationId":"api_consensus_validators_balance_dist_last_30_days_get_v1_consensus_validators_balance_distribution_last_30d_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"date":{"type":"string","format":"date","description":"The date corresponding to the balance distribution snapshot."},"q05":{"type":"number","description":"The 5th percentile of validator balances, indicating the lower tail of the distribution."},"q10":{"type":"number","description":"The 10th percentile of validator balances, representing the lower decile of the distribution."},"q25":{"type":"number","description":"The 25th percentile (first quartile) of validator balances, marking the lower quartile boundary."},"q50":{"type":"number","description":"The median validator balance, dividing the distribution into two equal halves."},"q75":{"type":"number","description":"The 75th percentile (third quartile) of validator balances, marking the upper quartile boundary."},"q90":{"type":"number","description":"The 90th percentile of validator balances, indicating the upper tail of the distribution."},"q95":{"type":"number","description":"The 95th percentile of validator balances, representing the upper extreme of the distribution."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/consensus/validators_balances/daily":{"get":{"tags":["Consensus"],"summary":"Validators Balances (daily)","description":"**Required Access:** `tier1`\n\nThe api_consensus_validators_balances_daily model provides a daily overview of validator balances and effective balances to support consensus and validator health analysis.\n\n**Columns:**\n- **date** (`Date`): The specific calendar date for the recorded validator balances.\n- **label** (`String`): Identifier indicating whether the row represents 'balance' or 'eff. balance'.\n- **value** (`Float64`): The numeric value of the validator balance or effective balance for the given date.","operationId":"api_consensus_validators_balances_daily_get_v1_consensus_validators_balances_daily_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"date":{"type":"string","format":"date","description":"The specific calendar date for the recorded validator balances."},"label":{"type":"string","description":"Identifier indicating whether the row represents 'balance' or 'eff. balance'."},"value":{"type":"number","description":"The numeric value of the validator balance or effective balance for the given date."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/consensus/validators_balances_distribution/daily":{"get":{"tags":["Consensus"],"summary":"Validators Balances Distribution (daily)","description":"**Required Access:** `tier1`\n\nThis view provides daily distribution percentiles of validator balances in GNO, enabling analysis of validator balance variability over time.\n\n**Columns:**\n- **date** (`Date`): The specific day for which the balance distribution data is recorded.\n- **q05** (`Float64`): The 5th percentile of validator balances in GNO, representing the lower tail of the distribution.\n- **q10** (`Float64`): The 10th percentile of validator balances in GNO, indicating the balance below which 10% of validators fall.\n- **q25** (`Float64`): The 25th percentile (first quartile) of validator balances in GNO.\n- **q50** (`Float64`): The median validator balance in GNO, dividing the distribution into two equal halves.\n- **q75** (`Float64`): The 75th percentile (third quartile) of validator balances in GNO.\n- **q90** (`Float64`): The 90th percentile of validator balances in GNO, representing the upper tail of the distribution.\n- **q95** (`Float64`): The 95th percentile of validator balances in GNO, indicating the top 5% of validator balances.","operationId":"api_consensus_validators_balances_dist_daily_get_v1_consensus_validators_balances_distribution_daily_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"date":{"type":"string","format":"date","description":"The specific day for which the balance distribution data is recorded."},"q05":{"type":"number","description":"The 5th percentile of validator balances in GNO, representing the lower tail of the distribution."},"q10":{"type":"number","description":"The 10th percentile of validator balances in GNO, indicating the balance below which 10% of validators fall."},"q25":{"type":"number","description":"The 25th percentile (first quartile) of validator balances in GNO."},"q50":{"type":"number","description":"The median validator balance in GNO, dividing the distribution into two equal halves."},"q75":{"type":"number","description":"The 75th percentile (third quartile) of validator balances in GNO."},"q90":{"type":"number","description":"The 90th percentile of validator balances in GNO, representing the upper tail of the distribution."},"q95":{"type":"number","description":"The 95th percentile of validator balances in GNO, indicating the top 5% of validator balances."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/consensus/validators_explorer/latest":{"get":{"tags":["Consensus"],"summary":"Validators Explorer (latest)","description":"**Required Access:** `tier1`\n\nPublic API view — SELECT * FROM fct_consensus_validators_explorer_latest. Requires withdrawal_credentials filter; see model config.\n\n**Declared Filters:**\n- **withdrawal_credentials**: = on `withdrawal_credentials` (Withdrawal credential (32-byte hex) — aggregates KPIs across every validator sharing this credential)\n\n**Pagination:**\n- **limit**: default `100`, max `1000`\n- **offset**: default `0`\n\n**Columns:**\n- **withdrawal_credentials** (`String`): Lowercased withdrawal credentials — the per-operator grouping key; one row per credential.\n- **as_of_date** (`Date`): Date the snapshot is computed as of (max date in the underlying data).","operationId":"api_consensus_validators_explorer_latest_get_v1_consensus_validators_explorer_latest_get","security":[{"APIKeyHeader":[]}],"responses":{"200":{"description":"Paginated response","content":{"application/json":{"schema":{"type":"object","required":["items","pagination"],"properties":{"items":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"withdrawal_credentials":{"type":"string","description":"Lowercased withdrawal credentials — the per-operator grouping key; one row per credential."},"as_of_date":{"type":"string","format":"date","description":"Date the snapshot is computed as of (max date in the underlying data)."}}}},"pagination":{"type":"object","required":["limit","offset","returned","has_more"],"properties":{"limit":{"type":"integer","minimum":1},"offset":{"type":"integer","minimum":0},"returned":{"type":"integer","minimum":0},"has_more":{"type":"boolean"}}}}}}}}},"parameters":[{"name":"withdrawal_credentials","in":"query","required":false,"description":"Withdrawal credential (32-byte hex) — aggregates KPIs across every validator sharing this credential","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"Row limit","schema":{"type":"integer","minimum":1,"maximum":1000,"default":100}},{"name":"offset","in":"query","required":false,"description":"Row offset","schema":{"type":"integer","minimum":0,"default":0}}]},"post":{"tags":["Consensus"],"summary":"Validators Explorer (latest) (POST)","description":"**Required Access:** `tier1`\n\nPublic API view — SELECT * FROM fct_consensus_validators_explorer_latest. Requires withdrawal_credentials filter; see model config.\n\n**Declared Filters:**\n- **withdrawal_credentials**: = on `withdrawal_credentials` (Withdrawal credential (32-byte hex) — aggregates KPIs across every validator sharing this credential)\n\n**Pagination:**\n- **limit**: default `100`, max `1000`\n- **offset**: default `0`\n\n**Columns:**\n- **withdrawal_credentials** (`String`): Lowercased withdrawal credentials — the per-operator grouping key; one row per credential.\n- **as_of_date** (`Date`): Date the snapshot is computed as of (max date in the underlying data).","operationId":"api_consensus_validators_explorer_latest_post_v1_consensus_validators_explorer_latest_post","security":[{"APIKeyHeader":[]}],"requestBody":{"content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/api_consensus_validators_explorer_latest_PostBody"},{"type":"null"}],"title":" Body"}}}},"responses":{"200":{"description":"Paginated response","content":{"application/json":{"schema":{"type":"object","required":["items","pagination"],"properties":{"items":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"withdrawal_credentials":{"type":"string","description":"Lowercased withdrawal credentials — the per-operator grouping key; one row per credential."},"as_of_date":{"type":"string","format":"date","description":"Date the snapshot is computed as of (max date in the underlying data)."}}}},"pagination":{"type":"object","required":["limit","offset","returned","has_more"],"properties":{"limit":{"type":"integer","minimum":1},"offset":{"type":"integer","minimum":0},"returned":{"type":"integer","minimum":0},"has_more":{"type":"boolean"}}}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/consensus/validators_explorer/daily":{"get":{"tags":["Consensus"],"summary":"Validators Explorer (daily)","description":"**Required Access:** `tier1`\n\nPublic API view — SELECT * FROM fct_consensus_validators_explorer_daily. Requires withdrawal_credentials filter; see model config.\n\n**Declared Filters:**\n- **withdrawal_credentials**: = on `withdrawal_credentials` (Withdrawal credential (32-byte hex) — aggregates daily metrics across every validator sharing this credential)\n- **date_from**: >= on `date` (Inclusive lower bound on date)\n- **date_to**: <= on `date` (Inclusive upper bound on date)\n\n**Pagination:**\n- **limit**: default `1000`, max `10000`\n- **offset**: default `0`\n\n**Sort:**\n- `date DESC`\n\n**Columns:**\n- **date** (`DateTime64`): Day of the roll-up (start-of-day UTC timestamp). Grain is one row per (date, withdrawal_credentials).\n- **withdrawal_credentials** (`String`): Lowercased withdrawal credentials — the per-operator grouping key.\n- **balance_gno** (`Float64`): Sum of end-of-day validator balances across validators sharing the credential, in GNO.\n- **effective_balance_gno** (`Float64`): Sum of end-of-day effective balances across validators sharing the credential, in GNO.\n- **consensus_income_amount_gno** (`Float64`): Sum of daily spec-bounded consensus income across validators sharing the credential, in GNO.\n- **apy** (`Float64`): Mean APY across validators sharing this credential on the date, outliers filtered.\n- **proposer_reward_total_gno** (`Float64`): Sum of proposer rewards earned on the date by validators sharing the credential, in GNO.\n- **proposed_blocks_count** (`UInt64`): Total blocks proposed on the date by validators sharing the credential.\n- **deposits_amount_gno** (`Float64`): Sum of raw reported deposit amounts on the date, in GNO. Post-Pectra these are request amounts that may be credited gradually via the pending-deposits queue (see int_consensus_validators_income_daily).\n- **withdrawals_amount_gno** (`Float64`): Sum of amounts withdrawn on the date across validators sharing the credential, in GNO.\n- **consolidation_inflow_gno** (`Float64`): Sum of consolidation amounts received (target role) on the date, in GNO.\n- **consolidation_outflow_gno** (`Float64`): Sum of consolidation amounts transferred out (source role) on the date, in GNO.\n- **validator_count_active** (`UInt64`): Count of distinct validator_index rows included in this (date, credential) aggregation. Dashboard uses this to decide between quantile bands (N>1) and a clean rolling-median line (N=1, solo credential).","operationId":"api_consensus_validators_explorer_daily_get_v1_consensus_validators_explorer_daily_get","security":[{"APIKeyHeader":[]}],"responses":{"200":{"description":"Paginated response","content":{"application/json":{"schema":{"type":"object","required":["items","pagination"],"properties":{"items":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"date":{"type":"string","format":"date-time","description":"Day of the roll-up (start-of-day UTC timestamp). Grain is one row per (date, withdrawal_credentials)."},"withdrawal_credentials":{"type":"string","description":"Lowercased withdrawal credentials — the per-operator grouping key."},"balance_gno":{"type":"number","description":"Sum of end-of-day validator balances across validators sharing the credential, in GNO."},"effective_balance_gno":{"type":"number","description":"Sum of end-of-day effective balances across validators sharing the credential, in GNO."},"consensus_income_amount_gno":{"type":"number","description":"Sum of daily spec-bounded consensus income across validators sharing the credential, in GNO."},"apy":{"type":"number","description":"Mean APY across validators sharing this credential on the date, outliers filtered."},"proposer_reward_total_gno":{"type":"number","description":"Sum of proposer rewards earned on the date by validators sharing the credential, in GNO."},"proposed_blocks_count":{"type":"integer","description":"Total blocks proposed on the date by validators sharing the credential."},"deposits_amount_gno":{"type":"number","description":"Sum of raw reported deposit amounts on the date, in GNO. Post-Pectra these are request amounts that may be credited gradually via the pending-deposits queue (see int_consensus_validators_income_daily)."},"withdrawals_amount_gno":{"type":"number","description":"Sum of amounts withdrawn on the date across validators sharing the credential, in GNO."},"consolidation_inflow_gno":{"type":"number","description":"Sum of consolidation amounts received (target role) on the date, in GNO."},"consolidation_outflow_gno":{"type":"number","description":"Sum of consolidation amounts transferred out (source role) on the date, in GNO."},"validator_count_active":{"type":"integer","description":"Count of distinct validator_index rows included in this (date, credential) aggregation. Dashboard uses this to decide between quantile bands (N>1) and a clean rolling-median line (N=1, solo credential)."}}}},"pagination":{"type":"object","required":["limit","offset","returned","has_more"],"properties":{"limit":{"type":"integer","minimum":1},"offset":{"type":"integer","minimum":0},"returned":{"type":"integer","minimum":0},"has_more":{"type":"boolean"}}}}}}}}},"parameters":[{"name":"withdrawal_credentials","in":"query","required":false,"description":"Withdrawal credential (32-byte hex) — aggregates daily metrics across every validator sharing this credential","schema":{"type":"string"}},{"name":"date_from","in":"query","required":false,"description":"Inclusive lower bound on date","schema":{"type":"string","format":"date"}},{"name":"date_to","in":"query","required":false,"description":"Inclusive upper bound on date","schema":{"type":"string","format":"date"}},{"name":"limit","in":"query","required":false,"description":"Row limit","schema":{"type":"integer","minimum":1,"maximum":10000,"default":1000}},{"name":"offset","in":"query","required":false,"description":"Row offset","schema":{"type":"integer","minimum":0,"default":0}}]},"post":{"tags":["Consensus"],"summary":"Validators Explorer (daily) (POST)","description":"**Required Access:** `tier1`\n\nPublic API view — SELECT * FROM fct_consensus_validators_explorer_daily. Requires withdrawal_credentials filter; see model config.\n\n**Declared Filters:**\n- **withdrawal_credentials**: = on `withdrawal_credentials` (Withdrawal credential (32-byte hex) — aggregates daily metrics across every validator sharing this credential)\n- **date_from**: >= on `date` (Inclusive lower bound on date)\n- **date_to**: <= on `date` (Inclusive upper bound on date)\n\n**Pagination:**\n- **limit**: default `1000`, max `10000`\n- **offset**: default `0`\n\n**Sort:**\n- `date DESC`\n\n**Columns:**\n- **date** (`DateTime64`): Day of the roll-up (start-of-day UTC timestamp). Grain is one row per (date, withdrawal_credentials).\n- **withdrawal_credentials** (`String`): Lowercased withdrawal credentials — the per-operator grouping key.\n- **balance_gno** (`Float64`): Sum of end-of-day validator balances across validators sharing the credential, in GNO.\n- **effective_balance_gno** (`Float64`): Sum of end-of-day effective balances across validators sharing the credential, in GNO.\n- **consensus_income_amount_gno** (`Float64`): Sum of daily spec-bounded consensus income across validators sharing the credential, in GNO.\n- **apy** (`Float64`): Mean APY across validators sharing this credential on the date, outliers filtered.\n- **proposer_reward_total_gno** (`Float64`): Sum of proposer rewards earned on the date by validators sharing the credential, in GNO.\n- **proposed_blocks_count** (`UInt64`): Total blocks proposed on the date by validators sharing the credential.\n- **deposits_amount_gno** (`Float64`): Sum of raw reported deposit amounts on the date, in GNO. Post-Pectra these are request amounts that may be credited gradually via the pending-deposits queue (see int_consensus_validators_income_daily).\n- **withdrawals_amount_gno** (`Float64`): Sum of amounts withdrawn on the date across validators sharing the credential, in GNO.\n- **consolidation_inflow_gno** (`Float64`): Sum of consolidation amounts received (target role) on the date, in GNO.\n- **consolidation_outflow_gno** (`Float64`): Sum of consolidation amounts transferred out (source role) on the date, in GNO.\n- **validator_count_active** (`UInt64`): Count of distinct validator_index rows included in this (date, credential) aggregation. Dashboard uses this to decide between quantile bands (N>1) and a clean rolling-median line (N=1, solo credential).","operationId":"api_consensus_validators_explorer_daily_post_v1_consensus_validators_explorer_daily_post","security":[{"APIKeyHeader":[]}],"requestBody":{"content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/api_consensus_validators_explorer_daily_PostBody"},{"type":"null"}],"title":" Body"}}}},"responses":{"200":{"description":"Paginated response","content":{"application/json":{"schema":{"type":"object","required":["items","pagination"],"properties":{"items":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"date":{"type":"string","format":"date-time","description":"Day of the roll-up (start-of-day UTC timestamp). Grain is one row per (date, withdrawal_credentials)."},"withdrawal_credentials":{"type":"string","description":"Lowercased withdrawal credentials — the per-operator grouping key."},"balance_gno":{"type":"number","description":"Sum of end-of-day validator balances across validators sharing the credential, in GNO."},"effective_balance_gno":{"type":"number","description":"Sum of end-of-day effective balances across validators sharing the credential, in GNO."},"consensus_income_amount_gno":{"type":"number","description":"Sum of daily spec-bounded consensus income across validators sharing the credential, in GNO."},"apy":{"type":"number","description":"Mean APY across validators sharing this credential on the date, outliers filtered."},"proposer_reward_total_gno":{"type":"number","description":"Sum of proposer rewards earned on the date by validators sharing the credential, in GNO."},"proposed_blocks_count":{"type":"integer","description":"Total blocks proposed on the date by validators sharing the credential."},"deposits_amount_gno":{"type":"number","description":"Sum of raw reported deposit amounts on the date, in GNO. Post-Pectra these are request amounts that may be credited gradually via the pending-deposits queue (see int_consensus_validators_income_daily)."},"withdrawals_amount_gno":{"type":"number","description":"Sum of amounts withdrawn on the date across validators sharing the credential, in GNO."},"consolidation_inflow_gno":{"type":"number","description":"Sum of consolidation amounts received (target role) on the date, in GNO."},"consolidation_outflow_gno":{"type":"number","description":"Sum of consolidation amounts transferred out (source role) on the date, in GNO."},"validator_count_active":{"type":"integer","description":"Count of distinct validator_index rows included in this (date, credential) aggregation. Dashboard uses this to decide between quantile bands (N>1) and a clean rolling-median line (N=1, solo credential)."}}}},"pagination":{"type":"object","required":["limit","offset","returned","has_more"],"properties":{"limit":{"type":"integer","minimum":1},"offset":{"type":"integer","minimum":0},"returned":{"type":"integer","minimum":0},"has_more":{"type":"boolean"}}}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/consensus/validators_explorer_apy_dist/daily":{"get":{"tags":["Consensus"],"summary":"Validators Explorer Apy Dist (daily)","description":"**Required Access:** `tier1`\n\nPublic API view — SELECT * FROM int_consensus_validators_explorer_apy_dist_daily. Requires withdrawal_credentials filter; see model config.\n\n**Declared Filters:**\n- **withdrawal_credentials**: = on `withdrawal_credentials` (Withdrawal credential (32-byte hex) — per-day cross-sectional APY quantiles across the validators under this credential, plus trailing 7d/30d medians of the credential's balance-weighted daily APY.)\n- **date_from**: >= on `date` (Inclusive lower bound on date)\n- **date_to**: <= on `date` (Inclusive upper bound on date)\n\n**Pagination:**\n- **limit**: default `1000`, max `10000`\n- **offset**: default `0`\n\n**Sort:**\n- `date DESC`\n\n**Columns:**\n- **date** (`DateTime`): Start-of-day UTC for the credential's cross-sectional APY distribution.\n- **withdrawal_credentials** (`String`): Lowercased withdrawal credentials grouping the validators whose APYs are aggregated.\n- **q05_apy** (`Float64`): 5th-percentile (T-Digest) cross-sectional APY across validators under this credential on the date.\n- **q10_apy** (`Float64`): 10th-percentile (T-Digest) cross-sectional APY across validators under this credential on the date.\n- **q25_apy** (`Float64`): 25th-percentile (T-Digest) cross-sectional APY across validators under this credential on the date.\n- **q50_apy** (`Float64`): Cross-sectional median APY across validators under this credential.\n- **q75_apy** (`Float64`): 75th-percentile (T-Digest) cross-sectional APY across validators under this credential on the date.\n- **q90_apy** (`Float64`): 90th-percentile (T-Digest) cross-sectional APY across validators under this credential on the date.\n- **q95_apy** (`Float64`): 95th-percentile (T-Digest) cross-sectional APY across validators under this credential on the date.\n- **apy_weighted** (`Float64`): Balance-weighted mean APY for the credential on the date.\n- **validator_count_active** (`UInt64`): Distinct validators under this credential contributing to the day's stats.\n- **apy_rolling_7d_median** (`Float64`): 7-day trailing median of apy_weighted per credential. Primary smoothing line for solo credentials.\n- **apy_rolling_30d_median** (`Float64`): 30-day trailing median of apy_weighted per credential.","operationId":"api_consensus_validators_explorer_apy_dist_daily_get_v1_consensus_validators_explorer_apy_dist_daily_get","security":[{"APIKeyHeader":[]}],"responses":{"200":{"description":"Paginated response","content":{"application/json":{"schema":{"type":"object","required":["items","pagination"],"properties":{"items":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"date":{"type":"string","format":"date-time","description":"Start-of-day UTC for the credential's cross-sectional APY distribution."},"withdrawal_credentials":{"type":"string","description":"Lowercased withdrawal credentials grouping the validators whose APYs are aggregated."},"q05_apy":{"type":"number","description":"5th-percentile (T-Digest) cross-sectional APY across validators under this credential on the date."},"q10_apy":{"type":"number","description":"10th-percentile (T-Digest) cross-sectional APY across validators under this credential on the date."},"q25_apy":{"type":"number","description":"25th-percentile (T-Digest) cross-sectional APY across validators under this credential on the date."},"q50_apy":{"type":"number","description":"Cross-sectional median APY across validators under this credential."},"q75_apy":{"type":"number","description":"75th-percentile (T-Digest) cross-sectional APY across validators under this credential on the date."},"q90_apy":{"type":"number","description":"90th-percentile (T-Digest) cross-sectional APY across validators under this credential on the date."},"q95_apy":{"type":"number","description":"95th-percentile (T-Digest) cross-sectional APY across validators under this credential on the date."},"apy_weighted":{"type":"number","description":"Balance-weighted mean APY for the credential on the date."},"validator_count_active":{"type":"integer","description":"Distinct validators under this credential contributing to the day's stats."},"apy_rolling_7d_median":{"type":"number","description":"7-day trailing median of apy_weighted per credential. Primary smoothing line for solo credentials."},"apy_rolling_30d_median":{"type":"number","description":"30-day trailing median of apy_weighted per credential."}}}},"pagination":{"type":"object","required":["limit","offset","returned","has_more"],"properties":{"limit":{"type":"integer","minimum":1},"offset":{"type":"integer","minimum":0},"returned":{"type":"integer","minimum":0},"has_more":{"type":"boolean"}}}}}}}}},"parameters":[{"name":"withdrawal_credentials","in":"query","required":false,"description":"Withdrawal credential (32-byte hex) — per-day cross-sectional APY quantiles across the validators under this credential, plus trailing 7d/30d medians of the credential's balance-weighted daily APY.","schema":{"type":"string"}},{"name":"date_from","in":"query","required":false,"description":"Inclusive lower bound on date","schema":{"type":"string","format":"date"}},{"name":"date_to","in":"query","required":false,"description":"Inclusive upper bound on date","schema":{"type":"string","format":"date"}},{"name":"limit","in":"query","required":false,"description":"Row limit","schema":{"type":"integer","minimum":1,"maximum":10000,"default":1000}},{"name":"offset","in":"query","required":false,"description":"Row offset","schema":{"type":"integer","minimum":0,"default":0}}]},"post":{"tags":["Consensus"],"summary":"Validators Explorer Apy Dist (daily) (POST)","description":"**Required Access:** `tier1`\n\nPublic API view — SELECT * FROM int_consensus_validators_explorer_apy_dist_daily. Requires withdrawal_credentials filter; see model config.\n\n**Declared Filters:**\n- **withdrawal_credentials**: = on `withdrawal_credentials` (Withdrawal credential (32-byte hex) — per-day cross-sectional APY quantiles across the validators under this credential, plus trailing 7d/30d medians of the credential's balance-weighted daily APY.)\n- **date_from**: >= on `date` (Inclusive lower bound on date)\n- **date_to**: <= on `date` (Inclusive upper bound on date)\n\n**Pagination:**\n- **limit**: default `1000`, max `10000`\n- **offset**: default `0`\n\n**Sort:**\n- `date DESC`\n\n**Columns:**\n- **date** (`DateTime`): Start-of-day UTC for the credential's cross-sectional APY distribution.\n- **withdrawal_credentials** (`String`): Lowercased withdrawal credentials grouping the validators whose APYs are aggregated.\n- **q05_apy** (`Float64`): 5th-percentile (T-Digest) cross-sectional APY across validators under this credential on the date.\n- **q10_apy** (`Float64`): 10th-percentile (T-Digest) cross-sectional APY across validators under this credential on the date.\n- **q25_apy** (`Float64`): 25th-percentile (T-Digest) cross-sectional APY across validators under this credential on the date.\n- **q50_apy** (`Float64`): Cross-sectional median APY across validators under this credential.\n- **q75_apy** (`Float64`): 75th-percentile (T-Digest) cross-sectional APY across validators under this credential on the date.\n- **q90_apy** (`Float64`): 90th-percentile (T-Digest) cross-sectional APY across validators under this credential on the date.\n- **q95_apy** (`Float64`): 95th-percentile (T-Digest) cross-sectional APY across validators under this credential on the date.\n- **apy_weighted** (`Float64`): Balance-weighted mean APY for the credential on the date.\n- **validator_count_active** (`UInt64`): Distinct validators under this credential contributing to the day's stats.\n- **apy_rolling_7d_median** (`Float64`): 7-day trailing median of apy_weighted per credential. Primary smoothing line for solo credentials.\n- **apy_rolling_30d_median** (`Float64`): 30-day trailing median of apy_weighted per credential.","operationId":"api_consensus_validators_explorer_apy_dist_daily_post_v1_consensus_validators_explorer_apy_dist_daily_post","security":[{"APIKeyHeader":[]}],"requestBody":{"content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/api_consensus_validators_explorer_apy_dist_daily_PostBody"},{"type":"null"}],"title":" Body"}}}},"responses":{"200":{"description":"Paginated response","content":{"application/json":{"schema":{"type":"object","required":["items","pagination"],"properties":{"items":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"date":{"type":"string","format":"date-time","description":"Start-of-day UTC for the credential's cross-sectional APY distribution."},"withdrawal_credentials":{"type":"string","description":"Lowercased withdrawal credentials grouping the validators whose APYs are aggregated."},"q05_apy":{"type":"number","description":"5th-percentile (T-Digest) cross-sectional APY across validators under this credential on the date."},"q10_apy":{"type":"number","description":"10th-percentile (T-Digest) cross-sectional APY across validators under this credential on the date."},"q25_apy":{"type":"number","description":"25th-percentile (T-Digest) cross-sectional APY across validators under this credential on the date."},"q50_apy":{"type":"number","description":"Cross-sectional median APY across validators under this credential."},"q75_apy":{"type":"number","description":"75th-percentile (T-Digest) cross-sectional APY across validators under this credential on the date."},"q90_apy":{"type":"number","description":"90th-percentile (T-Digest) cross-sectional APY across validators under this credential on the date."},"q95_apy":{"type":"number","description":"95th-percentile (T-Digest) cross-sectional APY across validators under this credential on the date."},"apy_weighted":{"type":"number","description":"Balance-weighted mean APY for the credential on the date."},"validator_count_active":{"type":"integer","description":"Distinct validators under this credential contributing to the day's stats."},"apy_rolling_7d_median":{"type":"number","description":"7-day trailing median of apy_weighted per credential. Primary smoothing line for solo credentials."},"apy_rolling_30d_median":{"type":"number","description":"30-day trailing median of apy_weighted per credential."}}}},"pagination":{"type":"object","required":["limit","offset","returned","has_more"],"properties":{"limit":{"type":"integer","minimum":1},"offset":{"type":"integer","minimum":0},"returned":{"type":"integer","minimum":0},"has_more":{"type":"boolean"}}}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/consensus/validators_explorer_balance_dist/latest":{"get":{"tags":["Consensus"],"summary":"Validators Explorer Balance Dist (latest)","description":"**Required Access:** `tier1`\n\nBalance-distribution histogram across co-validators sharing a withdrawal credential.\nLight view over fct_consensus_validators_status_latest (~558k rows); the API prunes\nby withdrawal_credentials before the bucketing runs so the query is cheap even\nwithout a physical index on credentials.\n\nBucket edges (<1, 1-16, 16-32, 32-48, 48-64, 64-128, 128-256, >=256 GNO) are chosen\nto span the two MaxEB regimes: 0x00 / 0x01 credentials cap at 32 GNO effective\nbalance (pre-Pectra), while 0x02 compounders + EIP-7251 go up to 2048 GNO\npost-Pectra. The 16 / 32 / 64 / 128 / 256 edges surface clusters at both caps plus\nany partial-balance validators (withdrawing or slashed). bucket_order (0-7) is\nemitted to keep the API sort stable in ascending balance order.\n\n\n**Declared Filters:**\n- **withdrawal_credentials**: = on `withdrawal_credentials` (Withdrawal credential (32-byte hex) — returns balance histogram across co-validators)\n\n**Pagination:**\n- **limit**: default `16`, max `64`\n- **offset**: default `0`\n\n**Sort:**\n- `bucket_order ASC`\n\n**Columns:**\n- **withdrawal_credentials** (`String`): Lowercased withdrawal credentials whose co-validators are bucketed (the required API filter).\n- **bucket** (`String`): Label for the balance bucket ('<1', '1-16', '16-32', '32-48', '48-64', '64-128', '128-256', '>=256').\n- **bucket_order** (`UInt8`): Integer ordering key for the bucket (0-7) so downstream charts keep bars in ascending balance order.\n- **validator_count** (`UInt64`): Number of validators under this credential falling in the balance bucket.\n- **balance_gno_total** (`Float64`): Total balance in GNO across the validators in this credential-and-bucket.\n- **as_of_date** (`Date`): Date the snapshot is computed as of (max date in the underlying data).","operationId":"api_consensus_validators_explorer_balance_dist_get_v1_consensus_validators_explorer_balance_dist_latest_get","security":[{"APIKeyHeader":[]}],"responses":{"200":{"description":"Paginated response","content":{"application/json":{"schema":{"type":"object","required":["items","pagination"],"properties":{"items":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"withdrawal_credentials":{"type":"string","description":"Lowercased withdrawal credentials whose co-validators are bucketed (the required API filter)."},"bucket":{"type":"string","description":"Label for the balance bucket ('<1', '1-16', '16-32', '32-48', '48-64', '64-128', '128-256', '>=256')."},"bucket_order":{"type":"integer","description":"Integer ordering key for the bucket (0-7) so downstream charts keep bars in ascending balance order."},"validator_count":{"type":"integer","description":"Number of validators under this credential falling in the balance bucket."},"balance_gno_total":{"type":"number","description":"Total balance in GNO across the validators in this credential-and-bucket."},"as_of_date":{"type":"string","format":"date","description":"Date the snapshot is computed as of (max date in the underlying data)."}}}},"pagination":{"type":"object","required":["limit","offset","returned","has_more"],"properties":{"limit":{"type":"integer","minimum":1},"offset":{"type":"integer","minimum":0},"returned":{"type":"integer","minimum":0},"has_more":{"type":"boolean"}}}}}}}}},"parameters":[{"name":"withdrawal_credentials","in":"query","required":false,"description":"Withdrawal credential (32-byte hex) — returns balance histogram across co-validators","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"Row limit","schema":{"type":"integer","minimum":1,"maximum":64,"default":16}},{"name":"offset","in":"query","required":false,"description":"Row offset","schema":{"type":"integer","minimum":0,"default":0}}]},"post":{"tags":["Consensus"],"summary":"Validators Explorer Balance Dist (latest) (POST)","description":"**Required Access:** `tier1`\n\nBalance-distribution histogram across co-validators sharing a withdrawal credential.\nLight view over fct_consensus_validators_status_latest (~558k rows); the API prunes\nby withdrawal_credentials before the bucketing runs so the query is cheap even\nwithout a physical index on credentials.\n\nBucket edges (<1, 1-16, 16-32, 32-48, 48-64, 64-128, 128-256, >=256 GNO) are chosen\nto span the two MaxEB regimes: 0x00 / 0x01 credentials cap at 32 GNO effective\nbalance (pre-Pectra), while 0x02 compounders + EIP-7251 go up to 2048 GNO\npost-Pectra. The 16 / 32 / 64 / 128 / 256 edges surface clusters at both caps plus\nany partial-balance validators (withdrawing or slashed). bucket_order (0-7) is\nemitted to keep the API sort stable in ascending balance order.\n\n\n**Declared Filters:**\n- **withdrawal_credentials**: = on `withdrawal_credentials` (Withdrawal credential (32-byte hex) — returns balance histogram across co-validators)\n\n**Pagination:**\n- **limit**: default `16`, max `64`\n- **offset**: default `0`\n\n**Sort:**\n- `bucket_order ASC`\n\n**Columns:**\n- **withdrawal_credentials** (`String`): Lowercased withdrawal credentials whose co-validators are bucketed (the required API filter).\n- **bucket** (`String`): Label for the balance bucket ('<1', '1-16', '16-32', '32-48', '48-64', '64-128', '128-256', '>=256').\n- **bucket_order** (`UInt8`): Integer ordering key for the bucket (0-7) so downstream charts keep bars in ascending balance order.\n- **validator_count** (`UInt64`): Number of validators under this credential falling in the balance bucket.\n- **balance_gno_total** (`Float64`): Total balance in GNO across the validators in this credential-and-bucket.\n- **as_of_date** (`Date`): Date the snapshot is computed as of (max date in the underlying data).","operationId":"api_consensus_validators_explorer_balance_dist_post_v1_consensus_validators_explorer_balance_dist_latest_post","security":[{"APIKeyHeader":[]}],"requestBody":{"content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/api_consensus_validators_explorer_balance_dist_PostBody"},{"type":"null"}],"title":" Body"}}}},"responses":{"200":{"description":"Paginated response","content":{"application/json":{"schema":{"type":"object","required":["items","pagination"],"properties":{"items":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"withdrawal_credentials":{"type":"string","description":"Lowercased withdrawal credentials whose co-validators are bucketed (the required API filter)."},"bucket":{"type":"string","description":"Label for the balance bucket ('<1', '1-16', '16-32', '32-48', '48-64', '64-128', '128-256', '>=256')."},"bucket_order":{"type":"integer","description":"Integer ordering key for the bucket (0-7) so downstream charts keep bars in ascending balance order."},"validator_count":{"type":"integer","description":"Number of validators under this credential falling in the balance bucket."},"balance_gno_total":{"type":"number","description":"Total balance in GNO across the validators in this credential-and-bucket."},"as_of_date":{"type":"string","format":"date","description":"Date the snapshot is computed as of (max date in the underlying data)."}}}},"pagination":{"type":"object","required":["limit","offset","returned","has_more"],"properties":{"limit":{"type":"integer","minimum":1},"offset":{"type":"integer","minimum":0},"returned":{"type":"integer","minimum":0},"has_more":{"type":"boolean"}}}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/consensus/validators_explorer_members/latest":{"get":{"tags":["Consensus"],"summary":"Validators Explorer Members (latest)","description":"**Required Access:** `tier1`\n\nPublic API view — SELECT * FROM fct_consensus_validators_explorer_members_table. Requires withdrawal_credentials filter; see model config.\n\n**Declared Filters:**\n- **withdrawal_credentials**: = on `withdrawal_credentials` (Withdrawal credential (32-byte hex) — returns every validator sharing this credential)\n\n**Pagination:**\n- **limit**: default `100`, max `5000`\n- **offset**: default `0`\n\n**Sort:**\n- `validator_index ASC`\n\n**User Sort:**\n- **sort_by**: one of `validator_index`, `balance_gno`, `consensus_income_amount_30d_gno`, `proposed_blocks_count_lifetime`, `total_income_estimated_gno`\n- **sort_direction**: `ASC` or `DESC` (defaults to `ASC` when `sort_by` is provided)\n\n**Columns:**\n- **balance_gno** (`Float64`): End-of-day validator balance in GNO.\n- **consensus_income_amount_30d_gno** (`Float64`): Sum of consensus income over the trailing 30 days, in GNO.\n- **proposed_blocks_count_lifetime** (`UInt64`): Lifetime count of blocks proposed by the validator.\n- **total_income_estimated_gno** (`Float64`): balance_gno + cumulative_withdrawals_gno − cumulative_deposits_gno (effective) − cumulative_consolidation_inflow_gno + cumulative_consolidation_outflow_gno. In GNO.\n- **validator_index** (`UInt64`): Beacon-chain validator index. Unique per date (see model-level unique_key).\n- **withdrawal_credentials** (`String`): Lowercased withdrawal credentials the validator sits under — the Validator Explorer's operator grouping key.\n- **as_of_date** (`Date`): Date the snapshot is computed as of (max date in the underlying data).","operationId":"api_consensus_validators_explorer_members_table_get_v1_consensus_validators_explorer_members_latest_get","security":[{"APIKeyHeader":[]}],"responses":{"200":{"description":"Paginated response","content":{"application/json":{"schema":{"type":"object","required":["items","pagination"],"properties":{"items":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"balance_gno":{"type":"number","description":"End-of-day validator balance in GNO."},"consensus_income_amount_30d_gno":{"type":"number","description":"Sum of consensus income over the trailing 30 days, in GNO."},"proposed_blocks_count_lifetime":{"type":"integer","description":"Lifetime count of blocks proposed by the validator."},"total_income_estimated_gno":{"type":"number","description":"balance_gno + cumulative_withdrawals_gno − cumulative_deposits_gno (effective) − cumulative_consolidation_inflow_gno + cumulative_consolidation_outflow_gno. In GNO."},"validator_index":{"type":"integer","description":"Beacon-chain validator index. Unique per date (see model-level unique_key)."},"withdrawal_credentials":{"type":"string","description":"Lowercased withdrawal credentials the validator sits under — the Validator Explorer's operator grouping key."},"as_of_date":{"type":"string","format":"date","description":"Date the snapshot is computed as of (max date in the underlying data)."}}}},"pagination":{"type":"object","required":["limit","offset","returned","has_more"],"properties":{"limit":{"type":"integer","minimum":1},"offset":{"type":"integer","minimum":0},"returned":{"type":"integer","minimum":0},"has_more":{"type":"boolean"}}}}}}}}},"parameters":[{"name":"withdrawal_credentials","in":"query","required":false,"description":"Withdrawal credential (32-byte hex) — returns every validator sharing this credential","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"Row limit","schema":{"type":"integer","minimum":1,"maximum":5000,"default":100}},{"name":"offset","in":"query","required":false,"description":"Row offset","schema":{"type":"integer","minimum":0,"default":0}},{"name":"sort_by","in":"query","required":false,"description":"Sort column","schema":{"type":"string","enum":["validator_index","balance_gno","consensus_income_amount_30d_gno","proposed_blocks_count_lifetime","total_income_estimated_gno"]}},{"name":"sort_direction","in":"query","required":false,"description":"Sort direction. Defaults to ASC when sort_by is provided.","schema":{"type":"string","enum":["ASC","DESC"],"default":"ASC"}}]},"post":{"tags":["Consensus"],"summary":"Validators Explorer Members (latest) (POST)","description":"**Required Access:** `tier1`\n\nPublic API view — SELECT * FROM fct_consensus_validators_explorer_members_table. Requires withdrawal_credentials filter; see model config.\n\n**Declared Filters:**\n- **withdrawal_credentials**: = on `withdrawal_credentials` (Withdrawal credential (32-byte hex) — returns every validator sharing this credential)\n\n**Pagination:**\n- **limit**: default `100`, max `5000`\n- **offset**: default `0`\n\n**Sort:**\n- `validator_index ASC`\n\n**User Sort:**\n- **sort_by**: one of `validator_index`, `balance_gno`, `consensus_income_amount_30d_gno`, `proposed_blocks_count_lifetime`, `total_income_estimated_gno`\n- **sort_direction**: `ASC` or `DESC` (defaults to `ASC` when `sort_by` is provided)\n\n**Columns:**\n- **balance_gno** (`Float64`): End-of-day validator balance in GNO.\n- **consensus_income_amount_30d_gno** (`Float64`): Sum of consensus income over the trailing 30 days, in GNO.\n- **proposed_blocks_count_lifetime** (`UInt64`): Lifetime count of blocks proposed by the validator.\n- **total_income_estimated_gno** (`Float64`): balance_gno + cumulative_withdrawals_gno − cumulative_deposits_gno (effective) − cumulative_consolidation_inflow_gno + cumulative_consolidation_outflow_gno. In GNO.\n- **validator_index** (`UInt64`): Beacon-chain validator index. Unique per date (see model-level unique_key).\n- **withdrawal_credentials** (`String`): Lowercased withdrawal credentials the validator sits under — the Validator Explorer's operator grouping key.\n- **as_of_date** (`Date`): Date the snapshot is computed as of (max date in the underlying data).","operationId":"api_consensus_validators_explorer_members_table_post_v1_consensus_validators_explorer_members_latest_post","security":[{"APIKeyHeader":[]}],"requestBody":{"content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/api_consensus_validators_explorer_members_table_PostBody"},{"type":"null"}],"title":" Body"}}}},"responses":{"200":{"description":"Paginated response","content":{"application/json":{"schema":{"type":"object","required":["items","pagination"],"properties":{"items":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"balance_gno":{"type":"number","description":"End-of-day validator balance in GNO."},"consensus_income_amount_30d_gno":{"type":"number","description":"Sum of consensus income over the trailing 30 days, in GNO."},"proposed_blocks_count_lifetime":{"type":"integer","description":"Lifetime count of blocks proposed by the validator."},"total_income_estimated_gno":{"type":"number","description":"balance_gno + cumulative_withdrawals_gno − cumulative_deposits_gno (effective) − cumulative_consolidation_inflow_gno + cumulative_consolidation_outflow_gno. In GNO."},"validator_index":{"type":"integer","description":"Beacon-chain validator index. Unique per date (see model-level unique_key)."},"withdrawal_credentials":{"type":"string","description":"Lowercased withdrawal credentials the validator sits under — the Validator Explorer's operator grouping key."},"as_of_date":{"type":"string","format":"date","description":"Date the snapshot is computed as of (max date in the underlying data)."}}}},"pagination":{"type":"object","required":["limit","offset","returned","has_more"],"properties":{"limit":{"type":"integer","minimum":1},"offset":{"type":"integer","minimum":0},"returned":{"type":"integer","minimum":0},"has_more":{"type":"boolean"}}}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/consensus/validators_income/daily":{"get":{"tags":["Consensus"],"summary":"Validators Income (daily)","description":"**Required Access:** `tier1`\n\nPublic API view — SELECT * FROM fct_consensus_validators_income_total_daily. Filter/pagination metadata in model config.\n\n**Declared Filters:**\n- **date_from**: >= on `date` (Inclusive lower bound on date)\n- **date_to**: <= on `date` (Inclusive upper bound on date)\n\n**Pagination:**\n- **limit**: default `2000`, max `10000`\n- **offset**: default `0`\n\n**Sort:**\n- `date DESC`\n\n**Columns:**\n- **date** (`DateTime64`): Start-of-day UTC for the network-wide daily income total. One row per day.\n- **income_gno** (`Float64`): Sum of consensus_income_amount_gno across all validators on the date.\n- **income_gno_rolling_7d_median** (`Float64`): 7-day trailing median of income_gno. Advisory overlay for the dashboard chart.\n- **income_gno_rolling_30d_median** (`Float64`): 30-day trailing median of income_gno.\n- **validators_snapshot_count** (`UInt64`): Count of validators snapshotted on the date from int_consensus_validators_snapshots_daily.\n- **anomaly_flag** (`UInt8`): 1 when abs(income_gno) > 5 * trailing-30d median(abs(income_gno)) AND abs(income_gno) > 16 GNO (the old 500-mGNO floor in real-GNO terms).\nAdvisory only — raw income_gno remains visible. Surfaced in the dashboard tooltip.","operationId":"api_consensus_validators_income_total_daily_get_v1_consensus_validators_income_daily_get","security":[{"APIKeyHeader":[]}],"responses":{"200":{"description":"Paginated response","content":{"application/json":{"schema":{"type":"object","required":["items","pagination"],"properties":{"items":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"date":{"type":"string","format":"date-time","description":"Start-of-day UTC for the network-wide daily income total. One row per day."},"income_gno":{"type":"number","description":"Sum of consensus_income_amount_gno across all validators on the date."},"income_gno_rolling_7d_median":{"type":"number","description":"7-day trailing median of income_gno. Advisory overlay for the dashboard chart."},"income_gno_rolling_30d_median":{"type":"number","description":"30-day trailing median of income_gno."},"validators_snapshot_count":{"type":"integer","description":"Count of validators snapshotted on the date from int_consensus_validators_snapshots_daily."},"anomaly_flag":{"type":"integer","description":"1 when abs(income_gno) > 5 * trailing-30d median(abs(income_gno)) AND abs(income_gno) > 16 GNO (the old 500-mGNO floor in real-GNO terms).\nAdvisory only — raw income_gno remains visible. Surfaced in the dashboard tooltip.\n"}}}},"pagination":{"type":"object","required":["limit","offset","returned","has_more"],"properties":{"limit":{"type":"integer","minimum":1},"offset":{"type":"integer","minimum":0},"returned":{"type":"integer","minimum":0},"has_more":{"type":"boolean"}}}}}}}}},"parameters":[{"name":"date_from","in":"query","required":false,"description":"Inclusive lower bound on date","schema":{"type":"string","format":"date"}},{"name":"date_to","in":"query","required":false,"description":"Inclusive upper bound on date","schema":{"type":"string","format":"date"}},{"name":"limit","in":"query","required":false,"description":"Row limit","schema":{"type":"integer","minimum":1,"maximum":10000,"default":2000}},{"name":"offset","in":"query","required":false,"description":"Row offset","schema":{"type":"integer","minimum":0,"default":0}}]},"post":{"tags":["Consensus"],"summary":"Validators Income (daily) (POST)","description":"**Required Access:** `tier1`\n\nPublic API view — SELECT * FROM fct_consensus_validators_income_total_daily. Filter/pagination metadata in model config.\n\n**Declared Filters:**\n- **date_from**: >= on `date` (Inclusive lower bound on date)\n- **date_to**: <= on `date` (Inclusive upper bound on date)\n\n**Pagination:**\n- **limit**: default `2000`, max `10000`\n- **offset**: default `0`\n\n**Sort:**\n- `date DESC`\n\n**Columns:**\n- **date** (`DateTime64`): Start-of-day UTC for the network-wide daily income total. One row per day.\n- **income_gno** (`Float64`): Sum of consensus_income_amount_gno across all validators on the date.\n- **income_gno_rolling_7d_median** (`Float64`): 7-day trailing median of income_gno. Advisory overlay for the dashboard chart.\n- **income_gno_rolling_30d_median** (`Float64`): 30-day trailing median of income_gno.\n- **validators_snapshot_count** (`UInt64`): Count of validators snapshotted on the date from int_consensus_validators_snapshots_daily.\n- **anomaly_flag** (`UInt8`): 1 when abs(income_gno) > 5 * trailing-30d median(abs(income_gno)) AND abs(income_gno) > 16 GNO (the old 500-mGNO floor in real-GNO terms).\nAdvisory only — raw income_gno remains visible. Surfaced in the dashboard tooltip.","operationId":"api_consensus_validators_income_total_daily_post_v1_consensus_validators_income_daily_post","security":[{"APIKeyHeader":[]}],"requestBody":{"content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/api_consensus_validators_income_total_daily_PostBody"},{"type":"null"}],"title":" Body"}}}},"responses":{"200":{"description":"Paginated response","content":{"application/json":{"schema":{"type":"object","required":["items","pagination"],"properties":{"items":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"date":{"type":"string","format":"date-time","description":"Start-of-day UTC for the network-wide daily income total. One row per day."},"income_gno":{"type":"number","description":"Sum of consensus_income_amount_gno across all validators on the date."},"income_gno_rolling_7d_median":{"type":"number","description":"7-day trailing median of income_gno. Advisory overlay for the dashboard chart."},"income_gno_rolling_30d_median":{"type":"number","description":"30-day trailing median of income_gno."},"validators_snapshot_count":{"type":"integer","description":"Count of validators snapshotted on the date from int_consensus_validators_snapshots_daily."},"anomaly_flag":{"type":"integer","description":"1 when abs(income_gno) > 5 * trailing-30d median(abs(income_gno)) AND abs(income_gno) > 16 GNO (the old 500-mGNO floor in real-GNO terms).\nAdvisory only — raw income_gno remains visible. Surfaced in the dashboard tooltip.\n"}}}},"pagination":{"type":"object","required":["limit","offset","returned","has_more"],"properties":{"limit":{"type":"integer","minimum":1},"offset":{"type":"integer","minimum":0},"returned":{"type":"integer","minimum":0},"has_more":{"type":"boolean"}}}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/consensus/validators_performance/latest":{"get":{"tags":["Consensus"],"summary":"Validators Performance (latest)","description":"**Required Access:** `tier1`\n\nPublic API view — one row per validator with latest snapshot fields plus 30-day and lifetime aggregates.\n\n**Declared Filters:**\n- **validator_index**: IN on `validator_index` (Validator index / indices)\n- **pubkey**: IN on `pubkey` (Validator public key(s))\n- **withdrawal_credentials**: IN on `withdrawal_credentials` (Withdrawal credential value(s))\n- **withdrawal_address**: IN on `withdrawal_address` (20-byte withdrawal address(es))\n\n**Pagination:**\n- **limit**: default `100`, max `5000`\n- **offset**: default `0`\n\n**Sort:**\n- `validator_index ASC`\n\n**User Sort:**\n- **sort_by**: one of `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`\n- **sort_direction**: `ASC` or `DESC` (defaults to `ASC` when `sort_by` is provided)\n\n**Columns:**\n- **effective_balance_gno** (`Float64`): End-of-day effective balance in real GNO (the 1-GNO-step stake used in the reward-cap formula; the spec's 32-mGNO step equals 1 GNO).\n- **pubkey** (`String`): Lowercased validator public key.\n- **withdrawal_address** (`Nullable(String)`): 20-byte withdrawal address derived from credentials when prefix is 0x01 or 0x02; NULL otherwise.\n- **withdrawal_credentials** (`String`): Lowercased withdrawal credentials.\n- **validator_index** (`UInt64`): Beacon-chain validator index.\n- **latest_date** (`DateTime64`): Date of the validator's most recent income row (max date in int_consensus_validators_income_daily).\n- **balance_gno** (`Float64`): Validator balance at the latest date, in GNO.\n- **consensus_income_amount_30d_gno** (`Float64`): Sum of consensus income over the trailing 30 days for the validator, in GNO.\n- **proposer_reward_total_30d_gno** (`Float64`): Sum of proposer rewards over the trailing 30 days for the validator, in GNO.\n- **proposed_blocks_count_lifetime** (`UInt64`): Total number of blocks proposed by the validator over its lifetime.\n- **total_income_estimated_gno** (`Float64`): Lifetime estimated consensus income for the validator, in GNO.\n- **as_of_date** (`Date`): Date the snapshot is computed as of (max date in the underlying data).","operationId":"api_consensus_validators_performance_latest_get_v1_consensus_validators_performance_latest_get","security":[{"APIKeyHeader":[]}],"responses":{"200":{"description":"Paginated response","content":{"application/json":{"schema":{"type":"object","required":["items","pagination"],"properties":{"items":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"effective_balance_gno":{"type":"number","description":"End-of-day effective balance in real GNO (the 1-GNO-step stake used in the reward-cap formula; the spec's 32-mGNO step equals 1 GNO)."},"pubkey":{"type":"string","description":"Lowercased validator public key."},"withdrawal_address":{"type":"string","description":"20-byte withdrawal address derived from credentials when prefix is 0x01 or 0x02; NULL otherwise."},"withdrawal_credentials":{"type":"string","description":"Lowercased withdrawal credentials."},"validator_index":{"type":"integer","description":"Beacon-chain validator index."},"latest_date":{"type":"string","format":"date-time","description":"Date of the validator's most recent income row (max date in int_consensus_validators_income_daily)."},"balance_gno":{"type":"number","description":"Validator balance at the latest date, in GNO."},"consensus_income_amount_30d_gno":{"type":"number","description":"Sum of consensus income over the trailing 30 days for the validator, in GNO."},"proposer_reward_total_30d_gno":{"type":"number","description":"Sum of proposer rewards over the trailing 30 days for the validator, in GNO."},"proposed_blocks_count_lifetime":{"type":"integer","description":"Total number of blocks proposed by the validator over its lifetime."},"total_income_estimated_gno":{"type":"number","description":"Lifetime estimated consensus income for the validator, in GNO."},"as_of_date":{"type":"string","format":"date","description":"Date the snapshot is computed as of (max date in the underlying data)."}}}},"pagination":{"type":"object","required":["limit","offset","returned","has_more"],"properties":{"limit":{"type":"integer","minimum":1},"offset":{"type":"integer","minimum":0},"returned":{"type":"integer","minimum":0},"has_more":{"type":"boolean"}}}}}}}}},"parameters":[{"name":"validator_index","in":"query","required":false,"description":"Validator index / indices. Accepts repeated query params or CSV.","style":"form","explode":true,"schema":{"type":"array","items":{"type":"string"},"maxItems":200}},{"name":"pubkey","in":"query","required":false,"description":"Validator public key(s). Accepts repeated query params or CSV.","style":"form","explode":true,"schema":{"type":"array","items":{"type":"string"},"maxItems":200}},{"name":"withdrawal_credentials","in":"query","required":false,"description":"Withdrawal credential value(s). Accepts repeated query params or CSV.","style":"form","explode":true,"schema":{"type":"array","items":{"type":"string"},"maxItems":200}},{"name":"withdrawal_address","in":"query","required":false,"description":"20-byte withdrawal address(es). Accepts repeated query params or CSV.","style":"form","explode":true,"schema":{"type":"array","items":{"type":"string"},"maxItems":200}},{"name":"limit","in":"query","required":false,"description":"Row limit","schema":{"type":"integer","minimum":1,"maximum":5000,"default":100}},{"name":"offset","in":"query","required":false,"description":"Row offset","schema":{"type":"integer","minimum":0,"default":0}},{"name":"sort_by","in":"query","required":false,"description":"Sort column","schema":{"type":"string","enum":["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"]}},{"name":"sort_direction","in":"query","required":false,"description":"Sort direction. Defaults to ASC when sort_by is provided.","schema":{"type":"string","enum":["ASC","DESC"],"default":"ASC"}}]},"post":{"tags":["Consensus"],"summary":"Validators Performance (latest) (POST)","description":"**Required Access:** `tier1`\n\nPublic API view — one row per validator with latest snapshot fields plus 30-day and lifetime aggregates.\n\n**Declared Filters:**\n- **validator_index**: IN on `validator_index` (Validator index / indices)\n- **pubkey**: IN on `pubkey` (Validator public key(s))\n- **withdrawal_credentials**: IN on `withdrawal_credentials` (Withdrawal credential value(s))\n- **withdrawal_address**: IN on `withdrawal_address` (20-byte withdrawal address(es))\n\n**Pagination:**\n- **limit**: default `100`, max `5000`\n- **offset**: default `0`\n\n**Sort:**\n- `validator_index ASC`\n\n**User Sort:**\n- **sort_by**: one of `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`\n- **sort_direction**: `ASC` or `DESC` (defaults to `ASC` when `sort_by` is provided)\n\n**Columns:**\n- **effective_balance_gno** (`Float64`): End-of-day effective balance in real GNO (the 1-GNO-step stake used in the reward-cap formula; the spec's 32-mGNO step equals 1 GNO).\n- **pubkey** (`String`): Lowercased validator public key.\n- **withdrawal_address** (`Nullable(String)`): 20-byte withdrawal address derived from credentials when prefix is 0x01 or 0x02; NULL otherwise.\n- **withdrawal_credentials** (`String`): Lowercased withdrawal credentials.\n- **validator_index** (`UInt64`): Beacon-chain validator index.\n- **latest_date** (`DateTime64`): Date of the validator's most recent income row (max date in int_consensus_validators_income_daily).\n- **balance_gno** (`Float64`): Validator balance at the latest date, in GNO.\n- **consensus_income_amount_30d_gno** (`Float64`): Sum of consensus income over the trailing 30 days for the validator, in GNO.\n- **proposer_reward_total_30d_gno** (`Float64`): Sum of proposer rewards over the trailing 30 days for the validator, in GNO.\n- **proposed_blocks_count_lifetime** (`UInt64`): Total number of blocks proposed by the validator over its lifetime.\n- **total_income_estimated_gno** (`Float64`): Lifetime estimated consensus income for the validator, in GNO.\n- **as_of_date** (`Date`): Date the snapshot is computed as of (max date in the underlying data).","operationId":"api_consensus_validators_performance_latest_post_v1_consensus_validators_performance_latest_post","security":[{"APIKeyHeader":[]}],"requestBody":{"content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/api_consensus_validators_performance_latest_PostBody"},{"type":"null"}],"title":" Body"}}}},"responses":{"200":{"description":"Paginated response","content":{"application/json":{"schema":{"type":"object","required":["items","pagination"],"properties":{"items":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"effective_balance_gno":{"type":"number","description":"End-of-day effective balance in real GNO (the 1-GNO-step stake used in the reward-cap formula; the spec's 32-mGNO step equals 1 GNO)."},"pubkey":{"type":"string","description":"Lowercased validator public key."},"withdrawal_address":{"type":"string","description":"20-byte withdrawal address derived from credentials when prefix is 0x01 or 0x02; NULL otherwise."},"withdrawal_credentials":{"type":"string","description":"Lowercased withdrawal credentials."},"validator_index":{"type":"integer","description":"Beacon-chain validator index."},"latest_date":{"type":"string","format":"date-time","description":"Date of the validator's most recent income row (max date in int_consensus_validators_income_daily)."},"balance_gno":{"type":"number","description":"Validator balance at the latest date, in GNO."},"consensus_income_amount_30d_gno":{"type":"number","description":"Sum of consensus income over the trailing 30 days for the validator, in GNO."},"proposer_reward_total_30d_gno":{"type":"number","description":"Sum of proposer rewards over the trailing 30 days for the validator, in GNO."},"proposed_blocks_count_lifetime":{"type":"integer","description":"Total number of blocks proposed by the validator over its lifetime."},"total_income_estimated_gno":{"type":"number","description":"Lifetime estimated consensus income for the validator, in GNO."},"as_of_date":{"type":"string","format":"date","description":"Date the snapshot is computed as of (max date in the underlying data)."}}}},"pagination":{"type":"object","required":["limit","offset","returned","has_more"],"properties":{"limit":{"type":"integer","minimum":1},"offset":{"type":"integer","minimum":0},"returned":{"type":"integer","minimum":0},"has_more":{"type":"boolean"}}}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/consensus/validators_performance/daily":{"get":{"tags":["Consensus"],"summary":"Validators Performance (daily)","description":"**Required Access:** `tier1`\n\nPublic 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.\n\n**Declared Filters:**\n- **validator_index**: IN on `validator_index` (Validator index / indices)\n- **pubkey**: IN on `pubkey` (Validator public key(s))\n- **withdrawal_credentials**: IN on `withdrawal_credentials` (Withdrawal credential value(s))\n- **withdrawal_address**: IN on `withdrawal_address` (20-byte withdrawal address(es) (derived from 0x01/0x02 credentials))\n- **date_from**: >= on `date` (Inclusive lower bound on date)\n- **date_to**: <= on `date` (Inclusive upper bound on date)\n\n**Pagination:**\n- **limit**: default `100`, max `5000`\n- **offset**: default `0`\n\n**Sort:**\n- `date DESC`\n- `validator_index ASC`\n\n**User Sort:**\n- **sort_by**: one of `date`, `validator_index`, `balance_gno`, `consensus_income_amount_gno`, `apy`, `proposer_reward_total_gno`, `proposed_blocks_count`\n- **sort_direction**: `ASC` or `DESC` (defaults to `ASC` when `sort_by` is provided)\n\n**Columns:**\n- **date** (`DateTime64`): Day of the income fact (start-of-day UTC timestamp). Grain is one row per (date, validator_index).\n- **validator_index** (`UInt64`): Beacon-chain validator index.\n- **status** (`String`): Validator lifecycle status at end of day (from int_consensus_validators_snapshots_daily).\n- **pubkey** (`String`): Lowercased validator public key.\n- **withdrawal_credentials** (`String`): Lowercased withdrawal credentials.\n- **withdrawal_address** (`Nullable(String)`): 20-byte withdrawal address derived from credentials when prefix is 0x01 or 0x02; NULL otherwise.\n- **balance_gno** (`Float64`): End-of-day validator balance in GNO.\n- **balance_prev_gno** (`Float64`): Previous-day balance in GNO.\n- **effective_balance_gno** (`Float64`): End-of-day effective balance in GNO.\n- **deposits_amount_gno** (`Float64`): Raw reported deposit amount for the date, in GNO. Post-Pectra this is a request amount that the beacon chain may credit gradually via the pending-deposits queue (see int_consensus_validators_income_daily).\n- **deposits_count** (`UInt64`): Number of deposit events recorded for the validator on the date.\n- **withdrawals_amount_gno** (`Float64`): Total amount withdrawn from the validator on the date, in GNO.\n- **withdrawals_count** (`UInt64`): Number of withdrawal events for the validator on the date.\n- **consolidation_inflow_gno** (`Float64`): Consolidation amount received (target role) on the date, in GNO.\n- **consolidation_outflow_gno** (`Float64`): Consolidation amount transferred out (source role) on the date, in GNO.\n- **consensus_income_amount_gno** (`Float64`): Spec-bounded consensus income on the date, in GNO — balance delta minus effective deposit credits, plus withdrawals, net of consolidations (see int_consensus_validators_income_daily).\n- **daily_rate** (`Nullable(Float64)`): consensus_income_amount_gno / NULLIF(balance_prev_gno + effective_deposits_credited_gno + consolidation_inflow_gno, 0).\n- **apy** (`Float64`): Annualized percent yield computed from daily_rate.\n- **cumulative_deposits_gno** (`Float64`): Running sum of effective deposit credits for the validator, in GNO.\n- **cumulative_withdrawals_gno** (`Float64`): Running sum of withdrawal amounts for the validator, in GNO.\n- **cumulative_consolidation_inflow_gno** (`Float64`): Running sum of consolidation inflows for the validator, in GNO.\n- **cumulative_consolidation_outflow_gno** (`Float64`): Running sum of consolidation outflows for the validator, in GNO.\n- **total_income_estimated_gno** (`Float64`): Lifetime estimated consensus income in GNO — balance + cumulative withdrawals − effective cumulative deposits − cumulative consolidation inflow + cumulative consolidation outflow.\n- **proposed_blocks_count** (`UInt64`): Blocks proposed by the validator on the date (0 if none).\n- **proposer_reward_total_gno** (`Float64`): Total proposer reward earned on the date, in GNO (0 if none).\n- **proposer_reward_attestations_gno** (`Float64`): Proposer-reward component from included attestations, in real GNO (source gwei-of-mGNO / 1e9 / 32).\n- **proposer_reward_sync_aggregate_gno** (`Float64`): Proposer-reward component from sync-aggregate inclusion, in real GNO (source gwei-of-mGNO / 1e9 / 32).\n- **proposer_reward_proposer_slashings_gno** (`Float64`): Proposer-reward component from included proposer slashings, in real GNO (source gwei-of-mGNO / 1e9 / 32).\n- **proposer_reward_attester_slashings_gno** (`Float64`): Proposer-reward component from included attester slashings, in real GNO (source gwei-of-mGNO / 1e9 / 32).","operationId":"api_consensus_validators_performance_daily_get_v1_consensus_validators_performance_daily_get","security":[{"APIKeyHeader":[]}],"responses":{"200":{"description":"Paginated response","content":{"application/json":{"schema":{"type":"object","required":["items","pagination"],"properties":{"items":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"date":{"type":"string","format":"date-time","description":"Day of the income fact (start-of-day UTC timestamp). Grain is one row per (date, validator_index)."},"validator_index":{"type":"integer","description":"Beacon-chain validator index."},"status":{"type":"string","description":"Validator lifecycle status at end of day (from int_consensus_validators_snapshots_daily)."},"pubkey":{"type":"string","description":"Lowercased validator public key."},"withdrawal_credentials":{"type":"string","description":"Lowercased withdrawal credentials."},"withdrawal_address":{"type":"string","description":"20-byte withdrawal address derived from credentials when prefix is 0x01 or 0x02; NULL otherwise."},"balance_gno":{"type":"number","description":"End-of-day validator balance in GNO."},"balance_prev_gno":{"type":"number","description":"Previous-day balance in GNO."},"effective_balance_gno":{"type":"number","description":"End-of-day effective balance in GNO."},"deposits_amount_gno":{"type":"number","description":"Raw reported deposit amount for the date, in GNO. Post-Pectra this is a request amount that the beacon chain may credit gradually via the pending-deposits queue (see int_consensus_validators_income_daily)."},"deposits_count":{"type":"integer","description":"Number of deposit events recorded for the validator on the date."},"withdrawals_amount_gno":{"type":"number","description":"Total amount withdrawn from the validator on the date, in GNO."},"withdrawals_count":{"type":"integer","description":"Number of withdrawal events for the validator on the date."},"consolidation_inflow_gno":{"type":"number","description":"Consolidation amount received (target role) on the date, in GNO."},"consolidation_outflow_gno":{"type":"number","description":"Consolidation amount transferred out (source role) on the date, in GNO."},"consensus_income_amount_gno":{"type":"number","description":"Spec-bounded consensus income on the date, in GNO — balance delta minus effective deposit credits, plus withdrawals, net of consolidations (see int_consensus_validators_income_daily)."},"daily_rate":{"type":"number","description":"consensus_income_amount_gno / NULLIF(balance_prev_gno + effective_deposits_credited_gno + consolidation_inflow_gno, 0)."},"apy":{"type":"number","description":"Annualized percent yield computed from daily_rate."},"cumulative_deposits_gno":{"type":"number","description":"Running sum of effective deposit credits for the validator, in GNO."},"cumulative_withdrawals_gno":{"type":"number","description":"Running sum of withdrawal amounts for the validator, in GNO."},"cumulative_consolidation_inflow_gno":{"type":"number","description":"Running sum of consolidation inflows for the validator, in GNO."},"cumulative_consolidation_outflow_gno":{"type":"number","description":"Running sum of consolidation outflows for the validator, in GNO."},"total_income_estimated_gno":{"type":"number","description":"Lifetime estimated consensus income in GNO — balance + cumulative withdrawals − effective cumulative deposits − cumulative consolidation inflow + cumulative consolidation outflow."},"proposed_blocks_count":{"type":"integer","description":"Blocks proposed by the validator on the date (0 if none)."},"proposer_reward_total_gno":{"type":"number","description":"Total proposer reward earned on the date, in GNO (0 if none)."},"proposer_reward_attestations_gno":{"type":"number","description":"Proposer-reward component from included attestations, in real GNO (source gwei-of-mGNO / 1e9 / 32)."},"proposer_reward_sync_aggregate_gno":{"type":"number","description":"Proposer-reward component from sync-aggregate inclusion, in real GNO (source gwei-of-mGNO / 1e9 / 32)."},"proposer_reward_proposer_slashings_gno":{"type":"number","description":"Proposer-reward component from included proposer slashings, in real GNO (source gwei-of-mGNO / 1e9 / 32)."},"proposer_reward_attester_slashings_gno":{"type":"number","description":"Proposer-reward component from included attester slashings, in real GNO (source gwei-of-mGNO / 1e9 / 32)."}}}},"pagination":{"type":"object","required":["limit","offset","returned","has_more"],"properties":{"limit":{"type":"integer","minimum":1},"offset":{"type":"integer","minimum":0},"returned":{"type":"integer","minimum":0},"has_more":{"type":"boolean"}}}}}}}}},"parameters":[{"name":"validator_index","in":"query","required":false,"description":"Validator index / indices. Accepts repeated query params or CSV.","style":"form","explode":true,"schema":{"type":"array","items":{"type":"string"},"maxItems":200}},{"name":"pubkey","in":"query","required":false,"description":"Validator public key(s). Accepts repeated query params or CSV.","style":"form","explode":true,"schema":{"type":"array","items":{"type":"string"},"maxItems":200}},{"name":"withdrawal_credentials","in":"query","required":false,"description":"Withdrawal credential value(s). Accepts repeated query params or CSV.","style":"form","explode":true,"schema":{"type":"array","items":{"type":"string"},"maxItems":200}},{"name":"withdrawal_address","in":"query","required":false,"description":"20-byte withdrawal address(es) (derived from 0x01/0x02 credentials). Accepts repeated query params or CSV.","style":"form","explode":true,"schema":{"type":"array","items":{"type":"string"},"maxItems":200}},{"name":"date_from","in":"query","required":false,"description":"Inclusive lower bound on date","schema":{"type":"string","format":"date"}},{"name":"date_to","in":"query","required":false,"description":"Inclusive upper bound on date","schema":{"type":"string","format":"date"}},{"name":"limit","in":"query","required":false,"description":"Row limit","schema":{"type":"integer","minimum":1,"maximum":5000,"default":100}},{"name":"offset","in":"query","required":false,"description":"Row offset","schema":{"type":"integer","minimum":0,"default":0}},{"name":"sort_by","in":"query","required":false,"description":"Sort column","schema":{"type":"string","enum":["date","validator_index","balance_gno","consensus_income_amount_gno","apy","proposer_reward_total_gno","proposed_blocks_count"]}},{"name":"sort_direction","in":"query","required":false,"description":"Sort direction. Defaults to ASC when sort_by is provided.","schema":{"type":"string","enum":["ASC","DESC"],"default":"ASC"}}]},"post":{"tags":["Consensus"],"summary":"Validators Performance (daily) (POST)","description":"**Required Access:** `tier1`\n\nPublic 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.\n\n**Declared Filters:**\n- **validator_index**: IN on `validator_index` (Validator index / indices)\n- **pubkey**: IN on `pubkey` (Validator public key(s))\n- **withdrawal_credentials**: IN on `withdrawal_credentials` (Withdrawal credential value(s))\n- **withdrawal_address**: IN on `withdrawal_address` (20-byte withdrawal address(es) (derived from 0x01/0x02 credentials))\n- **date_from**: >= on `date` (Inclusive lower bound on date)\n- **date_to**: <= on `date` (Inclusive upper bound on date)\n\n**Pagination:**\n- **limit**: default `100`, max `5000`\n- **offset**: default `0`\n\n**Sort:**\n- `date DESC`\n- `validator_index ASC`\n\n**User Sort:**\n- **sort_by**: one of `date`, `validator_index`, `balance_gno`, `consensus_income_amount_gno`, `apy`, `proposer_reward_total_gno`, `proposed_blocks_count`\n- **sort_direction**: `ASC` or `DESC` (defaults to `ASC` when `sort_by` is provided)\n\n**Columns:**\n- **date** (`DateTime64`): Day of the income fact (start-of-day UTC timestamp). Grain is one row per (date, validator_index).\n- **validator_index** (`UInt64`): Beacon-chain validator index.\n- **status** (`String`): Validator lifecycle status at end of day (from int_consensus_validators_snapshots_daily).\n- **pubkey** (`String`): Lowercased validator public key.\n- **withdrawal_credentials** (`String`): Lowercased withdrawal credentials.\n- **withdrawal_address** (`Nullable(String)`): 20-byte withdrawal address derived from credentials when prefix is 0x01 or 0x02; NULL otherwise.\n- **balance_gno** (`Float64`): End-of-day validator balance in GNO.\n- **balance_prev_gno** (`Float64`): Previous-day balance in GNO.\n- **effective_balance_gno** (`Float64`): End-of-day effective balance in GNO.\n- **deposits_amount_gno** (`Float64`): Raw reported deposit amount for the date, in GNO. Post-Pectra this is a request amount that the beacon chain may credit gradually via the pending-deposits queue (see int_consensus_validators_income_daily).\n- **deposits_count** (`UInt64`): Number of deposit events recorded for the validator on the date.\n- **withdrawals_amount_gno** (`Float64`): Total amount withdrawn from the validator on the date, in GNO.\n- **withdrawals_count** (`UInt64`): Number of withdrawal events for the validator on the date.\n- **consolidation_inflow_gno** (`Float64`): Consolidation amount received (target role) on the date, in GNO.\n- **consolidation_outflow_gno** (`Float64`): Consolidation amount transferred out (source role) on the date, in GNO.\n- **consensus_income_amount_gno** (`Float64`): Spec-bounded consensus income on the date, in GNO — balance delta minus effective deposit credits, plus withdrawals, net of consolidations (see int_consensus_validators_income_daily).\n- **daily_rate** (`Nullable(Float64)`): consensus_income_amount_gno / NULLIF(balance_prev_gno + effective_deposits_credited_gno + consolidation_inflow_gno, 0).\n- **apy** (`Float64`): Annualized percent yield computed from daily_rate.\n- **cumulative_deposits_gno** (`Float64`): Running sum of effective deposit credits for the validator, in GNO.\n- **cumulative_withdrawals_gno** (`Float64`): Running sum of withdrawal amounts for the validator, in GNO.\n- **cumulative_consolidation_inflow_gno** (`Float64`): Running sum of consolidation inflows for the validator, in GNO.\n- **cumulative_consolidation_outflow_gno** (`Float64`): Running sum of consolidation outflows for the validator, in GNO.\n- **total_income_estimated_gno** (`Float64`): Lifetime estimated consensus income in GNO — balance + cumulative withdrawals − effective cumulative deposits − cumulative consolidation inflow + cumulative consolidation outflow.\n- **proposed_blocks_count** (`UInt64`): Blocks proposed by the validator on the date (0 if none).\n- **proposer_reward_total_gno** (`Float64`): Total proposer reward earned on the date, in GNO (0 if none).\n- **proposer_reward_attestations_gno** (`Float64`): Proposer-reward component from included attestations, in real GNO (source gwei-of-mGNO / 1e9 / 32).\n- **proposer_reward_sync_aggregate_gno** (`Float64`): Proposer-reward component from sync-aggregate inclusion, in real GNO (source gwei-of-mGNO / 1e9 / 32).\n- **proposer_reward_proposer_slashings_gno** (`Float64`): Proposer-reward component from included proposer slashings, in real GNO (source gwei-of-mGNO / 1e9 / 32).\n- **proposer_reward_attester_slashings_gno** (`Float64`): Proposer-reward component from included attester slashings, in real GNO (source gwei-of-mGNO / 1e9 / 32).","operationId":"api_consensus_validators_performance_daily_post_v1_consensus_validators_performance_daily_post","security":[{"APIKeyHeader":[]}],"requestBody":{"content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/api_consensus_validators_performance_daily_PostBody"},{"type":"null"}],"title":" Body"}}}},"responses":{"200":{"description":"Paginated response","content":{"application/json":{"schema":{"type":"object","required":["items","pagination"],"properties":{"items":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"date":{"type":"string","format":"date-time","description":"Day of the income fact (start-of-day UTC timestamp). Grain is one row per (date, validator_index)."},"validator_index":{"type":"integer","description":"Beacon-chain validator index."},"status":{"type":"string","description":"Validator lifecycle status at end of day (from int_consensus_validators_snapshots_daily)."},"pubkey":{"type":"string","description":"Lowercased validator public key."},"withdrawal_credentials":{"type":"string","description":"Lowercased withdrawal credentials."},"withdrawal_address":{"type":"string","description":"20-byte withdrawal address derived from credentials when prefix is 0x01 or 0x02; NULL otherwise."},"balance_gno":{"type":"number","description":"End-of-day validator balance in GNO."},"balance_prev_gno":{"type":"number","description":"Previous-day balance in GNO."},"effective_balance_gno":{"type":"number","description":"End-of-day effective balance in GNO."},"deposits_amount_gno":{"type":"number","description":"Raw reported deposit amount for the date, in GNO. Post-Pectra this is a request amount that the beacon chain may credit gradually via the pending-deposits queue (see int_consensus_validators_income_daily)."},"deposits_count":{"type":"integer","description":"Number of deposit events recorded for the validator on the date."},"withdrawals_amount_gno":{"type":"number","description":"Total amount withdrawn from the validator on the date, in GNO."},"withdrawals_count":{"type":"integer","description":"Number of withdrawal events for the validator on the date."},"consolidation_inflow_gno":{"type":"number","description":"Consolidation amount received (target role) on the date, in GNO."},"consolidation_outflow_gno":{"type":"number","description":"Consolidation amount transferred out (source role) on the date, in GNO."},"consensus_income_amount_gno":{"type":"number","description":"Spec-bounded consensus income on the date, in GNO — balance delta minus effective deposit credits, plus withdrawals, net of consolidations (see int_consensus_validators_income_daily)."},"daily_rate":{"type":"number","description":"consensus_income_amount_gno / NULLIF(balance_prev_gno + effective_deposits_credited_gno + consolidation_inflow_gno, 0)."},"apy":{"type":"number","description":"Annualized percent yield computed from daily_rate."},"cumulative_deposits_gno":{"type":"number","description":"Running sum of effective deposit credits for the validator, in GNO."},"cumulative_withdrawals_gno":{"type":"number","description":"Running sum of withdrawal amounts for the validator, in GNO."},"cumulative_consolidation_inflow_gno":{"type":"number","description":"Running sum of consolidation inflows for the validator, in GNO."},"cumulative_consolidation_outflow_gno":{"type":"number","description":"Running sum of consolidation outflows for the validator, in GNO."},"total_income_estimated_gno":{"type":"number","description":"Lifetime estimated consensus income in GNO — balance + cumulative withdrawals − effective cumulative deposits − cumulative consolidation inflow + cumulative consolidation outflow."},"proposed_blocks_count":{"type":"integer","description":"Blocks proposed by the validator on the date (0 if none)."},"proposer_reward_total_gno":{"type":"number","description":"Total proposer reward earned on the date, in GNO (0 if none)."},"proposer_reward_attestations_gno":{"type":"number","description":"Proposer-reward component from included attestations, in real GNO (source gwei-of-mGNO / 1e9 / 32)."},"proposer_reward_sync_aggregate_gno":{"type":"number","description":"Proposer-reward component from sync-aggregate inclusion, in real GNO (source gwei-of-mGNO / 1e9 / 32)."},"proposer_reward_proposer_slashings_gno":{"type":"number","description":"Proposer-reward component from included proposer slashings, in real GNO (source gwei-of-mGNO / 1e9 / 32)."},"proposer_reward_attester_slashings_gno":{"type":"number","description":"Proposer-reward component from included attester slashings, in real GNO (source gwei-of-mGNO / 1e9 / 32)."}}}},"pagination":{"type":"object","required":["limit","offset","returned","has_more"],"properties":{"limit":{"type":"integer","minimum":1},"offset":{"type":"integer","minimum":0},"returned":{"type":"integer","minimum":0},"has_more":{"type":"boolean"}}}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/consensus/validators_search/latest":{"get":{"tags":["Consensus"],"summary":"Validators Search (latest)","description":"**Required Access:** `tier1`\n\nDropdown source for the Validator Explorer tab. Grain is one row per\nWITHDRAWAL_CREDENTIALS (not per validator) — on Gnosis today this is ~3,400 rows\nvs 558k at validator-grain, so the dashboard can load the full list in a single\nrequest (a few hundred KB on the wire) without 30s timeouts.\n\nCollapsing to credential-grain matches the Explorer tab's semantics: every chart\non that tab aggregates across all validators sharing the selected\nwithdrawal_credentials. A solo validator is just a \"credential with\nvalidator_count = 1\"; an operator is \"credential with validator_count = N\".\n\ndisplay_name is shaped as\n    '<prefix-4>…<address-tail-10> · N validator(s) (v#<first-index>)'\nusing the tail of the credential (the actual execution address) so operators with\nthe same 0x01 type-byte prefix remain visually distinguishable.\n\nLabelSelector filters client-side on substring match against every column the API\nreturns, so pasting a withdrawal_credentials string from a block explorer or wallet\nfinds the exact row. Pasting a validator_index or pubkey not in this column won't\nmatch here — those lookups need /api/validators_performance_latest, which stays at\nper-validator grain.\n\n\n**Pagination:**\n- **limit**: default `5000`, max `10000`\n- **offset**: default `0`\n\n**Sort:**\n- `validator_count DESC`\n\n**User Sort:**\n- **sort_by**: one of `validator_count`, `withdrawal_credentials`, `display_name`\n- **sort_direction**: `ASC` or `DESC` (defaults to `ASC` when `sort_by` is provided)\n\n**Columns:**\n- **withdrawal_credentials** (`String`): Lowercased withdrawal credentials — the per-row grouping key (one row per credential).\n- **first_validator_index** (`UInt32`): Lowest validator_index (min) among all validators sharing this withdrawal_credentials; seeds the display_name and serves as a stable per-credential identifier.\n- **validator_count** (`UInt64`): Number of validators sharing this withdrawal_credentials (COUNT(*)); 1 for a solo validator, N for an operator.\n- **withdrawal_address** (`Nullable(String)`): 20-byte execution withdrawal address for the credential (any() representative); NULL for 0x00 BLS credentials.\n- **display_name** (`String`): '<prefix-4>…<address-tail-10> · N validator(s) (v#<first-index>)' — the credential tail keeps same-prefix operators distinguishable; used by LabelSelector for client-side substring search.\n- **as_of_date** (`Date`): Date the snapshot is computed as of (max date in the underlying data).","operationId":"api_consensus_validators_search_get_v1_consensus_validators_search_latest_get","security":[{"APIKeyHeader":[]}],"responses":{"200":{"description":"Paginated response","content":{"application/json":{"schema":{"type":"object","required":["items","pagination"],"properties":{"items":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"withdrawal_credentials":{"type":"string","description":"Lowercased withdrawal credentials — the per-row grouping key (one row per credential)."},"first_validator_index":{"type":"integer","description":"Lowest validator_index (min) among all validators sharing this withdrawal_credentials; seeds the display_name and serves as a stable per-credential identifier."},"validator_count":{"type":"integer","description":"Number of validators sharing this withdrawal_credentials (COUNT(*)); 1 for a solo validator, N for an operator."},"withdrawal_address":{"type":"string","description":"20-byte execution withdrawal address for the credential (any() representative); NULL for 0x00 BLS credentials."},"display_name":{"type":"string","description":"'<prefix-4>…<address-tail-10> · N validator(s) (v#<first-index>)' — the credential tail keeps same-prefix operators distinguishable; used by LabelSelector for client-side substring search."},"as_of_date":{"type":"string","format":"date","description":"Date the snapshot is computed as of (max date in the underlying data)."}}}},"pagination":{"type":"object","required":["limit","offset","returned","has_more"],"properties":{"limit":{"type":"integer","minimum":1},"offset":{"type":"integer","minimum":0},"returned":{"type":"integer","minimum":0},"has_more":{"type":"boolean"}}}}}}}}},"parameters":[{"name":"limit","in":"query","required":false,"description":"Row limit","schema":{"type":"integer","minimum":1,"maximum":10000,"default":5000}},{"name":"offset","in":"query","required":false,"description":"Row offset","schema":{"type":"integer","minimum":0,"default":0}},{"name":"sort_by","in":"query","required":false,"description":"Sort column","schema":{"type":"string","enum":["validator_count","withdrawal_credentials","display_name"]}},{"name":"sort_direction","in":"query","required":false,"description":"Sort direction. Defaults to ASC when sort_by is provided.","schema":{"type":"string","enum":["ASC","DESC"],"default":"ASC"}}]},"post":{"tags":["Consensus"],"summary":"Validators Search (latest) (POST)","description":"**Required Access:** `tier1`\n\nDropdown source for the Validator Explorer tab. Grain is one row per\nWITHDRAWAL_CREDENTIALS (not per validator) — on Gnosis today this is ~3,400 rows\nvs 558k at validator-grain, so the dashboard can load the full list in a single\nrequest (a few hundred KB on the wire) without 30s timeouts.\n\nCollapsing to credential-grain matches the Explorer tab's semantics: every chart\non that tab aggregates across all validators sharing the selected\nwithdrawal_credentials. A solo validator is just a \"credential with\nvalidator_count = 1\"; an operator is \"credential with validator_count = N\".\n\ndisplay_name is shaped as\n    '<prefix-4>…<address-tail-10> · N validator(s) (v#<first-index>)'\nusing the tail of the credential (the actual execution address) so operators with\nthe same 0x01 type-byte prefix remain visually distinguishable.\n\nLabelSelector filters client-side on substring match against every column the API\nreturns, so pasting a withdrawal_credentials string from a block explorer or wallet\nfinds the exact row. Pasting a validator_index or pubkey not in this column won't\nmatch here — those lookups need /api/validators_performance_latest, which stays at\nper-validator grain.\n\n\n**Pagination:**\n- **limit**: default `5000`, max `10000`\n- **offset**: default `0`\n\n**Sort:**\n- `validator_count DESC`\n\n**User Sort:**\n- **sort_by**: one of `validator_count`, `withdrawal_credentials`, `display_name`\n- **sort_direction**: `ASC` or `DESC` (defaults to `ASC` when `sort_by` is provided)\n\n**Columns:**\n- **withdrawal_credentials** (`String`): Lowercased withdrawal credentials — the per-row grouping key (one row per credential).\n- **first_validator_index** (`UInt32`): Lowest validator_index (min) among all validators sharing this withdrawal_credentials; seeds the display_name and serves as a stable per-credential identifier.\n- **validator_count** (`UInt64`): Number of validators sharing this withdrawal_credentials (COUNT(*)); 1 for a solo validator, N for an operator.\n- **withdrawal_address** (`Nullable(String)`): 20-byte execution withdrawal address for the credential (any() representative); NULL for 0x00 BLS credentials.\n- **display_name** (`String`): '<prefix-4>…<address-tail-10> · N validator(s) (v#<first-index>)' — the credential tail keeps same-prefix operators distinguishable; used by LabelSelector for client-side substring search.\n- **as_of_date** (`Date`): Date the snapshot is computed as of (max date in the underlying data).","operationId":"api_consensus_validators_search_post_v1_consensus_validators_search_latest_post","security":[{"APIKeyHeader":[]}],"requestBody":{"content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/api_consensus_validators_search_PostBody"},{"type":"null"}],"title":" Body"}}}},"responses":{"200":{"description":"Paginated response","content":{"application/json":{"schema":{"type":"object","required":["items","pagination"],"properties":{"items":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"withdrawal_credentials":{"type":"string","description":"Lowercased withdrawal credentials — the per-row grouping key (one row per credential)."},"first_validator_index":{"type":"integer","description":"Lowest validator_index (min) among all validators sharing this withdrawal_credentials; seeds the display_name and serves as a stable per-credential identifier."},"validator_count":{"type":"integer","description":"Number of validators sharing this withdrawal_credentials (COUNT(*)); 1 for a solo validator, N for an operator."},"withdrawal_address":{"type":"string","description":"20-byte execution withdrawal address for the credential (any() representative); NULL for 0x00 BLS credentials."},"display_name":{"type":"string","description":"'<prefix-4>…<address-tail-10> · N validator(s) (v#<first-index>)' — the credential tail keeps same-prefix operators distinguishable; used by LabelSelector for client-side substring search."},"as_of_date":{"type":"string","format":"date","description":"Date the snapshot is computed as of (max date in the underlying data)."}}}},"pagination":{"type":"object","required":["limit","offset","returned","has_more"],"properties":{"limit":{"type":"integer","minimum":1},"offset":{"type":"integer","minimum":0},"returned":{"type":"integer","minimum":0},"has_more":{"type":"boolean"}}}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/consensus/validators_status/latest":{"get":{"tags":["Consensus"],"summary":"Validators Status (latest)","description":"**Required Access:** `tier1`\n\nThe api_consensus_validators_status_latest model provides the latest validator-level consensus status snapshot and supports filtered lookup by withdrawal credentials or validator pubkey.\n\n**Declared Filters:**\n- **withdrawal_credentials**: IN on `withdrawal_credentials` (Withdrawal credential value(s))\n- **pubkey**: IN on `pubkey` (Validator public key(s))\n- **validator_index**: IN on `validator_index` (Validator index / indices)\n- **withdrawal_address**: IN on `withdrawal_address` (20-byte withdrawal address(es) (derived from 0x01/0x02 credentials))\n\n**Pagination:**\n- **limit**: default `100`, max `5000`\n- **offset**: default `0`\n\n**Sort:**\n- `validator_index ASC`\n\n**User Sort:**\n- **sort_by**: one of `validator_index`, `balance`, `effective_balance`, `status`, `activation_epoch`, `exit_epoch`, `withdrawable_epoch`\n- **sort_direction**: `ASC` or `DESC` (defaults to `ASC` when `sort_by` is provided)\n\n**Columns:**\n- **slot** (`UInt64`): The most recent consensus slot included in the validator snapshot.\n- **validator_index** (`UInt32`): Unique numerical identifier assigned to each validator.\n- **balance** (`UInt64`): The current validator balance in Gwei at the latest slot.\n- **status** (`String`): The current validator lifecycle status at the latest slot.\n- **pubkey** (`String`): Lowercased validator public key for exact-match API filtering.\n- **withdrawal_credentials** (`String`): Lowercased withdrawal credentials for exact-match API filtering.\n- **withdrawal_address** (`Nullable(String)`): 20-byte withdrawal address derived from credentials when prefix is 0x01 or 0x02; NULL for 0x00 BLS credentials.\n- **effective_balance** (`UInt64`): The effective validator balance used for consensus calculations.\n- **slashed** (`UInt8`): Indicator showing whether the validator has been slashed.\n- **activation_eligibility_epoch** (`UInt64`): Epoch when the validator became eligible for activation.\n- **activation_epoch** (`UInt64`): Epoch when the validator entered the active validator set.\n- **exit_epoch** (`UInt64`): Epoch when the validator exited the active validator set.\n- **withdrawable_epoch** (`UInt64`): Epoch when the validator balance becomes withdrawable.\n- **slot_timestamp** (`DateTime64`): Timestamp corresponding to the latest consensus slot in the snapshot.\n- **as_of_date** (`Date`): Date the snapshot is computed as of (max date in the underlying data).","operationId":"api_consensus_validators_status_latest_get_v1_consensus_validators_status_latest_get","security":[{"APIKeyHeader":[]}],"responses":{"200":{"description":"Paginated response","content":{"application/json":{"schema":{"type":"object","required":["items","pagination"],"properties":{"items":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"slot":{"type":"integer","description":"The most recent consensus slot included in the validator snapshot."},"validator_index":{"type":"integer","description":"Unique numerical identifier assigned to each validator."},"balance":{"type":"integer","description":"The current validator balance in Gwei at the latest slot."},"status":{"type":"string","description":"The current validator lifecycle status at the latest slot."},"pubkey":{"type":"string","description":"Lowercased validator public key for exact-match API filtering."},"withdrawal_credentials":{"type":"string","description":"Lowercased withdrawal credentials for exact-match API filtering."},"withdrawal_address":{"type":"string","description":"20-byte withdrawal address derived from credentials when prefix is 0x01 or 0x02; NULL for 0x00 BLS credentials."},"effective_balance":{"type":"integer","description":"The effective validator balance used for consensus calculations."},"slashed":{"type":"integer","description":"Indicator showing whether the validator has been slashed."},"activation_eligibility_epoch":{"type":"integer","description":"Epoch when the validator became eligible for activation."},"activation_epoch":{"type":"integer","description":"Epoch when the validator entered the active validator set."},"exit_epoch":{"type":"integer","description":"Epoch when the validator exited the active validator set."},"withdrawable_epoch":{"type":"integer","description":"Epoch when the validator balance becomes withdrawable."},"slot_timestamp":{"type":"string","format":"date-time","description":"Timestamp corresponding to the latest consensus slot in the snapshot."},"as_of_date":{"type":"string","format":"date","description":"Date the snapshot is computed as of (max date in the underlying data)."}}}},"pagination":{"type":"object","required":["limit","offset","returned","has_more"],"properties":{"limit":{"type":"integer","minimum":1},"offset":{"type":"integer","minimum":0},"returned":{"type":"integer","minimum":0},"has_more":{"type":"boolean"}}}}}}}}},"parameters":[{"name":"withdrawal_credentials","in":"query","required":false,"description":"Withdrawal credential value(s). Accepts repeated query params or CSV.","style":"form","explode":true,"schema":{"type":"array","items":{"type":"string"},"maxItems":200}},{"name":"pubkey","in":"query","required":false,"description":"Validator public key(s). Accepts repeated query params or CSV.","style":"form","explode":true,"schema":{"type":"array","items":{"type":"string"},"maxItems":200}},{"name":"validator_index","in":"query","required":false,"description":"Validator index / indices. Accepts repeated query params or CSV.","style":"form","explode":true,"schema":{"type":"array","items":{"type":"string"},"maxItems":200}},{"name":"withdrawal_address","in":"query","required":false,"description":"20-byte withdrawal address(es) (derived from 0x01/0x02 credentials). Accepts repeated query params or CSV.","style":"form","explode":true,"schema":{"type":"array","items":{"type":"string"},"maxItems":200}},{"name":"limit","in":"query","required":false,"description":"Row limit","schema":{"type":"integer","minimum":1,"maximum":5000,"default":100}},{"name":"offset","in":"query","required":false,"description":"Row offset","schema":{"type":"integer","minimum":0,"default":0}},{"name":"sort_by","in":"query","required":false,"description":"Sort column","schema":{"type":"string","enum":["validator_index","balance","effective_balance","status","activation_epoch","exit_epoch","withdrawable_epoch"]}},{"name":"sort_direction","in":"query","required":false,"description":"Sort direction. Defaults to ASC when sort_by is provided.","schema":{"type":"string","enum":["ASC","DESC"],"default":"ASC"}}]},"post":{"tags":["Consensus"],"summary":"Validators Status (latest) (POST)","description":"**Required Access:** `tier1`\n\nThe api_consensus_validators_status_latest model provides the latest validator-level consensus status snapshot and supports filtered lookup by withdrawal credentials or validator pubkey.\n\n**Declared Filters:**\n- **withdrawal_credentials**: IN on `withdrawal_credentials` (Withdrawal credential value(s))\n- **pubkey**: IN on `pubkey` (Validator public key(s))\n- **validator_index**: IN on `validator_index` (Validator index / indices)\n- **withdrawal_address**: IN on `withdrawal_address` (20-byte withdrawal address(es) (derived from 0x01/0x02 credentials))\n\n**Pagination:**\n- **limit**: default `100`, max `5000`\n- **offset**: default `0`\n\n**Sort:**\n- `validator_index ASC`\n\n**User Sort:**\n- **sort_by**: one of `validator_index`, `balance`, `effective_balance`, `status`, `activation_epoch`, `exit_epoch`, `withdrawable_epoch`\n- **sort_direction**: `ASC` or `DESC` (defaults to `ASC` when `sort_by` is provided)\n\n**Columns:**\n- **slot** (`UInt64`): The most recent consensus slot included in the validator snapshot.\n- **validator_index** (`UInt32`): Unique numerical identifier assigned to each validator.\n- **balance** (`UInt64`): The current validator balance in Gwei at the latest slot.\n- **status** (`String`): The current validator lifecycle status at the latest slot.\n- **pubkey** (`String`): Lowercased validator public key for exact-match API filtering.\n- **withdrawal_credentials** (`String`): Lowercased withdrawal credentials for exact-match API filtering.\n- **withdrawal_address** (`Nullable(String)`): 20-byte withdrawal address derived from credentials when prefix is 0x01 or 0x02; NULL for 0x00 BLS credentials.\n- **effective_balance** (`UInt64`): The effective validator balance used for consensus calculations.\n- **slashed** (`UInt8`): Indicator showing whether the validator has been slashed.\n- **activation_eligibility_epoch** (`UInt64`): Epoch when the validator became eligible for activation.\n- **activation_epoch** (`UInt64`): Epoch when the validator entered the active validator set.\n- **exit_epoch** (`UInt64`): Epoch when the validator exited the active validator set.\n- **withdrawable_epoch** (`UInt64`): Epoch when the validator balance becomes withdrawable.\n- **slot_timestamp** (`DateTime64`): Timestamp corresponding to the latest consensus slot in the snapshot.\n- **as_of_date** (`Date`): Date the snapshot is computed as of (max date in the underlying data).","operationId":"api_consensus_validators_status_latest_post_v1_consensus_validators_status_latest_post","security":[{"APIKeyHeader":[]}],"requestBody":{"content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/api_consensus_validators_status_latest_PostBody"},{"type":"null"}],"title":" Body"}}}},"responses":{"200":{"description":"Paginated response","content":{"application/json":{"schema":{"type":"object","required":["items","pagination"],"properties":{"items":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"slot":{"type":"integer","description":"The most recent consensus slot included in the validator snapshot."},"validator_index":{"type":"integer","description":"Unique numerical identifier assigned to each validator."},"balance":{"type":"integer","description":"The current validator balance in Gwei at the latest slot."},"status":{"type":"string","description":"The current validator lifecycle status at the latest slot."},"pubkey":{"type":"string","description":"Lowercased validator public key for exact-match API filtering."},"withdrawal_credentials":{"type":"string","description":"Lowercased withdrawal credentials for exact-match API filtering."},"withdrawal_address":{"type":"string","description":"20-byte withdrawal address derived from credentials when prefix is 0x01 or 0x02; NULL for 0x00 BLS credentials."},"effective_balance":{"type":"integer","description":"The effective validator balance used for consensus calculations."},"slashed":{"type":"integer","description":"Indicator showing whether the validator has been slashed."},"activation_eligibility_epoch":{"type":"integer","description":"Epoch when the validator became eligible for activation."},"activation_epoch":{"type":"integer","description":"Epoch when the validator entered the active validator set."},"exit_epoch":{"type":"integer","description":"Epoch when the validator exited the active validator set."},"withdrawable_epoch":{"type":"integer","description":"Epoch when the validator balance becomes withdrawable."},"slot_timestamp":{"type":"string","format":"date-time","description":"Timestamp corresponding to the latest consensus slot in the snapshot."},"as_of_date":{"type":"string","format":"date","description":"Date the snapshot is computed as of (max date in the underlying data)."}}}},"pagination":{"type":"object","required":["limit","offset","returned","has_more"],"properties":{"limit":{"type":"integer","minimum":1},"offset":{"type":"integer","minimum":0},"returned":{"type":"integer","minimum":0},"has_more":{"type":"boolean"}}}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/consensus/validators_status/daily":{"get":{"tags":["Consensus"],"summary":"Validators Status (daily)","description":"**Required Access:** `tier1`\n\nThe 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.\n\n**Columns:**\n- **date** (`Date`): The specific calendar date for the recorded validator status counts.\n- **status** (`String`): The current state of validators, such as 'pending', 'slashed', or other status categories relevant to validator lifecycle.\n- **cnt** (`UInt64`): The number of validators in the given status on the specified date.","operationId":"api_consensus_validators_status_daily_get_v1_consensus_validators_status_daily_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"date":{"type":"string","format":"date","description":"The specific calendar date for the recorded validator status counts."},"status":{"type":"string","description":"The current state of validators, such as 'pending', 'slashed', or other status categories relevant to validator lifecycle."},"cnt":{"type":"integer","description":"The number of validators in the given status on the specified date."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/consensus/withdrawal_credentials_frequency/daily":{"get":{"tags":["Consensus"],"summary":"Withdrawal Credentials Frequency (daily)","description":"**Required Access:** `tier1`\n\nThis view aggregates daily counts of validators categorized by their withdrawal credentials frequency, supporting analysis of validator credential patterns over time.\n\n**Columns:**\n- **date** (`Date`): The specific calendar date for the recorded data, formatted as YYYY-MM-DD.\n- **label** (`String`): The bin number representing a specific withdrawal credentials frequency category.\n- **value** (`UInt64`): The count of validators within the specified withdrawal credentials frequency bin for the given date.","operationId":"api_consensus_withdrawal_credentials_freq_daily_get_v1_consensus_withdrawal_credentials_frequency_daily_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"date":{"type":"string","format":"date","description":"The specific calendar date for the recorded data, formatted as YYYY-MM-DD."},"label":{"type":"string","description":"The bin number representing a specific withdrawal credentials frequency category."},"value":{"type":"integer","description":"The count of validators within the specified withdrawal credentials frequency bin for the given date."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/consensus/withdrawls_cnt/latest":{"get":{"tags":["Consensus"],"summary":"Withdrawls Cnt (latest)","description":"**Required Access:** `tier0` (no API key required)\n\nThis view provides the latest count of withdrawal events from the consensus API, enabling monitoring of withdrawal activity trends over time.\n\n**Columns:**\n- **value** (`Float64`): The most recent total number of withdrawal events recorded, typically representing a count within a specific period.\n- **change_pct** (`Float64`): The percentage change in withdrawal count compared to the previous measurement, indicating growth or decline trends.\n- **as_of_date** (`Date`): Date the snapshot is computed as of (max date in the underlying data).","operationId":"api_consensus_info_withdrawls_cnt_latest_get_v1_consensus_withdrawls_cnt_latest_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"value":{"type":"number","description":"The most recent total number of withdrawal events recorded, typically representing a count within a specific period."},"change_pct":{"type":"number","description":"The percentage change in withdrawal count compared to the previous measurement, indicating growth or decline trends."},"as_of_date":{"type":"string","format":"date","description":"Date the snapshot is computed as of (max date in the underlying data)."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/crawlers_data/gno_supply/daily":{"get":{"tags":["Crawlers Data"],"summary":"Gno Supply (daily)","description":"**Required Access:** `tier1`\n\nThe api_crawlers_data_gno_supply_daily model aggregates daily GNO supply data from crawler sources to support trend analysis and reporting.\n\n**Columns:**\n- **label** (`String`): Identifier for the specific GNO supply data source or category.\n- **date** (`Date`): The date corresponding to the supply data, formatted as YYYY-MM-DD.\n- **supply** (`Float64`): The amount of GNO supply recorded on the given date, measured in units consistent with blockchain token quantities.","operationId":"api_crawlers_data_gno_supply_daily_get_v1_crawlers_data_gno_supply_daily_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"label":{"type":"string","description":"Identifier for the specific GNO supply data source or category."},"date":{"type":"string","format":"date","description":"The date corresponding to the supply data, formatted as YYYY-MM-DD."},"supply":{"type":"number","description":"The amount of GNO supply recorded on the given date, measured in units consistent with blockchain token quantities."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/esg/carbon_emissions/daily":{"get":{"tags":["Esg"],"summary":"Carbon Emissions (daily)","description":"**Required Access:** `tier1`\n\nThe `api_esg_carbon_emissions_daily` model provides daily aggregated estimates of carbon emissions, including moving averages and uncertainty bounds, to support ESG reporting and analysis.\n\n**Columns:**\n- **date** (`Date`): The specific calendar date for the recorded carbon emissions data.\n- **ma7_value** (`Float64`): 7-day moving average of the daily mean CO2 emissions in kilograms, providing a smoothed trend over the past week.\n- **ma7_lower_90** (`Float64`): 7-day moving average of the lower 90% confidence bound for daily CO2 emissions in kilograms, indicating the lower estimate of uncertainty.\n- **ma7_upper_90** (`Float64`): 7-day moving average of the upper 90% confidence bound for daily CO2 emissions in kilograms, indicating the upper estimate of uncertainty.\n- **ma7_lower_95** (`Float64`): 7-day moving average of the lower 95% confidence bound for daily CO2 emissions in kilograms, representing a more conservative lower estimate.\n- **ma7_upper_95** (`Float64`): 7-day moving average of the upper 95% confidence bound for daily CO2 emissions in kilograms, representing a more conservative upper estimate.","operationId":"api_esg_carbon_emissions_daily_get_v1_esg_carbon_emissions_daily_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"date":{"type":"string","format":"date","description":"The specific calendar date for the recorded carbon emissions data."},"ma7_value":{"type":"number","description":"7-day moving average of the daily mean CO2 emissions in kilograms, providing a smoothed trend over the past week."},"ma7_lower_90":{"type":"number","description":"7-day moving average of the lower 90% confidence bound for daily CO2 emissions in kilograms, indicating the lower estimate of uncertainty."},"ma7_upper_90":{"type":"number","description":"7-day moving average of the upper 90% confidence bound for daily CO2 emissions in kilograms, indicating the upper estimate of uncertainty."},"ma7_lower_95":{"type":"number","description":"7-day moving average of the lower 95% confidence bound for daily CO2 emissions in kilograms, representing a more conservative lower estimate."},"ma7_upper_95":{"type":"number","description":"7-day moving average of the upper 95% confidence bound for daily CO2 emissions in kilograms, representing a more conservative upper estimate."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/esg/carbon_emissions_annualised/latest":{"get":{"tags":["Esg"],"summary":"Carbon Emissions Annualised (latest)","description":"**Required Access:** `tier0` (no API key required)\n\nThis model provides the most recent annualized projection of CO2 emissions in tonnes, derived from ESG carbon footprint data, to support environmental impact assessments and reporting.\n\n**Columns:**\n- **annual_co2_tonnes_projected** (`Float64`): Estimated total CO2 emissions in tonnes for the latest available year, representing projected annualized emissions based on recent data.\n- **as_of_date** (`Date`): Date the snapshot is computed as of (max date in the underlying data).","operationId":"api_esg_carbon_emissions_annualised_latest_get_v1_esg_carbon_emissions_annualised_latest_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"annual_co2_tonnes_projected":{"type":"number","description":"Estimated total CO2 emissions in tonnes for the latest available year, representing projected annualized emissions based on recent data."},"as_of_date":{"type":"string","format":"date","description":"Date the snapshot is computed as of (max date in the underlying data)."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/esg/carbon_emissions_distribution/daily":{"get":{"tags":["Esg"],"summary":"Carbon Emissions Distribution (daily)","description":"**Required Access:** `tier1`\n\nThis view provides daily estimates and uncertainty bounds of carbon emissions (in kg CO2) with moving averages and month-to-date aggregations to support ESG reporting and analysis.\n\n**Columns:**\n- **date** (`Date`): The specific calendar date for the recorded carbon emission data.\n- **value** (`Float64`): The daily mean estimate of CO2 emissions in kilograms.\n- **lower_95** (`Float64`): The lower bound of the 95% confidence interval for daily CO2 emissions.\n- **upper_95** (`Float64`): The upper bound of the 95% confidence interval for daily CO2 emissions.\n- **lower_90** (`Float64`): The lower bound of the 90% confidence interval for daily CO2 emissions.\n- **upper_90** (`Float64`): The upper bound of the 90% confidence interval for daily CO2 emissions.\n- **ma7_value** (`Float64`): 7-day moving average of the daily mean CO2 emissions, smoothing short-term fluctuations.\n- **ma7_lower_95** (`Float64`): 7-day moving average of the lower 95% confidence bound.\n- **ma7_upper_95** (`Float64`): 7-day moving average of the upper 95% confidence bound.\n- **mtd_avg** (`DateTime64`): Month-to-date average of daily mean CO2 emissions up to the current date.\n- **mtd_total** (`DateTime64`): Cumulative total of daily mean CO2 emissions for the current month.","operationId":"api_esg_carbon_timeseries_bands_get_v1_esg_carbon_emissions_distribution_daily_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"date":{"type":"string","format":"date","description":"The specific calendar date for the recorded carbon emission data."},"value":{"type":"number","description":"The daily mean estimate of CO2 emissions in kilograms."},"lower_95":{"type":"number","description":"The lower bound of the 95% confidence interval for daily CO2 emissions."},"upper_95":{"type":"number","description":"The upper bound of the 95% confidence interval for daily CO2 emissions."},"lower_90":{"type":"number","description":"The lower bound of the 90% confidence interval for daily CO2 emissions."},"upper_90":{"type":"number","description":"The upper bound of the 90% confidence interval for daily CO2 emissions."},"ma7_value":{"type":"number","description":"7-day moving average of the daily mean CO2 emissions, smoothing short-term fluctuations."},"ma7_lower_95":{"type":"number","description":"7-day moving average of the lower 95% confidence bound."},"ma7_upper_95":{"type":"number","description":"7-day moving average of the upper 95% confidence bound."},"mtd_avg":{"type":"string","format":"date-time","description":"Month-to-date average of daily mean CO2 emissions up to the current date."},"mtd_total":{"type":"string","format":"date-time","description":"Cumulative total of daily mean CO2 emissions for the current month."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/esg/carbon_intensity_factors/daily":{"get":{"tags":["Esg"],"summary":"Carbon Intensity Factors (daily)","description":"**Required Access:** `tier1`\n\nThis view provides daily effective carbon intensity metrics for the network and selected countries, enabling comparison of carbon footprint performance over time.\n\n**Columns:**\n- **date** (`Date`): The specific date for the recorded carbon intensity data, formatted as YYYY-MM-DD.\n- **carbon_intensity** (`Float64`): The measured carbon intensity value in grams of CO2 equivalent per kWh, rounded to one decimal place.\n- **entity_code** (`String`): Identifier for the data source or country, such as 'GNOSIS' for the network or country codes like 'USA' and 'DEU'.","operationId":"api_esg_cif_network_vs_countries_daily_get_v1_esg_carbon_intensity_factors_daily_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"date":{"type":"string","format":"date","description":"The specific date for the recorded carbon intensity data, formatted as YYYY-MM-DD."},"carbon_intensity":{"type":"number","description":"The measured carbon intensity value in grams of CO2 equivalent per kWh, rounded to one decimal place."},"entity_code":{"type":"string","description":"Identifier for the data source or country, such as 'GNOSIS' for the network or country codes like 'USA' and 'DEU'."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/esg/energy_and_emissions_annual/daily":{"get":{"tags":["Esg"],"summary":"Energy And Emissions Annual (daily)","description":"**Required Access:** `tier1`\n\nThe api_esg_info_annual_daily model provides daily projections of energy consumption and CO2 emissions with associated uncertainty intervals, supporting ESG performance analysis at a daily granularity.\n\n**Columns:**\n- **date** (`Date`): The specific date for which the energy or emissions data is reported.\n- **label** (`String`): The type of metric, either 'Energy (MWh)' or 'CO2e (tonnes)', indicating the measurement category.\n- **mean_val** (`Float64`): The projected average value of energy consumption in MWh or CO2 emissions in tonnes for the given date.\n- **lower_95** (`Float64`): The lower bound of the 95% confidence interval for the projected value.\n- **upper_95** (`Float64`): The upper bound of the 95% confidence interval for the projected value.\n- **lower_90** (`Float64`): The lower bound of the 90% confidence interval for the projected value.\n- **upper_90** (`Float64`): The upper bound of the 90% confidence interval for the projected value.","operationId":"api_esg_info_annual_daily_get_v1_esg_energy_and_emissions_annual_daily_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"date":{"type":"string","format":"date","description":"The specific date for which the energy or emissions data is reported."},"label":{"type":"string","description":"The type of metric, either 'Energy (MWh)' or 'CO2e (tonnes)', indicating the measurement category."},"mean_val":{"type":"number","description":"The projected average value of energy consumption in MWh or CO2 emissions in tonnes for the given date."},"lower_95":{"type":"number","description":"The lower bound of the 95% confidence interval for the projected value."},"upper_95":{"type":"number","description":"The upper bound of the 95% confidence interval for the projected value."},"lower_90":{"type":"number","description":"The lower bound of the 90% confidence interval for the projected value."},"upper_90":{"type":"number","description":"The upper bound of the 90% confidence interval for the projected value."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/esg/energy_and_emissions_per_category/daily":{"get":{"tags":["Esg"],"summary":"Energy And Emissions Per Category (daily)","description":"**Required Access:** `tier1`\n\nThe api_esg_info_category_daily model aggregates daily ESG-related metrics, including carbon footprint, energy consumption, and node counts, categorized by stakeholder type for analytical insights.\n\n**Columns:**\n- **date** (`Date`): The date for which the ESG metrics are recorded, in date format.\n- **label** (`String`): The stakeholder group associated with the metrics, such as Home Staker, Professional Validator, Cloud Provider, or Unknown.\n- **category** (`String`): The type of metric, either 'CO2e (kg)', 'Energy (kWh)', or 'Nodes'.\n- **value** (`Float64`): The measured value of the metric, representing daily totals or counts.","operationId":"api_esg_info_category_daily_get_v1_esg_energy_and_emissions_per_category_daily_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"date":{"type":"string","format":"date","description":"The date for which the ESG metrics are recorded, in date format."},"label":{"type":"string","description":"The stakeholder group associated with the metrics, such as Home Staker, Professional Validator, Cloud Provider, or Unknown."},"category":{"type":"string","description":"The type of metric, either 'CO2e (kg)', 'Energy (kWh)', or 'Nodes'."},"value":{"type":"number","description":"The measured value of the metric, representing daily totals or counts."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/esg/energy_consumption/monthly":{"get":{"tags":["Esg"],"summary":"Energy Consumption (monthly)","description":"**Required Access:** `tier1`\n\nThe api_esg_energy_monthly model aggregates total energy consumption in kilowatt-hours (kWh) on a monthly basis, providing insights into energy usage trends for ESG reporting and analysis.\n\n**Columns:**\n- **date** (`DateTime64`): The first day of the month representing the aggregation period.\n- **value** (`UInt64`): The total energy consumption in kilowatt-hours (kWh) for the given month.","operationId":"api_esg_energy_monthly_get_v1_esg_energy_consumption_monthly_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"date":{"type":"string","format":"date-time","description":"The first day of the month representing the aggregation period."},"value":{"type":"integer","description":"The total energy consumption in kilowatt-hours (kWh) for the given month."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/esg/energy_consumption_annualised/latest":{"get":{"tags":["Esg"],"summary":"Energy Consumption Annualised (latest)","description":"**Required Access:** `tier0` (no API key required)\n\nThis dbt view provides the latest annualized energy consumption projection in MWh, supporting ESG and carbon footprint analysis for energy management.\n\n**Columns:**\n- **annual_energy_Mwh_projected** (`Float64`): The projected total energy consumption for the year, expressed in megawatt-hours (MWh).\n- **as_of_date** (`Date`): Date the snapshot is computed as of (max date in the underlying data).","operationId":"api_esg_energy_consumption_annualised_latest_get_v1_esg_energy_consumption_annualised_latest_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"annual_energy_Mwh_projected":{"type":"number","description":"The projected total energy consumption for the year, expressed in megawatt-hours (MWh)."},"as_of_date":{"type":"string","format":"date","description":"Date the snapshot is computed as of (max date in the underlying data)."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/esg/estimated_nodes/daily":{"get":{"tags":["Esg"],"summary":"Estimated Nodes (daily)","description":"**Required Access:** `tier1`\n\nThe api_esg_estimated_nodes_daily model provides daily estimates of observed and projected node counts related to ESG carbon footprint analysis, facilitating trend analysis and uncertainty quantification.\n\n**Columns:**\n- **date** (`Date`): The specific calendar date for the recorded data point.\n- **baseline_observed_nodes** (`Float64`): The observed number of nodes based on baseline measurements on the given date.\n- **estimated_nodes** (`UInt64`): The model's estimated total number of nodes for the given date.\n- **nodes_lower_95** (`UInt64`): The lower bound of the 95% confidence interval for the estimated node count.\n- **nodes_upper_95** (`UInt64`): The upper bound of the 95% confidence interval for the estimated node count.","operationId":"api_esg_estimated_nodes_daily_get_v1_esg_estimated_nodes_daily_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"date":{"type":"string","format":"date","description":"The specific calendar date for the recorded data point."},"baseline_observed_nodes":{"type":"number","description":"The observed number of nodes based on baseline measurements on the given date."},"estimated_nodes":{"type":"integer","description":"The model's estimated total number of nodes for the given date."},"nodes_lower_95":{"type":"integer","description":"The lower bound of the 95% confidence interval for the estimated node count."},"nodes_upper_95":{"type":"integer","description":"The upper bound of the 95% confidence interval for the estimated node count."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/account_balance_history/daily":{"get":{"tags":["Execution"],"summary":"Account Balance History (daily)","description":"**Required Access:** `tier1`\n\nSimple API view for Account Portfolio balance history.\n\n**Declared Filters:**\n- **address**: IN on `address`\n- **start_date**: >= on `date`\n- **end_date**: <= on `date`\n\n**Pagination:**\n- **limit**: default `1000`, max `5000`\n- **offset**: default `0`\n\n**Sort:**\n- `date ASC`\n\n**Columns:**\n- **address** (`Nullable(String)`)\n- **date** (`Date`)","operationId":"api_execution_account_balance_history_daily_get_v1_execution_account_balance_history_daily_get","security":[{"APIKeyHeader":[]}],"responses":{"200":{"description":"Paginated response","content":{"application/json":{"schema":{"type":"object","required":["items","pagination"],"properties":{"items":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"address":{"type":"string"},"date":{"type":"string","format":"date"}}}},"pagination":{"type":"object","required":["limit","offset","returned","has_more"],"properties":{"limit":{"type":"integer","minimum":1},"offset":{"type":"integer","minimum":0},"returned":{"type":"integer","minimum":0},"has_more":{"type":"boolean"}}}}}}}}},"parameters":[{"name":"address","in":"query","required":false,"description":"List filter. Accepts repeated query params or CSV.","style":"form","explode":true,"schema":{"type":"array","items":{"type":"string"},"maxItems":20}},{"name":"start_date","in":"query","required":false,"description":"","schema":{"type":"string","format":"date"}},{"name":"end_date","in":"query","required":false,"description":"","schema":{"type":"string","format":"date"}},{"name":"limit","in":"query","required":false,"description":"Row limit","schema":{"type":"integer","minimum":1,"maximum":5000,"default":1000}},{"name":"offset","in":"query","required":false,"description":"Row offset","schema":{"type":"integer","minimum":0,"default":0}}]},"post":{"tags":["Execution"],"summary":"Account Balance History (daily) (POST)","description":"**Required Access:** `tier1`\n\nSimple API view for Account Portfolio balance history.\n\n**Declared Filters:**\n- **address**: IN on `address`\n- **start_date**: >= on `date`\n- **end_date**: <= on `date`\n\n**Pagination:**\n- **limit**: default `1000`, max `5000`\n- **offset**: default `0`\n\n**Sort:**\n- `date ASC`\n\n**Columns:**\n- **address** (`Nullable(String)`)\n- **date** (`Date`)","operationId":"api_execution_account_balance_history_daily_post_v1_execution_account_balance_history_daily_post","security":[{"APIKeyHeader":[]}],"requestBody":{"content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/api_execution_account_balance_history_daily_PostBody"},{"type":"null"}],"title":" Body"}}}},"responses":{"200":{"description":"Paginated response","content":{"application/json":{"schema":{"type":"object","required":["items","pagination"],"properties":{"items":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"address":{"type":"string"},"date":{"type":"string","format":"date"}}}},"pagination":{"type":"object","required":["limit","offset","returned","has_more"],"properties":{"limit":{"type":"integer","minimum":1},"offset":{"type":"integer","minimum":0},"returned":{"type":"integer","minimum":0},"has_more":{"type":"boolean"}}}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/execution/account_counterparty_graph/latest":{"get":{"tags":["Execution"],"summary":"Account Counterparty Graph (latest)","description":"**Required Access:** `tier1`\n\nSimple API view for Account Portfolio counterparty graph rows.\n\n**Declared Filters:**\n- **source**: = on `source`\n- **edge_type**: = on `edge_type`\n\n**Pagination:**\n- **limit**: default `60`, max `250`\n- **offset**: default `0`\n\n**Sort:**\n- `weight DESC`\n\n**Columns:**\n- **edge_type** (`String`): Kind of relationship the edge represents.\n- **weight** (`UInt64`): Edge weight — aggregated interaction count (or 1 for structural relations).\n- **source** (`Nullable(String)`)\n- **target** (`Nullable(String)`)\n- **as_of_date** (`Date`): Date the snapshot is computed as of (max date in the underlying data).","operationId":"api_execution_account_counterparty_graph_get_v1_execution_account_counterparty_graph_latest_get","security":[{"APIKeyHeader":[]}],"responses":{"200":{"description":"Paginated response","content":{"application/json":{"schema":{"type":"object","required":["items","pagination"],"properties":{"items":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"edge_type":{"type":"string","description":"Kind of relationship the edge represents."},"weight":{"type":"integer","description":"Edge weight — aggregated interaction count (or 1 for structural relations)."},"source":{"type":"string"},"target":{"type":"string"},"as_of_date":{"type":"string","format":"date","description":"Date the snapshot is computed as of (max date in the underlying data)."}}}},"pagination":{"type":"object","required":["limit","offset","returned","has_more"],"properties":{"limit":{"type":"integer","minimum":1},"offset":{"type":"integer","minimum":0},"returned":{"type":"integer","minimum":0},"has_more":{"type":"boolean"}}}}}}}}},"parameters":[{"name":"source","in":"query","required":false,"description":"","schema":{"type":"string"}},{"name":"edge_type","in":"query","required":false,"description":"","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"Row limit","schema":{"type":"integer","minimum":1,"maximum":250,"default":60}},{"name":"offset","in":"query","required":false,"description":"Row offset","schema":{"type":"integer","minimum":0,"default":0}}]},"post":{"tags":["Execution"],"summary":"Account Counterparty Graph (latest) (POST)","description":"**Required Access:** `tier1`\n\nSimple API view for Account Portfolio counterparty graph rows.\n\n**Declared Filters:**\n- **source**: = on `source`\n- **edge_type**: = on `edge_type`\n\n**Pagination:**\n- **limit**: default `60`, max `250`\n- **offset**: default `0`\n\n**Sort:**\n- `weight DESC`\n\n**Columns:**\n- **edge_type** (`String`): Kind of relationship the edge represents.\n- **weight** (`UInt64`): Edge weight — aggregated interaction count (or 1 for structural relations).\n- **source** (`Nullable(String)`)\n- **target** (`Nullable(String)`)\n- **as_of_date** (`Date`): Date the snapshot is computed as of (max date in the underlying data).","operationId":"api_execution_account_counterparty_graph_post_v1_execution_account_counterparty_graph_latest_post","security":[{"APIKeyHeader":[]}],"requestBody":{"content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/api_execution_account_counterparty_graph_PostBody"},{"type":"null"}],"title":" Body"}}}},"responses":{"200":{"description":"Paginated response","content":{"application/json":{"schema":{"type":"object","required":["items","pagination"],"properties":{"items":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"edge_type":{"type":"string","description":"Kind of relationship the edge represents."},"weight":{"type":"integer","description":"Edge weight — aggregated interaction count (or 1 for structural relations)."},"source":{"type":"string"},"target":{"type":"string"},"as_of_date":{"type":"string","format":"date","description":"Date the snapshot is computed as of (max date in the underlying data)."}}}},"pagination":{"type":"object","required":["limit","offset","returned","has_more"],"properties":{"limit":{"type":"integer","minimum":1},"offset":{"type":"integer","minimum":0},"returned":{"type":"integer","minimum":0},"has_more":{"type":"boolean"}}}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/execution/account_linked_entities/latest":{"get":{"tags":["Execution"],"summary":"Account Linked Entities (latest)","description":"**Required Access:** `tier1`\n\nSimple API view for direct linked entities.\n\n**Declared Filters:**\n- **root_address**: IN on `root_address`\n- **relation**: = on `relation`\n- **entity_type**: = on `entity_type`\n\n**Pagination:**\n- **limit**: default `100`, max `5000`\n- **offset**: default `0`\n\n**Sort:**\n- `last_seen_at DESC`\n\n**Columns:**\n- **entity_type** (`String`): Type of linked entity ('safe', 'safe_owner', 'gpay_wallet', 'validator_credential').\n- **last_seen_at** (`DateTime`): Most recent timestamp evidencing the link (became-owner / last module event / slot timestamp).\n- **relation** (`String`): Relationship of the entity to root_address.\n- **root_address** (`Nullable(String)`)\n- **entity_id** (`Nullable(String)`)\n- **as_of_date** (`Date`): Date the snapshot is computed as of (max date in the underlying data).","operationId":"api_execution_account_linked_entities_latest_get_v1_execution_account_linked_entities_latest_get","security":[{"APIKeyHeader":[]}],"responses":{"200":{"description":"Paginated response","content":{"application/json":{"schema":{"type":"object","required":["items","pagination"],"properties":{"items":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"entity_type":{"type":"string","description":"Type of linked entity ('safe', 'safe_owner', 'gpay_wallet', 'validator_credential')."},"last_seen_at":{"type":"string","format":"date-time","description":"Most recent timestamp evidencing the link (became-owner / last module event / slot timestamp)."},"relation":{"type":"string","description":"Relationship of the entity to root_address."},"root_address":{"type":"string"},"entity_id":{"type":"string"},"as_of_date":{"type":"string","format":"date","description":"Date the snapshot is computed as of (max date in the underlying data)."}}}},"pagination":{"type":"object","required":["limit","offset","returned","has_more"],"properties":{"limit":{"type":"integer","minimum":1},"offset":{"type":"integer","minimum":0},"returned":{"type":"integer","minimum":0},"has_more":{"type":"boolean"}}}}}}}}},"parameters":[{"name":"root_address","in":"query","required":false,"description":"List filter. Accepts repeated query params or CSV.","style":"form","explode":true,"schema":{"type":"array","items":{"type":"string"},"maxItems":20}},{"name":"relation","in":"query","required":false,"description":"","schema":{"type":"string"}},{"name":"entity_type","in":"query","required":false,"description":"","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"Row limit","schema":{"type":"integer","minimum":1,"maximum":5000,"default":100}},{"name":"offset","in":"query","required":false,"description":"Row offset","schema":{"type":"integer","minimum":0,"default":0}}]},"post":{"tags":["Execution"],"summary":"Account Linked Entities (latest) (POST)","description":"**Required Access:** `tier1`\n\nSimple API view for direct linked entities.\n\n**Declared Filters:**\n- **root_address**: IN on `root_address`\n- **relation**: = on `relation`\n- **entity_type**: = on `entity_type`\n\n**Pagination:**\n- **limit**: default `100`, max `5000`\n- **offset**: default `0`\n\n**Sort:**\n- `last_seen_at DESC`\n\n**Columns:**\n- **entity_type** (`String`): Type of linked entity ('safe', 'safe_owner', 'gpay_wallet', 'validator_credential').\n- **last_seen_at** (`DateTime`): Most recent timestamp evidencing the link (became-owner / last module event / slot timestamp).\n- **relation** (`String`): Relationship of the entity to root_address.\n- **root_address** (`Nullable(String)`)\n- **entity_id** (`Nullable(String)`)\n- **as_of_date** (`Date`): Date the snapshot is computed as of (max date in the underlying data).","operationId":"api_execution_account_linked_entities_latest_post_v1_execution_account_linked_entities_latest_post","security":[{"APIKeyHeader":[]}],"requestBody":{"content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/api_execution_account_linked_entities_latest_PostBody"},{"type":"null"}],"title":" Body"}}}},"responses":{"200":{"description":"Paginated response","content":{"application/json":{"schema":{"type":"object","required":["items","pagination"],"properties":{"items":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"entity_type":{"type":"string","description":"Type of linked entity ('safe', 'safe_owner', 'gpay_wallet', 'validator_credential')."},"last_seen_at":{"type":"string","format":"date-time","description":"Most recent timestamp evidencing the link (became-owner / last module event / slot timestamp)."},"relation":{"type":"string","description":"Relationship of the entity to root_address."},"root_address":{"type":"string"},"entity_id":{"type":"string"},"as_of_date":{"type":"string","format":"date","description":"Date the snapshot is computed as of (max date in the underlying data)."}}}},"pagination":{"type":"object","required":["limit","offset","returned","has_more"],"properties":{"limit":{"type":"integer","minimum":1},"offset":{"type":"integer","minimum":0},"returned":{"type":"integer","minimum":0},"has_more":{"type":"boolean"}}}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/execution/account_profile/latest":{"get":{"tags":["Execution"],"summary":"Account Profile (latest)","description":"**Required Access:** `tier1`\n\nSimple API view over the latest Account Portfolio profile fact.\n\n**Declared Filters:**\n- **address**: IN on `address`\n\n**Pagination:**\n- **limit**: default `20`, max `200`\n- **offset**: default `0`\n\n**Columns:**\n- **address** (`Nullable(String)`)\n- **as_of_date** (`Date`): Date the snapshot is computed as of (max date in the underlying data).","operationId":"api_execution_account_profile_latest_get_v1_execution_account_profile_latest_get","security":[{"APIKeyHeader":[]}],"responses":{"200":{"description":"Paginated response","content":{"application/json":{"schema":{"type":"object","required":["items","pagination"],"properties":{"items":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"address":{"type":"string"},"as_of_date":{"type":"string","format":"date","description":"Date the snapshot is computed as of (max date in the underlying data)."}}}},"pagination":{"type":"object","required":["limit","offset","returned","has_more"],"properties":{"limit":{"type":"integer","minimum":1},"offset":{"type":"integer","minimum":0},"returned":{"type":"integer","minimum":0},"has_more":{"type":"boolean"}}}}}}}}},"parameters":[{"name":"address","in":"query","required":false,"description":"List filter. Accepts repeated query params or CSV.","style":"form","explode":true,"schema":{"type":"array","items":{"type":"string"},"maxItems":20}},{"name":"limit","in":"query","required":false,"description":"Row limit","schema":{"type":"integer","minimum":1,"maximum":200,"default":20}},{"name":"offset","in":"query","required":false,"description":"Row offset","schema":{"type":"integer","minimum":0,"default":0}}]},"post":{"tags":["Execution"],"summary":"Account Profile (latest) (POST)","description":"**Required Access:** `tier1`\n\nSimple API view over the latest Account Portfolio profile fact.\n\n**Declared Filters:**\n- **address**: IN on `address`\n\n**Pagination:**\n- **limit**: default `20`, max `200`\n- **offset**: default `0`\n\n**Columns:**\n- **address** (`Nullable(String)`)\n- **as_of_date** (`Date`): Date the snapshot is computed as of (max date in the underlying data).","operationId":"api_execution_account_profile_latest_post_v1_execution_account_profile_latest_post","security":[{"APIKeyHeader":[]}],"requestBody":{"content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/api_execution_account_profile_latest_PostBody"},{"type":"null"}],"title":" Body"}}}},"responses":{"200":{"description":"Paginated response","content":{"application/json":{"schema":{"type":"object","required":["items","pagination"],"properties":{"items":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"address":{"type":"string"},"as_of_date":{"type":"string","format":"date","description":"Date the snapshot is computed as of (max date in the underlying data)."}}}},"pagination":{"type":"object","required":["limit","offset","returned","has_more"],"properties":{"limit":{"type":"integer","minimum":1},"offset":{"type":"integer","minimum":0},"returned":{"type":"integer","minimum":0},"has_more":{"type":"boolean"}}}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/execution/account_recent_transactions/daily":{"get":{"tags":["Execution"],"summary":"Account Recent Transactions (daily)","description":"**Required Access:** `tier1`\n\nRecent production-backed token movement rows for Account Portfolio transaction tables.\n\n**Declared Filters:**\n- **address**: IN on `address`\n- **counterparty**: = on `counterparty`\n\n**Pagination:**\n- **limit**: default `100`, max `1000`\n- **offset**: default `0`\n\n**Sort:**\n- `date DESC`\n\n**Columns:**\n- **counterparty** (`Nullable(String)`): Counterparty address of the movement (other side of the transfer).\n- **address** (`Nullable(String)`)\n- **date** (`Date`)","operationId":"api_execution_account_recent_transactions_get_v1_execution_account_recent_transactions_daily_get","security":[{"APIKeyHeader":[]}],"responses":{"200":{"description":"Paginated response","content":{"application/json":{"schema":{"type":"object","required":["items","pagination"],"properties":{"items":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"counterparty":{"type":"string","description":"Counterparty address of the movement (other side of the transfer)."},"address":{"type":"string"},"date":{"type":"string","format":"date"}}}},"pagination":{"type":"object","required":["limit","offset","returned","has_more"],"properties":{"limit":{"type":"integer","minimum":1},"offset":{"type":"integer","minimum":0},"returned":{"type":"integer","minimum":0},"has_more":{"type":"boolean"}}}}}}}}},"parameters":[{"name":"address","in":"query","required":false,"description":"List filter. Accepts repeated query params or CSV.","style":"form","explode":true,"schema":{"type":"array","items":{"type":"string"},"maxItems":20}},{"name":"counterparty","in":"query","required":false,"description":"","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"Row limit","schema":{"type":"integer","minimum":1,"maximum":1000,"default":100}},{"name":"offset","in":"query","required":false,"description":"Row offset","schema":{"type":"integer","minimum":0,"default":0}}]},"post":{"tags":["Execution"],"summary":"Account Recent Transactions (daily) (POST)","description":"**Required Access:** `tier1`\n\nRecent production-backed token movement rows for Account Portfolio transaction tables.\n\n**Declared Filters:**\n- **address**: IN on `address`\n- **counterparty**: = on `counterparty`\n\n**Pagination:**\n- **limit**: default `100`, max `1000`\n- **offset**: default `0`\n\n**Sort:**\n- `date DESC`\n\n**Columns:**\n- **counterparty** (`Nullable(String)`): Counterparty address of the movement (other side of the transfer).\n- **address** (`Nullable(String)`)\n- **date** (`Date`)","operationId":"api_execution_account_recent_transactions_post_v1_execution_account_recent_transactions_daily_post","security":[{"APIKeyHeader":[]}],"requestBody":{"content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/api_execution_account_recent_transactions_PostBody"},{"type":"null"}],"title":" Body"}}}},"responses":{"200":{"description":"Paginated response","content":{"application/json":{"schema":{"type":"object","required":["items","pagination"],"properties":{"items":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"counterparty":{"type":"string","description":"Counterparty address of the movement (other side of the transfer)."},"address":{"type":"string"},"date":{"type":"string","format":"date"}}}},"pagination":{"type":"object","required":["limit","offset","returned","has_more"],"properties":{"limit":{"type":"integer","minimum":1},"offset":{"type":"integer","minimum":0},"returned":{"type":"integer","minimum":0},"has_more":{"type":"boolean"}}}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/execution/account_safes/latest":{"get":{"tags":["Execution"],"summary":"Account Safes (latest)","description":"**Required Access:** `tier2`\n\nReverse lookup — given an address, list every Safe it currently owns,\nenriched with that Safe's threshold, current owner count, and\ndeployment date so the Account Portfolio Safe section can render a\nfull table in a single round-trip. `require_any_of: [owner_address]`.\n\n\n**Declared Filters:**\n- **owner_address**: = on `owner_address` (Address whose owned Safes we want to list)\n\n**Pagination:**\n- **limit**: default `500`, max `5000`\n- **offset**: default `0`\n\n**Sort:**\n- `became_owner_at DESC`\n\n**User Sort:**\n- **sort_by**: one of `owner_address`, `safe_address`, `became_owner_at`, `current_threshold`, `current_owner_count`, `deployment_date`\n- **sort_direction**: `ASC` or `DESC` (defaults to `ASC` when `sort_by` is provided)\n\n**Columns:**\n- **owner_address** (`Nullable(String)`): The queried owner address (lowercase, 0x-prefixed); the required API filter.\n- **safe_address** (`Nullable(String)`): A Safe currently owned by owner_address (lowercase, 0x-prefixed).\n- **became_owner_at** (`DateTime64(0, 'UTC')`): Timestamp of the event that added (or set up) this owner. For an owner who was removed and re-added, this is the re-add time, not the original setup time.\n- **current_threshold** (`Nullable(UInt32)`): Confirmations currently required by this Safe.\n- **current_owner_count** (`UInt64`): Number of current owners of the Safe.\n- **creation_version** (`String`): Safe contract version this proxy was set up against (e.g. 1.3.0, 1.4.1, 1.3.0L2).\n- **deployment_date** (`Date`): Calendar date of the Safe's creation transaction.\n- **as_of_date** (`Date`): Date the snapshot is computed as of (max date in the underlying data).","operationId":"api_execution_account_safes_latest_get_v1_execution_account_safes_latest_get","security":[{"APIKeyHeader":[]}],"responses":{"200":{"description":"Paginated response","content":{"application/json":{"schema":{"type":"object","required":["items","pagination"],"properties":{"items":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"owner_address":{"type":"string","description":"The queried owner address (lowercase, 0x-prefixed); the required API filter."},"safe_address":{"type":"string","description":"A Safe currently owned by owner_address (lowercase, 0x-prefixed)."},"became_owner_at":{"type":"string","format":"date-time","description":"Timestamp of the event that added (or set up) this owner. For an owner who was removed and re-added, this is the re-add time, not the original setup time."},"current_threshold":{"type":"integer","description":"Confirmations currently required by this Safe."},"current_owner_count":{"type":"integer","description":"Number of current owners of the Safe."},"creation_version":{"type":"string","description":"Safe contract version this proxy was set up against (e.g. 1.3.0, 1.4.1, 1.3.0L2)."},"deployment_date":{"type":"string","format":"date","description":"Calendar date of the Safe's creation transaction."},"as_of_date":{"type":"string","format":"date","description":"Date the snapshot is computed as of (max date in the underlying data)."}}}},"pagination":{"type":"object","required":["limit","offset","returned","has_more"],"properties":{"limit":{"type":"integer","minimum":1},"offset":{"type":"integer","minimum":0},"returned":{"type":"integer","minimum":0},"has_more":{"type":"boolean"}}}}}}}}},"parameters":[{"name":"owner_address","in":"query","required":false,"description":"Address whose owned Safes we want to list","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"Row limit","schema":{"type":"integer","minimum":1,"maximum":5000,"default":500}},{"name":"offset","in":"query","required":false,"description":"Row offset","schema":{"type":"integer","minimum":0,"default":0}},{"name":"sort_by","in":"query","required":false,"description":"Sort column","schema":{"type":"string","enum":["owner_address","safe_address","became_owner_at","current_threshold","current_owner_count","deployment_date"]}},{"name":"sort_direction","in":"query","required":false,"description":"Sort direction. Defaults to ASC when sort_by is provided.","schema":{"type":"string","enum":["ASC","DESC"],"default":"ASC"}}]},"post":{"tags":["Execution"],"summary":"Account Safes (latest) (POST)","description":"**Required Access:** `tier2`\n\nReverse lookup — given an address, list every Safe it currently owns,\nenriched with that Safe's threshold, current owner count, and\ndeployment date so the Account Portfolio Safe section can render a\nfull table in a single round-trip. `require_any_of: [owner_address]`.\n\n\n**Declared Filters:**\n- **owner_address**: = on `owner_address` (Address whose owned Safes we want to list)\n\n**Pagination:**\n- **limit**: default `500`, max `5000`\n- **offset**: default `0`\n\n**Sort:**\n- `became_owner_at DESC`\n\n**User Sort:**\n- **sort_by**: one of `owner_address`, `safe_address`, `became_owner_at`, `current_threshold`, `current_owner_count`, `deployment_date`\n- **sort_direction**: `ASC` or `DESC` (defaults to `ASC` when `sort_by` is provided)\n\n**Columns:**\n- **owner_address** (`Nullable(String)`): The queried owner address (lowercase, 0x-prefixed); the required API filter.\n- **safe_address** (`Nullable(String)`): A Safe currently owned by owner_address (lowercase, 0x-prefixed).\n- **became_owner_at** (`DateTime64(0, 'UTC')`): Timestamp of the event that added (or set up) this owner. For an owner who was removed and re-added, this is the re-add time, not the original setup time.\n- **current_threshold** (`Nullable(UInt32)`): Confirmations currently required by this Safe.\n- **current_owner_count** (`UInt64`): Number of current owners of the Safe.\n- **creation_version** (`String`): Safe contract version this proxy was set up against (e.g. 1.3.0, 1.4.1, 1.3.0L2).\n- **deployment_date** (`Date`): Calendar date of the Safe's creation transaction.\n- **as_of_date** (`Date`): Date the snapshot is computed as of (max date in the underlying data).","operationId":"api_execution_account_safes_latest_post_v1_execution_account_safes_latest_post","security":[{"APIKeyHeader":[]}],"requestBody":{"content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/api_execution_account_safes_latest_PostBody"},{"type":"null"}],"title":" Body"}}}},"responses":{"200":{"description":"Paginated response","content":{"application/json":{"schema":{"type":"object","required":["items","pagination"],"properties":{"items":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"owner_address":{"type":"string","description":"The queried owner address (lowercase, 0x-prefixed); the required API filter."},"safe_address":{"type":"string","description":"A Safe currently owned by owner_address (lowercase, 0x-prefixed)."},"became_owner_at":{"type":"string","format":"date-time","description":"Timestamp of the event that added (or set up) this owner. For an owner who was removed and re-added, this is the re-add time, not the original setup time."},"current_threshold":{"type":"integer","description":"Confirmations currently required by this Safe."},"current_owner_count":{"type":"integer","description":"Number of current owners of the Safe."},"creation_version":{"type":"string","description":"Safe contract version this proxy was set up against (e.g. 1.3.0, 1.4.1, 1.3.0L2)."},"deployment_date":{"type":"string","format":"date","description":"Calendar date of the Safe's creation transaction."},"as_of_date":{"type":"string","format":"date","description":"Date the snapshot is computed as of (max date in the underlying data)."}}}},"pagination":{"type":"object","required":["limit","offset","returned","has_more"],"properties":{"limit":{"type":"integer","minimum":1},"offset":{"type":"integer","minimum":0},"returned":{"type":"integer","minimum":0},"has_more":{"type":"boolean"}}}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/execution/account_search/latest":{"get":{"tags":["Execution"],"summary":"Account Search (latest)","description":"**Required Access:** `tier1`\n\nSimple API view over Account Portfolio search index.\n\n**Declared Filters:**\n- **search_key**: = on `search_key`\n- **address**: = on `address`\n- **result_type**: = on `result_type`\n\n**Pagination:**\n- **limit**: default `20`, max `100`\n- **offset**: default `0`\n\n**Columns:**\n- **address** (`String`): Resolved account address for the search result (lowercase).\n- **search_key** (`Nullable(String)`)\n- **result_type** (`String`)\n- **as_of_date** (`Date`): Date the snapshot is computed as of (max date in the underlying data).","operationId":"api_execution_account_search_index_get_v1_execution_account_search_latest_get","security":[{"APIKeyHeader":[]}],"responses":{"200":{"description":"Paginated response","content":{"application/json":{"schema":{"type":"object","required":["items","pagination"],"properties":{"items":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"address":{"type":"string","description":"Resolved account address for the search result (lowercase)."},"search_key":{"type":"string"},"result_type":{"type":"string"},"as_of_date":{"type":"string","format":"date","description":"Date the snapshot is computed as of (max date in the underlying data)."}}}},"pagination":{"type":"object","required":["limit","offset","returned","has_more"],"properties":{"limit":{"type":"integer","minimum":1},"offset":{"type":"integer","minimum":0},"returned":{"type":"integer","minimum":0},"has_more":{"type":"boolean"}}}}}}}}},"parameters":[{"name":"search_key","in":"query","required":false,"description":"","schema":{"type":"string"}},{"name":"address","in":"query","required":false,"description":"","schema":{"type":"string"}},{"name":"result_type","in":"query","required":false,"description":"","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"Row limit","schema":{"type":"integer","minimum":1,"maximum":100,"default":20}},{"name":"offset","in":"query","required":false,"description":"Row offset","schema":{"type":"integer","minimum":0,"default":0}}]},"post":{"tags":["Execution"],"summary":"Account Search (latest) (POST)","description":"**Required Access:** `tier1`\n\nSimple API view over Account Portfolio search index.\n\n**Declared Filters:**\n- **search_key**: = on `search_key`\n- **address**: = on `address`\n- **result_type**: = on `result_type`\n\n**Pagination:**\n- **limit**: default `20`, max `100`\n- **offset**: default `0`\n\n**Columns:**\n- **address** (`String`): Resolved account address for the search result (lowercase).\n- **search_key** (`Nullable(String)`)\n- **result_type** (`String`)\n- **as_of_date** (`Date`): Date the snapshot is computed as of (max date in the underlying data).","operationId":"api_execution_account_search_index_post_v1_execution_account_search_latest_post","security":[{"APIKeyHeader":[]}],"requestBody":{"content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/api_execution_account_search_index_PostBody"},{"type":"null"}],"title":" Body"}}}},"responses":{"200":{"description":"Paginated response","content":{"application/json":{"schema":{"type":"object","required":["items","pagination"],"properties":{"items":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"address":{"type":"string","description":"Resolved account address for the search result (lowercase)."},"search_key":{"type":"string"},"result_type":{"type":"string"},"as_of_date":{"type":"string","format":"date","description":"Date the snapshot is computed as of (max date in the underlying data)."}}}},"pagination":{"type":"object","required":["limit","offset","returned","has_more"],"properties":{"limit":{"type":"integer","minimum":1},"offset":{"type":"integer","minimum":0},"returned":{"type":"integer","minimum":0},"has_more":{"type":"boolean"}}}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/execution/account_token_balances/latest":{"get":{"tags":["Execution"],"summary":"Account Token Balances (latest)","description":"**Required Access:** `tier1`\n\nSimple API view for latest Account Portfolio token balances.\n\n**Declared Filters:**\n- **address**: IN on `address`\n- **symbol**: = on `symbol`\n\n**Pagination:**\n- **limit**: default `100`, max `5000`\n- **offset**: default `0`\n\n**Sort:**\n- `balance_usd DESC`\n\n**Columns:**\n- **balance_usd** (`Float64`): Balance multiplied by the daily token price in USD. Null when no price is available for that (date, symbol).\n- **symbol** (`String`): The token's symbol, serving as a human-readable identifier.\n- **address** (`Nullable(String)`)\n- **token_address** (`String`)\n- **as_of_date** (`Date`): Date the snapshot is computed as of (max date in the underlying data).","operationId":"api_execution_account_token_balances_latest_get_v1_execution_account_token_balances_latest_get","security":[{"APIKeyHeader":[]}],"responses":{"200":{"description":"Paginated response","content":{"application/json":{"schema":{"type":"object","required":["items","pagination"],"properties":{"items":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"balance_usd":{"type":"number","description":"Balance multiplied by the daily token price in USD. Null when no price is available for that (date, symbol)."},"symbol":{"type":"string","description":"The token's symbol, serving as a human-readable identifier."},"address":{"type":"string"},"token_address":{"type":"string"},"as_of_date":{"type":"string","format":"date","description":"Date the snapshot is computed as of (max date in the underlying data)."}}}},"pagination":{"type":"object","required":["limit","offset","returned","has_more"],"properties":{"limit":{"type":"integer","minimum":1},"offset":{"type":"integer","minimum":0},"returned":{"type":"integer","minimum":0},"has_more":{"type":"boolean"}}}}}}}}},"parameters":[{"name":"address","in":"query","required":false,"description":"List filter. Accepts repeated query params or CSV.","style":"form","explode":true,"schema":{"type":"array","items":{"type":"string"},"maxItems":20}},{"name":"symbol","in":"query","required":false,"description":"","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"Row limit","schema":{"type":"integer","minimum":1,"maximum":5000,"default":100}},{"name":"offset","in":"query","required":false,"description":"Row offset","schema":{"type":"integer","minimum":0,"default":0}}]},"post":{"tags":["Execution"],"summary":"Account Token Balances (latest) (POST)","description":"**Required Access:** `tier1`\n\nSimple API view for latest Account Portfolio token balances.\n\n**Declared Filters:**\n- **address**: IN on `address`\n- **symbol**: = on `symbol`\n\n**Pagination:**\n- **limit**: default `100`, max `5000`\n- **offset**: default `0`\n\n**Sort:**\n- `balance_usd DESC`\n\n**Columns:**\n- **balance_usd** (`Float64`): Balance multiplied by the daily token price in USD. Null when no price is available for that (date, symbol).\n- **symbol** (`String`): The token's symbol, serving as a human-readable identifier.\n- **address** (`Nullable(String)`)\n- **token_address** (`String`)\n- **as_of_date** (`Date`): Date the snapshot is computed as of (max date in the underlying data).","operationId":"api_execution_account_token_balances_latest_post_v1_execution_account_token_balances_latest_post","security":[{"APIKeyHeader":[]}],"requestBody":{"content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/api_execution_account_token_balances_latest_PostBody"},{"type":"null"}],"title":" Body"}}}},"responses":{"200":{"description":"Paginated response","content":{"application/json":{"schema":{"type":"object","required":["items","pagination"],"properties":{"items":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"balance_usd":{"type":"number","description":"Balance multiplied by the daily token price in USD. Null when no price is available for that (date, symbol)."},"symbol":{"type":"string","description":"The token's symbol, serving as a human-readable identifier."},"address":{"type":"string"},"token_address":{"type":"string"},"as_of_date":{"type":"string","format":"date","description":"Date the snapshot is computed as of (max date in the underlying data)."}}}},"pagination":{"type":"object","required":["limit","offset","returned","has_more"],"properties":{"limit":{"type":"integer","minimum":1},"offset":{"type":"integer","minimum":0},"returned":{"type":"integer","minimum":0},"has_more":{"type":"boolean"}}}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/execution/account_token_movements/daily":{"get":{"tags":["Execution"],"summary":"Account Token Movements (daily)","description":"**Required Access:** `tier1`\n\nSimple API view for Account Portfolio token movements.\n\n**Declared Filters:**\n- **address**: IN on `address`\n- **counterparty**: = on `counterparty`\n- **symbol**: = on `symbol`\n- **direction**: = on `direction`\n- **start_date**: >= on `date`\n- **end_date**: <= on `date`\n\n**Pagination:**\n- **limit**: default `250`, max `5000`\n- **offset**: default `0`\n\n**Sort:**\n- `date DESC`\n\n**Columns:**\n- **counterparty** (`Nullable(String)`): Counterparty address of the movement (other side of the transfer).\n- **date** (`Date`): Movement date (daily grain).\n- **symbol** (`String`): Token symbol of the moved asset.\n- **address** (`Nullable(String)`)\n- **direction** (`String`)","operationId":"api_execution_account_token_movements_daily_get_v1_execution_account_token_movements_daily_get","security":[{"APIKeyHeader":[]}],"responses":{"200":{"description":"Paginated response","content":{"application/json":{"schema":{"type":"object","required":["items","pagination"],"properties":{"items":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"counterparty":{"type":"string","description":"Counterparty address of the movement (other side of the transfer)."},"date":{"type":"string","format":"date","description":"Movement date (daily grain)."},"symbol":{"type":"string","description":"Token symbol of the moved asset."},"address":{"type":"string"},"direction":{"type":"string"}}}},"pagination":{"type":"object","required":["limit","offset","returned","has_more"],"properties":{"limit":{"type":"integer","minimum":1},"offset":{"type":"integer","minimum":0},"returned":{"type":"integer","minimum":0},"has_more":{"type":"boolean"}}}}}}}}},"parameters":[{"name":"address","in":"query","required":false,"description":"List filter. Accepts repeated query params or CSV.","style":"form","explode":true,"schema":{"type":"array","items":{"type":"string"},"maxItems":20}},{"name":"counterparty","in":"query","required":false,"description":"","schema":{"type":"string"}},{"name":"symbol","in":"query","required":false,"description":"","schema":{"type":"string"}},{"name":"direction","in":"query","required":false,"description":"","schema":{"type":"string"}},{"name":"start_date","in":"query","required":false,"description":"","schema":{"type":"string","format":"date"}},{"name":"end_date","in":"query","required":false,"description":"","schema":{"type":"string","format":"date"}},{"name":"limit","in":"query","required":false,"description":"Row limit","schema":{"type":"integer","minimum":1,"maximum":5000,"default":250}},{"name":"offset","in":"query","required":false,"description":"Row offset","schema":{"type":"integer","minimum":0,"default":0}}]},"post":{"tags":["Execution"],"summary":"Account Token Movements (daily) (POST)","description":"**Required Access:** `tier1`\n\nSimple API view for Account Portfolio token movements.\n\n**Declared Filters:**\n- **address**: IN on `address`\n- **counterparty**: = on `counterparty`\n- **symbol**: = on `symbol`\n- **direction**: = on `direction`\n- **start_date**: >= on `date`\n- **end_date**: <= on `date`\n\n**Pagination:**\n- **limit**: default `250`, max `5000`\n- **offset**: default `0`\n\n**Sort:**\n- `date DESC`\n\n**Columns:**\n- **counterparty** (`Nullable(String)`): Counterparty address of the movement (other side of the transfer).\n- **date** (`Date`): Movement date (daily grain).\n- **symbol** (`String`): Token symbol of the moved asset.\n- **address** (`Nullable(String)`)\n- **direction** (`String`)","operationId":"api_execution_account_token_movements_daily_post_v1_execution_account_token_movements_daily_post","security":[{"APIKeyHeader":[]}],"requestBody":{"content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/api_execution_account_token_movements_daily_PostBody"},{"type":"null"}],"title":" Body"}}}},"responses":{"200":{"description":"Paginated response","content":{"application/json":{"schema":{"type":"object","required":["items","pagination"],"properties":{"items":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"counterparty":{"type":"string","description":"Counterparty address of the movement (other side of the transfer)."},"date":{"type":"string","format":"date","description":"Movement date (daily grain)."},"symbol":{"type":"string","description":"Token symbol of the moved asset."},"address":{"type":"string"},"direction":{"type":"string"}}}},"pagination":{"type":"object","required":["limit","offset","returned","has_more"],"properties":{"limit":{"type":"integer","minimum":1},"offset":{"type":"integer","minimum":0},"returned":{"type":"integer","minimum":0},"has_more":{"type":"boolean"}}}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/execution/account_transaction_summary/latest":{"get":{"tags":["Execution"],"summary":"Account Transaction Summary (latest)","description":"**Required Access:** `tier1`\n\nSimple API view for Account Portfolio transaction/activity summary.\n\n**Declared Filters:**\n- **address**: IN on `address`\n\n**Pagination:**\n- **limit**: default `50`, max `500`\n- **offset**: default `0`\n\n**Columns:**\n- **address** (`Nullable(String)`)\n- **as_of_date** (`Date`): Date the snapshot is computed as of (max date in the underlying data).","operationId":"api_execution_account_transaction_summary_latest_get_v1_execution_account_transaction_summary_latest_get","security":[{"APIKeyHeader":[]}],"responses":{"200":{"description":"Paginated response","content":{"application/json":{"schema":{"type":"object","required":["items","pagination"],"properties":{"items":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"address":{"type":"string"},"as_of_date":{"type":"string","format":"date","description":"Date the snapshot is computed as of (max date in the underlying data)."}}}},"pagination":{"type":"object","required":["limit","offset","returned","has_more"],"properties":{"limit":{"type":"integer","minimum":1},"offset":{"type":"integer","minimum":0},"returned":{"type":"integer","minimum":0},"has_more":{"type":"boolean"}}}}}}}}},"parameters":[{"name":"address","in":"query","required":false,"description":"List filter. Accepts repeated query params or CSV.","style":"form","explode":true,"schema":{"type":"array","items":{"type":"string"},"maxItems":20}},{"name":"limit","in":"query","required":false,"description":"Row limit","schema":{"type":"integer","minimum":1,"maximum":500,"default":50}},{"name":"offset","in":"query","required":false,"description":"Row offset","schema":{"type":"integer","minimum":0,"default":0}}]},"post":{"tags":["Execution"],"summary":"Account Transaction Summary (latest) (POST)","description":"**Required Access:** `tier1`\n\nSimple API view for Account Portfolio transaction/activity summary.\n\n**Declared Filters:**\n- **address**: IN on `address`\n\n**Pagination:**\n- **limit**: default `50`, max `500`\n- **offset**: default `0`\n\n**Columns:**\n- **address** (`Nullable(String)`)\n- **as_of_date** (`Date`): Date the snapshot is computed as of (max date in the underlying data).","operationId":"api_execution_account_transaction_summary_latest_post_v1_execution_account_transaction_summary_latest_post","security":[{"APIKeyHeader":[]}],"requestBody":{"content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/api_execution_account_transaction_summary_latest_PostBody"},{"type":"null"}],"title":" Body"}}}},"responses":{"200":{"description":"Paginated response","content":{"application/json":{"schema":{"type":"object","required":["items","pagination"],"properties":{"items":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"address":{"type":"string"},"as_of_date":{"type":"string","format":"date","description":"Date the snapshot is computed as of (max date in the underlying data)."}}}},"pagination":{"type":"object","required":["limit","offset","returned","has_more"],"properties":{"limit":{"type":"integer","minimum":1},"offset":{"type":"integer","minimum":0},"returned":{"type":"integer","minimum":0},"has_more":{"type":"boolean"}}}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/execution/account_validators/latest":{"get":{"tags":["Execution"],"summary":"Account Validators (latest)","description":"**Required Access:** `tier1`\n\nAccount-facing validator member view filterable by withdrawal address or credential.\n\n**Declared Filters:**\n- **withdrawal_address**: IN on `withdrawal_address`\n- **withdrawal_credentials**: = on `withdrawal_credentials`\n\n**Pagination:**\n- **limit**: default `100`, max `5000`\n- **offset**: default `0`\n\n**Sort:**\n- `validator_index ASC`\n\n**Columns:**\n- **withdrawal_credentials** (`String`): Lowercased withdrawal credentials the validator sits under — the Validator Explorer's operator grouping key.\n- **validator_index** (`UInt32`)\n- **withdrawal_address** (`Nullable(String)`)\n- **as_of_date** (`Date`): Date the snapshot is computed as of (max date in the underlying data).","operationId":"api_execution_account_validators_latest_get_v1_execution_account_validators_latest_get","security":[{"APIKeyHeader":[]}],"responses":{"200":{"description":"Paginated response","content":{"application/json":{"schema":{"type":"object","required":["items","pagination"],"properties":{"items":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"withdrawal_credentials":{"type":"string","description":"Lowercased withdrawal credentials the validator sits under — the Validator Explorer's operator grouping key."},"validator_index":{"type":"integer"},"withdrawal_address":{"type":"string"},"as_of_date":{"type":"string","format":"date","description":"Date the snapshot is computed as of (max date in the underlying data)."}}}},"pagination":{"type":"object","required":["limit","offset","returned","has_more"],"properties":{"limit":{"type":"integer","minimum":1},"offset":{"type":"integer","minimum":0},"returned":{"type":"integer","minimum":0},"has_more":{"type":"boolean"}}}}}}}}},"parameters":[{"name":"withdrawal_address","in":"query","required":false,"description":"List filter. Accepts repeated query params or CSV.","style":"form","explode":true,"schema":{"type":"array","items":{"type":"string"},"maxItems":20}},{"name":"withdrawal_credentials","in":"query","required":false,"description":"","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"Row limit","schema":{"type":"integer","minimum":1,"maximum":5000,"default":100}},{"name":"offset","in":"query","required":false,"description":"Row offset","schema":{"type":"integer","minimum":0,"default":0}}]},"post":{"tags":["Execution"],"summary":"Account Validators (latest) (POST)","description":"**Required Access:** `tier1`\n\nAccount-facing validator member view filterable by withdrawal address or credential.\n\n**Declared Filters:**\n- **withdrawal_address**: IN on `withdrawal_address`\n- **withdrawal_credentials**: = on `withdrawal_credentials`\n\n**Pagination:**\n- **limit**: default `100`, max `5000`\n- **offset**: default `0`\n\n**Sort:**\n- `validator_index ASC`\n\n**Columns:**\n- **withdrawal_credentials** (`String`): Lowercased withdrawal credentials the validator sits under — the Validator Explorer's operator grouping key.\n- **validator_index** (`UInt32`)\n- **withdrawal_address** (`Nullable(String)`)\n- **as_of_date** (`Date`): Date the snapshot is computed as of (max date in the underlying data).","operationId":"api_execution_account_validators_latest_post_v1_execution_account_validators_latest_post","security":[{"APIKeyHeader":[]}],"requestBody":{"content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/api_execution_account_validators_latest_PostBody"},{"type":"null"}],"title":" Body"}}}},"responses":{"200":{"description":"Paginated response","content":{"application/json":{"schema":{"type":"object","required":["items","pagination"],"properties":{"items":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"withdrawal_credentials":{"type":"string","description":"Lowercased withdrawal credentials the validator sits under — the Validator Explorer's operator grouping key."},"validator_index":{"type":"integer"},"withdrawal_address":{"type":"string"},"as_of_date":{"type":"string","format":"date","description":"Date the snapshot is computed as of (max date in the underlying data)."}}}},"pagination":{"type":"object","required":["limit","offset","returned","has_more"],"properties":{"limit":{"type":"integer","minimum":1},"offset":{"type":"integer","minimum":0},"returned":{"type":"integer","minimum":0},"has_more":{"type":"boolean"}}}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/execution/active_senders_per_token/daily":{"get":{"tags":["Execution"],"summary":"Active Senders Per Token (daily)","description":"**Required Access:** `tier0` (no API key required)\n\nThis view provides daily counts of active senders per API token, enabling analysis of token engagement over time.\n\n**Declared Filters:**\n- **token**: = on `token` (Token symbol)\n- **token_class**: = on `token_class` (Token class (native, stablecoin, bridged, etc.))\n- **start_date**: >= on `date` (Inclusive start date)\n- **end_date**: <= on `date` (Inclusive end date)\n\n**Sort:**\n- `date DESC`\n\n**Columns:**\n- **date** (`Date`): The calendar date for which the active sender count is recorded.\n- **token** (`String`): The identifier of the API token being analyzed.\n- **token_class** (`String`): The classification or category of the token, indicating its type or purpose.\n- **value** (`UInt64`): The number of unique active senders associated with the token on the given date.","operationId":"api_execution_tokens_active_senders_daily_get_v1_execution_active_senders_per_token_daily_get","security":[{"APIKeyHeader":[]}],"responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"date":{"type":"string","format":"date","description":"The calendar date for which the active sender count is recorded."},"token":{"type":"string","description":"The identifier of the API token being analyzed."},"token_class":{"type":"string","description":"The classification or category of the token, indicating its type or purpose."},"value":{"type":"integer","description":"The number of unique active senders associated with the token on the given date."}}}}}}}},"parameters":[{"name":"token","in":"query","required":false,"description":"Token symbol","schema":{"type":"string"}},{"name":"token_class","in":"query","required":false,"description":"Token class (native, stablecoin, bridged, etc.)","schema":{"type":"string"}},{"name":"start_date","in":"query","required":false,"description":"Inclusive start date","schema":{"type":"string","format":"date"}},{"name":"end_date","in":"query","required":false,"description":"Inclusive end date","schema":{"type":"string","format":"date"}}]}},"/v1/execution/address_resolver/latest":{"get":{"tags":["Execution"],"summary":"Address Resolver (latest)","description":"**Required Access:** `tier1`\n\nPer-address merge view over `fct_execution_address_resolver`. Collapses\nthe per-source rows into a single row per address using max() on every\nflag/count column. Hit by the Account Portfolio custom view on every\naddress change. `require_any_of: [address]`.\n\n\n**Declared Filters:**\n- **address**: = on `address` (Gnosis Chain address (0x…). Returns one row with boolean flags + counts for each account-portfolio domain.)\n\n**Pagination:**\n- **limit**: default `10`, max `100`\n- **offset**: default `0`\n\n**Columns:**\n- **address** (`Nullable(String)`)\n- **as_of_date** (`Date`): Date the snapshot is computed as of (max date in the underlying data).","operationId":"api_execution_address_resolver_get_v1_execution_address_resolver_latest_get","security":[{"APIKeyHeader":[]}],"responses":{"200":{"description":"Paginated response","content":{"application/json":{"schema":{"type":"object","required":["items","pagination"],"properties":{"items":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"address":{"type":"string"},"as_of_date":{"type":"string","format":"date","description":"Date the snapshot is computed as of (max date in the underlying data)."}}}},"pagination":{"type":"object","required":["limit","offset","returned","has_more"],"properties":{"limit":{"type":"integer","minimum":1},"offset":{"type":"integer","minimum":0},"returned":{"type":"integer","minimum":0},"has_more":{"type":"boolean"}}}}}}}}},"parameters":[{"name":"address","in":"query","required":false,"description":"Gnosis Chain address (0x…). Returns one row with boolean flags + counts for each account-portfolio domain.","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"Row limit","schema":{"type":"integer","minimum":1,"maximum":100,"default":10}},{"name":"offset","in":"query","required":false,"description":"Row offset","schema":{"type":"integer","minimum":0,"default":0}}]},"post":{"tags":["Execution"],"summary":"Address Resolver (latest) (POST)","description":"**Required Access:** `tier1`\n\nPer-address merge view over `fct_execution_address_resolver`. Collapses\nthe per-source rows into a single row per address using max() on every\nflag/count column. Hit by the Account Portfolio custom view on every\naddress change. `require_any_of: [address]`.\n\n\n**Declared Filters:**\n- **address**: = on `address` (Gnosis Chain address (0x…). Returns one row with boolean flags + counts for each account-portfolio domain.)\n\n**Pagination:**\n- **limit**: default `10`, max `100`\n- **offset**: default `0`\n\n**Columns:**\n- **address** (`Nullable(String)`)\n- **as_of_date** (`Date`): Date the snapshot is computed as of (max date in the underlying data).","operationId":"api_execution_address_resolver_post_v1_execution_address_resolver_latest_post","security":[{"APIKeyHeader":[]}],"requestBody":{"content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/api_execution_address_resolver_PostBody"},{"type":"null"}],"title":" Body"}}}},"responses":{"200":{"description":"Paginated response","content":{"application/json":{"schema":{"type":"object","required":["items","pagination"],"properties":{"items":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"address":{"type":"string"},"as_of_date":{"type":"string","format":"date","description":"Date the snapshot is computed as of (max date in the underlying data)."}}}},"pagination":{"type":"object","required":["limit","offset","returned","has_more"],"properties":{"limit":{"type":"integer","minimum":1},"offset":{"type":"integer","minimum":0},"returned":{"type":"integer","minimum":0},"has_more":{"type":"boolean"}}}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/execution/address_search/latest":{"get":{"tags":["Execution"],"summary":"Address Search (latest)","description":"**Required Access:** `tier1`\n\nLightweight dropdown source for the Account Portfolio tab's global\nfilter. Two columns (address + display_name), `allow_unfiltered: true`\nso LabelSelector loads the full list in one request and substring-matches\nclient-side.\n\n\n**Pagination:**\n- **limit**: default `10000`, max `50000`\n- **offset**: default `0`\n\n**Sort:**\n- `connected_validator_count DESC`\n- `connected_safe_count DESC`\n\n**User Sort:**\n- **sort_by**: one of `address`, `display_name`, `connected_validator_count`, `connected_safe_count`\n- **sort_direction**: `ASC` or `DESC` (defaults to `ASC` when `sort_by` is provided)\n\n**Columns:**\n- **connected_safe_count** (`UInt64`): Number of Safes this address currently owns (0 if not an owner).\n- **connected_validator_count** (`UInt64`): Number of validators whose withdrawal_address is this address (0 if none).\n- **address** (`Nullable(String)`)\n- **display_name** (`String`)\n- **as_of_date** (`Date`): Date the snapshot is computed as of (max date in the underlying data).","operationId":"api_execution_address_search_get_v1_execution_address_search_latest_get","security":[{"APIKeyHeader":[]}],"responses":{"200":{"description":"Paginated response","content":{"application/json":{"schema":{"type":"object","required":["items","pagination"],"properties":{"items":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"connected_safe_count":{"type":"integer","description":"Number of Safes this address currently owns (0 if not an owner)."},"connected_validator_count":{"type":"integer","description":"Number of validators whose withdrawal_address is this address (0 if none)."},"address":{"type":"string"},"display_name":{"type":"string"},"as_of_date":{"type":"string","format":"date","description":"Date the snapshot is computed as of (max date in the underlying data)."}}}},"pagination":{"type":"object","required":["limit","offset","returned","has_more"],"properties":{"limit":{"type":"integer","minimum":1},"offset":{"type":"integer","minimum":0},"returned":{"type":"integer","minimum":0},"has_more":{"type":"boolean"}}}}}}}}},"parameters":[{"name":"limit","in":"query","required":false,"description":"Row limit","schema":{"type":"integer","minimum":1,"maximum":50000,"default":10000}},{"name":"offset","in":"query","required":false,"description":"Row offset","schema":{"type":"integer","minimum":0,"default":0}},{"name":"sort_by","in":"query","required":false,"description":"Sort column","schema":{"type":"string","enum":["address","display_name","connected_validator_count","connected_safe_count"]}},{"name":"sort_direction","in":"query","required":false,"description":"Sort direction. Defaults to ASC when sort_by is provided.","schema":{"type":"string","enum":["ASC","DESC"],"default":"ASC"}}]},"post":{"tags":["Execution"],"summary":"Address Search (latest) (POST)","description":"**Required Access:** `tier1`\n\nLightweight dropdown source for the Account Portfolio tab's global\nfilter. Two columns (address + display_name), `allow_unfiltered: true`\nso LabelSelector loads the full list in one request and substring-matches\nclient-side.\n\n\n**Pagination:**\n- **limit**: default `10000`, max `50000`\n- **offset**: default `0`\n\n**Sort:**\n- `connected_validator_count DESC`\n- `connected_safe_count DESC`\n\n**User Sort:**\n- **sort_by**: one of `address`, `display_name`, `connected_validator_count`, `connected_safe_count`\n- **sort_direction**: `ASC` or `DESC` (defaults to `ASC` when `sort_by` is provided)\n\n**Columns:**\n- **connected_safe_count** (`UInt64`): Number of Safes this address currently owns (0 if not an owner).\n- **connected_validator_count** (`UInt64`): Number of validators whose withdrawal_address is this address (0 if none).\n- **address** (`Nullable(String)`)\n- **display_name** (`String`)\n- **as_of_date** (`Date`): Date the snapshot is computed as of (max date in the underlying data).","operationId":"api_execution_address_search_post_v1_execution_address_search_latest_post","security":[{"APIKeyHeader":[]}],"requestBody":{"content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/api_execution_address_search_PostBody"},{"type":"null"}],"title":" Body"}}}},"responses":{"200":{"description":"Paginated response","content":{"application/json":{"schema":{"type":"object","required":["items","pagination"],"properties":{"items":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"connected_safe_count":{"type":"integer","description":"Number of Safes this address currently owns (0 if not an owner)."},"connected_validator_count":{"type":"integer","description":"Number of validators whose withdrawal_address is this address (0 if none)."},"address":{"type":"string"},"display_name":{"type":"string"},"as_of_date":{"type":"string","format":"date","description":"Date the snapshot is computed as of (max date in the underlying data)."}}}},"pagination":{"type":"object","required":["limit","offset","returned","has_more"],"properties":{"limit":{"type":"integer","minimum":1},"offset":{"type":"integer","minimum":0},"returned":{"type":"integer","minimum":0},"has_more":{"type":"boolean"}}}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/execution/balance_cohorts_amount_per_token/daily":{"get":{"tags":["Execution"],"summary":"Balance Cohorts Amount Per Token (daily)","description":"**Required Access:** `tier1`\n\nThis view aggregates daily token balance cohort values, segmented by balance buckets, to support analysis of token holdings over time.\n\n**Declared Filters:**\n- **token**: = on `token` (Token symbol)\n- **start_date**: >= on `date` (Inclusive start date)\n- **end_date**: <= on `date` (Inclusive end date)\n\n**Sort:**\n- `date DESC`\n\n**Columns:**\n- **date** (`Date`): The specific calendar date for the recorded token balance data.\n- **token** (`String`): The symbol representing the specific cryptocurrency or token.\n- **cohort_unit** (`String`): The unit used for cohort bucketing ('usd' for balance_usd, 'native' for balance).\n- **label** (`String`): The bucket label categorizing token balances, such as ranges or tiers.\n- **value_native** (`Float64`): The total native token balance within the specified bucket on the given date.\n- **value_usd** (`Float64`): The total USD value of token balances within the specified bucket on the given date.","operationId":"api_execution_tokens_balance_cohorts_value_daily_get_v1_execution_balance_cohorts_amount_per_token_daily_get","security":[{"APIKeyHeader":[]}],"responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"date":{"type":"string","format":"date","description":"The specific calendar date for the recorded token balance data."},"token":{"type":"string","description":"The symbol representing the specific cryptocurrency or token."},"cohort_unit":{"type":"string","description":"The unit used for cohort bucketing ('usd' for balance_usd, 'native' for balance)."},"label":{"type":"string","description":"The bucket label categorizing token balances, such as ranges or tiers."},"value_native":{"type":"number","description":"The total native token balance within the specified bucket on the given date."},"value_usd":{"type":"number","description":"The total USD value of token balances within the specified bucket on the given date."}}}}}}}},"parameters":[{"name":"token","in":"query","required":false,"description":"Token symbol","schema":{"type":"string"}},{"name":"start_date","in":"query","required":false,"description":"Inclusive start date","schema":{"type":"string","format":"date"}},{"name":"end_date","in":"query","required":false,"description":"Inclusive end date","schema":{"type":"string","format":"date"}}]}},"/v1/execution/balance_cohorts_holders_per_token/daily":{"get":{"tags":["Execution"],"summary":"Balance Cohorts Holders Per Token (daily)","description":"**Required Access:** `tier1`\n\nThis view provides daily snapshots of token balance cohort distributions among holders, enabling analysis of holder segmentation over time.\n\n**Declared Filters:**\n- **token**: = on `token` (Token symbol)\n- **start_date**: >= on `date` (Inclusive start date)\n- **end_date**: <= on `date` (Inclusive end date)\n\n**Sort:**\n- `date DESC`\n\n**Columns:**\n- **date** (`Date`): The date of the snapshot, representing the day of data aggregation.\n- **token** (`String`): The symbol identifier of the token being analyzed.\n- **cohort_unit** (`String`): The unit used for cohort bucketing ('usd' for balance_usd, 'native' for balance).\n- **label** (`String`): The balance bucket label categorizing holder balances, such as ranges or segments.\n- **value** (`UInt64`): The number of holders within each balance bucket on the given date.","operationId":"api_execution_tokens_balance_cohorts_holders_daily_get_v1_execution_balance_cohorts_holders_per_token_daily_get","security":[{"APIKeyHeader":[]}],"responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"date":{"type":"string","format":"date","description":"The date of the snapshot, representing the day of data aggregation."},"token":{"type":"string","description":"The symbol identifier of the token being analyzed."},"cohort_unit":{"type":"string","description":"The unit used for cohort bucketing ('usd' for balance_usd, 'native' for balance)."},"label":{"type":"string","description":"The balance bucket label categorizing holder balances, such as ranges or segments."},"value":{"type":"integer","description":"The number of holders within each balance bucket on the given date."}}}}}}}},"parameters":[{"name":"token","in":"query","required":false,"description":"Token symbol","schema":{"type":"string"}},{"name":"start_date","in":"query","required":false,"description":"Inclusive start date","schema":{"type":"string","format":"date"}},{"name":"end_date","in":"query","required":false,"description":"Inclusive end date","schema":{"type":"string","format":"date"}}]}},"/v1/execution/blocks_gas_usage_pct/daily":{"get":{"tags":["Execution"],"summary":"Blocks Gas Usage Pct (daily)","description":"**Required Access:** `tier1`\n\nThe api_execution_blocks_gas_usage_pct_daily model provides daily insights into the percentage of gas used by API execution blocks, assisting in monitoring resource consumption trends over time.\n\n**Columns:**\n- **date** (`Date`): The specific day for which the gas usage percentage is recorded.\n- **value** (`Float64`): The percentage of gas used by execution blocks on the given date, rounded to two decimal places.","operationId":"api_execution_blocks_gas_usage_pct_daily_get_v1_execution_blocks_gas_usage_pct_daily_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"date":{"type":"string","format":"date","description":"The specific day for which the gas usage percentage is recorded."},"value":{"type":"number","description":"The percentage of gas used by execution blocks on the given date, rounded to two decimal places."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/blocks_gas_usage_pct/monthly":{"get":{"tags":["Execution"],"summary":"Blocks Gas Usage Pct (monthly)","description":"**Required Access:** `tier1`\n\nThis model provides a monthly percentage of gas usage for execution blocks, enabling analysis of gas consumption trends over time.\n\n**Columns:**\n- **date** (`Date`): The month for which the gas usage percentage is reported, formatted as a date.\n- **value** (`Float64`): The gas usage percentage for the month, rounded to two decimal places.","operationId":"api_execution_blocks_gas_usage_pct_monthly_get_v1_execution_blocks_gas_usage_pct_monthly_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"date":{"type":"string","format":"date","description":"The month for which the gas usage percentage is reported, formatted as a date."},"value":{"type":"number","description":"The gas usage percentage for the month, rounded to two decimal places."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/blocks_per_clients_count/daily":{"get":{"tags":["Execution"],"summary":"Blocks Per Clients Count (daily)","description":"**Required Access:** `tier1`\n\nThe api_execution_blocks_clients_cnt_daily model provides daily aggregated counts of API execution blocks per client, supporting operational monitoring and capacity planning.\n\n**Columns:**\n- **date** (`Date`): The specific calendar date for the recorded data, formatted as YYYY-MM-DD.\n- **client** (`String`): The identifier for the client associated with the API execution blocks.\n- **value** (`UInt64`): The count of API execution blocks for the given client on the specified date.","operationId":"api_execution_blocks_clients_cnt_daily_get_v1_execution_blocks_per_clients_count_daily_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"date":{"type":"string","format":"date","description":"The specific calendar date for the recorded data, formatted as YYYY-MM-DD."},"client":{"type":"string","description":"The identifier for the client associated with the API execution blocks."},"value":{"type":"integer","description":"The count of API execution blocks for the given client on the specified date."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/blocks_per_clients_pct/daily":{"get":{"tags":["Execution"],"summary":"Blocks Per Clients Pct (daily)","description":"**Required Access:** `tier1`\n\nThe api_execution_blocks_clients_pct_daily model provides daily percentage metrics of API execution blocks per client, facilitating monitoring of client-specific API usage patterns over time.\n\n**Columns:**\n- **date** (`Date`): The specific calendar date for the recorded metrics.\n- **client** (`String`): Identifier for the client associated with the API execution data.\n- **value** (`Float64`): The percentage of execution blocks for the client on the given date, rounded to two decimal places.","operationId":"api_execution_blocks_clients_pct_daily_get_v1_execution_blocks_per_clients_pct_daily_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"date":{"type":"string","format":"date","description":"The specific calendar date for the recorded metrics."},"client":{"type":"string","description":"Identifier for the client associated with the API execution data."},"value":{"type":"number","description":"The percentage of execution blocks for the client on the given date, rounded to two decimal places."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/circles_backers_current/daily":{"get":{"tags":["Execution"],"summary":"Circles Backers Current (daily)","description":"**Required Access:** `tier1`\n\nTime-series of currently-trusted (revocation-aware) backers; latest day excluded. Distinct from api:circles_v2_backers_cumulative (ever-backed).\n\n**Columns:**\n- **date** (`Date`): Calendar day (UTC).\n- **currently_trusted_backers** (`UInt64`): Distinct backers whose backers-group trust interval is open as of the end of this day (revocation-aware).","operationId":"api_execution_circles_v2_backers_current_daily_get_v1_execution_circles_backers_current_daily_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"date":{"type":"string","format":"date","description":"Calendar day (UTC)."},"currently_trusted_backers":{"type":"integer","description":"Distinct backers whose backers-group trust interval is open as of the end of this day (revocation-aware)."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/circles_v2_active_minters/daily":{"get":{"tags":["Execution"],"summary":"Circles V2 Active Minters (daily)","description":"**Required Access:** `tier1`\n\nTime-series view over fct_execution_circles_v2_active_minters_daily; latest day excluded.\n\n**Columns:**\n- **date** (`Date`): Calendar day (UTC).\n- **active_minters** (`UInt64`): Distinct avatars meeting the active-minter criteria on this day.","operationId":"api_execution_circles_v2_active_minters_daily_get_v1_execution_circles_v2_active_minters_daily_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"date":{"type":"string","format":"date","description":"Calendar day (UTC)."},"active_minters":{"type":"integer","description":"Distinct avatars meeting the active-minter criteria on this day."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/circles_v2_active_trusts/daily":{"get":{"tags":["Execution"],"summary":"Circles V2 Active Trusts (daily)","description":"**Required Access:** `tier1`\n\nAPI view of daily active trust count time series.\n\n**Columns:**\n- **date** (`Date`): Calendar date.\n- **new_trusts** (`Int64`): Trust relationships created on this date.\n- **revoked_trusts** (`Int64`): Trust relationships revoked/expired on this date.\n- **active_trusts** (`Int64`): Cumulative active trust count.","operationId":"api_execution_circles_v2_active_trusts_daily_get_v1_execution_circles_v2_active_trusts_daily_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"date":{"type":"string","format":"date","description":"Calendar date."},"new_trusts":{"type":"integer","description":"Trust relationships created on this date."},"revoked_trusts":{"type":"integer","description":"Trust relationships revoked/expired on this date."},"active_trusts":{"type":"integer","description":"Cumulative active trust count."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/circles_v2_active_trusts_cnt/latest":{"get":{"tags":["Execution"],"summary":"Circles V2 Active Trusts Cnt (latest)","description":"**Required Access:** `tier1`\n\nLatest active trust count with 7-day change percentage.\n\n**Columns:**\n- **total** (`UInt64`): Current active trust count.\n- **change_pct** (`Float64`): 7-day percentage change.\n- **as_of_date** (`Date`): Date the snapshot is computed as of (max date in the underlying data).","operationId":"api_execution_circles_v2_active_trusts_cnt_latest_get_v1_execution_circles_v2_active_trusts_cnt_latest_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"total":{"type":"integer","description":"Current active trust count."},"change_pct":{"type":"number","description":"7-day percentage change."},"as_of_date":{"type":"string","format":"date","description":"Date the snapshot is computed as of (max date in the underlying data)."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/circles_v2_avatar_balances/daily":{"get":{"tags":["Execution"],"summary":"Circles V2 Avatar Balances (daily)","description":"**Required Access:** `tier1`\n\nDaily CRC balance per avatar broken down by token (one row per avatar/date/token).\n\n**Columns:**\n- **avatar** (`String`): Address of the avatar.\n- **date** (`Date`): Calendar date of the balance snapshot.\n- **token_address** (`String`): Address of the Circles token contract held on that date.\n- **balance** (`Float64`): Static balance held in the token on that date.\n- **balance_demurraged** (`Float64`): Demurrage-adjusted balance held in the token on that date.","operationId":"api_execution_circles_v2_avatar_balances_daily_get_v1_execution_circles_v2_avatar_balances_daily_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"avatar":{"type":"string","description":"Address of the avatar."},"date":{"type":"string","format":"date","description":"Calendar date of the balance snapshot."},"token_address":{"type":"string","description":"Address of the Circles token contract held on that date."},"balance":{"type":"number","description":"Static balance held in the token on that date."},"balance_demurraged":{"type":"number","description":"Demurrage-adjusted balance held in the token on that date."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/circles_v2_avatar_balances/snapshot":{"get":{"tags":["Execution"],"summary":"Circles V2 Avatar Balances (snapshot)","description":"**Required Access:** `tier1`\n\nLatest per-(avatar, token) CRC balance snapshot with an is_wrapped flag\nindicating whether the token_address is an ERC-20 wrapper. Thin\npassthrough over fct_execution_circles_v2_avatar_balances_latest, which\nis materialised daily from the per-day balance fact joined to the\ndistinct wrapper registry.\n\n\n**Columns:**\n- **avatar** (`String`): Address of the avatar holding the balance.\n- **token_address** (`String`): Address of the Circles token contract.\n- **is_wrapped** (`Bool`): True when the token is an ERC-20 wrapper around a personal CRC token (registered in `int_execution_circles_v2_wrappers`); false when it is the underlying ERC-1155 personal CRC token.\n- **balance** (`Float64`): Static balance in token units (raw / 1e18).\n- **balance_demurraged** (`Float64`): Demurrage-adjusted balance in token units.\n- **as_of_date** (`Date`): Date the snapshot is computed as of (max date in the underlying data).","operationId":"api_execution_circles_v2_avatar_balances_latest_get_v1_execution_circles_v2_avatar_balances_snapshot_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"avatar":{"type":"string","description":"Address of the avatar holding the balance."},"token_address":{"type":"string","description":"Address of the Circles token contract."},"is_wrapped":{"type":"boolean","description":"True when the token is an ERC-20 wrapper around a personal CRC token (registered in `int_execution_circles_v2_wrappers`); false when it is the underlying ERC-1155 personal CRC token."},"balance":{"type":"number","description":"Static balance in token units (raw / 1e18)."},"balance_demurraged":{"type":"number","description":"Demurrage-adjusted balance in token units."},"as_of_date":{"type":"string","format":"date","description":"Date the snapshot is computed as of (max date in the underlying data)."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/circles_v2_avatar_metadata/snapshot":{"get":{"tags":["Execution"],"summary":"Circles V2 Avatar Metadata (snapshot)","description":"**Required Access:** `tier1`\n\nPer-avatar identity for Circles v2: on-chain registration metadata\n(avatar type, on-chain name, inviter, token_id, registration timestamp)\njoined to the most recently fetched IPFS profile from\nint_execution_circles_v2_avatar_metadata (display name,\npreview/image URLs, description, current digest / CID / gateway URL,\nfetched_at). Backs the \"Avatar Identity\" panel on the Circles dashboard.\n\n\n**Columns:**\n- **avatar** (`String`): Address of the registered avatar.\n- **avatar_type** (`String`): Avatar category (Human, Group, Org).\n- **invited_by** (`String`): Address of the avatar that invited this avatar (NULL for Groups/Orgs).\n- **name** (`String`): On-chain name set at registration (NULL for Humans).\n- **token_id** (`String`): Personal token contract address (NULL for Orgs).\n- **registered_at** (`DateTime64`): UTC timestamp of the registration event.\n- **current_metadata_digest** (`Nullable(String)`): 0x-prefixed hex digest of the most recent metadata payload announced for this avatar by NameRegistry. NULL when the avatar has never published an IPFS profile.\n- **current_ipfs_cid_v0** (`Nullable(String)`): CIDv0 derived from `current_metadata_digest`.\n- **current_gateway_url** (`Nullable(String)`): Full IPFS gateway URL for the current digest using the configured `circles_ipfs_gateway` var.\n- **metadata_name** (`String`): Display `name` field extracted from the current IPFS profile JSON. Populated for ~99.9% of resolved avatars.\n- **metadata_symbol** (`String`): `symbol` field extracted from the current profile JSON. Rarely populated (group/org tokens only).\n- **metadata_description** (`String`): `description` field extracted from the current profile JSON. Populated for ~20% of avatars.\n- **metadata_image_url** (`String`): `imageUrl` field from the current profile JSON. Rarely populated (~1.5%); prefer `metadata_preview_image_url` for thumbnails.\n- **metadata_preview_image_url** (`String`): `previewImageUrl` field from the current profile JSON. Populated for ~53% of avatars.\n- **metadata_fetched_at** (`Nullable(DateTime)`): Timestamp the current IPFS payload was fetched from the gateway.\n- **as_of_date** (`Date`): Date the snapshot is computed as of (max date in the underlying data).","operationId":"api_execution_circles_v2_avatar_metadata_get_v1_execution_circles_v2_avatar_metadata_snapshot_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"avatar":{"type":"string","description":"Address of the registered avatar."},"avatar_type":{"type":"string","description":"Avatar category (Human, Group, Org)."},"invited_by":{"type":"string","description":"Address of the avatar that invited this avatar (NULL for Groups/Orgs)."},"name":{"type":"string","description":"On-chain name set at registration (NULL for Humans)."},"token_id":{"type":"string","description":"Personal token contract address (NULL for Orgs)."},"registered_at":{"type":"string","format":"date-time","description":"UTC timestamp of the registration event."},"current_metadata_digest":{"type":"string","description":"0x-prefixed hex digest of the most recent metadata payload announced for this avatar by NameRegistry. NULL when the avatar has never published an IPFS profile."},"current_ipfs_cid_v0":{"type":"string","description":"CIDv0 derived from `current_metadata_digest`."},"current_gateway_url":{"type":"string","description":"Full IPFS gateway URL for the current digest using the configured `circles_ipfs_gateway` var."},"metadata_name":{"type":"string","description":"Display `name` field extracted from the current IPFS profile JSON. Populated for ~99.9% of resolved avatars."},"metadata_symbol":{"type":"string","description":"`symbol` field extracted from the current profile JSON. Rarely populated (group/org tokens only)."},"metadata_description":{"type":"string","description":"`description` field extracted from the current profile JSON. Populated for ~20% of avatars."},"metadata_image_url":{"type":"string","description":"`imageUrl` field from the current profile JSON. Rarely populated (~1.5%); prefer `metadata_preview_image_url` for thumbnails."},"metadata_preview_image_url":{"type":"string","description":"`previewImageUrl` field from the current profile JSON. Populated for ~53% of avatars."},"metadata_fetched_at":{"type":"string","format":"date-time","description":"Timestamp the current IPFS payload was fetched from the gateway."},"as_of_date":{"type":"string","format":"date","description":"Date the snapshot is computed as of (max date in the underlying data)."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/circles_v2_avatar_metadata_history/history":{"get":{"tags":["Execution"],"summary":"Circles V2 Avatar Metadata History (history)","description":"**Required Access:** `tier1`\n\nHistorical timeline of every Circles v2 avatar metadata change. Thin\npassthrough over int_execution_circles_v2_avatar_metadata_history with\none row per (avatar, metadata_digest) ever announced, in event order,\ncarrying valid_from / valid_to / is_current and the parsed IPFS profile\nfields (name, symbol, description, imageUrl, previewImageUrl) so the\ndashboard can render the full sequence of name + image updates per\navatar.\n\n\n**Columns:**\n- **avatar** (`String`): Address of the registered avatar.\n- **avatar_type** (`String`): Avatar category (Human, Group, Org).\n- **onchain_name** (`Nullable(String)`): On-chain name set at registration (Group/Org only).\n- **metadata_digest** (`String`): 0x-prefixed hex digest emitted by this UpdateMetadataDigest event.\n- **ipfs_cid_v0** (`String`): CIDv0 derived from `metadata_digest`.\n- **gateway_url** (`String`): Full IPFS gateway URL for this digest version.\n- **valid_from** (`DateTime64`): Timestamp of the on-chain UpdateMetadataDigest event that introduced this digest.\n- **valid_to** (`Nullable(DateTime64)`): Timestamp of the next UpdateMetadataDigest event for this avatar. NULL on the most recent row.\n- **is_current** (`Bool`): True when this row is the most recent metadata digest for the avatar.\n- **transaction_hash** (`String`): Transaction hash of the on-chain event.\n- **log_index** (`UInt32`): Log index of the on-chain event.\n- **metadata_name** (`String`): Display `name` field extracted from this historical version's profile JSON.\n- **metadata_symbol** (`String`): `symbol` field extracted from this historical version's profile JSON.\n- **metadata_description** (`String`): `description` field extracted from this historical version's profile JSON.\n- **metadata_image_url** (`String`): `imageUrl` field from this historical version's profile JSON.\n- **metadata_preview_image_url** (`String`): `previewImageUrl` field from this historical version's profile JSON.\n- **metadata_fetched_at** (`Nullable(DateTime)`): Timestamp the IPFS payload for this digest was fetched from the gateway.\n- **as_of_date** (`Date`): Date the snapshot is computed as of (max date in the underlying data).","operationId":"api_execution_circles_v2_avatar_metadata_history_get_v1_execution_circles_v2_avatar_metadata_history_history_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"avatar":{"type":"string","description":"Address of the registered avatar."},"avatar_type":{"type":"string","description":"Avatar category (Human, Group, Org)."},"onchain_name":{"type":"string","description":"On-chain name set at registration (Group/Org only)."},"metadata_digest":{"type":"string","description":"0x-prefixed hex digest emitted by this UpdateMetadataDigest event."},"ipfs_cid_v0":{"type":"string","description":"CIDv0 derived from `metadata_digest`."},"gateway_url":{"type":"string","description":"Full IPFS gateway URL for this digest version."},"valid_from":{"type":"string","format":"date-time","description":"Timestamp of the on-chain UpdateMetadataDigest event that introduced this digest."},"valid_to":{"type":"string","format":"date-time","description":"Timestamp of the next UpdateMetadataDigest event for this avatar. NULL on the most recent row."},"is_current":{"type":"boolean","description":"True when this row is the most recent metadata digest for the avatar."},"transaction_hash":{"type":"string","description":"Transaction hash of the on-chain event."},"log_index":{"type":"integer","description":"Log index of the on-chain event."},"metadata_name":{"type":"string","description":"Display `name` field extracted from this historical version's profile JSON."},"metadata_symbol":{"type":"string","description":"`symbol` field extracted from this historical version's profile JSON."},"metadata_description":{"type":"string","description":"`description` field extracted from this historical version's profile JSON."},"metadata_image_url":{"type":"string","description":"`imageUrl` field from this historical version's profile JSON."},"metadata_preview_image_url":{"type":"string","description":"`previewImageUrl` field from this historical version's profile JSON."},"metadata_fetched_at":{"type":"string","format":"date-time","description":"Timestamp the IPFS payload for this digest was fetched from the gateway."},"as_of_date":{"type":"string","format":"date","description":"Date the snapshot is computed as of (max date in the underlying data)."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/circles_v2_avatar_mint_activity/daily":{"get":{"tags":["Execution"],"summary":"Circles V2 Avatar Mint Activity (daily)","description":"**Required Access:** `tier1`\n\nDaily personal-mint activity per Circles v2 avatar.\n\nA Circles v2 personal mint is a Hub TransferSingle event where\nfrom_address is the zero address (0x0000…0000) and the recipient is\nthe avatar itself. Each row in int_execution_circles_v2_hub_transfers\nmatching that shape represents one personalMint() call (or the\nunscheduled mint that happens during a transfer).\n\nOutput is one row per (avatar, date) with the number of mint events\nand the total amount minted that day (raw / 1e18). Backs the \"Mint\nActivity\" panel on the Circles Avatar tab.\n\n\n**Columns:**\n- **avatar** (`String`): Address of the avatar receiving the mint.\n- **date** (`Date`): Calendar date of the mint events (UTC).\n- **mint_events** (`UInt64`): Number of personalMint() calls that landed on this day for the avatar.\n- **amount_minted** (`Float64`): Total CRC minted to the avatar on this day (raw / 1e18).","operationId":"api_execution_circles_v2_avatar_mint_activity_daily_get_v1_execution_circles_v2_avatar_mint_activity_daily_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"avatar":{"type":"string","description":"Address of the avatar receiving the mint."},"date":{"type":"string","format":"date","description":"Calendar date of the mint events (UTC)."},"mint_events":{"type":"integer","description":"Number of personalMint() calls that landed on this day for the avatar."},"amount_minted":{"type":"number","description":"Total CRC minted to the avatar on this day (raw / 1e18)."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/circles_v2_avatar_personal_token_supply/latest":{"get":{"tags":["Execution"],"summary":"Circles V2 Avatar Personal Token Supply (latest)","description":"**Required Access:** `tier1`\n\nOne-row-per-avatar summary of a Circles v2 avatar's own personal CRC\ntoken: total circulating supply, how much is wrapped as ERC-20, and\nthe wrapped share. Thin passthrough over\nfct_execution_circles_v2_avatar_personal_token_supply_latest, which\nrolls up fct_execution_circles_v2_avatar_token_distribution so the\nsupply respects the same 0.001 CRC dust threshold used by the\ndistribution fact.\n\n\n**Columns:**\n- **avatar** (`String`): The avatar whose personal CRC token is being summarised.\n- **supply** (`Float64`): Circulating supply of this avatar's personal CRC (sum of balances across all holder categories).\n- **wrapped** (`Float64`): Portion of the supply currently held by the avatar's ERC-20 wrapper contracts.\n- **unwrapped** (`Float64`): Portion of the supply held as native ERC-1155 (supply − wrapped).\n- **wrapped_pct** (`Nullable(Float64)`): wrapped / supply × 100, rounded to 1 decimal. NULL when supply = 0.\n- **supply_demurraged** (`Float64`): Demurrage-adjusted equivalent of supply.\n- **wrapped_demurraged** (`Float64`): Demurrage-adjusted equivalent of wrapped.\n- **as_of_date** (`Date`): Date the snapshot is computed as of (max date in the underlying data).","operationId":"api_execution_circles_v2_avatar_personal_token_supply_latest_get_v1_execution_circles_v2_avatar_personal_token_supply_latest_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"avatar":{"type":"string","description":"The avatar whose personal CRC token is being summarised."},"supply":{"type":"number","description":"Circulating supply of this avatar's personal CRC (sum of balances across all holder categories)."},"wrapped":{"type":"number","description":"Portion of the supply currently held by the avatar's ERC-20 wrapper contracts."},"unwrapped":{"type":"number","description":"Portion of the supply held as native ERC-1155 (supply − wrapped)."},"wrapped_pct":{"type":"number","description":"wrapped / supply × 100, rounded to 1 decimal. NULL when supply = 0."},"supply_demurraged":{"type":"number","description":"Demurrage-adjusted equivalent of supply."},"wrapped_demurraged":{"type":"number","description":"Demurrage-adjusted equivalent of wrapped."},"as_of_date":{"type":"string","format":"date","description":"Date the snapshot is computed as of (max date in the underlying data)."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/circles_v2_avatar_search/snapshot":{"get":{"tags":["Execution"],"summary":"Circles V2 Avatar Search (snapshot)","description":"**Required Access:** `tier1`\n\nLightweight (avatar, display_name) lookup used by the dashboard global\nfilter to support searching avatars by display name OR address. Two\ncolumns, one row per registered Circles v2 avatar (sourced from\napi_execution_circles_v2_avatar_metadata). display_name prefers the\nIPFS profile name and falls back to the on-chain name (Group/Org only)\nso every row has something usable to search against; the avatar\naddress is always present.\n\n\n**Columns:**\n- **avatar** (`String`): Address of the registered avatar.\n- **display_name** (`String`): IPFS profile name with on-chain name fallback (empty when neither is set).\n- **as_of_date** (`Date`): Date the snapshot is computed as of (max date in the underlying data).","operationId":"api_execution_circles_v2_avatar_search_get_v1_execution_circles_v2_avatar_search_snapshot_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"avatar":{"type":"string","description":"Address of the registered avatar."},"display_name":{"type":"string","description":"IPFS profile name with on-chain name fallback (empty when neither is set)."},"as_of_date":{"type":"string","format":"date","description":"Date the snapshot is computed as of (max date in the underlying data)."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/circles_v2_avatar_token_distribution/latest":{"get":{"tags":["Execution"],"summary":"Circles V2 Avatar Token Distribution (latest)","description":"**Required Access:** `tier1`\n\nPer-avatar distribution of holders of a Circles v2 personal CRC token\n(the ERC-1155 token whose token_address equals the avatar address).\nThin passthrough over fct_execution_circles_v2_avatar_token_distribution,\nwhich classifies every current holder (above the 0.001 CRC dust\nthreshold) as one of: Self (the avatar itself holds its own CRC),\nWrapped (ERC-20) (held by an ERC20Lift wrapper contract registered for\nthis avatar), Other Circles avatars (any other registered avatar), or\nOther contracts (DEX pools, custodians, etc.). One row per (avatar,\nholder_category); the dashboard's avatar global filter selects which\navatar's token distribution to inspect.\n\n\n**Columns:**\n- **avatar** (`String`): The avatar whose personal CRC token is being inspected.\n- **holder_category** (`String`): One of Self, Wrapped (ERC-20), Other Circles avatars, Other contracts.\n- **holder_count** (`UInt64`): Number of distinct accounts in this category that hold the avatar's CRC token (above the 0.001 CRC dust threshold).\n- **balance** (`Float64`): Sum of static CRC balances held by accounts in this category.\n- **balance_demurraged** (`Float64`): Sum of demurrage-adjusted CRC balances held by accounts in this category.\n- **as_of_date** (`Date`): Date the snapshot is computed as of (max date in the underlying data).","operationId":"api_execution_circles_v2_avatar_token_distribution_get_v1_execution_circles_v2_avatar_token_distribution_latest_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"avatar":{"type":"string","description":"The avatar whose personal CRC token is being inspected."},"holder_category":{"type":"string","description":"One of Self, Wrapped (ERC-20), Other Circles avatars, Other contracts."},"holder_count":{"type":"integer","description":"Number of distinct accounts in this category that hold the avatar's CRC token (above the 0.001 CRC dust threshold)."},"balance":{"type":"number","description":"Sum of static CRC balances held by accounts in this category."},"balance_demurraged":{"type":"number","description":"Sum of demurrage-adjusted CRC balances held by accounts in this category."},"as_of_date":{"type":"string","format":"date","description":"Date the snapshot is computed as of (max date in the underlying data)."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/circles_v2_avatar_tokens_held_count/latest":{"get":{"tags":["Execution"],"summary":"Circles V2 Avatar Tokens Held Count (latest)","description":"**Required Access:** `tier1`\n\nPer-avatar count of distinct CRC tokens currently held with a balance\nabove the 0.001 CRC dust threshold (1e15 raw wei). Thin passthrough\nover fct_execution_circles_v2_avatar_tokens_held_count, which is\nmaterialised daily from int_execution_circles_v2_balances_daily on the\nlast completed day. Backs the \"Tokens Held\" KPI card on the Circles\nAvatar tab.\n\n\n**Columns:**\n- **avatar** (`String`): Address of the avatar holding the tokens.\n- **tokens_held_count** (`UInt64`): Number of distinct token contracts the avatar holds with > 0.001 CRC.\n- **as_of_date** (`Date`): Date the snapshot is computed as of (max date in the underlying data).","operationId":"api_execution_circles_v2_avatar_tokens_held_count_get_v1_execution_circles_v2_avatar_tokens_held_count_latest_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"avatar":{"type":"string","description":"Address of the avatar holding the tokens."},"tokens_held_count":{"type":"integer","description":"Number of distinct token contracts the avatar holds with > 0.001 CRC."},"as_of_date":{"type":"string","format":"date","description":"Date the snapshot is computed as of (max date in the underlying data)."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/circles_v2_avatar_trust_network/snapshot":{"get":{"tags":["Execution"],"summary":"Circles V2 Avatar Trust Network (snapshot)","description":"**Required Access:** `tier1`\n\nTrust-network edge list for the Circles v2 Avatar Trust Network panel.\n\nOne row per directed trust edge from the perspective of the focal\navatar. For mutual relationships TWO rows are emitted (avatar →\ncounterparty AND counterparty → avatar) so the chart renders both\narrows. The dashboard's avatar global filter scopes rows to one focal\navatar — ClickHouse pushes that filter down into each UNION branch, so\nper-request cost stays small despite the apparent size of the query.\nMaterialising this globally would produce ~millions of rows × long IPFS\nstrings and blow the memory budget, so this stays a view on purpose.\n\nEach row carries display name and IPFS preview image for both\nendpoints (joined from api_execution_circles_v2_avatar_metadata). The\ndashboard graph chart consumes these via sourceImageField /\ntargetImageField to render avatar thumbnails on the nodes. The\ntarget_layer / source_layer columns drive the chart's concentric\nlayout: \"Focal avatar\" lives at the centre, \"Mutual\" forms the inner\nring, \"Trust given\" the middle ring, \"Trust received\" the outer ring.\n\n\n**Columns:**\n- **avatar** (`String`): The focal avatar this row belongs to (used by the dashboard's avatar global filter).\n- **source_id** (`String`): Address of the truster on this edge.\n- **target_id** (`String`): Address of the trustee on this edge.\n- **source_name** (`String`): Display name of the source endpoint (IPFS profile name → on-chain name → truncated address).\n- **target_name** (`String`): Display name of the target endpoint (IPFS profile name → on-chain name → truncated address).\n- **source_image** (`String`): IPFS preview image URL of the source endpoint, or empty when no profile image is published.\n- **target_image** (`String`): IPFS preview image URL of the target endpoint, or empty when no profile image is published.\n- **direction** (`String`): One of \"Mutual\" / \"Trust given\" / \"Trust received\" — drives the edgeStyleField on the dashboard graph panel so each direction renders in its own colour. Mutual relationships emit two rows (one per direction) so both arrows render.\n- **source_layer** (`String`): Concentric ring assignment for the source endpoint. \"Focal avatar\" when the source IS the focal avatar (centre), otherwise the direction label (Mutual / Trust given / Trust received) so the counterparty lands on the correct ring.\n- **target_layer** (`String`): Concentric ring assignment for the target endpoint. \"Focal avatar\" when the target IS the focal avatar (centre), otherwise the direction label.\n- **value** (`UInt8`): Constant 1 (trust edges are unweighted; the column exists so the chart engine can size nodes by degree).\n- **as_of_date** (`Date`): Date the snapshot is computed as of (max date in the underlying data).","operationId":"api_execution_circles_v2_avatar_trust_network_get_v1_execution_circles_v2_avatar_trust_network_snapshot_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"avatar":{"type":"string","description":"The focal avatar this row belongs to (used by the dashboard's avatar global filter)."},"source_id":{"type":"string","description":"Address of the truster on this edge."},"target_id":{"type":"string","description":"Address of the trustee on this edge."},"source_name":{"type":"string","description":"Display name of the source endpoint (IPFS profile name → on-chain name → truncated address)."},"target_name":{"type":"string","description":"Display name of the target endpoint (IPFS profile name → on-chain name → truncated address)."},"source_image":{"type":"string","description":"IPFS preview image URL of the source endpoint, or empty when no profile image is published."},"target_image":{"type":"string","description":"IPFS preview image URL of the target endpoint, or empty when no profile image is published."},"direction":{"type":"string","description":"One of \"Mutual\" / \"Trust given\" / \"Trust received\" — drives the edgeStyleField on the dashboard graph panel so each direction renders in its own colour. Mutual relationships emit two rows (one per direction) so both arrows render."},"source_layer":{"type":"string","description":"Concentric ring assignment for the source endpoint. \"Focal avatar\" when the source IS the focal avatar (centre), otherwise the direction label (Mutual / Trust given / Trust received) so the counterparty lands on the correct ring."},"target_layer":{"type":"string","description":"Concentric ring assignment for the target endpoint. \"Focal avatar\" when the target IS the focal avatar (centre), otherwise the direction label."},"value":{"type":"integer","description":"Constant 1 (trust edges are unweighted; the column exists so the chart engine can size nodes by degree)."},"as_of_date":{"type":"string","format":"date","description":"Date the snapshot is computed as of (max date in the underlying data)."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/circles_v2_avatar_trust_relations/snapshot":{"get":{"tags":["Execution"],"summary":"Circles V2 Avatar Trust Relations (snapshot)","description":"**Required Access:** `tier1`\n\nCurrent active trust relations pivoted to one row per (avatar, counterparty) pair with direction (outgoing, incoming, or mutual) and the timestamps of each direction.\n\n**Columns:**\n- **avatar** (`String`): The avatar address.\n- **counterparty** (`String`): The other side of the trust relation.\n- **direction** (`String`): outgoing if avatar trusts counterparty only; incoming if counterparty trusts avatar only; mutual if both directions exist.\n- **outgoing_from** (`DateTime64`): Start timestamp of the outgoing trust (avatar -> counterparty); NULL if no outgoing trust exists.\n- **incoming_from** (`DateTime64`): Start timestamp of the incoming trust (counterparty -> avatar); NULL if no incoming trust exists.\n- **as_of_date** (`Date`): Date the snapshot is computed as of (max date in the underlying data).","operationId":"api_execution_circles_v2_avatar_trust_relations_get_v1_execution_circles_v2_avatar_trust_relations_snapshot_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"avatar":{"type":"string","description":"The avatar address."},"counterparty":{"type":"string","description":"The other side of the trust relation."},"direction":{"type":"string","description":"outgoing if avatar trusts counterparty only; incoming if counterparty trusts avatar only; mutual if both directions exist."},"outgoing_from":{"type":"string","format":"date-time","description":"Start timestamp of the outgoing trust (avatar -> counterparty); NULL if no outgoing trust exists."},"incoming_from":{"type":"string","format":"date-time","description":"Start timestamp of the incoming trust (counterparty -> avatar); NULL if no incoming trust exists."},"as_of_date":{"type":"string","format":"date","description":"Date the snapshot is computed as of (max date in the underlying data)."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/circles_v2_avatar_trusts/daily":{"get":{"tags":["Execution"],"summary":"Circles V2 Avatar Trusts (daily)","description":"**Required Access:** `tier1`\n\nDaily cumulative trusts given and received per avatar.\n\n**Columns:**\n- **avatar** (`String`): Address of the avatar.\n- **date** (`Date`): Calendar date.\n- **trusts_given_count** (`Int64`): Cumulative count of outgoing trust relationships.\n- **trusts_received_count** (`Int64`): Cumulative count of incoming trust relationships.","operationId":"api_execution_circles_v2_avatar_trusts_daily_get_v1_execution_circles_v2_avatar_trusts_daily_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"avatar":{"type":"string","description":"Address of the avatar."},"date":{"type":"string","format":"date","description":"Calendar date."},"trusts_given_count":{"type":"integer","description":"Cumulative count of outgoing trust relationships."},"trusts_received_count":{"type":"integer","description":"Cumulative count of incoming trust relationships."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/circles_v2_avatar_trusts_summary/latest":{"get":{"tags":["Execution"],"summary":"Circles V2 Avatar Trusts Summary (latest)","description":"**Required Access:** `tier1`\n\nLatest snapshot of cumulative trusts given and received per avatar.\n\n**Columns:**\n- **avatar** (`String`): Address of the avatar.\n- **trusts_given_count** (`Int64`): Cumulative count of outgoing trust relationships at latest day.\n- **trusts_received_count** (`Int64`): Cumulative count of incoming trust relationships at latest day.\n- **as_of_date** (`Date`): Date the snapshot is computed as of (max date in the underlying data).","operationId":"api_execution_circles_v2_avatar_trusts_summary_get_v1_execution_circles_v2_avatar_trusts_summary_latest_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"avatar":{"type":"string","description":"Address of the avatar."},"trusts_given_count":{"type":"integer","description":"Cumulative count of outgoing trust relationships at latest day."},"trusts_received_count":{"type":"integer","description":"Cumulative count of incoming trust relationships at latest day."},"as_of_date":{"type":"string","format":"date","description":"Date the snapshot is computed as of (max date in the underlying data)."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/circles_v2_avatars/daily":{"get":{"tags":["Execution"],"summary":"Circles V2 Avatars (daily)","description":"**Required Access:** `tier1`\n\nAPI view of daily avatar type counts and cumulative totals.\n\n**Columns:**\n- **date** (`Date`): The specific date of the recorded avatar usage data.\n- **avatar_type** (`String`): The category or type of avatar (Human, Group, Organization).\n- **cnt** (`UInt64`): The number of new avatars registered on the given date.\n- **total** (`UInt64`): The cumulative total of avatars of this type up to the given date.","operationId":"api_execution_circles_v2_avatars_get_v1_execution_circles_v2_avatars_daily_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"date":{"type":"string","format":"date","description":"The specific date of the recorded avatar usage data."},"avatar_type":{"type":"string","description":"The category or type of avatar (Human, Group, Organization)."},"cnt":{"type":"integer","description":"The number of new avatars registered on the given date."},"total":{"type":"integer","description":"The cumulative total of avatars of this type up to the given date."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/circles_v2_avatars_current/snapshot":{"get":{"tags":["Execution"],"summary":"Circles V2 Avatars Current (snapshot)","description":"**Required Access:** `tier1`\n\nAPI view of current Circles v2 avatar registrations.\n\n**Columns:**\n- **block_number** (`UInt64`): Block number of the latest registration event.\n- **block_timestamp** (`DateTime`): Block timestamp of the latest registration event.\n- **transaction_hash** (`String`): Transaction hash of the latest registration event.\n- **transaction_index** (`UInt64`): Transaction index within the block.\n- **log_index** (`UInt64`): Log index within the transaction.\n- **avatar_type** (`String`): Type of avatar (Human, Org, Group).\n- **invited_by** (`String`): Address of the avatar that invited this avatar.\n- **avatar** (`String`): Address of the registered avatar.\n- **token_id** (`String`): Token ID associated with the avatar.\n- **name** (`String`): Display name of the avatar.","operationId":"api_execution_circles_v2_avatars_current_get_v1_execution_circles_v2_avatars_current_snapshot_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"block_number":{"type":"integer","description":"Block number of the latest registration event."},"block_timestamp":{"type":"string","format":"date-time","description":"Block timestamp of the latest registration event."},"transaction_hash":{"type":"string","description":"Transaction hash of the latest registration event."},"transaction_index":{"type":"integer","description":"Transaction index within the block."},"log_index":{"type":"integer","description":"Log index within the transaction."},"avatar_type":{"type":"string","description":"Type of avatar (Human, Org, Group)."},"invited_by":{"type":"string","description":"Address of the avatar that invited this avatar."},"avatar":{"type":"string","description":"Address of the registered avatar."},"token_id":{"type":"string","description":"Token ID associated with the avatar."},"name":{"type":"string","description":"Display name of the avatar."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/circles_v2_backers_cumulative/daily":{"get":{"tags":["Execution"],"summary":"Circles V2 Backers Cumulative (daily)","description":"**Required Access:** `tier1`\n\nTime-series view of trust-defined EVER-BACKED cumulative backers (ignores revocation); latest day excluded. For the revocation-aware series see api:circles_backers_current.\n\n**Columns:**\n- **date** (`Date`): Calendar day (UTC).\n- **new_backers** (`UInt64`): Trust-defined backers first trusted by the backers group on this day.\n- **cumulative_backers** (`UInt64`): Running total of distinct trust-defined backers ever trusted up to and including this day (ignores revocation).","operationId":"api_execution_circles_v2_backers_cumulative_daily_get_v1_execution_circles_v2_backers_cumulative_daily_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"date":{"type":"string","format":"date","description":"Calendar day (UTC)."},"new_backers":{"type":"integer","description":"Trust-defined backers first trusted by the backers group on this day."},"cumulative_backers":{"type":"integer","description":"Running total of distinct trust-defined backers ever trusted up to and including this day (ignores revocation)."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/circles_v2_backing_depositors_current/latest":{"get":{"tags":["Execution"],"summary":"Circles V2 Backing Depositors Current (latest)","description":"**Required Access:** `tier1`\n\nSnapshot of distinct depositor addresses.\n\n**Columns:**\n- **backer** (`String`): Depositor address (emitted at least one backing event).\n- **first_initiated_at** (`DateTime`): Timestamp of the depositor's earliest backing event.\n- **last_event_at** (`DateTime`): Timestamp of the depositor's most recent backing event.\n- **n_initiated** (`UInt64`): Number of 'initiated' backing events by this depositor.\n- **n_completed** (`UInt64`): Number of 'completed' backing events by this depositor.\n- **n_released** (`UInt64`): Number of 'released' backing events by this depositor.\n- **n_distinct_assets** (`UInt64`): Distinct backing assets this depositor has pledged.\n- **as_of_date** (`Date`): Date the snapshot is computed as of (max date in the underlying data).","operationId":"api_execution_circles_v2_backing_depositors_current_get_v1_execution_circles_v2_backing_depositors_current_latest_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"backer":{"type":"string","description":"Depositor address (emitted at least one backing event)."},"first_initiated_at":{"type":"string","format":"date-time","description":"Timestamp of the depositor's earliest backing event."},"last_event_at":{"type":"string","format":"date-time","description":"Timestamp of the depositor's most recent backing event."},"n_initiated":{"type":"integer","description":"Number of 'initiated' backing events by this depositor."},"n_completed":{"type":"integer","description":"Number of 'completed' backing events by this depositor."},"n_released":{"type":"integer","description":"Number of 'released' backing events by this depositor."},"n_distinct_assets":{"type":"integer","description":"Distinct backing assets this depositor has pledged."},"as_of_date":{"type":"string","format":"date","description":"Date the snapshot is computed as of (max date in the underlying data)."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/circles_v2_backing_events/daily":{"get":{"tags":["Execution"],"summary":"Circles V2 Backing Events (daily)","description":"**Required Access:** `tier1`\n\nTime-series of Circles v2 backing-lifecycle events, by stage.\n\n**Columns:**\n- **date** (`Date`): Calendar day (UTC).\n- **lifecycle_stage** (`String`): Backing lifecycle stage (initiated / deployed / lbp_deployed / completed / released / asset_status_updated / global_release_updated).\n- **n_events** (`UInt64`): Number of backing events in this stage on this day.\n- **n_distinct_backers** (`UInt64`): Distinct backer addresses emitting an event in this stage on this day.\n- **n_distinct_assets** (`UInt64`): Distinct backing assets pledged in this stage on this day.","operationId":"api_execution_circles_v2_backing_events_daily_get_v1_execution_circles_v2_backing_events_daily_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"date":{"type":"string","format":"date","description":"Calendar day (UTC)."},"lifecycle_stage":{"type":"string","description":"Backing lifecycle stage (initiated / deployed / lbp_deployed / completed / released / asset_status_updated / global_release_updated)."},"n_events":{"type":"integer","description":"Number of backing events in this stage on this day."},"n_distinct_backers":{"type":"integer","description":"Distinct backer addresses emitting an event in this stage on this day."},"n_distinct_assets":{"type":"integer","description":"Distinct backing assets pledged in this stage on this day."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/circles_v2_balance_cohorts/daily":{"get":{"tags":["Execution"],"summary":"Circles V2 Balance Cohorts (daily)","description":"**Required Access:** `tier1`\n\nDaily wealth distribution: distinct CRC holders bucketed by balance tier (0-1 / 1-10 / 10-100 / 100-1k / 1k-10k / 10k-100k / 100k+). Passthrough over int_execution_circles_v2_balance_cohorts_daily, excluding the current incomplete day.\n\n\n**Columns:**\n- **date** (`Date`): Calendar date (current incomplete day excluded).\n- **balance_bucket** (`String`): Balance range bucket label (e.g. '0-1', '1-10', '100k+').\n- **holder_count** (`UInt64`): Number of distinct holders in this bucket.\n- **total_balance** (`Float64`): Sum of nominal balances in this bucket in CRC.\n- **total_demurraged_balance** (`Nullable(Float64)`): Sum of demurrage-adjusted balances in this bucket in CRC.","operationId":"api_execution_circles_v2_balance_cohorts_daily_get_v1_execution_circles_v2_balance_cohorts_daily_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"date":{"type":"string","format":"date","description":"Calendar date (current incomplete day excluded)."},"balance_bucket":{"type":"string","description":"Balance range bucket label (e.g. '0-1', '1-10', '100k+')."},"holder_count":{"type":"integer","description":"Number of distinct holders in this bucket."},"total_balance":{"type":"number","description":"Sum of nominal balances in this bucket in CRC."},"total_demurraged_balance":{"type":"number","description":"Sum of demurrage-adjusted balances in this bucket in CRC."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/circles_v2_economically_active_avatars/weekly":{"get":{"tags":["Execution"],"summary":"Circles V2 Economically Active Avatars (weekly)","description":"**Required Access:** `tier1`\n\nWeekly economically active Circles avatars (ecosystem-wide, circles-first definition) by earning_kind, with the in-app-tx subset. The Gnosis App WEAU (in-app filtered) lives at api:gnosis_app_weekly_economically_active_users.\n\n\n**Columns:**\n- **week** (`Date`): Monday-aligned start of the week (UTC).\n- **earning_kind** (`String`): 'gcrc_cashback', 'inviter_fee' or 'any'.\n- **avatars** (`UInt64`): Distinct economically active avatars (ecosystem-wide).\n- **avatars_in_app_tx** (`UInt64`): Subset whose earning events came via a Gnosis App relayer tx.","operationId":"api_execution_circles_v2_economically_active_avatars_weekly_get_v1_execution_circles_v2_economically_active_avatars_weekly_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"week":{"type":"string","format":"date","description":"Monday-aligned start of the week (UTC)."},"earning_kind":{"type":"string","description":"'gcrc_cashback', 'inviter_fee' or 'any'."},"avatars":{"type":"integer","description":"Distinct economically active avatars (ecosystem-wide)."},"avatars_in_app_tx":{"type":"integer","description":"Subset whose earning events came via a Gnosis App relayer tx."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/circles_v2_gcrc_cashback/weekly":{"get":{"tags":["Execution"],"summary":"Circles V2 Gcrc Cashback (weekly)","description":"**Required Access:** `tier1`\n\nWeekly Circles v2 gCRC cashback distribution: distinct recipient count and total gCRC amount sent from the cashback wallet to app users (weeks meeting the >= 1 gCRC threshold). The latest incomplete week is excluded.\n\n\n**Columns:**\n- **week** (`Date`): Start-of-week date (UTC, Monday start) for the cashback aggregation.\n- **n_recipients** (`UInt64`): Distinct recipients that received gCRC cashback that week.\n- **amount** (`Float64`): Total gCRC amount distributed as cashback that week.","operationId":"api_execution_circles_v2_gcrc_cashback_weekly_get_v1_execution_circles_v2_gcrc_cashback_weekly_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"week":{"type":"string","format":"date","description":"Start-of-week date (UTC, Monday start) for the cashback aggregation."},"n_recipients":{"type":"integer","description":"Distinct recipients that received gCRC cashback that week."},"amount":{"type":"number","description":"Total gCRC amount distributed as cashback that week."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/circles_v2_gcrc_cashback_cumulative/weekly":{"get":{"tags":["Execution"],"summary":"Circles V2 Gcrc Cashback Cumulative (weekly)","description":"**Required Access:** `tier1`\n\nCumulative Circles v2 gCRC cashback over time, one row per week: the running total gCRC distributed and the running count of distinct lifetime recipients (each recipient counted in the week they first received cashback).\n\n\n**Columns:**\n- **week** (`Date`): Week start (Monday, UTC).\n- **cumulative_amount** (`Float64`): Running total gCRC cashback distributed through the end of this week.\n- **cumulative_recipients** (`UInt64`): Running count of distinct lifetime cashback recipients, each counted in the week they first received cashback.","operationId":"api_execution_circles_v2_gcrc_cashback_cumulative_get_v1_execution_circles_v2_gcrc_cashback_cumulative_weekly_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"week":{"type":"string","format":"date","description":"Week start (Monday, UTC)."},"cumulative_amount":{"type":"number","description":"Running total gCRC cashback distributed through the end of this week."},"cumulative_recipients":{"type":"integer","description":"Running count of distinct lifetime cashback recipients, each counted in the week they first received cashback."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/circles_v2_gcrc_cashback_recipients_ranking/latest":{"get":{"tags":["Execution"],"summary":"Circles V2 Gcrc Cashback Recipients Ranking (latest)","description":"**Required Access:** `tier1`\n\nTop 100 lifetime recipients of Circles v2 gCRC cashback, ranked by total amount received, enriched with each recipient's avatar profile (display name and preview image).\n\n\n**Columns:**\n- **as_of_date** (`Date`): Date the snapshot was generated (today, UTC).\n- **rank** (`UInt64`): Rank by total cashback received (1 = highest).\n- **address** (`String`): Recipient avatar address.\n- **display_name** (`String`): Human-readable display name, falling back to the address when no profile name exists.\n- **preview_image_url** (`Nullable(String)`): Avatar preview image URL, if available.\n- **total_amount** (`Float64`): Total gCRC cashback received across all weeks.\n- **n_weeks** (`UInt64`): Number of distinct weeks the recipient received cashback.\n- **last_week** (`Date`): Most recent week (UTC week start) the recipient received cashback.","operationId":"api_execution_circles_v2_gcrc_cashback_recipients_ranking_get_v1_execution_circles_v2_gcrc_cashback_recipients_ranking_latest_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"as_of_date":{"type":"string","format":"date","description":"Date the snapshot was generated (today, UTC)."},"rank":{"type":"integer","description":"Rank by total cashback received (1 = highest)."},"address":{"type":"string","description":"Recipient avatar address."},"display_name":{"type":"string","description":"Human-readable display name, falling back to the address when no profile name exists."},"preview_image_url":{"type":"string","description":"Avatar preview image URL, if available."},"total_amount":{"type":"number","description":"Total gCRC cashback received across all weeks."},"n_weeks":{"type":"integer","description":"Number of distinct weeks the recipient received cashback."},"last_week":{"type":"string","format":"date","description":"Most recent week (UTC week start) the recipient received cashback."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/circles_v2_gcrc_cashback_total/latest":{"get":{"tags":["Execution"],"summary":"Circles V2 Gcrc Cashback Total (latest)","description":"**Required Access:** `tier1`\n\nLifetime (single-row) Circles v2 gCRC cashback totals for KPI tiles: the cumulative cashback amount distributed and the number of distinct recipients across all completed weeks.\n\n\n**Columns:**\n- **as_of_date** (`Date`): Snapshot date the totals were computed (today, UTC).\n- **total_amount** (`Float64`): Cumulative gCRC cashback amount distributed across all completed weeks.\n- **total_recipients** (`UInt64`): Distinct addresses that received gCRC cashback across all completed weeks.","operationId":"api_execution_circles_v2_gcrc_cashback_total_get_v1_execution_circles_v2_gcrc_cashback_total_latest_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"as_of_date":{"type":"string","format":"date","description":"Snapshot date the totals were computed (today, UTC)."},"total_amount":{"type":"number","description":"Cumulative gCRC cashback amount distributed across all completed weeks."},"total_recipients":{"type":"integer","description":"Distinct addresses that received gCRC cashback across all completed weeks."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/circles_v2_group_collateral/daily":{"get":{"tags":["Execution"],"summary":"Circles V2 Group Collateral (daily)","description":"**Required Access:** `tier1`\n\nPer-group daily member-CRC collateral (native units).\n\n**Columns:**\n- **date** (`Date`): Calendar day (UTC).\n- **group_address** (`String`): Lowercased group avatar address.\n- **collateral** (`Float64`): Member-CRC collateral held by the group at end-of-day (native units, summed across all backing token ids).","operationId":"api_execution_circles_v2_group_collateral_daily_get_v1_execution_circles_v2_group_collateral_daily_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"date":{"type":"string","format":"date","description":"Calendar day (UTC)."},"group_address":{"type":"string","description":"Lowercased group avatar address."},"collateral":{"type":"number","description":"Member-CRC collateral held by the group at end-of-day (native units, summed across all backing token ids)."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/circles_v2_group_explorer_profile/latest":{"get":{"tags":["Execution"],"summary":"Circles V2 Group Explorer Profile (latest)","description":"**Required Access:** `tier1`\n\nOne row per Circles v2 group: identity, on-chain handlers, and snapshot KPIs (members, supply, wrapped %, collateral, 7d mints, holders). Backs the Group Explorer identity header and KPI tiles.\n\n\n**Columns:**\n- **group_address** (`String`): Lowercased group avatar address.\n- **as_of_date** (`Date`): Snapshot date the row was materialized (UTC).\n- **display_name** (`String`): Group display name from metadata or on-chain fallback.\n- **preview_image_url** (`Nullable(String)`): Group avatar preview image URL from metadata.\n- **registered_at** (`DateTime`): Most recent on-chain registration timestamp for the group.\n- **invited_by** (`Nullable(String)`): Address that invited the group per metadata.\n- **owner** (`Nullable(String)`): Current group owner address.\n- **treasury_address** (`Nullable(String)`): Current treasury handler address.\n- **service** (`Nullable(String)`): Current service handler address.\n- **mint_handler** (`Nullable(String)`): Current mint handler address.\n- **redemption_handler** (`Nullable(String)`): Current redemption handler address.\n- **n_members** (`UInt64`): Current group member count.\n- **supply** (`Float64`): Current group token supply in native units.\n- **wrapped_pct** (`Float64`): Share of supply held as ERC-20 wrapper.\n- **collateral_total** (`Float64`): Latest total member-CRC collateral in native units.\n- **mints_7d** (`Float64`): Group-token minted in the last 7 days in native units.\n- **holders_count** (`UInt64`): Distinct holders of the group token.","operationId":"api_execution_circles_v2_group_explorer_profile_get_v1_execution_circles_v2_group_explorer_profile_latest_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"group_address":{"type":"string","description":"Lowercased group avatar address."},"as_of_date":{"type":"string","format":"date","description":"Snapshot date the row was materialized (UTC)."},"display_name":{"type":"string","description":"Group display name from metadata or on-chain fallback."},"preview_image_url":{"type":"string","description":"Group avatar preview image URL from metadata."},"registered_at":{"type":"string","format":"date-time","description":"Most recent on-chain registration timestamp for the group."},"invited_by":{"type":"string","description":"Address that invited the group per metadata."},"owner":{"type":"string","description":"Current group owner address."},"treasury_address":{"type":"string","description":"Current treasury handler address."},"service":{"type":"string","description":"Current service handler address."},"mint_handler":{"type":"string","description":"Current mint handler address."},"redemption_handler":{"type":"string","description":"Current redemption handler address."},"n_members":{"type":"integer","description":"Current group member count."},"supply":{"type":"number","description":"Current group token supply in native units."},"wrapped_pct":{"type":"number","description":"Share of supply held as ERC-20 wrapper."},"collateral_total":{"type":"number","description":"Latest total member-CRC collateral in native units."},"mints_7d":{"type":"number","description":"Group-token minted in the last 7 days in native units."},"holders_count":{"type":"integer","description":"Distinct holders of the group token."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/circles_v2_group_holders/snapshot":{"get":{"tags":["Execution"],"summary":"Circles V2 Group Holders (snapshot)","description":"**Required Access:** `tier1`\n\nHolders of a group's token, resolving both native ERC-1155 and ERC-20 wrapper legs (wrapper mapped back to group via the wrapper registry).\n\n\n**Columns:**\n- **as_of_date** (`Date`): Snapshot date the holder list was computed (today() UTC).\n- **group_address** (`String`): Lowercased group avatar address.\n- **holder** (`String`): Lowercased holder avatar address.\n- **display_name** (`String`): Holder display name from IPFS metadata or on-chain name or address fallback.\n- **balance** (`Float64`): Holder total group-token balance in native units summing the native and wrapper legs.\n- **is_wrapped** (`UInt8`): 1 if any of the holder balance is held via an ERC-20 wrapper.","operationId":"api_execution_circles_v2_group_holders_get_v1_execution_circles_v2_group_holders_snapshot_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"as_of_date":{"type":"string","format":"date","description":"Snapshot date the holder list was computed (today() UTC)."},"group_address":{"type":"string","description":"Lowercased group avatar address."},"holder":{"type":"string","description":"Lowercased holder avatar address."},"display_name":{"type":"string","description":"Holder display name from IPFS metadata or on-chain name or address fallback."},"balance":{"type":"number","description":"Holder total group-token balance in native units summing the native and wrapper legs."},"is_wrapped":{"type":"integer","description":"1 if any of the holder balance is held via an ERC-20 wrapper."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/circles_v2_group_member_scores/latest":{"get":{"tags":["Execution"],"summary":"Circles V2 Group Member Scores (latest)","description":"**Required Access:** `tier1`\n\nLatest on-chain score per (score-based group, member), from the OffchainScoreBasedMintPolicy PersonalMinted event. One row per member per group; score is the value at the member's most recent mint.\n\n\n**Columns:**\n- **as_of_date** (`Date`): Date the snapshot was computed (query date\n- **group_address** (`String`): Lowercased group avatar address.\n- **member** (`String`): Member (minter) avatar address\n- **score** (`UInt64`): Member's off-chain trust score at their latest mint.\n- **last_mint_at** (`DateTime`): Timestamp of the member's latest score-based mint.\n- **last_mint_amount** (`Float64`): Group tokens minted at the latest mint (CRC).\n- **n_mints** (`UInt64`): Number of score-based mints by this member in this group.","operationId":"api_execution_circles_v2_group_member_scores_get_v1_execution_circles_v2_group_member_scores_latest_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"as_of_date":{"type":"string","format":"date","description":"Date the snapshot was computed (query date"},"group_address":{"type":"string","description":"Lowercased group avatar address."},"member":{"type":"string","description":"Member (minter) avatar address"},"score":{"type":"integer","description":"Member's off-chain trust score at their latest mint."},"last_mint_at":{"type":"string","format":"date-time","description":"Timestamp of the member's latest score-based mint."},"last_mint_amount":{"type":"number","description":"Group tokens minted at the latest mint (CRC)."},"n_mints":{"type":"integer","description":"Number of score-based mints by this member in this group."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/circles_v2_group_members/snapshot":{"get":{"tags":["Execution"],"summary":"Circles V2 Group Members (snapshot)","description":"**Required Access:** `tier1`\n\nMembers of a group (trustees on its outgoing trust list) with profile and join date; is_mutual flags reciprocal trust.\n\n\n**Columns:**\n- **as_of_date** (`Date`): Snapshot date the row was materialized (constant today()).\n- **group_address** (`String`): Lowercased group avatar address.\n- **member** (`String`): Lowercased member avatar address.\n- **display_name** (`String`): Member IPFS metadata name, else on-chain name, else the address.\n- **preview_image_url** (`Nullable(String)`): Member profile preview image URL from IPFS metadata, if any.\n- **member_since** (`DateTime`): Timestamp the member's trust edge became valid (join date).\n- **is_mutual** (`UInt8`): 1 when the member also trusts the group back (reciprocal trust).\n- **score** (`Nullable(UInt64)`): Member's latest on-chain mint score for score-based groups, else null.","operationId":"api_execution_circles_v2_group_members_get_v1_execution_circles_v2_group_members_snapshot_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"as_of_date":{"type":"string","format":"date","description":"Snapshot date the row was materialized (constant today())."},"group_address":{"type":"string","description":"Lowercased group avatar address."},"member":{"type":"string","description":"Lowercased member avatar address."},"display_name":{"type":"string","description":"Member IPFS metadata name, else on-chain name, else the address."},"preview_image_url":{"type":"string","description":"Member profile preview image URL from IPFS metadata, if any."},"member_since":{"type":"string","format":"date-time","description":"Timestamp the member's trust edge became valid (join date)."},"is_mutual":{"type":"integer","description":"1 when the member also trusts the group back (reciprocal trust)."},"score":{"type":"integer","description":"Member's latest on-chain mint score for score-based groups, else null."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/circles_v2_group_mints/daily":{"get":{"tags":["Execution"],"summary":"Circles V2 Group Mints (daily)","description":"**Required Access:** `tier1`\n\nPer-group daily group-token mints vs collateral redemptions (distinct tokens/units, labelled in the kind column).\n\n\n**Columns:**\n- **date** (`Date`): Calendar day (UTC).\n- **group_address** (`String`): Lowercased group avatar address.\n- **kind** (`String`): Series label distinguishing group-token mints from collateral redemptions.\n- **amount** (`Float64`): Summed amount for that day/group/kind (native CRC units, 1e18-scaled).","operationId":"api_execution_circles_v2_group_mints_daily_get_v1_execution_circles_v2_group_mints_daily_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"date":{"type":"string","format":"date","description":"Calendar day (UTC)."},"group_address":{"type":"string","description":"Lowercased group avatar address."},"kind":{"type":"string","description":"Series label distinguishing group-token mints from collateral redemptions."},"amount":{"type":"number","description":"Summed amount for that day/group/kind (native CRC units, 1e18-scaled)."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/circles_v2_group_score_distribution/latest":{"get":{"tags":["Execution"],"summary":"Circles V2 Group Score Distribution (latest)","description":"**Required Access:** `tier1`\n\nCount of members per score bucket, per score-based group. Buckets carry a bucket_rank for stable ordering in charts.\n\n\n**Columns:**\n- **as_of_date** (`Date`): Date the snapshot was computed (UTC).\n- **group_address** (`String`): Lowercased group avatar address.\n- **score_bucket** (`String`): Score range bucket label (0-24 / 25-49 / 50-74 / 75-99 / 100-149 / 150+).\n- **bucket_rank** (`UInt8`): Ordinal rank of the bucket for chart ordering.\n- **n_members** (`UInt64`): Number of members in this score bucket.","operationId":"api_execution_circles_v2_group_score_distribution_get_v1_execution_circles_v2_group_score_distribution_latest_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"as_of_date":{"type":"string","format":"date","description":"Date the snapshot was computed (UTC)."},"group_address":{"type":"string","description":"Lowercased group avatar address."},"score_bucket":{"type":"string","description":"Score range bucket label (0-24 / 25-49 / 50-74 / 75-99 / 100-149 / 150+)."},"bucket_rank":{"type":"integer","description":"Ordinal rank of the bucket for chart ordering."},"n_members":{"type":"integer","description":"Number of members in this score bucket."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/circles_v2_group_search/snapshot":{"get":{"tags":["Execution"],"summary":"Circles V2 Group Search (snapshot)","description":"**Required Access:** `tier1`\n\n(group_address, display_name) lookup backing the Group Explorer global filter. One row per Circles v2 Group avatar.\n\n\n**Columns:**\n- **as_of_date** (`Date`): Snapshot date the lookup was materialised (today() at build time).\n- **group_address** (`String`): Lowercased group avatar address.\n- **display_name** (`String`): IPFS metadata name, else on-chain name, else the address.","operationId":"api_execution_circles_v2_group_search_get_v1_execution_circles_v2_group_search_snapshot_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"as_of_date":{"type":"string","format":"date","description":"Snapshot date the lookup was materialised (today() at build time)."},"group_address":{"type":"string","description":"Lowercased group avatar address."},"display_name":{"type":"string","description":"IPFS metadata name, else on-chain name, else the address."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/circles_v2_group_size/daily":{"get":{"tags":["Execution"],"summary":"Circles V2 Group Size (daily)","description":"**Required Access:** `tier1`\n\nPer-group daily member count, from historical trust intervals.\n\n**Columns:**\n- **group_address** (`String`): Lowercased group avatar address.\n- **date** (`Date`): Calendar day (UTC).\n- **n_members** (`UInt64`): Number of members (trustees) in the group that day.","operationId":"api_execution_circles_v2_group_size_daily_get_v1_execution_circles_v2_group_size_daily_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"group_address":{"type":"string","description":"Lowercased group avatar address."},"date":{"type":"string","format":"date","description":"Calendar day (UTC)."},"n_members":{"type":"integer","description":"Number of members (trustees) in the group that day."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/circles_v2_group_size_distribution/latest":{"get":{"tags":["Execution"],"summary":"Circles V2 Group Size Distribution (latest)","description":"**Required Access:** `tier1`\n\nHistogram of Circles v2 group sizes (members per group).\n\n**Columns:**\n- **bucket** (`String`): Group-size bucket label, prefixed with its order (e.g. '1. 0', '2. 1–5', … '6. 500+').\n- **bucket_order** (`UInt8`): 1..6 ordering for stable stacking.\n- **n_groups** (`UInt64`): Number of groups falling into this size bucket.\n- **as_of_date** (`Date`): Date the snapshot is computed as of (max date in the underlying data).","operationId":"api_execution_circles_v2_group_size_distribution_get_v1_execution_circles_v2_group_size_distribution_latest_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"bucket":{"type":"string","description":"Group-size bucket label, prefixed with its order (e.g. '1. 0', '2. 1–5', … '6. 500+')."},"bucket_order":{"type":"integer","description":"1..6 ordering for stable stacking."},"n_groups":{"type":"integer","description":"Number of groups falling into this size bucket."},"as_of_date":{"type":"string","format":"date","description":"Date the snapshot is computed as of (max date in the underlying data)."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/circles_v2_group_supply/daily":{"get":{"tags":["Execution"],"summary":"Circles V2 Group Supply (daily)","description":"**Required Access:** `tier1`\n\nPer-group daily token supply, split native ERC-1155 vs ERC-20 wrapper (wrapper level = prefix-sum of wrapper supply deltas).\n\n\n**Columns:**\n- **group_address** (`String`): Lowercased group avatar address.\n- **date** (`Date`): Calendar day (UTC).\n- **supply** (`Float64`): Nominal (non-demurraged) group token supply that day (native CRC units, 1e18-scaled).\n- **supply_demurraged** (`Float64`): Demurraged group token supply that day (native CRC units, 1e18-scaled).","operationId":"api_execution_circles_v2_group_supply_daily_get_v1_execution_circles_v2_group_supply_daily_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"group_address":{"type":"string","description":"Lowercased group avatar address."},"date":{"type":"string","format":"date","description":"Calendar day (UTC)."},"supply":{"type":"number","description":"Nominal (non-demurraged) group token supply that day (native CRC units, 1e18-scaled)."},"supply_demurraged":{"type":"number","description":"Demurraged group token supply that day (native CRC units, 1e18-scaled)."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/circles_v2_group_token_supply/daily":{"get":{"tags":["Execution"],"summary":"Circles V2 Group Token Supply (daily)","description":"**Required Access:** `tier1`\n\nLong-format time-series view (one row per (date, label)) over fct_execution_circles_v2_group_token_supply_daily, ready for a stacked-area chart with seriesField='label'. Latest day excluded.\n\n\n**Columns:**\n- **date** (`Date`): Calendar day (UTC).\n- **label** (`String`): 'ERC-1155 (native)' or 'ERC-20 (wrapped)'.\n- **value** (`Float64`): Group-token supply for this label's form on this day, in CRC.\n- **value_demurraged** (`Float64`): Demurrage-adjusted equivalent of value.","operationId":"api_execution_circles_v2_group_token_supply_daily_get_v1_execution_circles_v2_group_token_supply_daily_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"date":{"type":"string","format":"date","description":"Calendar day (UTC)."},"label":{"type":"string","description":"'ERC-1155 (native)' or 'ERC-20 (wrapped)'."},"value":{"type":"number","description":"Group-token supply for this label's form on this day, in CRC."},"value_demurraged":{"type":"number","description":"Demurrage-adjusted equivalent of value."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/circles_v2_group_token_supply_top/latest":{"get":{"tags":["Execution"],"summary":"Circles V2 Group Token Supply Top (latest)","description":"**Required Access:** `tier1`\n\nTop 100 Circles v2 groups by personal-token supply (leaderboard view).\n\n**Columns:**\n- **rank** (`UInt64`): Leaderboard rank (1 = largest supply), ordered by supply descending.\n- **group_avatar** (`String`): Lowercase group avatar address.\n- **display_name** (`Nullable(String)`): Group display name — IPFS metadata name, falling back to the on-chain name. NULL if none.\n- **preview_image_url** (`Nullable(String)`): Preview image URL from the group's IPFS profile metadata. NULL if none.\n- **supply** (`Float64`): Circulating supply of the group's own personal CRC token (sum across all holder categories).\n- **wrapped** (`Float64`): Portion of the supply currently held by the avatar's ERC-20 wrapper contracts.\n- **unwrapped** (`Float64`): Portion of the supply held as native ERC-1155 (supply − wrapped).\n- **wrapped_pct** (`Nullable(Float64)`): wrapped / supply × 100. NULL when supply = 0.\n- **supply_demurraged** (`Float64`): Demurrage-adjusted equivalent of supply.\n- **n_members** (`UInt64`): Distinct trustees on the group's outgoing trust list (0 if none).\n- **as_of_date** (`Date`): Date the snapshot is computed as of (max date in the underlying data).","operationId":"api_execution_circles_v2_group_token_supply_top_latest_get_v1_execution_circles_v2_group_token_supply_top_latest_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"rank":{"type":"integer","description":"Leaderboard rank (1 = largest supply), ordered by supply descending."},"group_avatar":{"type":"string","description":"Lowercase group avatar address."},"display_name":{"type":"string","description":"Group display name — IPFS metadata name, falling back to the on-chain name. NULL if none."},"preview_image_url":{"type":"string","description":"Preview image URL from the group's IPFS profile metadata. NULL if none."},"supply":{"type":"number","description":"Circulating supply of the group's own personal CRC token (sum across all holder categories)."},"wrapped":{"type":"number","description":"Portion of the supply currently held by the avatar's ERC-20 wrapper contracts."},"unwrapped":{"type":"number","description":"Portion of the supply held as native ERC-1155 (supply − wrapped)."},"wrapped_pct":{"type":"number","description":"wrapped / supply × 100. NULL when supply = 0."},"supply_demurraged":{"type":"number","description":"Demurrage-adjusted equivalent of supply."},"n_members":{"type":"integer","description":"Distinct trustees on the group's outgoing trust list (0 if none)."},"as_of_date":{"type":"string","format":"date","description":"Date the snapshot is computed as of (max date in the underlying data)."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/circles_v2_groups_cnt/latest":{"get":{"tags":["Execution"],"summary":"Circles V2 Groups Cnt (latest)","description":"**Required Access:** `tier1`\n\nLatest count of group avatars and 7-day percentage change.\n\n**Columns:**\n- **total** (`UInt64`): The total number of group avatars at the latest date.\n- **change_pct** (`Float64`): Percentage change in group count compared to 7 days ago, rounded to 1 decimal.\n- **as_of_date** (`Date`): Date the snapshot is computed as of (max date in the underlying data).","operationId":"api_execution_circles_v2_groups_cnt_latest_get_v1_execution_circles_v2_groups_cnt_latest_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"total":{"type":"integer","description":"The total number of group avatars at the latest date."},"change_pct":{"type":"number","description":"Percentage change in group count compared to 7 days ago, rounded to 1 decimal."},"as_of_date":{"type":"string","format":"date","description":"Date the snapshot is computed as of (max date in the underlying data)."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/circles_v2_groups_overview/daily":{"get":{"tags":["Execution"],"summary":"Circles V2 Groups Overview (daily)","description":"**Required Access:** `tier1`\n\nDaily group registrations + collateral activity, with cumulative group total.\n\n**Columns:**\n- **date** (`Date`): Calendar day (UTC).\n- **n_new_groups** (`UInt64`): Group avatars registered on this day.\n- **n_collateral_events** (`UInt64`): StandardTreasury lock/burn/return collateral events on this day.\n- **n_distinct_groups_acting** (`UInt64`): Distinct groups touching collateral on this day.\n- **n_groups_total** (`UInt64`): Cumulative running total of registered groups up to and including this day.","operationId":"api_execution_circles_v2_groups_overview_daily_get_v1_execution_circles_v2_groups_overview_daily_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"date":{"type":"string","format":"date","description":"Calendar day (UTC)."},"n_new_groups":{"type":"integer","description":"Group avatars registered on this day."},"n_collateral_events":{"type":"integer","description":"StandardTreasury lock/burn/return collateral events on this day."},"n_distinct_groups_acting":{"type":"integer","description":"Distinct groups touching collateral on this day."},"n_groups_total":{"type":"integer","description":"Cumulative running total of registered groups up to and including this day."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/circles_v2_hub_events/daily":{"get":{"tags":["Execution"],"summary":"Circles V2 Hub Events (daily)","description":"**Required Access:** `tier1`\n\nTime-series view over int_execution_circles_v2_hub_events_daily; latest day excluded.\n\n**Columns:**\n- **date** (`Date`): Calendar day (UTC).\n- **event_name** (`String`): Hub event name (RegisterHuman, Trust, TransferSingle, …).\n- **n_events** (`UInt64`): Number of events of this kind on this day.\n- **n_tx** (`UInt64`): Number of distinct transactions emitting this event on this day.\n- **n_distinct_addresses** (`UInt64`): Distinct participant addresses across all event-specific fields.","operationId":"api_execution_circles_v2_hub_events_daily_get_v1_execution_circles_v2_hub_events_daily_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"date":{"type":"string","format":"date","description":"Calendar day (UTC)."},"event_name":{"type":"string","description":"Hub event name (RegisterHuman, Trust, TransferSingle, …)."},"n_events":{"type":"integer","description":"Number of events of this kind on this day."},"n_tx":{"type":"integer","description":"Number of distinct transactions emitting this event on this day."},"n_distinct_addresses":{"type":"integer","description":"Distinct participant addresses across all event-specific fields."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/circles_v2_humans_cnt/latest":{"get":{"tags":["Execution"],"summary":"Circles V2 Humans Cnt (latest)","description":"**Required Access:** `tier1`\n\nLatest count of human avatars and 7-day percentage change.\n\n**Columns:**\n- **total** (`UInt64`): The total number of human avatars at the latest date.\n- **change_pct** (`Float64`): Percentage change in human count compared to 7 days ago.\n- **as_of_date** (`Date`): Date the snapshot is computed as of (max date in the underlying data).","operationId":"api_execution_circles_v2_humans_cnt_latest_get_v1_execution_circles_v2_humans_cnt_latest_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"total":{"type":"integer","description":"The total number of human avatars at the latest date."},"change_pct":{"type":"number","description":"Percentage change in human count compared to 7 days ago."},"as_of_date":{"type":"string","format":"date","description":"Date the snapshot is computed as of (max date in the underlying data)."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/circles_v2_invite_funnel_cohort/monthly":{"get":{"tags":["Execution"],"summary":"Circles V2 Invite Funnel Cohort (monthly)","description":"**Required Access:** `tier1`\n\nInvitee cohort by month, with the five-stage mint-cadence funnel (Invited → ≥2 days → ≥7 days → ≥14 days → Active Minter) and the percentile latency to \"came back\" (second mint on a different day). Skips the trivial acceptance mint, which always fires.\n\n\n**Columns:**\n- **cohort_month** (`Date`): Month the cohort was invited (toStartOfMonth of invited_at); the row grain.\n- **n_invited** (`UInt64`): Total invitees in this cohort.\n- **n_minted_2_days** (`UInt64`): Invitees with >= 2 distinct mint days in the first 30 days.\n- **n_minted_7_days** (`UInt64`): Invitees with >= 7 distinct mint days in the first 30 days.\n- **n_minted_14_days** (`UInt64`): Invitees with >= 14 distinct mint days in the first 30 days.\n- **n_active_minter** (`UInt64`): Invitees that ever reached canonical Active Minter status (mint_days_14dw = 14 AND mint_14dw >= 80% of 336).\n- **pct_minted_2_days** (`Float64`): n_minted_2_days / n_invited × 100, rounded to 1 decimal.\n- **pct_minted_7_days** (`Float64`): n_minted_7_days / n_invited × 100, rounded to 1 decimal.\n- **pct_minted_14_days** (`Float64`): n_minted_14_days / n_invited × 100, rounded to 1 decimal.\n- **pct_active_minter** (`Float64`): n_active_minter / n_invited × 100, rounded to 1 decimal.\n- **median_days_to_second_mint** (`Nullable(Int64)`): Median days from invite to the first mint on a different day.\n- **p25_days_to_second_mint** (`Nullable(Int64)`): 25th-percentile days from invite to the first mint on a different day.\n- **p75_days_to_second_mint** (`Nullable(Int64)`): 75th-percentile days from invite to the first mint on a different day.","operationId":"api_execution_circles_v2_invite_funnel_cohort_monthly_get_v1_execution_circles_v2_invite_funnel_cohort_monthly_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"cohort_month":{"type":"string","format":"date","description":"Month the cohort was invited (toStartOfMonth of invited_at); the row grain."},"n_invited":{"type":"integer","description":"Total invitees in this cohort."},"n_minted_2_days":{"type":"integer","description":"Invitees with >= 2 distinct mint days in the first 30 days."},"n_minted_7_days":{"type":"integer","description":"Invitees with >= 7 distinct mint days in the first 30 days."},"n_minted_14_days":{"type":"integer","description":"Invitees with >= 14 distinct mint days in the first 30 days."},"n_active_minter":{"type":"integer","description":"Invitees that ever reached canonical Active Minter status (mint_days_14dw = 14 AND mint_14dw >= 80% of 336)."},"pct_minted_2_days":{"type":"number","description":"n_minted_2_days / n_invited × 100, rounded to 1 decimal."},"pct_minted_7_days":{"type":"number","description":"n_minted_7_days / n_invited × 100, rounded to 1 decimal."},"pct_minted_14_days":{"type":"number","description":"n_minted_14_days / n_invited × 100, rounded to 1 decimal."},"pct_active_minter":{"type":"number","description":"n_active_minter / n_invited × 100, rounded to 1 decimal."},"median_days_to_second_mint":{"type":"integer","description":"Median days from invite to the first mint on a different day."},"p25_days_to_second_mint":{"type":"integer","description":"25th-percentile days from invite to the first mint on a different day."},"p75_days_to_second_mint":{"type":"integer","description":"75th-percentile days from invite to the first mint on a different day."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/circles_v2_inviter_farm_quota/latest":{"get":{"tags":["Execution"],"summary":"Circles V2 Inviter Farm Quota (latest)","description":"**Required Access:** `tier1`\n\nInviter InvitationFarm leaderboard (invites claimed + current quota), ordered by invites_claimed. Passthrough over fct_execution_circles_v2_inviter_farm_quota with an as_of_date snapshot stamp.\n\n\n**Columns:**\n- **inviter** (`String`): Lowercase inviter address.\n- **invites_claimed** (`Int64`): Total invites claimed from the farm.\n- **n_claim_events** (`UInt64`): Number of claim events.\n- **current_quota** (`Nullable(Int64)`): Latest granted invite quota; NULL if never set.\n- **first_claim_at** (`Nullable(DateTime)`): First claim timestamp; NULL if none.\n- **last_claim_at** (`Nullable(DateTime)`): Most recent claim timestamp; NULL if none.\n- **quota_updated_at** (`Nullable(DateTime)`): Latest quota-update timestamp; NULL if none.\n- **as_of_date** (`Date`): Date the snapshot is computed as of (max InvitationFarm event date).","operationId":"api_execution_circles_v2_inviter_farm_quota_get_v1_execution_circles_v2_inviter_farm_quota_latest_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"inviter":{"type":"string","description":"Lowercase inviter address."},"invites_claimed":{"type":"integer","description":"Total invites claimed from the farm."},"n_claim_events":{"type":"integer","description":"Number of claim events."},"current_quota":{"type":"integer","description":"Latest granted invite quota; NULL if never set."},"first_claim_at":{"type":"string","format":"date-time","description":"First claim timestamp; NULL if none."},"last_claim_at":{"type":"string","format":"date-time","description":"Most recent claim timestamp; NULL if none."},"quota_updated_at":{"type":"string","format":"date-time","description":"Latest quota-update timestamp; NULL if none."},"as_of_date":{"type":"string","format":"date","description":"Date the snapshot is computed as of (max InvitationFarm event date)."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/circles_v2_inviters_ranking/latest":{"get":{"tags":["Execution"],"summary":"Circles V2 Inviters Ranking (latest)","description":"**Required Access:** `tier1`\n\nTop-N inviters leaderboard ordered by number of human avatars invited. Pre-joins the inviter's display name, preview image URL (IPFS profile), and current blacklist flag so the dashboard renders the table directly.\n\n\n**Columns:**\n- **rank** (`UInt64`): Leaderboard rank by invite count (1 = most invites).\n- **inviter** (`String`): Lowercase inviter avatar address.\n- **display_name** (`String`): IPFS profile display name (empty string when unset).\n- **preview_image_url** (`String`): IPFS profile previewImageUrl (empty string when unset).\n- **is_blacklisted** (`Bool`): True iff the address appears in stg_crawlers_data__circles_blacklisted at build time.\n- **invite_count** (`UInt64`): Total humans invited.\n- **first_invite_ts** (`DateTime`): Timestamp of the first invite.\n- **last_invite_ts** (`DateTime`): Timestamp of the most recent invite.\n- **as_of_date** (`Date`): Date the snapshot is computed as of (max date in the underlying data).","operationId":"api_execution_circles_v2_inviters_ranking_get_v1_execution_circles_v2_inviters_ranking_latest_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"rank":{"type":"integer","description":"Leaderboard rank by invite count (1 = most invites)."},"inviter":{"type":"string","description":"Lowercase inviter avatar address."},"display_name":{"type":"string","description":"IPFS profile display name (empty string when unset)."},"preview_image_url":{"type":"string","description":"IPFS profile previewImageUrl (empty string when unset)."},"is_blacklisted":{"type":"boolean","description":"True iff the address appears in stg_crawlers_data__circles_blacklisted at build time."},"invite_count":{"type":"integer","description":"Total humans invited."},"first_invite_ts":{"type":"string","format":"date-time","description":"Timestamp of the first invite."},"last_invite_ts":{"type":"string","format":"date-time","description":"Timestamp of the most recent invite."},"as_of_date":{"type":"string","format":"date","description":"Date the snapshot is computed as of (max date in the underlying data)."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/circles_v2_kpi_active_minters/latest":{"get":{"tags":["Execution"],"summary":"Circles V2 Kpi Active Minters (latest)","description":"**Required Access:** `tier0` (no API key required)\n\nKPI: yesterday's Active Minters count with WoW pct change.\n\n**Columns:**\n- **value** (`UInt64`): Active Minters count on the latest complete day.\n- **change_pct** (`Nullable(Float64)`): Percent change vs the count 7 days earlier.\n- **as_of_date** (`Date`): Date the snapshot is computed as of (max date in the underlying data).","operationId":"api_execution_circles_v2_kpi_active_minters_latest_get_v1_execution_circles_v2_kpi_active_minters_latest_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"value":{"type":"integer","description":"Active Minters count on the latest complete day."},"change_pct":{"type":"number","description":"Percent change vs the count 7 days earlier."},"as_of_date":{"type":"string","format":"date","description":"Date the snapshot is computed as of (max date in the underlying data)."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/circles_v2_kpi_avg_members_per_group/latest":{"get":{"tags":["Execution"],"summary":"Circles V2 Kpi Avg Members Per Group (latest)","description":"**Required Access:** `tier0` (no API key required)\n\nKPI: average and median members per group.\n\n**Columns:**\n- **value** (`Nullable(Float64)`): Average member count across all groups\n- **median_members** (`Float64`): Median member count across all groups.\n- **change_pct** (`Nullable(Float64)`): Always NULL — no time series for group size upstream\n- **as_of_date** (`Date`): Date the snapshot is computed as of (max date in the underlying data).","operationId":"api_execution_circles_v2_kpi_avg_members_per_group_latest_get_v1_execution_circles_v2_kpi_avg_members_per_group_latest_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"value":{"type":"number","description":"Average member count across all groups"},"median_members":{"type":"number","description":"Median member count across all groups."},"change_pct":{"type":"number","description":"Always NULL — no time series for group size upstream"},"as_of_date":{"type":"string","format":"date","description":"Date the snapshot is computed as of (max date in the underlying data)."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/circles_v2_kpi_avg_trusts_per_avatar/latest":{"get":{"tags":["Execution"],"summary":"Circles V2 Kpi Avg Trusts Per Avatar (latest)","description":"**Required Access:** `tier0` (no API key required)\n\nKPI: average trusts per human avatar = active_trusts / humans. Network-density indicator.\n\n**Columns:**\n- **value** (`Float64`): active_trusts / humans (rounded to 2 decimals).\n- **as_of_date** (`Date`): Date the snapshot is computed as of (max date in the underlying data).","operationId":"api_execution_circles_v2_kpi_avg_trusts_per_avatar_latest_get_v1_execution_circles_v2_kpi_avg_trusts_per_avatar_latest_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"value":{"type":"number","description":"active_trusts / humans (rounded to 2 decimals)."},"as_of_date":{"type":"string","format":"date","description":"Date the snapshot is computed as of (max date in the underlying data)."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/circles_v2_kpi_depositors_in_backers_pct/latest":{"get":{"tags":["Execution"],"summary":"Circles V2 Kpi Depositors In Backers Pct (latest)","description":"**Required Access:** `tier0` (no API key required)\n\nKPI: % of depositors that ended up trusted by the backers group.\n\n**Columns:**\n- **value** (`Nullable(Float64)`): Percent of distinct depositors that are also trust-defined backers (depositors_in_backers / total_depositors × 100).\n- **total_depositors** (`UInt64`): Total distinct depositor addresses.\n- **depositors_in_backers** (`UInt64`): Depositors that are also trusted by the backers group.\n- **change_pct** (`Nullable(Float64)`): Always NULL — no time series\n- **as_of_date** (`Date`): Date the snapshot is computed as of (max date in the underlying data).","operationId":"api_execution_circles_v2_kpi_depositors_in_backers_pct_latest_get_v1_execution_circles_v2_kpi_depositors_in_backers_pct_latest_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"value":{"type":"number","description":"Percent of distinct depositors that are also trust-defined backers (depositors_in_backers / total_depositors × 100)."},"total_depositors":{"type":"integer","description":"Total distinct depositor addresses."},"depositors_in_backers":{"type":"integer","description":"Depositors that are also trusted by the backers group."},"change_pct":{"type":"number","description":"Always NULL — no time series"},"as_of_date":{"type":"string","format":"date","description":"Date the snapshot is computed as of (max date in the underlying data)."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/circles_v2_kpi_group_token_supply/latest":{"get":{"tags":["Execution"],"summary":"Circles V2 Kpi Group Token Supply (latest)","description":"**Required Access:** `tier0` (no API key required)\n\nKPI: aggregate group-token supply with 7d change.\n\n**Columns:**\n- **value** (`Float64`): Latest aggregate group-token supply across all groups\n- **change_pct** (`Nullable(Float64)`): Percent change vs the aggregate group-token supply 7 days earlier.\n- **as_of_date** (`Date`): Date the snapshot is computed as of (max date in the underlying data).","operationId":"api_execution_circles_v2_kpi_group_token_supply_latest_get_v1_execution_circles_v2_kpi_group_token_supply_latest_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"value":{"type":"number","description":"Latest aggregate group-token supply across all groups"},"change_pct":{"type":"number","description":"Percent change vs the aggregate group-token supply 7 days earlier."},"as_of_date":{"type":"string","format":"date","description":"Date the snapshot is computed as of (max date in the underlying data)."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/circles_v2_kpi_group_wrapped_pct/latest":{"get":{"tags":["Execution"],"summary":"Circles V2 Kpi Group Wrapped Pct (latest)","description":"**Required Access:** `tier0` (no API key required)\n\nKPI: share of group-token supply held as ERC-20 wrappers, with 7d delta.\n\n**Columns:**\n- **value** (`Nullable(Float64)`): Latest share of aggregate group-token supply held as ERC-20 wrappers (percent\n- **change_pct** (`Nullable(Float64)`): Percentage-point change vs the wrapped share 7 days earlier.\n- **as_of_date** (`Date`): Date the snapshot is computed as of (max date in the underlying data).","operationId":"api_execution_circles_v2_kpi_group_wrapped_pct_latest_get_v1_execution_circles_v2_kpi_group_wrapped_pct_latest_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"value":{"type":"number","description":"Latest share of aggregate group-token supply held as ERC-20 wrappers (percent"},"change_pct":{"type":"number","description":"Percentage-point change vs the wrapped share 7 days earlier."},"as_of_date":{"type":"string","format":"date","description":"Date the snapshot is computed as of (max date in the underlying data)."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/circles_v2_kpi_mints/last_7d/7d":{"get":{"tags":["Execution"],"summary":"Circles V2 Kpi Mints (last_7d) [7d]","description":"**Required Access:** `tier0` (no API key required)\n\nKPI: total mints in the last 7 full days with WoW pct change.\n\n**Columns:**\n- **value** (`UInt64`): Total mint events in last 7 days.\n- **amount** (`Float64`): Total CRC minted in last 7 days.\n- **change_pct** (`Nullable(Float64)`): Percent change vs prior 7d window.\n- **as_of_date** (`Date`): Date the snapshot is computed as of (max date in the underlying data).","operationId":"api_execution_circles_v2_kpi_mints_7d_get_v1_execution_circles_v2_kpi_mints_last_7d_7d_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"value":{"type":"integer","description":"Total mint events in last 7 days."},"amount":{"type":"number","description":"Total CRC minted in last 7 days."},"change_pct":{"type":"number","description":"Percent change vs prior 7d window."},"as_of_date":{"type":"string","format":"date","description":"Date the snapshot is computed as of (max date in the underlying data)."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/circles_v2_kpi_new_backers/latest/7d":{"get":{"tags":["Execution"],"summary":"Circles V2 Kpi New Backers (latest) [7d]","description":"**Required Access:** `tier0` (no API key required)\n\nKPI: backers newly trusted in the last 7 days with WoW change.\n\n**Columns:**\n- **value** (`UInt64`): Backers newly trusted by the backers group in the last 7 days.\n- **change_pct** (`Nullable(Float64)`): Percent change vs the prior 7-day window.\n- **as_of_date** (`Date`): Date the snapshot is computed as of (max date in the underlying data).","operationId":"api_execution_circles_v2_kpi_new_backers_7d_get_v1_execution_circles_v2_kpi_new_backers_latest_7d_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"value":{"type":"integer","description":"Backers newly trusted by the backers group in the last 7 days."},"change_pct":{"type":"number","description":"Percent change vs the prior 7-day window."},"as_of_date":{"type":"string","format":"date","description":"Date the snapshot is computed as of (max date in the underlying data)."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/circles_v2_kpi_new_groups/latest/7d":{"get":{"tags":["Execution"],"summary":"Circles V2 Kpi New Groups (latest) [7d]","description":"**Required Access:** `tier0` (no API key required)\n\nKPI: groups registered in the last 7 days with WoW change.\n\n**Columns:**\n- **value** (`UInt64`): Groups registered in the last 7 days.\n- **change_pct** (`Nullable(Float64)`): Percent change vs the prior 7-day window.\n- **as_of_date** (`Date`): Date the snapshot is computed as of (max date in the underlying data).","operationId":"api_execution_circles_v2_kpi_new_groups_7d_get_v1_execution_circles_v2_kpi_new_groups_latest_7d_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"value":{"type":"integer","description":"Groups registered in the last 7 days."},"change_pct":{"type":"number","description":"Percent change vs the prior 7-day window."},"as_of_date":{"type":"string","format":"date","description":"Date the snapshot is computed as of (max date in the underlying data)."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/circles_v2_kpi_new_trusts/last_7d/7d":{"get":{"tags":["Execution"],"summary":"Circles V2 Kpi New Trusts (last_7d) [7d]","description":"**Required Access:** `tier0` (no API key required)\n\nKPI: new trusts granted in the last 7 full days with WoW pct change.\n\n**Columns:**\n- **value** (`UInt64`): Total new trusts in last 7 days.\n- **revoked** (`UInt64`): Total revoked trusts in last 7 days.\n- **change_pct** (`Nullable(Float64)`): Percent change in new trusts vs the prior 7-day window.\n- **as_of_date** (`Date`): Date the snapshot is computed as of (max date in the underlying data).","operationId":"api_execution_circles_v2_kpi_new_trusts_7d_get_v1_execution_circles_v2_kpi_new_trusts_last_7d_7d_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"value":{"type":"integer","description":"Total new trusts in last 7 days."},"revoked":{"type":"integer","description":"Total revoked trusts in last 7 days."},"change_pct":{"type":"number","description":"Percent change in new trusts vs the prior 7-day window."},"as_of_date":{"type":"string","format":"date","description":"Date the snapshot is computed as of (max date in the underlying data)."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/circles_v2_kpi_total_backers/latest":{"get":{"tags":["Execution"],"summary":"Circles V2 Kpi Total Backers (latest)","description":"**Required Access:** `tier0` (no API key required)\n\nKPI: backers currently trusted by the backers group (revocation-aware), with 7d change.\n\n**Columns:**\n- **value** (`UInt64`): Backers currently trusted by the backers group (countIf(is_currently_trusted), latest complete day) — revocation-aware, not the ever-backed cumulative total.\n- **change_pct** (`Nullable(Float64)`): Percent change vs 7 days earlier. NOTE: computed off the ever-backed cumulative series as a growth proxy, so it slightly overstates growth when revocations occur.\n- **as_of_date** (`Date`): Date the snapshot is computed as of (max date in the underlying data).","operationId":"api_execution_circles_v2_kpi_total_backers_latest_get_v1_execution_circles_v2_kpi_total_backers_latest_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"value":{"type":"integer","description":"Backers currently trusted by the backers group (countIf(is_currently_trusted), latest complete day) — revocation-aware, not the ever-backed cumulative total."},"change_pct":{"type":"number","description":"Percent change vs 7 days earlier. NOTE: computed off the ever-backed cumulative series as a growth proxy, so it slightly overstates growth when revocations occur."},"as_of_date":{"type":"string","format":"date","description":"Date the snapshot is computed as of (max date in the underlying data)."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/circles_v2_kpi_total_depositors/latest":{"get":{"tags":["Execution"],"summary":"Circles V2 Kpi Total Depositors (latest)","description":"**Required Access:** `tier0` (no API key required)\n\nKPI: total distinct depositors with 7d-new and WoW change.\n\n**Columns:**\n- **value** (`UInt64`): Total distinct depositors (addresses that have emitted a CirclesBackingInitiated event).\n- **new_last_7d** (`UInt64`): Depositors whose first initiation was in the last 7 days.\n- **change_pct** (`Nullable(Float64)`): Percent change in newly-initiated depositors vs the prior 7-day window.\n- **as_of_date** (`Date`): Date the snapshot is computed as of (max date in the underlying data).","operationId":"api_execution_circles_v2_kpi_total_depositors_latest_get_v1_execution_circles_v2_kpi_total_depositors_latest_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"value":{"type":"integer","description":"Total distinct depositors (addresses that have emitted a CirclesBackingInitiated event)."},"new_last_7d":{"type":"integer","description":"Depositors whose first initiation was in the last 7 days."},"change_pct":{"type":"number","description":"Percent change in newly-initiated depositors vs the prior 7-day window."},"as_of_date":{"type":"string","format":"date","description":"Date the snapshot is computed as of (max date in the underlying data)."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/circles_v2_kpi_total_supply/latest":{"get":{"tags":["Execution"],"summary":"Circles V2 Kpi Total Supply (latest)","description":"**Required Access:** `tier0` (no API key required)\n\nKPI: latest network-wide CRC supply with 7-day pct change.\n\n**Columns:**\n- **value** (`Float64`): Latest total CRC supply (raw / 1e18).\n- **change_pct** (`Nullable(Float64)`): Percent change vs the total supply 7 days earlier.\n- **as_of_date** (`Date`): Date the snapshot is computed as of (max date in the underlying data).","operationId":"api_execution_circles_v2_kpi_total_supply_latest_get_v1_execution_circles_v2_kpi_total_supply_latest_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"value":{"type":"number","description":"Latest total CRC supply (raw / 1e18)."},"change_pct":{"type":"number","description":"Percent change vs the total supply 7 days earlier."},"as_of_date":{"type":"string","format":"date","description":"Date the snapshot is computed as of (max date in the underlying data)."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/circles_v2_minter_cohort/daily":{"get":{"tags":["Execution"],"summary":"Circles V2 Minter Cohort (daily)","description":"**Required Access:** `tier1`\n\nTime-series view over fct_execution_circles_v2_minter_cohort_daily; latest day excluded.\n\n**Columns:**\n- **date** (`Date`): Calendar day (UTC).\n- **cohort** (`String`): Human-readable 14-day mint-coverage bucket label.\n- **cohort_order** (`UInt8`): 1..6 ordering for stable stacking (low → high coverage).\n- **cnt** (`UInt64`): Distinct avatars in this bucket on this day.","operationId":"api_execution_circles_v2_minter_cohort_daily_get_v1_execution_circles_v2_minter_cohort_daily_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"date":{"type":"string","format":"date","description":"Calendar day (UTC)."},"cohort":{"type":"string","description":"Human-readable 14-day mint-coverage bucket label."},"cohort_order":{"type":"integer","description":"1..6 ordering for stable stacking (low → high coverage)."},"cnt":{"type":"integer","description":"Distinct avatars in this bucket on this day."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/circles_v2_mints/daily":{"get":{"tags":["Execution"],"summary":"Circles V2 Mints (daily)","description":"**Required Access:** `tier1`\n\nTime-series view over int_execution_circles_v2_mints_daily; latest day excluded. One row per (date, mint_kind) — mint_kind separates personal mints from group mints and V1→V2 migrations; aggregate across kinds for the network-total grain.\n\n\n**Columns:**\n- **date** (`Date`): Calendar day (UTC).\n- **mint_kind** (`String`): personal | group | migration | other.\n- **n_mint_events** (`UInt64`): Number of mint events for this (date, mint_kind).\n- **n_minters** (`UInt64`): Distinct recipient addresses (to_address) for this (date, mint_kind).\n- **amount_minted** (`Float64`): Total CRC minted for this (date, mint_kind) (raw / 1e18).","operationId":"api_execution_circles_v2_mints_daily_get_v1_execution_circles_v2_mints_daily_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"date":{"type":"string","format":"date","description":"Calendar day (UTC)."},"mint_kind":{"type":"string","description":"personal | group | migration | other."},"n_mint_events":{"type":"integer","description":"Number of mint events for this (date, mint_kind)."},"n_minters":{"type":"integer","description":"Distinct recipient addresses (to_address) for this (date, mint_kind)."},"amount_minted":{"type":"number","description":"Total CRC minted for this (date, mint_kind) (raw / 1e18)."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/circles_v2_orgs_cnt/latest":{"get":{"tags":["Execution"],"summary":"Circles V2 Orgs Cnt (latest)","description":"**Required Access:** `tier1`\n\nLatest count of organization avatars and 7-day percentage change.\n\n**Columns:**\n- **total** (`UInt64`): The total number of organization avatars at the latest date.\n- **change_pct** (`Float64`): Percentage change in organization count compared to 7 days ago.\n- **as_of_date** (`Date`): Date the snapshot is computed as of (max date in the underlying data).","operationId":"api_execution_circles_v2_orgs_cnt_latest_get_v1_execution_circles_v2_orgs_cnt_latest_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"total":{"type":"integer","description":"The total number of organization avatars at the latest date."},"change_pct":{"type":"number","description":"Percentage change in organization count compared to 7 days ago."},"as_of_date":{"type":"string","format":"date","description":"Date the snapshot is computed as of (max date in the underlying data)."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/circles_v2_p2p_velocity/daily":{"get":{"tags":["Execution"],"summary":"Circles V2 P2P Velocity (daily)","description":"**Required Access:** `tier1`\n\nPeer-to-peer transfer velocity (mint/burn/wrap/unwrap excluded).\n\n**Columns:**\n- **date** (`Date`): Calendar day (UTC).\n- **n_transfers** (`UInt64`): Number of peer-to-peer transfers on this day.\n- **n_senders** (`UInt64`): Distinct p2p sender addresses on this day.\n- **n_receivers** (`UInt64`): Distinct p2p recipient addresses on this day.\n- **amount** (`Float64`): Total p2p transfer volume in CRC (raw / 1e18).","operationId":"api_execution_circles_v2_p2p_velocity_daily_get_v1_execution_circles_v2_p2p_velocity_daily_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"date":{"type":"string","format":"date","description":"Calendar day (UTC)."},"n_transfers":{"type":"integer","description":"Number of peer-to-peer transfers on this day."},"n_senders":{"type":"integer","description":"Distinct p2p sender addresses on this day."},"n_receivers":{"type":"integer","description":"Distinct p2p recipient addresses on this day."},"amount":{"type":"number","description":"Total p2p transfer volume in CRC (raw / 1e18)."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/circles_v2_pool_explorer_liquidity/daily":{"get":{"tags":["Execution"],"summary":"Circles V2 Pool Explorer Liquidity (daily)","description":"**Required Access:** `tier1`\n\nDaily count of liquidity events (Mint = 'Add', Burn = 'Remove') per Uniswap V3 Circles pool, deduped on (transaction_hash, log_index) so each add/remove event counts once. One row per day, pool, and event kind.\n\n\n**Columns:**\n- **date** (`Date`): Calendar day (UTC) of the liquidity events, derived from block_timestamp.\n- **pool_address** (`String`): Lowercase 0x-prefixed address of the Uniswap V3 Circles liquidity pool.\n- **event_kind** (`String`): Liquidity event kind: 'Add' for Mint events, 'Remove' otherwise (Burn).\n- **n_events** (`UInt64`): Distinct count of liquidity events that day for the pool and event kind, deduped on (transaction_hash, log_index).","operationId":"api_execution_circles_v2_pool_explorer_liquidity_daily_get_v1_execution_circles_v2_pool_explorer_liquidity_daily_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"date":{"type":"string","format":"date","description":"Calendar day (UTC) of the liquidity events, derived from block_timestamp."},"pool_address":{"type":"string","description":"Lowercase 0x-prefixed address of the Uniswap V3 Circles liquidity pool."},"event_kind":{"type":"string","description":"Liquidity event kind: 'Add' for Mint events, 'Remove' otherwise (Burn)."},"n_events":{"type":"integer","description":"Distinct count of liquidity events that day for the pool and event kind, deduped on (transaction_hash, log_index)."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/circles_v2_pool_explorer_liquidity_events/snapshot":{"get":{"tags":["Execution"],"summary":"Circles V2 Pool Explorer Liquidity Events (snapshot)","description":"**Required Access:** `tier1`\n\nIndividual liquidity events (Mint mapped to Add, Burn to Remove) for the main Uniswap V3 Circles pools, one row per event, with each token amount added/removed, the USD value of the event, and the LP (position owner). Prices are resolved via daily ASOF carry-forward (CRC legs from the crc20 price model, stable legs from the oracle), with early events valued at each token's first observed price.\n\n\n**Columns:**\n- **pool_address** (`String`): Lowercase 0x pool contract address of the Uniswap V3 Circles pool the event belongs to.\n- **ts** (`DateTime`): Block timestamp of the liquidity event (UTC); serves as the freshness column.\n- **tx_hash** (`String`): Transaction hash of the liquidity event.\n- **event_kind** (`String`): Liquidity action: 'Add' for Mint events, 'Remove' for Burn events.\n- **token0_symbol** (`String`): Human-readable symbol of pool token0 (sDAI, EURe, s-gCRC, s-CBG, or an address prefix fallback).\n- **amount0** (`Float64`): Amount of token0 added or removed in the event, scaled to whole units (divided by 1e18).\n- **token1_symbol** (`String`): Human-readable symbol of pool token1 (sDAI, EURe, s-gCRC, s-CBG, or an address prefix fallback).\n- **amount1** (`Float64`): Amount of token1 added or removed in the event, scaled to whole units (divided by 1e18).\n- **amount_usd** (`Float64`): Total USD value of the event across both token legs, using ASOF carry-forward prices (0 when unpriced).\n- **lp** (`String`): Lowercase 0x address of the liquidity provider (position owner) for the event.","operationId":"api_execution_circles_v2_pool_explorer_liquidity_events_get_v1_execution_circles_v2_pool_explorer_liquidity_events_snapshot_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"pool_address":{"type":"string","description":"Lowercase 0x pool contract address of the Uniswap V3 Circles pool the event belongs to."},"ts":{"type":"string","format":"date-time","description":"Block timestamp of the liquidity event (UTC); serves as the freshness column."},"tx_hash":{"type":"string","description":"Transaction hash of the liquidity event."},"event_kind":{"type":"string","description":"Liquidity action: 'Add' for Mint events, 'Remove' for Burn events."},"token0_symbol":{"type":"string","description":"Human-readable symbol of pool token0 (sDAI, EURe, s-gCRC, s-CBG, or an address prefix fallback)."},"amount0":{"type":"number","description":"Amount of token0 added or removed in the event, scaled to whole units (divided by 1e18)."},"token1_symbol":{"type":"string","description":"Human-readable symbol of pool token1 (sDAI, EURe, s-gCRC, s-CBG, or an address prefix fallback)."},"amount1":{"type":"number","description":"Amount of token1 added or removed in the event, scaled to whole units (divided by 1e18)."},"amount_usd":{"type":"number","description":"Total USD value of the event across both token legs, using ASOF carry-forward prices (0 when unpriced)."},"lp":{"type":"string","description":"Lowercase 0x address of the liquidity provider (position owner) for the event."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/circles_v2_pool_explorer_swaps/daily":{"get":{"tags":["Execution"],"summary":"Circles V2 Pool Explorer Swaps (daily)","description":"**Required Access:** `tier1`\n\nDaily swap activity per main Circles DEX pool tracked in the Pool Explorer: number of swaps, total USD volume, and distinct trader count, scoped to the curated set of liquidity pools.\n\n\n**Columns:**\n- **date** (`Date`): Calendar day of the swap activity (UTC), derived from block_timestamp.\n- **pool_address** (`String`): Lower-cased liquidity pool contract address.\n- **n_swaps** (`UInt64`): Number of swaps executed in the pool that day.\n- **volume_usd** (`Float64`): Total swap volume in USD for the pool that day.\n- **n_traders** (`UInt64`): Distinct traders (taker, falling back to tx sender) that day.","operationId":"api_execution_circles_v2_pool_explorer_swaps_daily_get_v1_execution_circles_v2_pool_explorer_swaps_daily_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"date":{"type":"string","format":"date","description":"Calendar day of the swap activity (UTC), derived from block_timestamp."},"pool_address":{"type":"string","description":"Lower-cased liquidity pool contract address."},"n_swaps":{"type":"integer","description":"Number of swaps executed in the pool that day."},"volume_usd":{"type":"number","description":"Total swap volume in USD for the pool that day."},"n_traders":{"type":"integer","description":"Distinct traders (taker, falling back to tx sender) that day."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/circles_v2_pool_explorer_swaps/snapshot":{"get":{"tags":["Execution"],"summary":"Circles V2 Pool Explorer Swaps (snapshot)","description":"**Required Access:** `tier1`\n\nIndividual recent swaps executed on the main Circles v2 DEX pools, scoped to the curated liquidity pools for the Pool Explorer swaps table. One row per trade with the pool, timestamp, transaction hash, tokens and amounts on each side, USD value, and the trader address.\n\n\n**Columns:**\n- **pool_address** (`String`): Lower-cased address of the Circles DEX pool the swap occurred in.\n- **ts** (`DateTime`): Block timestamp of the swap (UTC); serves as the freshness column.\n- **tx_hash** (`String`): Transaction hash of the swap.\n- **token_sold** (`String`): Symbol of the token sold (input side) in the swap.\n- **amount_sold** (`Float64`): Amount of the token sold (input side).\n- **token_bought** (`String`): Symbol of the token bought (output side) in the swap.\n- **amount_bought** (`Float64`): Amount of the token bought (output side).\n- **amount_usd** (`Nullable(Float64)`): USD value of the swap; null when no price is available.\n- **trader** (`String`): Trader address, taken as the taker if present else the transaction sender.","operationId":"api_execution_circles_v2_pool_explorer_swaps_get_v1_execution_circles_v2_pool_explorer_swaps_snapshot_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"pool_address":{"type":"string","description":"Lower-cased address of the Circles DEX pool the swap occurred in."},"ts":{"type":"string","format":"date-time","description":"Block timestamp of the swap (UTC); serves as the freshness column."},"tx_hash":{"type":"string","description":"Transaction hash of the swap."},"token_sold":{"type":"string","description":"Symbol of the token sold (input side) in the swap."},"amount_sold":{"type":"number","description":"Amount of the token sold (input side)."},"token_bought":{"type":"string","description":"Symbol of the token bought (output side) in the swap."},"amount_bought":{"type":"number","description":"Amount of the token bought (output side)."},"amount_usd":{"type":"number","description":"USD value of the swap; null when no price is available."},"trader":{"type":"string","description":"Trader address, taken as the taker if present else the transaction sender."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/circles_v2_pool_search/snapshot":{"get":{"tags":["Execution"],"summary":"Circles V2 Pool Search (snapshot)","description":"**Required Access:** `tier1`\n\nPoint-in-time (pool_address, display_name) lookup of Circles v2 liquidity pools that backs the Pool Explorer filter dropdown. Returns one row per known pool with its lowercased contract address and human-readable label.\n\n\n**Columns:**\n- **as_of_date** (`Date`): Snapshot date the lookup was generated (today(), UTC).\n- **pool_address** (`String`): Lowercased Circles liquidity pool contract address.\n- **display_name** (`String`): Human-readable pool label shown in the Pool Explorer dropdown.","operationId":"api_execution_circles_v2_pool_search_get_v1_execution_circles_v2_pool_search_snapshot_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"as_of_date":{"type":"string","format":"date","description":"Snapshot date the lookup was generated (today(), UTC)."},"pool_address":{"type":"string","description":"Lowercased Circles liquidity pool contract address."},"display_name":{"type":"string","description":"Human-readable pool label shown in the Pool Explorer dropdown."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/circles_v2_pools/latest":{"get":{"tags":["Execution"],"summary":"Circles V2 Pools (latest)","description":"**Required Access:** `tier1`\n\nOne row per main Circles DEX pool: latest TVL plus trailing-7d volume, trades, distinct traders and fees. Backs the Liquidity KPI tiles and pools leaderboard.\n\n\n**Columns:**\n- **as_of_date** (`Date`): Date the snapshot is computed as of (query date\n- **pool_address** (`String`): Pool contract address (lowercase).\n- **pool** (`String`): Human-readable pool label (token pair).\n- **protocol** (`Nullable(String)`): DEX protocol (Uniswap V3).\n- **tvl_usd** (`Nullable(Float64)`): Most recent daily TVL in USD.\n- **volume_7d** (`Float64`): Trailing-7d trading volume in USD.\n- **trades_7d** (`UInt64`): Trailing-7d swap count.\n- **traders_7d** (`UInt64`): Trailing-7d distinct traders (deduplicated across days).\n- **fees_7d** (`Float64`): Trailing-7d fees in USD.","operationId":"api_execution_circles_v2_pools_latest_get_v1_execution_circles_v2_pools_latest_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"as_of_date":{"type":"string","format":"date","description":"Date the snapshot is computed as of (query date"},"pool_address":{"type":"string","description":"Pool contract address (lowercase)."},"pool":{"type":"string","description":"Human-readable pool label (token pair)."},"protocol":{"type":"string","description":"DEX protocol (Uniswap V3)."},"tvl_usd":{"type":"number","description":"Most recent daily TVL in USD."},"volume_7d":{"type":"number","description":"Trailing-7d trading volume in USD."},"trades_7d":{"type":"integer","description":"Trailing-7d swap count."},"traders_7d":{"type":"integer","description":"Trailing-7d distinct traders (deduplicated across days)."},"fees_7d":{"type":"number","description":"Trailing-7d fees in USD."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/circles_v2_pools/daily":{"get":{"tags":["Execution"],"summary":"Circles V2 Pools (daily)","description":"**Required Access:** `tier1`\n\nDaily liquidity/market metrics for the main Circles DEX pools (seed circles_liquidity_pools), one row per (date, pool). Sourced from int_execution_pools_metrics_daily; current incomplete day excluded.\n\n\n**Columns:**\n- **date** (`Date`): Calendar day (UTC).\n- **pool** (`String`): Human-readable pool label (token pair).\n- **pool_address** (`String`): Pool contract address (lowercase).\n- **protocol** (`String`): DEX protocol (Uniswap V3).\n- **tvl_usd** (`Nullable(Float64)`): Total value locked in USD.\n- **volume_usd** (`Float64`): Daily trading volume in USD.\n- **fees_usd** (`Float64`): Daily accrued fees in USD.\n- **swap_count** (`UInt64`): Number of Swap events on this pool on this day.","operationId":"api_execution_circles_v2_pools_daily_get_v1_execution_circles_v2_pools_daily_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"date":{"type":"string","format":"date","description":"Calendar day (UTC)."},"pool":{"type":"string","description":"Human-readable pool label (token pair)."},"pool_address":{"type":"string","description":"Pool contract address (lowercase)."},"protocol":{"type":"string","description":"DEX protocol (Uniswap V3)."},"tvl_usd":{"type":"number","description":"Total value locked in USD."},"volume_usd":{"type":"number","description":"Daily trading volume in USD."},"fees_usd":{"type":"number","description":"Daily accrued fees in USD."},"swap_count":{"type":"integer","description":"Number of Swap events on this pool on this day."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/circles_v2_pools_reserves/latest":{"get":{"tags":["Execution"],"summary":"Circles V2 Pools Reserves (latest)","description":"**Required Access:** `tier1`\n\nLatest per-(pool, token) reserve, token USD price and TVL for the main Circles DEX pools. Emits two rows per pool (one per leg), backing the pool-reserves card.\n\n\n**Columns:**\n- **as_of_date** (`Date`): Freshness date the row was materialized (today, UTC).\n- **pool** (`String`): Human-readable pool label.\n- **pool_address** (`String`): On-chain address of the DEX pool contract.\n- **token_address** (`String`): On-chain address of the reserve token (one of the pool's two legs).\n- **token_symbol** (`String`): Symbol of the reserve token.\n- **reserve** (`Float64`): Latest reserve amount held for this token in the pool.\n- **price_usd** (`Float64`): Latest USD price of the reserve token.\n- **tvl_usd** (`Float64`): Latest USD value of this token's reserve (reserve x price).\n- **as_of** (`Date`): Most recent source date the latest reserve/price/TVL values were observed.","operationId":"api_execution_circles_v2_pools_reserves_latest_get_v1_execution_circles_v2_pools_reserves_latest_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"as_of_date":{"type":"string","format":"date","description":"Freshness date the row was materialized (today, UTC)."},"pool":{"type":"string","description":"Human-readable pool label."},"pool_address":{"type":"string","description":"On-chain address of the DEX pool contract."},"token_address":{"type":"string","description":"On-chain address of the reserve token (one of the pool's two legs)."},"token_symbol":{"type":"string","description":"Symbol of the reserve token."},"reserve":{"type":"number","description":"Latest reserve amount held for this token in the pool."},"price_usd":{"type":"number","description":"Latest USD price of the reserve token."},"tvl_usd":{"type":"number","description":"Latest USD value of this token's reserve (reserve x price)."},"as_of":{"type":"string","format":"date","description":"Most recent source date the latest reserve/price/TVL values were observed."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/circles_v2_pools_reserves/daily":{"get":{"tags":["Execution"],"summary":"Circles V2 Pools Reserves (daily)","description":"**Required Access:** `tier1`\n\nDaily USD total value locked (TVL) per main Circles DEX pool, computed as the sum of both token legs' USD value. Backs the reserves-over-time chart and the latest-TVL used by the KPI and leaderboard.\n\n\n**Columns:**\n- **date** (`Date`): Calendar day (UTC).\n- **pool** (`String`): Human-readable pool label.\n- **pool_address** (`String`): Pool contract address.\n- **tvl_usd** (`Float64`): Total value locked in the pool that day in USD (sum of both token legs, rounded to 2 decimals).","operationId":"api_execution_circles_v2_pools_reserves_daily_get_v1_execution_circles_v2_pools_reserves_daily_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"date":{"type":"string","format":"date","description":"Calendar day (UTC)."},"pool":{"type":"string","description":"Human-readable pool label."},"pool_address":{"type":"string","description":"Pool contract address."},"tvl_usd":{"type":"number","description":"Total value locked in the pool that day in USD (sum of both token legs, rounded to 2 decimals)."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/circles_v2_pools_reserves_token/daily":{"get":{"tags":["Execution"],"summary":"Circles V2 Pools Reserves Token (daily)","description":"**Required Access:** `tier1`\n\nDaily per-(pool, token) reserve balance and USD valuation for the main Circles DEX pools (Uniswap V3 and Balancer V3). Base model behind the TVL rollup, the reserves-over-time chart and the reserves card; prices come from a daily ASOF carry-forward and the current incomplete day is excluded.\n\n\n**Columns:**\n- **date** (`Date`): Calendar day (UTC).\n- **pool** (`String`): Human-readable pool label.\n- **pool_address** (`String`): Pool contract address (lowercased, 0x-prefixed).\n- **token_address** (`String`): Reserve token contract address (lowercased).\n- **token_symbol** (`String`): Human-readable token symbol (sDAI/EURe/s-gCRC/s-CBG, or the address prefix as fallback).\n- **reserve** (`Float64`): Token reserve balance held by the pool that day (native token units).\n- **price_usd** (`Nullable(Float64)`): ASOF carry-forward USD price for the token, falling back to the earliest observed price; may be null when the token is unpriced.\n- **tvl_usd** (`Nullable(Float64)`): USD value of the reserve (reserve * price_usd); null when the token leg is unpriced.","operationId":"api_execution_circles_v2_pools_reserves_token_daily_get_v1_execution_circles_v2_pools_reserves_token_daily_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"date":{"type":"string","format":"date","description":"Calendar day (UTC)."},"pool":{"type":"string","description":"Human-readable pool label."},"pool_address":{"type":"string","description":"Pool contract address (lowercased, 0x-prefixed)."},"token_address":{"type":"string","description":"Reserve token contract address (lowercased)."},"token_symbol":{"type":"string","description":"Human-readable token symbol (sDAI/EURe/s-gCRC/s-CBG, or the address prefix as fallback)."},"reserve":{"type":"number","description":"Token reserve balance held by the pool that day (native token units)."},"price_usd":{"type":"number","description":"ASOF carry-forward USD price for the token, falling back to the earliest observed price; may be null when the token is unpriced."},"tvl_usd":{"type":"number","description":"USD value of the reserve (reserve * price_usd); null when the token leg is unpriced."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/circles_v2_pools_traders/daily":{"get":{"tags":["Execution"],"summary":"Circles V2 Pools Traders (daily)","description":"**Required Access:** `tier1`\n\nDaily distinct traders and trade count per main Circles DEX pool. A trader is the swap taker (Swap recipient), falling back to the tx signer.\n\n\n**Columns:**\n- **date** (`Date`): Calendar day (UTC).\n- **pool** (`String`): Human-readable pool label (token pair).\n- **pool_address** (`String`): Pool contract address (lowercase).\n- **distinct_traders** (`UInt64`): Distinct traders active in the pool that day.\n- **trades** (`UInt64`): Number of swaps in the pool that day.","operationId":"api_execution_circles_v2_pools_traders_daily_get_v1_execution_circles_v2_pools_traders_daily_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"date":{"type":"string","format":"date","description":"Calendar day (UTC)."},"pool":{"type":"string","description":"Human-readable pool label (token pair)."},"pool_address":{"type":"string","description":"Pool contract address (lowercase)."},"distinct_traders":{"type":"integer","description":"Distinct traders active in the pool that day."},"trades":{"type":"integer","description":"Number of swaps in the pool that day."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/circles_v2_score_mints/daily":{"get":{"tags":["Execution"],"summary":"Circles V2 Score Mints (daily)","description":"**Required Access:** `tier1`\n\nDaily score-based mint activity per group: mint count, distinct minters, average member score at mint, and total group tokens minted. Current incomplete day excluded.\n\n\n**Columns:**\n- **group_address** (`String`): Lowercased group avatar address.\n- **date** (`Date`): Calendar day (UTC).\n- **n_mints** (`UInt64`): Number of score-based mints that day.\n- **n_minters** (`UInt64`): Distinct minters that day.\n- **avg_score** (`Float64`): Average member score at mint that day.\n- **amount** (`Float64`): Total group tokens minted that day (CRC).","operationId":"api_execution_circles_v2_score_mints_daily_get_v1_execution_circles_v2_score_mints_daily_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"group_address":{"type":"string","description":"Lowercased group avatar address."},"date":{"type":"string","format":"date","description":"Calendar day (UTC)."},"n_mints":{"type":"integer","description":"Number of score-based mints that day."},"n_minters":{"type":"integer","description":"Distinct minters that day."},"avg_score":{"type":"number","description":"Average member score at mint that day."},"amount":{"type":"number","description":"Total group tokens minted that day (CRC)."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/circles_v2_stats_current/latest":{"get":{"tags":["Execution"],"summary":"Circles V2 Stats Current (latest)","description":"**Required Access:** `tier1`\n\nSnapshot of network-level Circles v2 counts (avatars total + by type, active trusts, tokens, wrappers). One row per measure.\n\n\n**Columns:**\n- **measure** (`String`): Measure name (avatar_count_v2 / human_count_v2 / group_count_v2 / org_count_v2 / active_trust_count_v2 / token_count_v2 / wrapper_count_v2).\n- **value** (`UInt64`): Measure value.\n- **as_of_date** (`Date`): Date the snapshot is computed as of (max date in the underlying data).","operationId":"api_execution_circles_v2_stats_current_get_v1_execution_circles_v2_stats_current_latest_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"measure":{"type":"string","description":"Measure name (avatar_count_v2 / human_count_v2 / group_count_v2 / org_count_v2 / active_trust_count_v2 / token_count_v2 / wrapper_count_v2)."},"value":{"type":"integer","description":"Measure value."},"as_of_date":{"type":"string","format":"date","description":"Date the snapshot is computed as of (max date in the underlying data)."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/circles_v2_supply_by_holder_type/daily":{"get":{"tags":["Execution"],"summary":"Circles V2 Supply By Holder Type (daily)","description":"**Required Access:** `tier1`\n\nAPI view of daily CRC supply breakdown by holder type (avatar type or Dune label sector).\n\n**Columns:**\n- **date** (`Date`): Calendar date.\n- **label** (`String`): Holder classification (Human, Group, Organization, DEX, Wallets and AA, etc.).\n- **value** (`Float64`): Nominal supply held by this holder type in CRC.\n- **value_demurraged** (`Float64`): Demurrage-adjusted supply held by this holder type in CRC.\n- **holder_count** (`UInt64`): Number of distinct addresses in this holder type.","operationId":"api_execution_circles_v2_supply_by_holder_type_daily_get_v1_execution_circles_v2_supply_by_holder_type_daily_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"date":{"type":"string","format":"date","description":"Calendar date."},"label":{"type":"string","description":"Holder classification (Human, Group, Organization, DEX, Wallets and AA, etc.)."},"value":{"type":"number","description":"Nominal supply held by this holder type in CRC."},"value_demurraged":{"type":"number","description":"Demurrage-adjusted supply held by this holder type in CRC."},"holder_count":{"type":"integer","description":"Number of distinct addresses in this holder type."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/circles_v2_total_supply/daily":{"get":{"tags":["Execution"],"summary":"Circles V2 Total Supply (daily)","description":"**Required Access:** `tier1`\n\nAPI view of daily network-wide CRC supply.\n\n**Columns:**\n- **date** (`Date`): Calendar date.\n- **value** (`Float64`): Total CRC supply (nominal).\n- **value_demurraged** (`Float64`): Total CRC supply (demurrage-adjusted).\n- **token_count** (`UInt64`): Number of distinct tokens with non-zero supply.","operationId":"api_execution_circles_v2_total_supply_daily_get_v1_execution_circles_v2_total_supply_daily_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"date":{"type":"string","format":"date","description":"Calendar date."},"value":{"type":"number","description":"Total CRC supply (nominal)."},"value_demurraged":{"type":"number","description":"Total CRC supply (demurrage-adjusted)."},"token_count":{"type":"integer","description":"Number of distinct tokens with non-zero supply."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/circles_v2_transfers/daily":{"get":{"tags":["Execution"],"summary":"Circles V2 Transfers (daily)","description":"**Required Access:** `tier1`\n\nTime-series of Circles v2 transfers by category.\n\n**Columns:**\n- **date** (`Date`): Calendar day (UTC).\n- **transfer_category** (`String`): Transfer category (mint / burn / wrap / unwrap / p2p).\n- **n_transfers** (`UInt64`): Number of transfers in this category on this day.\n- **n_senders** (`UInt64`): Distinct sender addresses in this category on this day (zero address excluded).\n- **n_receivers** (`UInt64`): Distinct recipient addresses in this category on this day (zero address excluded).\n- **amount** (`Float64`): Sum of native transfer amount in CRC (raw / 1e18).\n- **amount_demurraged** (`Float64`): Sum of demurrage-adjusted transfer amount in CRC.","operationId":"api_execution_circles_v2_transfers_daily_get_v1_execution_circles_v2_transfers_daily_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"date":{"type":"string","format":"date","description":"Calendar day (UTC)."},"transfer_category":{"type":"string","description":"Transfer category (mint / burn / wrap / unwrap / p2p)."},"n_transfers":{"type":"integer","description":"Number of transfers in this category on this day."},"n_senders":{"type":"integer","description":"Distinct sender addresses in this category on this day (zero address excluded)."},"n_receivers":{"type":"integer","description":"Distinct recipient addresses in this category on this day (zero address excluded)."},"amount":{"type":"number","description":"Sum of native transfer amount in CRC (raw / 1e18)."},"amount_demurraged":{"type":"number","description":"Sum of demurrage-adjusted transfer amount in CRC."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/circles_v2_trust_relations_current/snapshot":{"get":{"tags":["Execution"],"summary":"Circles V2 Trust Relations Current (snapshot)","description":"**Required Access:** `tier1`\n\nAPI view of current active Circles v2 trust relations.\n\n**Columns:**\n- **truster** (`String`): Address of the avatar granting trust.\n- **trustee** (`String`): Address of the avatar receiving trust.\n- **valid_from** (`DateTime64`): Start timestamp of the trust relation validity period.\n- **valid_to** (`DateTime64`): End timestamp of the trust relation validity period.\n- **as_of_date** (`Date`): Date the snapshot is computed as of (max date in the underlying data).","operationId":"api_execution_circles_v2_trust_relations_current_get_v1_execution_circles_v2_trust_relations_current_snapshot_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"truster":{"type":"string","description":"Address of the avatar granting trust."},"trustee":{"type":"string","description":"Address of the avatar receiving trust."},"valid_from":{"type":"string","format":"date-time","description":"Start timestamp of the trust relation validity period."},"valid_to":{"type":"string","format":"date-time","description":"End timestamp of the trust relation validity period."},"as_of_date":{"type":"string","format":"date","description":"Date the snapshot is computed as of (max date in the underlying data)."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/circles_v2_trusts/daily":{"get":{"tags":["Execution"],"summary":"Circles V2 Trusts (daily)","description":"**Required Access:** `tier1`\n\nTime-series view over int_execution_circles_v2_trusts_daily; latest day excluded.\n\n**Columns:**\n- **date** (`Date`): Calendar day (UTC).\n- **n_trust_events** (`UInt64`): Total Trust events on this day.\n- **n_new_trusts** (`UInt64`): Events granting or extending trust (expiry > now).\n- **n_revoked_trusts** (`UInt64`): Events setting expiry <= now (revoke).\n- **n_distinct_trusters** (`UInt64`): Distinct truster addresses active that day.\n- **n_distinct_trustees** (`UInt64`): Distinct trustee addresses active that day.","operationId":"api_execution_circles_v2_trusts_daily_get_v1_execution_circles_v2_trusts_daily_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"date":{"type":"string","format":"date","description":"Calendar day (UTC)."},"n_trust_events":{"type":"integer","description":"Total Trust events on this day."},"n_new_trusts":{"type":"integer","description":"Events granting or extending trust (expiry > now)."},"n_revoked_trusts":{"type":"integer","description":"Events setting expiry <= now (revoke)."},"n_distinct_trusters":{"type":"integer","description":"Distinct truster addresses active that day."},"n_distinct_trustees":{"type":"integer","description":"Distinct trustee addresses active that day."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/circles_v2_trusts_distribution/latest":{"get":{"tags":["Execution"],"summary":"Circles V2 Trusts Distribution (latest)","description":"**Required Access:** `tier1`\n\nDistribution histogram of trust degree (given / received) across avatars. Each row is a (direction, bucket) cell with the count of avatars whose trust degree falls in that bucket as of the latest complete day.\n\n\n**Columns:**\n- **direction** (`String`): 'given' or 'received'.\n- **trust_bucket** (`String`): Bucket label (0 / 1-5 / 6-10 / 11-25 / 26-50 / 51-100 / 100+).\n- **avatar_count** (`UInt64`): Number of avatars in this bucket.\n- **as_of_date** (`Date`): Date the snapshot is computed as of (max date in the underlying data).","operationId":"api_execution_circles_v2_trusts_distribution_get_v1_execution_circles_v2_trusts_distribution_latest_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"direction":{"type":"string","description":"'given' or 'received'."},"trust_bucket":{"type":"string","description":"Bucket label (0 / 1-5 / 6-10 / 11-25 / 26-50 / 51-100 / 100+)."},"avatar_count":{"type":"integer","description":"Number of avatars in this bucket."},"as_of_date":{"type":"string","format":"date","description":"Date the snapshot is computed as of (max date in the underlying data)."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/circles_v2_wrapper_share/daily":{"get":{"tags":["Execution"],"summary":"Circles V2 Wrapper Share (daily)","description":"**Required Access:** `tier1`\n\nNetwork wrapped vs unwrapped supply share over time.\n\n**Columns:**\n- **date** (`Date`): Calendar day (UTC).\n- **wrapped_supply** (`Float64`): Cumulative ERC-20 wrapped CRC across all wrappers on this day.\n- **unwrapped_supply** (`Float64`): Native (unwrapped) CRC supply on this day (total_supply - wrapped_supply).\n- **total_supply** (`Float64`): Network-wide total CRC supply on this day.\n- **wrapped_pct** (`Nullable(Float64)`): wrapped_supply / total_supply × 100, rounded to 2 decimals. NULL when total_supply = 0.","operationId":"api_execution_circles_v2_wrapper_share_daily_get_v1_execution_circles_v2_wrapper_share_daily_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"date":{"type":"string","format":"date","description":"Calendar day (UTC)."},"wrapped_supply":{"type":"number","description":"Cumulative ERC-20 wrapped CRC across all wrappers on this day."},"unwrapped_supply":{"type":"number","description":"Native (unwrapped) CRC supply on this day (total_supply - wrapped_supply)."},"total_supply":{"type":"number","description":"Network-wide total CRC supply on this day."},"wrapped_pct":{"type":"number","description":"wrapped_supply / total_supply × 100, rounded to 2 decimals. NULL when total_supply = 0."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/cow_batch_metrics_ts/daily":{"get":{"tags":["Execution"],"summary":"Cow Batch Metrics Ts (daily)","description":"**Required Access:** `tier1`\n\nDaily average number of trades settled per CoW Protocol batch. Values above 1.0 indicate days where the solver matched multiple orders in a single settlement. On Gnosis Chain this peaked at ~2.8 in mid-2021 and has been near 1.0 since 2022, reflecting that most batches now contain a single trade routed through external DEX liquidity. Superseded by api_execution_cow_batch_routing_ts for routing-type breakdown.\n\n\n**Columns:**\n- **date** (`Date`): Calendar day of the batch-metrics time series.\n- **value** (`Float64`): Average trades per batch on this day.","operationId":"api_execution_cow_batch_metrics_ts_get_v1_execution_cow_batch_metrics_ts_daily_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"date":{"type":"string","format":"date","description":"Calendar day of the batch-metrics time series."},"value":{"type":"number","description":"Average trades per batch on this day."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/cow_batch_routing_ts/daily":{"get":{"tags":["Execution"],"summary":"Cow Batch Routing Ts (daily)","description":"**Required Access:** `tier1`\n\nDaily share of CoW Protocol settlement batches by routing type, as percentages of total daily batches. Three labels: \"Pure CoW\" (multi-trade batch with zero AMM interactions — true Coincidence of Wants), \"Partial CoW\" (multi-trade batch with some AMM interactions, meaning at least some peer matching happened), \"Pure DEX\" (single-trade batches or all trades routed through AMMs). Pure CoW peaked at ~34% in Sep 2021 and is near zero on Gnosis Chain since mid-2022.\n\n\n**Columns:**\n- **date** (`Date`): Calendar day of the batch-routing time series.\n- **label** (`String`): 'Pure CoW' | 'Partial CoW' | 'Pure DEX'.\n- **value** (`Float64`): Percentage of daily batches in this routing category (0–100).","operationId":"api_execution_cow_batch_routing_ts_get_v1_execution_cow_batch_routing_ts_daily_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"date":{"type":"string","format":"date","description":"Calendar day of the batch-routing time series."},"label":{"type":"string","description":"'Pure CoW' | 'Partial CoW' | 'Pure DEX'."},"value":{"type":"number","description":"Percentage of daily batches in this routing category (0–100)."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/cow_fees_ts/daily":{"get":{"tags":["Execution"],"summary":"Cow Fees Ts (daily)","description":"**Required Access:** `tier1`\n\nDaily CoW Protocol revenue (USD) on Gnosis Chain. Filtered to fee_source = 'api' — surplus-based fees introduced Sep 2024. Pre-Sep 2024 on-chain feeAmount values are excluded: under CoW v1's fee-subsidy model that field represented the user's signed-maximum fee ceiling, not actual protocol revenue (the DAO reimbursed solvers for gas + a small margin off-chain via CIP-12 / solver rewards). Including those values would overstate revenue for 2021–mid-2024 by orders of magnitude relative to what the protocol actually kept.\n\n\n**Columns:**\n- **date** (`Date`): Calendar day of the fees time series.\n- **value** (`Nullable(Float64)`): Daily USD fees collected via the surplus-based fee model.","operationId":"api_execution_cow_fees_ts_get_v1_execution_cow_fees_ts_daily_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"date":{"type":"string","format":"date","description":"Calendar day of the fees time series."},"value":{"type":"number","description":"Daily USD fees collected via the surplus-based fee model."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/cow_kpi_active_solvers/last_7d":{"get":{"tags":["Execution"],"summary":"Cow Kpi Active Solvers (last_7d)","description":"**Required Access:** `tier0` (no API key required)\n\nNumber of distinct solvers that settled at least one batch in the last 7 complete days, with week-over-week change. Reflects who is actually competing for batches, not just who is allow-listed.\n\n\n**Columns:**\n- **value** (`UInt64`): Distinct solvers with >=1 batch in the last 7 complete days.\n- **change_pct** (`Nullable(Float64)`): Percentage change vs the prior 7-day window.\n- **as_of_date** (`Date`): Last complete day reflected in the trailing 7-day window (today - 1).","operationId":"api_execution_cow_kpi_active_solvers_get_v1_execution_cow_kpi_active_solvers_last_7d_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"value":{"type":"integer","description":"Distinct solvers with >=1 batch in the last 7 complete days."},"change_pct":{"type":"number","description":"Percentage change vs the prior 7-day window."},"as_of_date":{"type":"string","format":"date","description":"Last complete day reflected in the trailing 7-day window (today - 1)."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/cow_kpi_fees/last_7d/7d":{"get":{"tags":["Execution"],"summary":"Cow Kpi Fees (last_7d) [7d]","description":"**Required Access:** `tier0` (no API key required)\n\n7-day CoW Protocol revenue (USD) with week-over-week change. Reflects surplus-based fees (fee_source = 'api', Sep 2024+). Pre-Sep 2024 on-chain feeAmount is excluded because those values represent signed-maximum under CoW v1's fee-subsidy model, not actual revenue.\n\n\n**Columns:**\n- **value** (`Nullable(Float64)`): Total api-sourced fees USD over the last 7 complete days.\n- **change_pct** (`Nullable(Float64)`): Percentage change vs the prior 7-day window.\n- **as_of_date** (`Date`): Last complete day reflected in the trailing 7-day window (today - 1).","operationId":"api_execution_cow_kpi_fees_7d_get_v1_execution_cow_kpi_fees_last_7d_7d_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"value":{"type":"number","description":"Total api-sourced fees USD over the last 7 complete days."},"change_pct":{"type":"number","description":"Percentage change vs the prior 7-day window."},"as_of_date":{"type":"string","format":"date","description":"Last complete day reflected in the trailing 7-day window (today - 1)."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/cow_kpi_solver_value/last_7d/7d":{"get":{"tags":["Execution"],"summary":"Cow Kpi Solver Value (last_7d) [7d]","description":"**Required Access:** `tier0` (no API key required)\n\n7-day gross solver value (USD) with week-over-week change. Covers priceImprovement and surplus fee policies (Sep 2024+).\n\n\n**Columns:**\n- **value** (`Nullable(Float64)`): Total solver-generated value (USD) over the last 7 complete days.\n- **change_pct** (`Nullable(Float64)`): Percentage change vs the prior 7-day window.\n- **as_of_date** (`Date`): Last complete day reflected in the trailing 7-day window (today - 1).","operationId":"api_execution_cow_kpi_solver_value_7d_get_v1_execution_cow_kpi_solver_value_last_7d_7d_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"value":{"type":"number","description":"Total solver-generated value (USD) over the last 7 complete days."},"change_pct":{"type":"number","description":"Percentage change vs the prior 7-day window."},"as_of_date":{"type":"string","format":"date","description":"Last complete day reflected in the trailing 7-day window (today - 1)."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/cow_kpi_traders/last_7d/7d":{"get":{"tags":["Execution"],"summary":"Cow Kpi Traders (last_7d) [7d]","description":"**Required Access:** `tier0` (no API key required)\n\n7-day unique trader count (exact) with week-over-week change. Uses fct_execution_cow_trades directly for exact uniqExact across the window (daily uniques are not additive).\n\n\n**Columns:**\n- **value** (`UInt64`): Distinct taker addresses over the last 7 complete days.\n- **change_pct** (`Nullable(Float64)`): Percentage change vs the prior 7-day window.\n- **as_of_date** (`Date`): Last complete day reflected in the trailing 7-day window (today - 1).","operationId":"api_execution_cow_kpi_traders_7d_get_v1_execution_cow_kpi_traders_last_7d_7d_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"value":{"type":"integer","description":"Distinct taker addresses over the last 7 complete days."},"change_pct":{"type":"number","description":"Percentage change vs the prior 7-day window."},"as_of_date":{"type":"string","format":"date","description":"Last complete day reflected in the trailing 7-day window (today - 1)."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/cow_kpi_trades/last_7d/7d":{"get":{"tags":["Execution"],"summary":"Cow Kpi Trades (last_7d) [7d]","description":"**Required Access:** `tier0` (no API key required)\n\n7-day CoW Protocol trade count with week-over-week change.\n\n\n**Columns:**\n- **value** (`UInt64`): Total trades over the last 7 complete days.\n- **change_pct** (`Nullable(Float64)`): Percentage change vs the prior 7-day window.\n- **as_of_date** (`Date`): Last complete day reflected in the trailing 7-day window (today - 1).","operationId":"api_execution_cow_kpi_trades_7d_get_v1_execution_cow_kpi_trades_last_7d_7d_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"value":{"type":"integer","description":"Total trades over the last 7 complete days."},"change_pct":{"type":"number","description":"Percentage change vs the prior 7-day window."},"as_of_date":{"type":"string","format":"date","description":"Last complete day reflected in the trailing 7-day window (today - 1)."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/cow_kpi_volume/last_7d/7d":{"get":{"tags":["Execution"],"summary":"Cow Kpi Volume (last_7d) [7d]","description":"**Required Access:** `tier0` (no API key required)\n\n7-day CoW Protocol trading volume with week-over-week change.\n\n\n**Columns:**\n- **value** (`Float64`): Total USD volume over the last 7 complete days.\n- **change_pct** (`Nullable(Float64)`): Percentage change vs the prior 7-day window.\n- **as_of_date** (`Date`): Last complete day reflected in the trailing 7-day window (today - 1).","operationId":"api_execution_cow_kpi_volume_7d_get_v1_execution_cow_kpi_volume_last_7d_7d_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"value":{"type":"number","description":"Total USD volume over the last 7 complete days."},"change_pct":{"type":"number","description":"Percentage change vs the prior 7-day window."},"as_of_date":{"type":"string","format":"date","description":"Last complete day reflected in the trailing 7-day window (today - 1)."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/cow_solver_value_ts/daily":{"get":{"tags":["Execution"],"summary":"Cow Solver Value Ts (daily)","description":"**Required Access:** `tier1`\n\nDaily gross value generated by CoW solvers on Gnosis Chain (USD). For each trade with a priceImprovement or surplus fee policy, this is the full value found beyond the reference price before the protocol takes its cut (solver_value_usd = fee_usd / surplus_factor). Sep 2024+ only.\n\n\n**Columns:**\n- **date** (`Date`): Calendar day of the solver-value time series.\n- **value** (`Nullable(Float64)`): Daily USD solver-generated value.","operationId":"api_execution_cow_solver_value_ts_get_v1_execution_cow_solver_value_ts_daily_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"date":{"type":"string","format":"date","description":"Calendar day of the solver-value time series."},"value":{"type":"number","description":"Daily USD solver-generated value."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/cow_solvers_volume_ts/daily":{"get":{"tags":["Execution"],"summary":"Cow Solvers Volume Ts (daily)","description":"**Required Access:** `tier1`\n\nDaily volume by solver, top 6 by recent (180d) volume plus an \"Other\" bucket. Solver labels come from the cow_solvers seed when available; otherwise fall back to a truncated address. Uses a 180-day ranking window to surface currently active solvers rather than historically dominant but now-inactive ones.\n\n\n**Columns:**\n- **date** (`Date`): Calendar day of the per-solver volume time series.\n- **label** (`String`): Solver name (from seed) or truncated address, or \"Other\".\n- **value** (`Nullable(Float64)`): Daily USD volume for this solver group.","operationId":"api_execution_cow_solvers_volume_ts_get_v1_execution_cow_solvers_volume_ts_daily_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"date":{"type":"string","format":"date","description":"Calendar day of the per-solver volume time series."},"label":{"type":"string","description":"Solver name (from seed) or truncated address, or \"Other\"."},"value":{"type":"number","description":"Daily USD volume for this solver group."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/cow_top_pairs/weekly":{"get":{"tags":["Execution"],"summary":"Cow Top Pairs (weekly)","description":"**Required Access:** `tier1`\n\nWeekly volume by top 8 directional token pairs (sold → bought), with remaining pairs grouped as \"Other\". Pair ranking uses lifetime volume.\n\n\n**Columns:**\n- **date** (`Date`): Week start (Monday).\n- **label** (`String`): Directional pair label, e.g. 'USDC.e → EURe', or 'Other'.\n- **value** (`Nullable(Float64)`): Weekly USD volume for this pair group.","operationId":"api_execution_cow_top_pairs_weekly_get_v1_execution_cow_top_pairs_weekly_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"date":{"type":"string","format":"date","description":"Week start (Monday)."},"label":{"type":"string","description":"Directional pair label, e.g. 'USDC.e → EURe', or 'Other'."},"value":{"type":"number","description":"Weekly USD volume for this pair group."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/cow_trades_ts/daily":{"get":{"tags":["Execution"],"summary":"Cow Trades Ts (daily)","description":"**Required Access:** `tier1`\n\nDaily CoW Protocol trade count.\n\n\n**Columns:**\n- **date** (`Date`): Calendar day of the trade-count time series.\n- **value** (`UInt64`): Number of trades on this day.","operationId":"api_execution_cow_trades_ts_get_v1_execution_cow_trades_ts_daily_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"date":{"type":"string","format":"date","description":"Calendar day of the trade-count time series."},"value":{"type":"integer","description":"Number of trades on this day."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/cow_volume_ts/daily":{"get":{"tags":["Execution"],"summary":"Cow Volume Ts (daily)","description":"**Required Access:** `tier1`\n\nDaily CoW Protocol trading volume. Client-side time-range filtering applies via the dashboard's global selector.\n\n\n**Columns:**\n- **date** (`Date`): Calendar day of the volume time series.\n- **value** (`Nullable(Float64)`): Daily USD volume.","operationId":"api_execution_cow_volume_ts_get_v1_execution_cow_volume_ts_daily_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"date":{"type":"string","format":"date","description":"Calendar day of the volume time series."},"value":{"type":"number","description":"Daily USD volume."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/execution_lending/daily":{"get":{"tags":["Execution"],"summary":"Execution Lending (daily)","description":"**Required Access:** `tier1`\n\nLong-format daily APY series per (token, protocol) across Aave V3 and\nSparkLend. Each row pivots into one of two apy_type values\n('Lending APY' or 'Borrow APY'). Drives the lending APY time-series\nchart on the lending dashboard.\n\n\n**Columns:**\n- **date** (`Date`)\n- **token** (`String`): Reserve token symbol.\n- **token_class** (`String`)\n- **label** (`String`): Lending protocol identifier ('Aave V3' or 'SparkLend').\n- **apy_type** (`String`): 'Lending APY' or 'Borrow APY'.\n- **value** (`Float64`): APY for the row's apy_type.","operationId":"api_execution_lending_daily_get_v1_execution_execution_lending_daily_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"date":{"type":"string","format":"date"},"token":{"type":"string","description":"Reserve token symbol."},"token_class":{"type":"string"},"label":{"type":"string","description":"Lending protocol identifier ('Aave V3' or 'SparkLend')."},"apy_type":{"type":"string","description":"'Lending APY' or 'Borrow APY'."},"value":{"type":"number","description":"APY for the row's apy_type."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/execution_lending/snapshot":{"get":{"tags":["Execution"],"summary":"Execution Lending (snapshot)","description":"**Required Access:** `tier1`\n\nLatest lending TVL per reserve token on Gnosis (aggregated across Aave V3 and SparkLend) for pie chart display. Each row is a token with its total USD value locked across all protocols.\n\n**Columns:**\n- **token** (`String`)\n- **value** (`Float64`)\n- **as_of_date** (`Date`): Date the snapshot is computed as of (max date in the underlying data).","operationId":"api_execution_lending_tvl_by_token_latest_get_v1_execution_execution_lending_snapshot_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"token":{"type":"string"},"value":{"type":"number"},"as_of_date":{"type":"string","format":"date","description":"Date the snapshot is computed as of (max date in the underlying data)."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/execution_lending_activity_counts/weekly":{"get":{"tags":["Execution"],"summary":"Execution Lending Activity Counts (weekly)","description":"**Required Access:** `tier1`\n\nWeekly lender/borrower distinct user counts pivoted into long format for\nstacked-bar activity charts. One row per (week, token, protocol,\nactivity_type), filtered to non-zero counts. Sourced from\nfct_execution_lending_weekly.\n\n\n**Columns:**\n- **date** (`Date`): Week start date.\n- **token** (`String`): Reserve token symbol.\n- **token_class** (`String`)\n- **label** (`String`): Lending protocol identifier.\n- **activity_type** (`String`): 'Lenders' or 'Borrowers'.\n- **value** (`UInt64`): Distinct user count for the activity_type in the week.","operationId":"api_execution_lending_activity_counts_weekly_get_v1_execution_execution_lending_activity_counts_weekly_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"date":{"type":"string","format":"date","description":"Week start date."},"token":{"type":"string","description":"Reserve token symbol."},"token_class":{"type":"string"},"label":{"type":"string","description":"Lending protocol identifier."},"activity_type":{"type":"string","description":"'Lenders' or 'Borrowers'."},"value":{"type":"integer","description":"Distinct user count for the activity_type in the week."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/execution_lending_activity_volumes/weekly":{"get":{"tags":["Execution"],"summary":"Execution Lending Activity Volumes (weekly)","description":"**Required Access:** `tier1`\n\nWeekly deposit/borrow volumes pivoted into long format for stacked-bar\nvolume charts. One row per (week, token, protocol, volume_type), filtered\nto non-zero volumes. Sourced from fct_execution_lending_weekly.\n\n\n**Columns:**\n- **date** (`Date`): Week start date.\n- **token** (`String`): Reserve token symbol.\n- **token_class** (`String`)\n- **label** (`String`): Lending protocol identifier.\n- **volume_type** (`String`): 'Deposits' or 'Borrows'.\n- **value** (`Float64`): Total volume in native units for the volume_type in the week.","operationId":"api_execution_lending_activity_volumes_weekly_get_v1_execution_execution_lending_activity_volumes_weekly_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"date":{"type":"string","format":"date","description":"Week start date."},"token":{"type":"string","description":"Reserve token symbol."},"token_class":{"type":"string"},"label":{"type":"string","description":"Lending protocol identifier."},"volume_type":{"type":"string","description":"'Deposits' or 'Borrows'."},"value":{"type":"number","description":"Total volume in native units for the volume_type in the week."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/execution_lending_balance_cohorts_holders/daily":{"get":{"tags":["Execution"],"summary":"Execution Lending Balance Cohorts Holders (daily)","description":"**Required Access:** `tier1`\n\nDaily lender count by balance cohort per (protocol, token) across Aave V3 and SparkLend. Stacked bar chart data showing holder count per balance bucket, filterable by token and protocol.\n\n**Columns:**\n- **date** (`Date`)\n- **protocol** (`String`): Lending protocol identifier.\n- **token** (`String`)\n- **cohort_unit** (`String`)\n- **label** (`String`): Balance bucket label.\n- **value** (`UInt64`)","operationId":"api_execution_lending_balance_cohorts_holders_daily_get_v1_execution_execution_lending_balance_cohorts_holders_daily_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"date":{"type":"string","format":"date"},"protocol":{"type":"string","description":"Lending protocol identifier."},"token":{"type":"string"},"cohort_unit":{"type":"string"},"label":{"type":"string","description":"Balance bucket label."},"value":{"type":"integer"}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/execution_lending_balance_cohorts_value/daily":{"get":{"tags":["Execution"],"summary":"Execution Lending Balance Cohorts Value (daily)","description":"**Required Access:** `tier1`\n\nDaily lender balance cohort values per (protocol, token) across Aave V3 and SparkLend. Stacked bar chart data showing total USD and native value held by lenders in each balance bucket, filterable by token and protocol.\n\n**Columns:**\n- **date** (`Date`)\n- **protocol** (`String`): Lending protocol identifier. One of 'Aave V3' or 'SparkLend'.\n- **token** (`String`)\n- **cohort_unit** (`String`)\n- **label** (`String`): Balance bucket label (e.g. '10-100', '1k-10k').\n- **value_native** (`Float64`)\n- **value_usd** (`Float64`)","operationId":"api_execution_lending_balance_cohorts_value_daily_get_v1_execution_execution_lending_balance_cohorts_value_daily_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"date":{"type":"string","format":"date"},"protocol":{"type":"string","description":"Lending protocol identifier. One of 'Aave V3' or 'SparkLend'."},"token":{"type":"string"},"cohort_unit":{"type":"string"},"label":{"type":"string","description":"Balance bucket label (e.g. '10-100', '1k-10k')."},"value_native":{"type":"number"},"value_usd":{"type":"number"}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/execution_lending_borrowers_count/last_7d":{"get":{"tags":["Execution"],"summary":"Execution Lending Borrowers Count (last_7d)","description":"**Required Access:** `tier0` (no API key required)\n\nKPI view of recently-active borrowers on Gnosis (Aave V3, SparkLend).\nIMPORTANT — this is a 7-day FLOW, not a stock: unique wallets that emitted a\nBorrow within the trailing 7 days (bitmap-merged from fct_execution_lending_latest,\ngranularity:last_7d). It is NOT symmetric with api_execution_lending_lenders_count_7d,\nwhich is a point-in-time balance STOCK (wallets with a positive supply balance on\nthe latest date). Do not compare the two side by side as like-for-like — lenders =\nbalance stock, borrowers = 7-day borrow activity. (A true borrower STOCK would\nrequire per-wallet debt balances, which user_balances_daily does not currently track.)\nOne row per protocol plus an 'ALL'-protocols aggregate. change_pct compares against\nthe equivalent 7-day count one week earlier.\n\n\n**Columns:**\n- **token** (`String`): Always 'ALL' (no per-token slice exposed).\n- **protocol** (`String`): Lending protocol identifier or 'ALL' for the cross-protocol aggregate.\n- **value** (`Float64`): Distinct wallets that borrowed within the trailing 7 days (FLOW, not a debt-balance stock).\n- **change_pct** (`Nullable(Float64)`): Percent change vs the count 7 days earlier (NULL when prior is zero or missing).\n- **as_of_date** (`Date`): Date the snapshot is computed as of (max date in the underlying data).","operationId":"api_execution_lending_borrowers_count_7d_get_v1_execution_execution_lending_borrowers_count_last_7d_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"token":{"type":"string","description":"Always 'ALL' (no per-token slice exposed)."},"protocol":{"type":"string","description":"Lending protocol identifier or 'ALL' for the cross-protocol aggregate."},"value":{"type":"number","description":"Distinct wallets that borrowed within the trailing 7 days (FLOW, not a debt-balance stock)."},"change_pct":{"type":"number","description":"Percent change vs the count 7 days earlier (NULL when prior is zero or missing)."},"as_of_date":{"type":"string","format":"date","description":"Date the snapshot is computed as of (max date in the underlying data)."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/execution_lending_lenders_count/latest":{"get":{"tags":["Execution"],"summary":"Execution Lending Lenders Count (latest)","description":"**Required Access:** `tier0` (no API key required)\n\nKPI view of currently-active lenders on Gnosis (Aave V3, SparkLend).\n\"Active lenders\" is a STOCK measure — unique wallets currently holding a\npositive supply balance in a lending market on Gnosis (point-in-time count),\nnot a flow measure (users who supplied within a window).\n\nOne row per protocol plus an 'ALL'-protocols aggregate row (distinct\nwallets across both markets). change_pct compares today's active count vs\nthe count from 7 days ago on the same balance snapshot (users whose\nbalance was positive then, regardless of whether they're still active now).\n\n\n**Columns:**\n- **token** (`String`): Always 'ALL' (no per-token slice exposed in this view).\n- **protocol** (`String`): Lending protocol identifier or 'ALL' for the cross-protocol aggregate.\n- **value** (`Float64`): Distinct lender count with positive supply balance on the latest available date.\n- **change_pct** (`Nullable(Float64)`): Percent change vs the count 7 days earlier (NULL when the prior value is zero or missing).\n- **as_of_date** (`Date`): Date the snapshot is computed as of (max date in the underlying data).","operationId":"api_execution_lending_lenders_count_7d_get_v1_execution_execution_lending_lenders_count_latest_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"token":{"type":"string","description":"Always 'ALL' (no per-token slice exposed in this view)."},"protocol":{"type":"string","description":"Lending protocol identifier or 'ALL' for the cross-protocol aggregate."},"value":{"type":"number","description":"Distinct lender count with positive supply balance on the latest available date."},"change_pct":{"type":"number","description":"Percent change vs the count 7 days earlier (NULL when the prior value is zero or missing)."},"as_of_date":{"type":"string","format":"date","description":"Date the snapshot is computed as of (max date in the underlying data)."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/execution_pools_fee_apr/daily/7d":{"get":{"tags":["Execution"],"summary":"Execution Pools Fee Apr (daily) [7d]","description":"**Required Access:** `tier1`\n\nAPI view for fee APR (7D trailing) time series by token and pool label (Uniswap V3/Swapr V3 only). Uses accrued fees from Swap + Flash (gross; independent of Collect/claims).\n\n**Columns:**\n- **date** (`Date`): Calendar day (UTC) of the fee APR time series.\n- **token** (`String`): Token symbol the pool is grouped under.\n- **label** (`String`): Pool display name.\n- **apy_type** (`String`): Constant metric label (\"Fee APR (7D trailing)\") used as the chart series name.\n- **value** (`Float64`): 7-day trailing fee APR (annualized, %) for the pool on this date.","operationId":"api_execution_pools_fee_apr_7d_daily_get_v1_execution_execution_pools_fee_apr_daily_7d_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"date":{"type":"string","format":"date","description":"Calendar day (UTC) of the fee APR time series."},"token":{"type":"string","description":"Token symbol the pool is grouped under."},"label":{"type":"string","description":"Pool display name."},"apy_type":{"type":"string","description":"Constant metric label (\"Fee APR (7D trailing)\") used as the chart series name."},"value":{"type":"number","description":"7-day trailing fee APR (annualized, %) for the pool on this date."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/execution_pools_fees_usd/daily":{"get":{"tags":["Execution"],"summary":"Execution Pools Fees Usd (daily)","description":"**Required Access:** `tier1`\n\nAPI view for daily fee revenue (USD) by token and pool, sourced from fct_execution_pools_daily.\n\n**Columns:**\n- **date** (`Date`): Calendar day (UTC) of the fee revenue time series.\n- **token** (`String`): Token symbol the pool is grouped under.\n- **label** (`String`): Pool display name.\n- **value** (`Float64`): Daily gross fee revenue in USD.","operationId":"api_execution_pools_fees_usd_daily_get_v1_execution_execution_pools_fees_usd_daily_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"date":{"type":"string","format":"date","description":"Calendar day (UTC) of the fee revenue time series."},"token":{"type":"string","description":"Token symbol the pool is grouped under."},"label":{"type":"string","description":"Pool display name."},"value":{"type":"number","description":"Daily gross fee revenue in USD."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/execution_pools_fees_usd/snapshot/7d":{"get":{"tags":["Execution"],"summary":"Execution Pools Fees Usd (snapshot) [7d]","description":"**Required Access:** `tier1`\n\nPer-token total LP fees over the last 7 days (snapshot) with 7-day-prior change. Sourced from fct_execution_pools_snapshots filtered to metric='Fees_7D'.\n\n**Columns:**\n- **token** (`String`): Token symbol the snapshot is aggregated for.\n- **value** (`Float64`): 7-day total fees in USD for the token.\n- **change_pct** (`Nullable(Float64)`): Percent change vs the previous 7-day window.\n- **as_of_date** (`Date`): Date the snapshot is computed as of (max date in the underlying data).","operationId":"api_execution_pools_fees_7d_get_v1_execution_execution_pools_fees_usd_snapshot_7d_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"token":{"type":"string","description":"Token symbol the snapshot is aggregated for."},"value":{"type":"number","description":"7-day total fees in USD for the token."},"change_pct":{"type":"number","description":"Percent change vs the previous 7-day window."},"as_of_date":{"type":"string","format":"date","description":"Date the snapshot is computed as of (max date in the underlying data)."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/execution_pools_lp_activity/daily":{"get":{"tags":["Execution"],"summary":"Execution Pools Lp Activity (daily)","description":"**Required Access:** `tier1`\n\nAPI view for daily LP activity (Mint/Burn event counts) per pool per token, unpivoted into one row per event type for the BarChart seriesField. Reuses pool labels and top-pool filtering from fct_execution_pools_daily.\n\n\n**Columns:**\n- **date** (`Date`): Calendar day (UTC) of the LP activity.\n- **token** (`String`): Token symbol the pools are grouped under.\n- **label** (`String`): Pool label (token pair, protocol, address suffix) from fct_execution_pools_daily.\n- **type** (`String`): LP event type — 'Add' (Mint events) or 'Remove' (Burn events).\n- **value** (`UInt64`): Count of LP events of this type across all pools containing this token on this day.","operationId":"api_execution_pools_lp_activity_daily_get_v1_execution_execution_pools_lp_activity_daily_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"date":{"type":"string","format":"date","description":"Calendar day (UTC) of the LP activity."},"token":{"type":"string","description":"Token symbol the pools are grouped under."},"label":{"type":"string","description":"Pool label (token pair, protocol, address suffix) from fct_execution_pools_daily."},"type":{"type":"string","description":"LP event type — 'Add' (Mint events) or 'Remove' (Burn events)."},"value":{"type":"integer","description":"Count of LP events of this type across all pools containing this token on this day."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/execution_pools_lps_count/last_7d":{"get":{"tags":["Execution"],"summary":"Execution Pools Lps Count (last_7d)","description":"**Required Access:** `tier1`\n\nAPI view for unique LP provider count over the last 7 days per token.\n\n**Columns:**\n- **token** (`String`): Token symbol the LP count is aggregated for.\n- **value** (`Float64`): Unique LP addresses over the last 7 days across all pools containing this token.\n- **change_pct** (`Float64`): Percentage change vs the prior 7-day window.\n- **as_of_date** (`Date`): Date the snapshot is computed as of (max date in the underlying data).","operationId":"api_execution_pools_lps_count_7d_get_v1_execution_execution_pools_lps_count_last_7d_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"token":{"type":"string","description":"Token symbol the LP count is aggregated for."},"value":{"type":"number","description":"Unique LP addresses over the last 7 days across all pools containing this token."},"change_pct":{"type":"number","description":"Percentage change vs the prior 7-day window."},"as_of_date":{"type":"string","format":"date","description":"Date the snapshot is computed as of (max date in the underlying data)."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/execution_pools_net_apr/daily":{"get":{"tags":["Execution"],"summary":"Execution Pools Net Apr (daily)","description":"**Required Access:** `tier1`\n\nAPI view for net APR (fee APR plus LVR) time series by token and pool label, with fee APR and LVR components.\n\n**Columns:**\n- **date** (`Date`): Calendar day (UTC) of the APR time series.\n- **token** (`String`): Token symbol the pool is grouped under.\n- **label** (`String`): Pool display name.\n- **fee_apr_7d** (`Float64`): 7-day trailing fee APR (annualized, %).\n- **lvr_apr_7d** (`Float64`): Annualised 7-day Loss Versus Rebalancing (%). Always <= 0 (negative = loss).\n- **net_apr_7d** (`Float64`): Net APR (fee_apr_7d + lvr_apr_7d), the estimated real return after LVR cost.","operationId":"api_execution_pools_net_apr_daily_get_v1_execution_execution_pools_net_apr_daily_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"date":{"type":"string","format":"date","description":"Calendar day (UTC) of the APR time series."},"token":{"type":"string","description":"Token symbol the pool is grouped under."},"label":{"type":"string","description":"Pool display name."},"fee_apr_7d":{"type":"number","description":"7-day trailing fee APR (annualized, %)."},"lvr_apr_7d":{"type":"number","description":"Annualised 7-day Loss Versus Rebalancing (%). Always <= 0 (negative = loss)."},"net_apr_7d":{"type":"number","description":"Net APR (fee_apr_7d + lvr_apr_7d), the estimated real return after LVR cost."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/execution_pools_swap_count/daily":{"get":{"tags":["Execution"],"summary":"Execution Pools Swap Count (daily)","description":"**Required Access:** `tier1`\n\nAPI view for daily swap event count by token and pool, sourced from fct_execution_pools_daily.\n\n**Columns:**\n- **date** (`Date`): Calendar day (UTC) of the swap-count time series.\n- **token** (`String`): Token symbol the pool is grouped under.\n- **label** (`String`): Pool display name.\n- **value** (`UInt64`): Number of Swap events on this pool on this day.","operationId":"api_execution_pools_swap_count_daily_get_v1_execution_execution_pools_swap_count_daily_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"date":{"type":"string","format":"date","description":"Calendar day (UTC) of the swap-count time series."},"token":{"type":"string","description":"Token symbol the pool is grouped under."},"label":{"type":"string","description":"Pool display name."},"value":{"type":"integer","description":"Number of Swap events on this pool on this day."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/execution_pools_tvl_by_pool/snapshot":{"get":{"tags":["Execution"],"summary":"Execution Pools Tvl By Pool (snapshot)","description":"**Required Access:** `tier1`\n\nLatest-day TVL breakdown per (token, pool) for the pools dashboard's\ndrill-down chart. One row per pool with positive TVL on the latest\navailable date (excluding today, which may be partial). Sourced from\nfct_execution_pools_daily.\n\n\n**Columns:**\n- **token** (`String`): Reference token symbol used to group pools.\n- **label** (`String`): Pool display name (combines symbols, protocol, address suffix).\n- **value** (`Float64`): Pool TVL in USD on the latest available date.\n- **as_of_date** (`Date`): Date the snapshot is computed as of (max date in the underlying data).","operationId":"api_execution_pools_tvl_by_pool_latest_get_v1_execution_execution_pools_tvl_by_pool_snapshot_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"token":{"type":"string","description":"Reference token symbol used to group pools."},"label":{"type":"string","description":"Pool display name (combines symbols, protocol, address suffix)."},"value":{"type":"number","description":"Pool TVL in USD on the latest available date."},"as_of_date":{"type":"string","format":"date","description":"Date the snapshot is computed as of (max date in the underlying data)."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/execution_pools_tvl_token/daily":{"get":{"tags":["Execution"],"summary":"Execution Pools Tvl Token (daily)","description":"**Required Access:** `tier1`\n\nDaily TVL time series per (token, pool) decomposed into the contribution\nof each pool side. Sourced from fct_execution_pools_tvl_token_daily.\nDrives the per-token TVL stacked-area chart.\n\n\n**Columns:**\n- **date** (`Date`): Calendar day (UTC) of the TVL time series.\n- **token** (`String`): Reference token symbol (renamed from ref_token).\n- **label** (`String`): Pool display name.\n- **series** (`String`): Series identifier for stacking (typically the side of the pool the TVL is denominated in).\n- **tvl_usd** (`Float64`): Component TVL in USD for this row.\n- **tvl_in_token0** (`Nullable(Float64)`): Pool TVL portion attributable to token0 (native units).\n- **tvl_in_token1** (`Nullable(Float64)`): Pool TVL portion attributable to token1 (native units).\n- **token0_symbol** (`String`): Symbol of the pool's token0.\n- **token1_symbol** (`String`): Symbol of the pool's token1.\n- **token_amount** (`Nullable(Float64)`): Token-side balance for the reference token on this date.","operationId":"api_execution_pools_tvl_token_daily_get_v1_execution_execution_pools_tvl_token_daily_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"date":{"type":"string","format":"date","description":"Calendar day (UTC) of the TVL time series."},"token":{"type":"string","description":"Reference token symbol (renamed from ref_token)."},"label":{"type":"string","description":"Pool display name."},"series":{"type":"string","description":"Series identifier for stacking (typically the side of the pool the TVL is denominated in)."},"tvl_usd":{"type":"number","description":"Component TVL in USD for this row."},"tvl_in_token0":{"type":"number","description":"Pool TVL portion attributable to token0 (native units)."},"tvl_in_token1":{"type":"number","description":"Pool TVL portion attributable to token1 (native units)."},"token0_symbol":{"type":"string","description":"Symbol of the pool's token0."},"token1_symbol":{"type":"string","description":"Symbol of the pool's token1."},"token_amount":{"type":"number","description":"Token-side balance for the reference token on this date."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/execution_pools_tvl_usd/daily":{"get":{"tags":["Execution"],"summary":"Execution Pools Tvl Usd (daily)","description":"**Required Access:** `tier1`\n\nAPI view for pool TVL (USD) time series by token and pool label.\n\n**Columns:**\n- **date** (`Date`): Calendar day (UTC) of the TVL time series.\n- **token** (`String`): Token symbol the pool is grouped under.\n- **label** (`String`): Pool display name.\n- **tvl_type** (`String`): Constant metric label (\"TVL (USD)\") used as the chart series name.\n- **value** (`Float64`): Pool TVL in USD on this date.","operationId":"api_execution_pools_tvl_daily_get_v1_execution_execution_pools_tvl_usd_daily_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"date":{"type":"string","format":"date","description":"Calendar day (UTC) of the TVL time series."},"token":{"type":"string","description":"Token symbol the pool is grouped under."},"label":{"type":"string","description":"Pool display name."},"tvl_type":{"type":"string","description":"Constant metric label (\"TVL (USD)\") used as the chart series name."},"value":{"type":"number","description":"Pool TVL in USD on this date."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/execution_pools_tvl_usd/snapshot":{"get":{"tags":["Execution"],"summary":"Execution Pools Tvl Usd (snapshot)","description":"**Required Access:** `tier1`\n\nLatest TVL snapshot per token across all tracked DEX pools with 7-day change. Sourced from fct_execution_pools_snapshots filtered to metric='TVL_Latest'.\n\n**Columns:**\n- **token** (`String`): Token symbol the snapshot is aggregated for.\n- **value** (`Float64`): Latest TVL in USD.\n- **change_pct** (`Nullable(Float64)`): Percent change in TVL vs 7 days ago.\n- **as_of_date** (`Date`): Date the snapshot is computed as of (max date in the underlying data).","operationId":"api_execution_pools_tvl_latest_get_v1_execution_execution_pools_tvl_usd_snapshot_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"token":{"type":"string","description":"Token symbol the snapshot is aggregated for."},"value":{"type":"number","description":"Latest TVL in USD."},"change_pct":{"type":"number","description":"Percent change in TVL vs 7 days ago."},"as_of_date":{"type":"string","format":"date","description":"Date the snapshot is computed as of (max date in the underlying data)."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/execution_pools_volume_usd/daily":{"get":{"tags":["Execution"],"summary":"Execution Pools Volume Usd (daily)","description":"**Required Access:** `tier1`\n\nAPI view for daily trading volume (USD) by token and pool, sourced from fct_execution_pools_daily.\n\n**Columns:**\n- **date** (`Date`): Calendar day (UTC) of the volume time series.\n- **token** (`String`): Token symbol the pool is grouped under.\n- **label** (`String`): Pool display name.\n- **volume_type** (`String`): Constant metric label (\"Volume (USD)\") used as the chart series name.\n- **value** (`Float64`): Daily gross trading volume in USD.","operationId":"api_execution_pools_volume_daily_get_v1_execution_execution_pools_volume_usd_daily_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"date":{"type":"string","format":"date","description":"Calendar day (UTC) of the volume time series."},"token":{"type":"string","description":"Token symbol the pool is grouped under."},"label":{"type":"string","description":"Pool display name."},"volume_type":{"type":"string","description":"Constant metric label (\"Volume (USD)\") used as the chart series name."},"value":{"type":"number","description":"Daily gross trading volume in USD."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/execution_pools_volume_usd/snapshot/7d":{"get":{"tags":["Execution"],"summary":"Execution Pools Volume Usd (snapshot) [7d]","description":"**Required Access:** `tier1`\n\nAPI view for 7-day total trading volume per token (snapshot from fct_execution_pools_snapshots).\n\n**Columns:**\n- **token** (`String`): Token symbol the snapshot is aggregated for.\n- **value** (`Float64`): Total trading volume (USD) over the last 7 days.\n- **change_pct** (`Float64`): Percentage change vs prior 7-day window.\n- **as_of_date** (`Date`): Date the snapshot is computed as of (max date in the underlying data).","operationId":"api_execution_pools_volume_7d_get_v1_execution_execution_pools_volume_usd_snapshot_7d_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"token":{"type":"string","description":"Token symbol the snapshot is aggregated for."},"value":{"type":"number","description":"Total trading volume (USD) over the last 7 days."},"change_pct":{"type":"number","description":"Percentage change vs prior 7-day window."},"as_of_date":{"type":"string","format":"date","description":"Date the snapshot is computed as of (max date in the underlying data)."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/gnosis_app_active_users_incl_gpay/daily":{"get":{"tags":["Execution"],"summary":"Gnosis App Active Users Incl Gpay (daily)","description":"**Required Access:** `tier1`\n\nGnosis App Daily Active Users (DAU), Gnosis-Pay-inclusive variant over fct_execution_gnosis_app_users_daily_incl_gpay. Daily-grain member of the active-users-incl-gpay resolution triplet. Latest incomplete day (today) excluded.\n\n**Declared Filters:**\n- **start_date**: >= on `date` (Inclusive start date)\n- **end_date**: <= on `date` (Inclusive end date)\n\n**Sort:**\n- `date DESC`\n\n**Columns:**\n- **date** (`Date`): Calendar date (UTC). Time-series grain.\n- **active_users** (`UInt64`): Distinct active Gnosis App users on this date, additionally including GA owners whose only activity was a Gnosis Pay card-wallet transaction.\n- **new_users** (`UInt64`): Users whose first-ever activity (onboarding) was on this date.\n- **returning_users** (`UInt64`): Active this date AND active in the prior 7 days.\n- **reactivated_users** (`UInt64`): Active this date, not active in the prior 30 days, but active earlier.","operationId":"api_execution_gnosis_app_active_users_incl_gpay_daily_get_v1_execution_gnosis_app_active_users_incl_gpay_daily_get","security":[{"APIKeyHeader":[]}],"responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"date":{"type":"string","format":"date","description":"Calendar date (UTC). Time-series grain."},"active_users":{"type":"integer","description":"Distinct active Gnosis App users on this date, additionally including GA owners whose only activity was a Gnosis Pay card-wallet transaction."},"new_users":{"type":"integer","description":"Users whose first-ever activity (onboarding) was on this date."},"returning_users":{"type":"integer","description":"Active this date AND active in the prior 7 days."},"reactivated_users":{"type":"integer","description":"Active this date, not active in the prior 30 days, but active earlier."}}}}}}}},"parameters":[{"name":"start_date","in":"query","required":false,"description":"Inclusive start date","schema":{"type":"string","format":"date"}},{"name":"end_date","in":"query","required":false,"description":"Inclusive end date","schema":{"type":"string","format":"date"}}]}},"/v1/execution/gnosis_app_active_users_incl_gpay/weekly":{"get":{"tags":["Execution"],"summary":"Gnosis App Active Users Incl Gpay (weekly)","description":"**Required Access:** `tier1`\n\nGnosis App Weekly Active Users (WAU), Gnosis-Pay-inclusive variant over fct_execution_gnosis_app_users_weekly_incl_gpay. Resolution-suffixed twin of api_execution_gnosis_app_weekly_active_users_incl_gpay; weekly-grain member of the active-users-incl-gpay resolution triplet. Latest incomplete week excluded.\n\n**Declared Filters:**\n- **start_date**: >= on `week` (Inclusive start week)\n- **end_date**: <= on `week` (Inclusive end week)\n\n**Sort:**\n- `week DESC`\n\n**Columns:**\n- **week** (`Date`): Monday-aligned start of the week (UTC). Time-series grain.\n- **active_users** (`UInt64`): Distinct active Gnosis App users in the week, additionally including GA owners whose only activity was a Gnosis Pay card-wallet transaction.\n- **new_users** (`UInt64`): Users whose first-ever activity (onboarding) was this week.\n- **returning_users** (`UInt64`): Active this week AND active the previous week.\n- **reactivated_users** (`UInt64`): Active this week, not active in the prior 4 weeks, but active earlier.","operationId":"api_execution_gnosis_app_active_users_incl_gpay_weekly_get_v1_execution_gnosis_app_active_users_incl_gpay_weekly_get","security":[{"APIKeyHeader":[]}],"responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"week":{"type":"string","format":"date","description":"Monday-aligned start of the week (UTC). Time-series grain."},"active_users":{"type":"integer","description":"Distinct active Gnosis App users in the week, additionally including GA owners whose only activity was a Gnosis Pay card-wallet transaction."},"new_users":{"type":"integer","description":"Users whose first-ever activity (onboarding) was this week."},"returning_users":{"type":"integer","description":"Active this week AND active the previous week."},"reactivated_users":{"type":"integer","description":"Active this week, not active in the prior 4 weeks, but active earlier."}}}}}}}},"parameters":[{"name":"start_date","in":"query","required":false,"description":"Inclusive start week","schema":{"type":"string","format":"date"}},{"name":"end_date","in":"query","required":false,"description":"Inclusive end week","schema":{"type":"string","format":"date"}}]}},"/v1/execution/gnosis_app_active_users_incl_gpay/monthly":{"get":{"tags":["Execution"],"summary":"Gnosis App Active Users Incl Gpay (monthly)","description":"**Required Access:** `tier1`\n\nGnosis App Monthly Active Users (MAU), Gnosis-Pay-inclusive variant over fct_execution_gnosis_app_users_monthly_incl_gpay. Monthly-grain member of the active-users-incl-gpay resolution triplet. Latest incomplete month excluded.\n\n**Declared Filters:**\n- **start_date**: >= on `month` (Inclusive start month)\n- **end_date**: <= on `month` (Inclusive end month)\n\n**Sort:**\n- `month DESC`\n\n**Columns:**\n- **month** (`Date`): First day of the month (UTC). Time-series grain.\n- **active_users** (`UInt64`): Distinct active Gnosis App users in the month, additionally including GA owners whose only activity was a Gnosis Pay card-wallet transaction.\n- **new_users** (`UInt64`): Users whose first-ever activity (onboarding) was this month.\n- **returning_users** (`UInt64`): Active this month AND active the previous month.\n- **reactivated_users** (`UInt64`): Active this month, not active in the prior 2 months, but active earlier.","operationId":"api_execution_gnosis_app_active_users_incl_gpay_monthly_get_v1_execution_gnosis_app_active_users_incl_gpay_monthly_get","security":[{"APIKeyHeader":[]}],"responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"month":{"type":"string","format":"date","description":"First day of the month (UTC). Time-series grain."},"active_users":{"type":"integer","description":"Distinct active Gnosis App users in the month, additionally including GA owners whose only activity was a Gnosis Pay card-wallet transaction."},"new_users":{"type":"integer","description":"Users whose first-ever activity (onboarding) was this month."},"returning_users":{"type":"integer","description":"Active this month AND active the previous month."},"reactivated_users":{"type":"integer","description":"Active this month, not active in the prior 2 months, but active earlier."}}}}}}}},"parameters":[{"name":"start_date","in":"query","required":false,"description":"Inclusive start month","schema":{"type":"string","format":"date"}},{"name":"end_date","in":"query","required":false,"description":"Inclusive end month","schema":{"type":"string","format":"date"}}]}},"/v1/execution/gnosis_app_activity_by_action/daily":{"get":{"tags":["Execution"],"summary":"Gnosis App Activity By Action (daily)","description":"**Required Access:** `tier1`\n\nFastAPI view over fct_execution_gnosis_app_activity_by_action_daily. Params: activity_kind, start_date, end_date.\n\n**Declared Filters:**\n- **activity_kind**: = on `activity_kind` (Activity kind (onboard, swap_filled, topup, marketplace_buy, etc.))\n- **start_date**: >= on `date` (Inclusive start date)\n- **end_date**: <= on `date` (Inclusive end date)\n\n**Sort:**\n- `date DESC`\n\n**Columns:**\n- **date** (`Date`): Calendar date (UTC).\n- **activity_kind** (`String`): Type of activity (swap_filled / topup / marketplace_buy / circles_* / ...).\n- **n_events** (`UInt64`): Number of events.\n- **n_users** (`UInt64`): Distinct users.\n- **amount_usd** (`Nullable(Float64)`): USD amount.","operationId":"api_execution_gnosis_app_activity_by_action_daily_get_v1_execution_gnosis_app_activity_by_action_daily_get","security":[{"APIKeyHeader":[]}],"responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"date":{"type":"string","format":"date","description":"Calendar date (UTC)."},"activity_kind":{"type":"string","description":"Type of activity (swap_filled / topup / marketplace_buy / circles_* / ...)."},"n_events":{"type":"integer","description":"Number of events."},"n_users":{"type":"integer","description":"Distinct users."},"amount_usd":{"type":"number","description":"USD amount."}}}}}}}},"parameters":[{"name":"activity_kind","in":"query","required":false,"description":"Activity kind (onboard, swap_filled, topup, marketplace_buy, etc.)","schema":{"type":"string"}},{"name":"start_date","in":"query","required":false,"description":"Inclusive start date","schema":{"type":"string","format":"date"}},{"name":"end_date","in":"query","required":false,"description":"Inclusive end date","schema":{"type":"string","format":"date"}}]}},"/v1/execution/gnosis_app_activity_by_action/weekly":{"get":{"tags":["Execution"],"summary":"Gnosis App Activity By Action (weekly)","description":"**Required Access:** `tier1`\n\nFastAPI view over fct_execution_gnosis_app_activity_by_action_weekly.\n\n**Declared Filters:**\n- **activity_kind**: = on `activity_kind` (Activity kind)\n- **start_date**: >= on `week` (Inclusive start week)\n- **end_date**: <= on `week` (Inclusive end week)\n\n**Sort:**\n- `week DESC`\n\n**Columns:**\n- **week** (`Date`): Monday-aligned start of the week (UTC).\n- **activity_kind** (`String`): Type of activity (swap_filled / topup / marketplace_buy / circles_* / ...).\n- **n_events** (`UInt64`): Number of events.\n- **n_users** (`UInt64`): Distinct users.\n- **amount_usd** (`Nullable(Float64)`): USD amount.","operationId":"api_execution_gnosis_app_activity_by_action_weekly_get_v1_execution_gnosis_app_activity_by_action_weekly_get","security":[{"APIKeyHeader":[]}],"responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"week":{"type":"string","format":"date","description":"Monday-aligned start of the week (UTC)."},"activity_kind":{"type":"string","description":"Type of activity (swap_filled / topup / marketplace_buy / circles_* / ...)."},"n_events":{"type":"integer","description":"Number of events."},"n_users":{"type":"integer","description":"Distinct users."},"amount_usd":{"type":"number","description":"USD amount."}}}}}}}},"parameters":[{"name":"activity_kind","in":"query","required":false,"description":"Activity kind","schema":{"type":"string"}},{"name":"start_date","in":"query","required":false,"description":"Inclusive start week","schema":{"type":"string","format":"date"}},{"name":"end_date","in":"query","required":false,"description":"Inclusive end week","schema":{"type":"string","format":"date"}}]}},"/v1/execution/gnosis_app_activity_by_action/monthly":{"get":{"tags":["Execution"],"summary":"Gnosis App Activity By Action (monthly)","description":"**Required Access:** `tier1`\n\nFastAPI view over fct_execution_gnosis_app_activity_by_action_monthly.\n\n**Declared Filters:**\n- **activity_kind**: = on `activity_kind` (Activity kind)\n- **start_month**: >= on `month` (Inclusive start month)\n- **end_month**: <= on `month` (Inclusive end month)\n\n**Sort:**\n- `month DESC`\n\n**Columns:**\n- **month** (`Date`): First day of the month (UTC).\n- **activity_kind** (`String`): Type of activity (swap_filled / topup / marketplace_buy / circles_* / ...).\n- **n_events** (`UInt64`): Number of events.\n- **n_users** (`UInt64`): Distinct users.\n- **amount_usd** (`Nullable(Float64)`): USD amount.","operationId":"api_execution_gnosis_app_activity_by_action_monthly_get_v1_execution_gnosis_app_activity_by_action_monthly_get","security":[{"APIKeyHeader":[]}],"responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"month":{"type":"string","format":"date","description":"First day of the month (UTC)."},"activity_kind":{"type":"string","description":"Type of activity (swap_filled / topup / marketplace_buy / circles_* / ...)."},"n_events":{"type":"integer","description":"Number of events."},"n_users":{"type":"integer","description":"Distinct users."},"amount_usd":{"type":"number","description":"USD amount."}}}}}}}},"parameters":[{"name":"activity_kind","in":"query","required":false,"description":"Activity kind","schema":{"type":"string"}},{"name":"start_month","in":"query","required":false,"description":"Inclusive start month","schema":{"type":"string","format":"date"}},{"name":"end_month","in":"query","required":false,"description":"Inclusive end month","schema":{"type":"string","format":"date"}}]}},"/v1/execution/gnosis_app_churn/monthly":{"get":{"tags":["Execution"],"summary":"Gnosis App Churn (monthly)","description":"**Required Access:** `tier1`\n\nFastAPI view over fct_execution_gnosis_app_churn_monthly. Params: scope, start_month, end_month.\n\n**Declared Filters:**\n- **scope**: = on `scope` ('Any' or 'Swap')\n- **start_month**: >= on `month` (Inclusive start month)\n- **end_month**: <= on `month` (Inclusive end month)\n\n**Sort:**\n- `month DESC`\n\n**Columns:**\n- **scope** (`String`): Metric scope label ('Any' or 'Swap').\n- **month** (`Date`): First day of the month (UTC).\n- **new_users** (`UInt64`): Distinct addresses whose first-ever activity was in this month.\n- **retained_users** (`UInt64`): Active in this month and the previous month.\n- **returning_users** (`UInt64`): Active this month and also active in the immediately prior period.\n- **churned_users** (`UInt64`): Active this month but not the next.\n- **total_active** (`UInt64`): Total distinct active users in the month.\n- **churn_rate** (`Float64`): Share of users churned into the next month (percent).\n- **retention_rate** (`Float64`): Share of users retained into the next month (percent).","operationId":"api_execution_gnosis_app_churn_monthly_get_v1_execution_gnosis_app_churn_monthly_get","security":[{"APIKeyHeader":[]}],"responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"scope":{"type":"string","description":"Metric scope label ('Any' or 'Swap')."},"month":{"type":"string","format":"date","description":"First day of the month (UTC)."},"new_users":{"type":"integer","description":"Distinct addresses whose first-ever activity was in this month."},"retained_users":{"type":"integer","description":"Active in this month and the previous month."},"returning_users":{"type":"integer","description":"Active this month and also active in the immediately prior period."},"churned_users":{"type":"integer","description":"Active this month but not the next."},"total_active":{"type":"integer","description":"Total distinct active users in the month."},"churn_rate":{"type":"number","description":"Share of users churned into the next month (percent)."},"retention_rate":{"type":"number","description":"Share of users retained into the next month (percent)."}}}}}}}},"parameters":[{"name":"scope","in":"query","required":false,"description":"'Any' or 'Swap'","schema":{"type":"string"}},{"name":"start_month","in":"query","required":false,"description":"Inclusive start month","schema":{"type":"string","format":"date"}},{"name":"end_month","in":"query","required":false,"description":"Inclusive end month","schema":{"type":"string","format":"date"}}]}},"/v1/execution/gnosis_app_circles_ecosystem_weekly_active_users/weekly":{"get":{"tags":["Execution"],"summary":"Gnosis App Circles Ecosystem Weekly Active Users (weekly)","description":"**Required Access:** `tier1`\n\nWhole-Circles-network weekly active reach (NOT Gnosis App growth; that is api:gnosis_app_users weekly / api:gnosis_app_kpi_weekly_active_users). Time-series over fct_execution_gnosis_app_weekly_active_users_circles_ecosystem (latest week excluded).\n\n\n**Columns:**\n- **week** (`Date`): Monday-aligned start of the week (UTC). Time-series grain.\n- **is_blacklisted** (`Bool`): True if the address appears in the circles blacklist snapshot.\n- **cnt** (`UInt64`): Distinct ecosystem-active addresses in this week × blacklist bucket.","operationId":"api_execution_gnosis_app_circles_ecosystem_weekly_active_users_get_v1_execution_gnosis_app_circles_ecosystem_weekly_active_users_weekly_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"week":{"type":"string","format":"date","description":"Monday-aligned start of the week (UTC). Time-series grain."},"is_blacklisted":{"type":"boolean","description":"True if the address appears in the circles blacklist snapshot."},"cnt":{"type":"integer","description":"Distinct ecosystem-active addresses in this week × blacklist bucket."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/gnosis_app_gpay_topups/weekly":{"get":{"tags":["Execution"],"summary":"Gnosis App Gpay Topups (weekly)","description":"**Required Access:** `tier1`\n\nFastAPI view over fct_execution_gnosis_app_gpay_topups_weekly.\n\n**Declared Filters:**\n- **start_date**: >= on `week` (Inclusive start week)\n- **end_date**: <= on `week` (Inclusive end week)\n\n**Sort:**\n- `week DESC`\n\n**Columns:**\n- **week** (`Date`): Monday-aligned start of the week (UTC).\n- **n_topups** (`UInt64`): Number of in-app top-up events.\n- **n_ga_users** (`UInt64`): Distinct Gnosis App users.\n- **n_gp_wallets** (`UInt64`): Distinct Gnosis Pay wallets.\n- **volume_usd** (`Nullable(Float64)`): USD volume.","operationId":"api_execution_gnosis_app_gpay_topups_weekly_get_v1_execution_gnosis_app_gpay_topups_weekly_get","security":[{"APIKeyHeader":[]}],"responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"week":{"type":"string","format":"date","description":"Monday-aligned start of the week (UTC)."},"n_topups":{"type":"integer","description":"Number of in-app top-up events."},"n_ga_users":{"type":"integer","description":"Distinct Gnosis App users."},"n_gp_wallets":{"type":"integer","description":"Distinct Gnosis Pay wallets."},"volume_usd":{"type":"number","description":"USD volume."}}}}}}}},"parameters":[{"name":"start_date","in":"query","required":false,"description":"Inclusive start week","schema":{"type":"string","format":"date"}},{"name":"end_date","in":"query","required":false,"description":"Inclusive end week","schema":{"type":"string","format":"date"}}]}},"/v1/execution/gnosis_app_gpay_topups/monthly":{"get":{"tags":["Execution"],"summary":"Gnosis App Gpay Topups (monthly)","description":"**Required Access:** `tier1`\n\nFastAPI view over fct_execution_gnosis_app_gpay_topups_monthly.\n\n**Declared Filters:**\n- **start_month**: >= on `month` (Inclusive start month)\n- **end_month**: <= on `month` (Inclusive end month)\n\n**Sort:**\n- `month DESC`\n\n**Columns:**\n- **month** (`Date`): First day of the month (UTC).\n- **n_topups** (`UInt64`): Number of in-app top-up events.\n- **n_ga_users** (`UInt64`): Distinct Gnosis App users.\n- **n_gp_wallets** (`UInt64`): Distinct Gnosis Pay wallets.\n- **volume_usd** (`Nullable(Float64)`): USD volume.","operationId":"api_execution_gnosis_app_gpay_topups_monthly_get_v1_execution_gnosis_app_gpay_topups_monthly_get","security":[{"APIKeyHeader":[]}],"responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"month":{"type":"string","format":"date","description":"First day of the month (UTC)."},"n_topups":{"type":"integer","description":"Number of in-app top-up events."},"n_ga_users":{"type":"integer","description":"Distinct Gnosis App users."},"n_gp_wallets":{"type":"integer","description":"Distinct Gnosis Pay wallets."},"volume_usd":{"type":"number","description":"USD volume."}}}}}}}},"parameters":[{"name":"start_month","in":"query","required":false,"description":"Inclusive start month","schema":{"type":"string","format":"date"}},{"name":"end_month","in":"query","required":false,"description":"Inclusive end month","schema":{"type":"string","format":"date"}}]}},"/v1/execution/gnosis_app_gpay_topups_by_token/daily":{"get":{"tags":["Execution"],"summary":"Gnosis App Gpay Topups By Token (daily)","description":"**Required Access:** `tier1`\n\nFastAPI endpoint view of fct_execution_gnosis_app_gpay_topups_by_token_daily.\nSupports query params: token_bought_symbol, start_date, end_date.\n\n\n**Declared Filters:**\n- **token_bought_symbol**: = on `token_bought_symbol` (Bought token symbol (e.g. 'EURe', 'USDC'))\n- **start_date**: >= on `date` (Inclusive start date)\n- **end_date**: <= on `date` (Inclusive end date)\n\n**Sort:**\n- `date DESC`\n\n**Columns:**\n- **date** (`Date`): Calendar date (UTC).\n- **token_bought_symbol** (`Nullable(String)`): Symbol of the token bought.\n- **n_topups** (`UInt64`): Number of in-app top-up events.\n- **n_ga_users** (`UInt64`): Distinct Gnosis App users.\n- **n_gp_wallets** (`UInt64`): Distinct Gnosis Pay wallets.\n- **volume_token_bought** (`Nullable(Float64)`): Volume of the bought token in native units.\n- **volume_usd** (`Nullable(Float64)`): USD volume.","operationId":"api_execution_gnosis_app_gpay_topups_by_token_daily_get_v1_execution_gnosis_app_gpay_topups_by_token_daily_get","security":[{"APIKeyHeader":[]}],"responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"date":{"type":"string","format":"date","description":"Calendar date (UTC)."},"token_bought_symbol":{"type":"string","description":"Symbol of the token bought."},"n_topups":{"type":"integer","description":"Number of in-app top-up events."},"n_ga_users":{"type":"integer","description":"Distinct Gnosis App users."},"n_gp_wallets":{"type":"integer","description":"Distinct Gnosis Pay wallets."},"volume_token_bought":{"type":"number","description":"Volume of the bought token in native units."},"volume_usd":{"type":"number","description":"USD volume."}}}}}}}},"parameters":[{"name":"token_bought_symbol","in":"query","required":false,"description":"Bought token symbol (e.g. 'EURe', 'USDC')","schema":{"type":"string"}},{"name":"start_date","in":"query","required":false,"description":"Inclusive start date","schema":{"type":"string","format":"date"}},{"name":"end_date","in":"query","required":false,"description":"Inclusive end date","schema":{"type":"string","format":"date"}}]}},"/v1/execution/gnosis_app_gpay_topups_cohort/monthly":{"get":{"tags":["Execution"],"summary":"Gnosis App Gpay Topups Cohort (monthly)","description":"**Required Access:** `tier1`\n\nFastAPI view over fct_execution_gnosis_app_gpay_topups_cohort_monthly. Params: start_month, end_month.\n\n**Declared Filters:**\n- **start_month**: >= on `cohort_month` (Inclusive start cohort month)\n- **end_month**: <= on `cohort_month` (Inclusive end cohort month)\n\n**Sort:**\n- `cohort_month DESC`\n\n**Columns:**\n- **cohort_month** (`Date`): Month of the user's first top-up (cohort anchor).\n- **x** (`String`): Activity month as a string (toString(activity_month)); x-axis of the retention grid.\n- **y** (`String`): First-top-up cohort month as a string (toString(cohort_month)); y-axis of the retention grid.\n- **retention_pct** (`Float64`): Share of the first-top-up cohort still topping up in activity_month (users / initial_users x 100).\n- **value_abs** (`UInt64`): Distinct cohort users who topped up in this cell (renamed from users).\n- **amount_retention_pct** (`Nullable(Float64)`): Retained USD amount as a share of the cohort's initial amount (x100).\n- **value_usd** (`Nullable(Float64)`): USD amount (renamed from amount_usd).","operationId":"api_execution_gnosis_app_gpay_topups_cohort_monthly_get_v1_execution_gnosis_app_gpay_topups_cohort_monthly_get","security":[{"APIKeyHeader":[]}],"responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"cohort_month":{"type":"string","format":"date","description":"Month of the user's first top-up (cohort anchor)."},"x":{"type":"string","description":"Activity month as a string (toString(activity_month)); x-axis of the retention grid."},"y":{"type":"string","description":"First-top-up cohort month as a string (toString(cohort_month)); y-axis of the retention grid."},"retention_pct":{"type":"number","description":"Share of the first-top-up cohort still topping up in activity_month (users / initial_users x 100)."},"value_abs":{"type":"integer","description":"Distinct cohort users who topped up in this cell (renamed from users)."},"amount_retention_pct":{"type":"number","description":"Retained USD amount as a share of the cohort's initial amount (x100)."},"value_usd":{"type":"number","description":"USD amount (renamed from amount_usd)."}}}}}}}},"parameters":[{"name":"start_month","in":"query","required":false,"description":"Inclusive start cohort month","schema":{"type":"string","format":"date"}},{"name":"end_month","in":"query","required":false,"description":"Inclusive end cohort month","schema":{"type":"string","format":"date"}}]}},"/v1/execution/gnosis_app_gpay_volume/daily":{"get":{"tags":["Execution"],"summary":"Gnosis App Gpay Volume (daily)","description":"**Required Access:** `tier1`\n\nFastAPI endpoint view of fct_execution_gnosis_app_gpay_volume_daily.\nGA-controlled Gnosis Pay funding (funded_volume_usd) and card spend\n(spend_usd) per day, split by onboarding_class, with cumulative series.\nSupports query params: onboarding_class, start_date, end_date.\n\n\n**Declared Filters:**\n- **onboarding_class**: = on `onboarding_class` (Onboarding class ('onboarded_via_ga' or 'imported'))\n- **start_date**: >= on `date` (Inclusive start date)\n- **end_date**: <= on `date` (Inclusive end date)\n\n**Sort:**\n- `date DESC`\n\n**Columns:**\n- **date** (`Date`): Calendar date (UTC).\n- **onboarding_class** (`String`): 'onboarded_via_ga' or 'imported'.\n- **funded_volume_usd** (`Float64`): USD inflows (Fiat Top Up + Crypto Deposit) on GA-controlled Safes.\n- **spend_usd** (`Float64`): USD card payments (action=Payment) on GA-controlled Safes.\n- **spend_count** (`UInt64`): Number of card Payment transactions.\n- **spending_wallets** (`UInt64`): Distinct GA-controlled Safes that made a card payment.\n- **funded_volume_cumulative_usd** (`Float64`): Running total of funded_volume_usd within onboarding_class.\n- **spend_cumulative_usd** (`Float64`): Running total of spend_usd within onboarding_class.","operationId":"api_execution_gnosis_app_gpay_volume_daily_get_v1_execution_gnosis_app_gpay_volume_daily_get","security":[{"APIKeyHeader":[]}],"responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"date":{"type":"string","format":"date","description":"Calendar date (UTC)."},"onboarding_class":{"type":"string","description":"'onboarded_via_ga' or 'imported'."},"funded_volume_usd":{"type":"number","description":"USD inflows (Fiat Top Up + Crypto Deposit) on GA-controlled Safes."},"spend_usd":{"type":"number","description":"USD card payments (action=Payment) on GA-controlled Safes."},"spend_count":{"type":"integer","description":"Number of card Payment transactions."},"spending_wallets":{"type":"integer","description":"Distinct GA-controlled Safes that made a card payment."},"funded_volume_cumulative_usd":{"type":"number","description":"Running total of funded_volume_usd within onboarding_class."},"spend_cumulative_usd":{"type":"number","description":"Running total of spend_usd within onboarding_class."}}}}}}}},"parameters":[{"name":"onboarding_class","in":"query","required":false,"description":"Onboarding class ('onboarded_via_ga' or 'imported')","schema":{"type":"string"}},{"name":"start_date","in":"query","required":false,"description":"Inclusive start date","schema":{"type":"string","format":"date"}},{"name":"end_date","in":"query","required":false,"description":"Inclusive end date","schema":{"type":"string","format":"date"}}]}},"/v1/execution/gnosis_app_gpay_wallets/daily":{"get":{"tags":["Execution"],"summary":"Gnosis App Gpay Wallets (daily)","description":"**Required Access:** `tier1`\n\nFastAPI endpoint view of fct_execution_gnosis_app_gpay_wallets_daily.\nSupports query params: onboarding_class, start_date, end_date.\n\n\n**Declared Filters:**\n- **onboarding_class**: = on `onboarding_class` (Onboarding class ('onboarded_via_ga' or 'imported'))\n- **start_date**: >= on `date` (Inclusive start date)\n- **end_date**: <= on `date` (Inclusive end date)\n\n**Sort:**\n- `date DESC`\n\n**Columns:**\n- **date** (`Date`): Calendar date (UTC).\n- **onboarding_class** (`String`): 'onboarded_via_ga' or 'imported'.\n- **n_ga_wallets_new** (`UInt64`): GP wallets that became GA-owned for the first time on this date.\n- **n_ga_wallets_cumulative** (`UInt64`): Running total of ever-GA-owned GP wallets.","operationId":"api_execution_gnosis_app_gpay_wallets_daily_get_v1_execution_gnosis_app_gpay_wallets_daily_get","security":[{"APIKeyHeader":[]}],"responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"date":{"type":"string","format":"date","description":"Calendar date (UTC)."},"onboarding_class":{"type":"string","description":"'onboarded_via_ga' or 'imported'."},"n_ga_wallets_new":{"type":"integer","description":"GP wallets that became GA-owned for the first time on this date."},"n_ga_wallets_cumulative":{"type":"integer","description":"Running total of ever-GA-owned GP wallets."}}}}}}}},"parameters":[{"name":"onboarding_class","in":"query","required":false,"description":"Onboarding class ('onboarded_via_ga' or 'imported')","schema":{"type":"string"}},{"name":"start_date","in":"query","required":false,"description":"Inclusive start date","schema":{"type":"string","format":"date"}},{"name":"end_date","in":"query","required":false,"description":"Inclusive end date","schema":{"type":"string","format":"date"}}]}},"/v1/execution/gnosis_app_gt_active_wallets/daily":{"get":{"tags":["Execution"],"summary":"Gnosis App Gt Active Wallets (daily)","description":"**Required Access:** `tier2`\n\nPublic DAU series (active app-engaged wallets per day). WAU/MAU in the underlying fct.\n\n**Sort:**\n- `date DESC`\n\n**Columns:**\n- **date** (`Date`): Calendar day.\n- **active_wallets** (`UInt64`): Distinct active wallets that day.\n- **new_wallets** (`UInt64`): First-ever-active wallets that day.\n- **active_wallets_app_tagged** (`UInt64`): App-feature-active wallets that day (heuristic-comparable).\n- **new_wallets_app_tagged** (`UInt64`): First-app-tagged-active wallets that day.","operationId":"api_execution_gnosis_app_gt_active_wallets_get_v1_execution_gnosis_app_gt_active_wallets_daily_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"date":{"type":"string","format":"date","description":"Calendar day."},"active_wallets":{"type":"integer","description":"Distinct active wallets that day."},"new_wallets":{"type":"integer","description":"First-ever-active wallets that day."},"active_wallets_app_tagged":{"type":"integer","description":"App-feature-active wallets that day (heuristic-comparable)."},"new_wallets_app_tagged":{"type":"integer","description":"First-app-tagged-active wallets that day."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/gnosis_app_gt_reconciliation/total":{"get":{"tags":["Execution"],"summary":"Gnosis App Gt Reconciliation (total)","description":"**Required Access:** `tier2`\n\nPublic reconciliation snapshot — registered (GT registry) vs active (heuristic) containment.\n\n**Sort:**\n- `registry_containment DESC`\n\n**Columns:**\n- **heuristic_users** (`UInt64`): Distinct heuristic active-user addresses.\n- **gt_registry_users** (`UInt64`): GT registry (gnosis_app_user) count.\n- **gt_avatar_users** (`UInt64`): GT avatar (active spine) count.\n- **heuristic_in_registry** (`UInt64`): Heuristic users present in the GT registry.\n- **heuristic_in_avatar** (`UInt64`): Heuristic users present in the GT avatar spine.\n- **heuristic_only_vs_registry** (`UInt64`): Heuristic users absent from the GT registry.\n- **registry_containment** (`Float64`): heuristic_in_registry / heuristic_users (cutover gate >= 0.90).\n- **avatar_containment** (`Float64`): heuristic_in_avatar / heuristic_users (expected ~1.0).\n- **as_of_date** (`Date`): Snapshot date (query/build date).\n- **gt_registered_active** (`UInt64`): Canonical GT active users (registry + any app-tagged action).\n- **gt_registered_active_incl_circles** (`UInt64`): Broad variant incl. generic Circles actions + referrals (sizing only).\n- **gt_active_in_heuristic** (`UInt64`): Registered-active identities also in the heuristic active set.\n- **gt_active_missed_by_heuristic** (`UInt64`): Registered-active identities the current-app heuristic misses (legacy/Metri/non-current).\n- **gt_active_legacy_only** (`UInt64`): Registered-active identities with only legacy (Metri) signals, no current-app signal.\n- **active_vs_heuristic_ratio** (`Float64`): gt_registered_active / heuristic_users.","operationId":"api_execution_gnosis_app_gt_user_reconciliation_get_v1_execution_gnosis_app_gt_reconciliation_total_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"heuristic_users":{"type":"integer","description":"Distinct heuristic active-user addresses."},"gt_registry_users":{"type":"integer","description":"GT registry (gnosis_app_user) count."},"gt_avatar_users":{"type":"integer","description":"GT avatar (active spine) count."},"heuristic_in_registry":{"type":"integer","description":"Heuristic users present in the GT registry."},"heuristic_in_avatar":{"type":"integer","description":"Heuristic users present in the GT avatar spine."},"heuristic_only_vs_registry":{"type":"integer","description":"Heuristic users absent from the GT registry."},"registry_containment":{"type":"number","description":"heuristic_in_registry / heuristic_users (cutover gate >= 0.90)."},"avatar_containment":{"type":"number","description":"heuristic_in_avatar / heuristic_users (expected ~1.0)."},"as_of_date":{"type":"string","format":"date","description":"Snapshot date (query/build date)."},"gt_registered_active":{"type":"integer","description":"Canonical GT active users (registry + any app-tagged action)."},"gt_registered_active_incl_circles":{"type":"integer","description":"Broad variant incl. generic Circles actions + referrals (sizing only)."},"gt_active_in_heuristic":{"type":"integer","description":"Registered-active identities also in the heuristic active set."},"gt_active_missed_by_heuristic":{"type":"integer","description":"Registered-active identities the current-app heuristic misses (legacy/Metri/non-current)."},"gt_active_legacy_only":{"type":"integer","description":"Registered-active identities with only legacy (Metri) signals, no current-app signal."},"active_vs_heuristic_ratio":{"type":"number","description":"gt_registered_active / heuristic_users."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/gnosis_app_gt_referrals/total":{"get":{"tags":["Execution"],"summary":"Gnosis App Gt Referrals (total)","description":"**Required Access:** `tier2`\n\nPublic referral metrics — earned ledger vs full invite graph.\n\n**Sort:**\n- `n_edges DESC`\n\n**Columns:**\n- **metric_scope** (`String`): earned | full_invite_graph.\n- **n_inviters** (`UInt64`): Distinct inviters.\n- **n_invitees** (`UInt64`): Distinct invitees.\n- **n_edges** (`UInt64`): Invite edges.\n- **total_reward_crc** (`Nullable(Float64)`): Native CRC rewards (earned scope only).\n- **total_reward_usd** (`Nullable(Float64)`): Permanently NULL (no CRC price feed).\n- **as_of_date** (`Date`): Snapshot date (query/build date).","operationId":"api_execution_gnosis_app_gt_referrals_get_v1_execution_gnosis_app_gt_referrals_total_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"metric_scope":{"type":"string","description":"earned | full_invite_graph."},"n_inviters":{"type":"integer","description":"Distinct inviters."},"n_invitees":{"type":"integer","description":"Distinct invitees."},"n_edges":{"type":"integer","description":"Invite edges."},"total_reward_crc":{"type":"number","description":"Native CRC rewards (earned scope only)."},"total_reward_usd":{"type":"number","description":"Permanently NULL (no CRC price feed)."},"as_of_date":{"type":"string","format":"date","description":"Snapshot date (query/build date)."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/gnosis_app_gt_swaps/total":{"get":{"tags":["Execution"],"summary":"Gnosis App Gt Swaps (total)","description":"**Required Access:** `tier2`\n\nPublic swap counts by scope x CoW status enum.\n\n**Declared Filters:**\n- **app_scope**: = on `app_scope` (gnosis_app | metri | third_party | unknown | test)\n\n**Sort:**\n- `n_swaps DESC`\n\n**Columns:**\n- **app_scope** (`String`): native | all_cow.\n- **status** (`String`): CoW order status enum.\n- **n_swaps** (`UInt64`): Order count.\n- **n_swappers** (`UInt64`): Distinct owners.\n- **as_of_date** (`Date`): Snapshot date (query/build date).","operationId":"api_execution_gnosis_app_gt_swaps_get_v1_execution_gnosis_app_gt_swaps_total_get","security":[{"APIKeyHeader":[]}],"responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"app_scope":{"type":"string","description":"native | all_cow."},"status":{"type":"string","description":"CoW order status enum."},"n_swaps":{"type":"integer","description":"Order count."},"n_swappers":{"type":"integer","description":"Distinct owners."},"as_of_date":{"type":"string","format":"date","description":"Snapshot date (query/build date)."}}}}}}}},"parameters":[{"name":"app_scope","in":"query","required":false,"description":"gnosis_app | metri | third_party | unknown | test","schema":{"type":"string"}}]}},"/v1/execution/gnosis_app_gt_wallet_cohort_retention/total":{"get":{"tags":["Execution"],"summary":"Gnosis App Gt Wallet Cohort Retention (total)","description":"**Required Access:** `tier2`\n\nPublic acquisition-cohort retention matrix (point-in-time; as_of_date).\n\n**Sort:**\n- `cohort_month DESC`\n- `month_index ASC`\n\n**Columns:**\n- **basis** (`String`): any_action | app_tagged.\n- **cohort_month** (`Date`): Acquisition cohort month.\n- **month_index** (`Int32`): Months since acquisition.\n- **retained_wallets** (`UInt64`): Retained wallets at this index.\n- **cohort_size** (`UInt64`): Cohort denominator.\n- **retention_pct** (`Float64`): retained / cohort_size.\n- **as_of_date** (`Date`): Snapshot (build) date.","operationId":"api_execution_gnosis_app_gt_wallet_cohort_retention_get_v1_execution_gnosis_app_gt_wallet_cohort_retention_total_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"basis":{"type":"string","description":"any_action | app_tagged."},"cohort_month":{"type":"string","format":"date","description":"Acquisition cohort month."},"month_index":{"type":"integer","description":"Months since acquisition."},"retained_wallets":{"type":"integer","description":"Retained wallets at this index."},"cohort_size":{"type":"integer","description":"Cohort denominator."},"retention_pct":{"type":"number","description":"retained / cohort_size."},"as_of_date":{"type":"string","format":"date","description":"Snapshot (build) date."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/gnosis_app_gt_wallet_metrics/latest":{"get":{"tags":["Execution"],"summary":"Gnosis App Gt Wallet Metrics (latest)","description":"**Required Access:** `tier1`\n\nPublic per-wallet metric endpoint (pseudonym-only; curated lifecycle/engagement/trust/segment surface). Point-in-time (as_of_date).\n\n**Declared Filters:**\n- **user_pseudonym**: = on `user_pseudonym` (sipHash64 pseudonym (joinable to mixpanel/gpay/circles))\n- **engagement_tier**: = on `engagement_tier` (inactive | casual | core | power)\n- **app_generation**: = on `app_generation` (current | legacy | both | none)\n\n**Sort:**\n- `n_actions DESC`\n\n**Columns:**\n- **user_pseudonym** (`UInt64`): sipHash64 pseudonym (joinable to mixpanel/gpay/circles).\n- **app_generation** (`String`): current | legacy | both | none.\n- **engagement_tier** (`String`): inactive | casual | core | power.\n- **is_registered_active** (`Bool`): Canonical active flag.\n- **is_active_30d** (`Bool`): Active within 30 days.\n- **is_active_90d** (`Bool`): Active within 90 days.\n- **tenure_days** (`Nullable(Int64)`): Days between first and last action.\n- **days_since_last_action** (`Nullable(Int64)`): Days since last action.\n- **n_actions** (`UInt64`): Total on-chain actions.\n- **app_action_breadth** (`UInt16`): Distinct app-tagged action types (0-8).\n- **n_swaps_gnosis_app** (`UInt64`): Swaps under app.gnosis.io.\n- **n_swaps_metri** (`UInt64`): Swaps under app.metri.xyz.\n- **n_metri_transfer** (`UInt64`): MetriTransfer events.\n- **n_personal_mint** (`UInt64`): PersonalMint (CRC claim) events.\n- **n_cashback** (`UInt64`): Cashback NFT mints.\n- **n_investment** (`UInt64`): Metri auto-invest accounts.\n- **n_invitees** (`UInt64`): Distinct invitees referred.\n- **trusts_given** (`Int64`): Trust out-degree.\n- **trusts_received** (`Int64`): Trust in-degree.\n- **trusts_mutual** (`Int64`): Mutual trust count.\n- **referral_crc_earned** (`Float64`): CRC earned as inviter.\n- **earned_from_invites_crc** (`Float64`): Lifetime CRC from invites.\n- **is_gp_card_user** (`Bool`): Linked to a GP card.\n- **is_investor** (`Bool`): Owns an auto-invest account.\n- **is_power_user** (`Bool`): High-breadth + recently active.\n- **circles_version** (`Nullable(Int32)`): Avatar Circles version (1/2).\n- **as_of_date** (`Date`): Snapshot (build) date.","operationId":"api_execution_gnosis_app_gt_wallet_metrics_get_v1_execution_gnosis_app_gt_wallet_metrics_latest_get","security":[{"APIKeyHeader":[]}],"responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"user_pseudonym":{"type":"integer","description":"sipHash64 pseudonym (joinable to mixpanel/gpay/circles)."},"app_generation":{"type":"string","description":"current | legacy | both | none."},"engagement_tier":{"type":"string","description":"inactive | casual | core | power."},"is_registered_active":{"type":"boolean","description":"Canonical active flag."},"is_active_30d":{"type":"boolean","description":"Active within 30 days."},"is_active_90d":{"type":"boolean","description":"Active within 90 days."},"tenure_days":{"type":"integer","description":"Days between first and last action."},"days_since_last_action":{"type":"integer","description":"Days since last action."},"n_actions":{"type":"integer","description":"Total on-chain actions."},"app_action_breadth":{"type":"integer","description":"Distinct app-tagged action types (0-8)."},"n_swaps_gnosis_app":{"type":"integer","description":"Swaps under app.gnosis.io."},"n_swaps_metri":{"type":"integer","description":"Swaps under app.metri.xyz."},"n_metri_transfer":{"type":"integer","description":"MetriTransfer events."},"n_personal_mint":{"type":"integer","description":"PersonalMint (CRC claim) events."},"n_cashback":{"type":"integer","description":"Cashback NFT mints."},"n_investment":{"type":"integer","description":"Metri auto-invest accounts."},"n_invitees":{"type":"integer","description":"Distinct invitees referred."},"trusts_given":{"type":"integer","description":"Trust out-degree."},"trusts_received":{"type":"integer","description":"Trust in-degree."},"trusts_mutual":{"type":"integer","description":"Mutual trust count."},"referral_crc_earned":{"type":"number","description":"CRC earned as inviter."},"earned_from_invites_crc":{"type":"number","description":"Lifetime CRC from invites."},"is_gp_card_user":{"type":"boolean","description":"Linked to a GP card."},"is_investor":{"type":"boolean","description":"Owns an auto-invest account."},"is_power_user":{"type":"boolean","description":"High-breadth + recently active."},"circles_version":{"type":"integer","description":"Avatar Circles version (1/2)."},"as_of_date":{"type":"string","format":"date","description":"Snapshot (build) date."}}}}}}}},"parameters":[{"name":"user_pseudonym","in":"query","required":false,"description":"sipHash64 pseudonym (joinable to mixpanel/gpay/circles)","schema":{"type":"string"}},{"name":"engagement_tier","in":"query","required":false,"description":"inactive | casual | core | power","schema":{"type":"string"}},{"name":"app_generation","in":"query","required":false,"description":"current | legacy | both | none","schema":{"type":"string"}}]}},"/v1/execution/gnosis_app_kpi_churn_rate/last_month":{"get":{"tags":["Execution"],"summary":"Gnosis App Kpi Churn Rate (last_month)","description":"**Required Access:** `tier0` (no API key required)\n\nKPI: latest-month 'Any'-scope churn rate.\n\n**Columns:**\n- **as_of_date** (`Date`): Date the snapshot is computed as of (max date in the underlying data).","operationId":"api_execution_gnosis_app_kpi_churn_rate_latest_get_v1_execution_gnosis_app_kpi_churn_rate_last_month_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"as_of_date":{"type":"string","format":"date","description":"Date the snapshot is computed as of (max date in the underlying data)."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/gnosis_app_kpi_dau/last_day":{"get":{"tags":["Execution"],"summary":"Gnosis App Kpi Dau (last_day)","description":"**Required Access:** `tier0` (no API key required)\n\nKPI: DAU yesterday with pct change vs the day before.\n\n**Columns:**\n- **as_of_date** (`Date`): Date the snapshot is computed as of (max date in the underlying data).","operationId":"api_execution_gnosis_app_kpi_dau_latest_get_v1_execution_gnosis_app_kpi_dau_last_day_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"as_of_date":{"type":"string","format":"date","description":"Date the snapshot is computed as of (max date in the underlying data)."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/gnosis_app_kpi_gp_wallets/snapshot":{"get":{"tags":["Execution"],"summary":"Gnosis App Kpi Gp Wallets (snapshot)","description":"**Required Access:** `tier0` (no API key required)\n\nKPI: count of GP wallets currently GA-owned.\n\n**Columns:**\n- **as_of_date** (`Date`): Date the snapshot is computed as of (max date in the underlying data).","operationId":"api_execution_gnosis_app_kpi_gp_wallets_latest_get_v1_execution_gnosis_app_kpi_gp_wallets_snapshot_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"as_of_date":{"type":"string","format":"date","description":"Date the snapshot is computed as of (max date in the underlying data)."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/gnosis_app_kpi_gp_wallets_imported/snapshot":{"get":{"tags":["Execution"],"summary":"Gnosis App Kpi Gp Wallets Imported (snapshot)","description":"**Required Access:** `tier0` (no API key required)\n\nKPI: cumulative GP wallets imported (pre-existing GP users who added GA).\n\n**Columns:**\n- **as_of_date** (`Date`): Date the snapshot is computed as of (max date in the underlying data).","operationId":"api_execution_gnosis_app_kpi_gp_wallets_imported_get_v1_execution_gnosis_app_kpi_gp_wallets_imported_snapshot_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"as_of_date":{"type":"string","format":"date","description":"Date the snapshot is computed as of (max date in the underlying data)."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/gnosis_app_kpi_gp_wallets_onboarded/snapshot":{"get":{"tags":["Execution"],"summary":"Gnosis App Kpi Gp Wallets Onboarded (snapshot)","description":"**Required Access:** `tier0` (no API key required)\n\nKPI: cumulative GP wallets onboarded via Gnosis App.\n\n**Columns:**\n- **as_of_date** (`Date`): Date the snapshot is computed as of (max date in the underlying data).","operationId":"api_execution_gnosis_app_kpi_gp_wallets_onboarded_get_v1_execution_gnosis_app_kpi_gp_wallets_onboarded_snapshot_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"as_of_date":{"type":"string","format":"date","description":"Date the snapshot is computed as of (max date in the underlying data)."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/gnosis_app_kpi_marketplace_buys/last_7d":{"get":{"tags":["Execution"],"summary":"Gnosis App Kpi Marketplace Buys (last_7d)","description":"**Required Access:** `tier0` (no API key required)\n\nKPI: marketplace buys in the last 7 full days.\n\n**Columns:**\n- **as_of_date** (`Date`): Date the snapshot is computed as of (max date in the underlying data).","operationId":"api_execution_gnosis_app_kpi_marketplace_buys_7d_get_v1_execution_gnosis_app_kpi_marketplace_buys_last_7d_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"as_of_date":{"type":"string","format":"date","description":"Date the snapshot is computed as of (max date in the underlying data)."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/gnosis_app_kpi_marketplace_buys_total/snapshot":{"get":{"tags":["Execution"],"summary":"Gnosis App Kpi Marketplace Buys Total (snapshot)","description":"**Required Access:** `tier0` (no API key required)\n\nKPI: lifetime marketplace buys across all curated offers.\n\n**Columns:**\n- **as_of_date** (`Date`): Date the snapshot is computed as of (max date in the underlying data).","operationId":"api_execution_gnosis_app_kpi_marketplace_buys_total_get_v1_execution_gnosis_app_kpi_marketplace_buys_total_snapshot_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"as_of_date":{"type":"string","format":"date","description":"Date the snapshot is computed as of (max date in the underlying data)."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/gnosis_app_kpi_marketplace_payers/last_7d":{"get":{"tags":["Execution"],"summary":"Gnosis App Kpi Marketplace Payers (last_7d)","description":"**Required Access:** `tier0` (no API key required)\n\nKPI: distinct marketplace payers in the last 7 full days.\n\n**Columns:**\n- **as_of_date** (`Date`): Date the snapshot is computed as of (max date in the underlying data).","operationId":"api_execution_gnosis_app_kpi_marketplace_payers_7d_get_v1_execution_gnosis_app_kpi_marketplace_payers_last_7d_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"as_of_date":{"type":"string","format":"date","description":"Date the snapshot is computed as of (max date in the underlying data)."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/gnosis_app_kpi_mau/last_month":{"get":{"tags":["Execution"],"summary":"Gnosis App Kpi Mau (last_month)","description":"**Required Access:** `tier0` (no API key required)\n\nKPI: MAU for the latest complete month with pct change vs prior.\n\n**Columns:**\n- **as_of_date** (`Date`): Date the snapshot is computed as of (max date in the underlying data).","operationId":"api_execution_gnosis_app_kpi_mau_latest_get_v1_execution_gnosis_app_kpi_mau_last_month_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"as_of_date":{"type":"string","format":"date","description":"Date the snapshot is computed as of (max date in the underlying data)."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/gnosis_app_kpi_new_users/last_7d":{"get":{"tags":["Execution"],"summary":"Gnosis App Kpi New Users (last_7d)","description":"**Required Access:** `tier0` (no API key required)\n\nKPI: new users in the last 7 full days with pct change vs prior 7d.\n\n**Columns:**\n- **as_of_date** (`Date`): Date the snapshot is computed as of (max date in the underlying data).","operationId":"api_execution_gnosis_app_kpi_new_users_7d_get_v1_execution_gnosis_app_kpi_new_users_last_7d_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"as_of_date":{"type":"string","format":"date","description":"Date the snapshot is computed as of (max date in the underlying data)."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/gnosis_app_kpi_repeat_purchase_rate/last_30d":{"get":{"tags":["Execution"],"summary":"Gnosis App Kpi Repeat Purchase Rate (last_30d)","description":"**Required Access:** `tier0` (no API key required)\n\nKPI: share of last-30d active users with ≥2 swap_filled or marketplace_buy events.\n\n**Columns:**\n- **as_of_date** (`Date`): Date the snapshot is computed as of (max date in the underlying data).","operationId":"api_execution_gnosis_app_kpi_repeat_purchase_rate_latest_get_v1_execution_gnosis_app_kpi_repeat_purchase_rate_last_30d_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"as_of_date":{"type":"string","format":"date","description":"Date the snapshot is computed as of (max date in the underlying data)."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/gnosis_app_kpi_retention_pct/last_month":{"get":{"tags":["Execution"],"summary":"Gnosis App Kpi Retention Pct (last_month)","description":"**Required Access:** `tier0` (no API key required)\n\nKPI: latest-cohort M1 retention %.\n\n**Columns:**\n- **as_of_date** (`Date`): Date the snapshot is computed as of (max date in the underlying data).","operationId":"api_execution_gnosis_app_kpi_retention_pct_latest_get_v1_execution_gnosis_app_kpi_retention_pct_last_month_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"as_of_date":{"type":"string","format":"date","description":"Date the snapshot is computed as of (max date in the underlying data)."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/gnosis_app_kpi_swap_fees/last_7d/7d":{"get":{"tags":["Execution"],"summary":"Gnosis App Kpi Swap Fees (last_7d) [7d]","description":"**Required Access:** `tier0` (no API key required)\n\nKPI: protocol fee revenue (USD) from filled swaps in last 7 full days with WoW pct change.\n\n**Columns:**\n- **as_of_date** (`Date`): Date the snapshot is computed as of (max date in the underlying data).","operationId":"api_execution_gnosis_app_kpi_swap_fees_7d_get_v1_execution_gnosis_app_kpi_swap_fees_last_7d_7d_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"as_of_date":{"type":"string","format":"date","description":"Date the snapshot is computed as of (max date in the underlying data)."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/gnosis_app_kpi_swap_volume/last_7d":{"get":{"tags":["Execution"],"summary":"Gnosis App Kpi Swap Volume (last_7d)","description":"**Required Access:** `tier0` (no API key required)\n\nKPI: filled-swap USD volume in the last 7 full days.\n\n**Columns:**\n- **as_of_date** (`Date`): Date the snapshot is computed as of (max date in the underlying data).","operationId":"api_execution_gnosis_app_kpi_swap_volume_7d_get_v1_execution_gnosis_app_kpi_swap_volume_last_7d_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"as_of_date":{"type":"string","format":"date","description":"Date the snapshot is computed as of (max date in the underlying data)."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/gnosis_app_kpi_swaps/last_7d":{"get":{"tags":["Execution"],"summary":"Gnosis App Kpi Swaps (last_7d)","description":"**Required Access:** `tier0` (no API key required)\n\nKPI: signed swap count in the last 7 full days.\n\n**Columns:**\n- **as_of_date** (`Date`): Date the snapshot is computed as of (max date in the underlying data).","operationId":"api_execution_gnosis_app_kpi_swaps_7d_get_v1_execution_gnosis_app_kpi_swaps_last_7d_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"as_of_date":{"type":"string","format":"date","description":"Date the snapshot is computed as of (max date in the underlying data)."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/gnosis_app_kpi_token_offer_claimers/last_7d":{"get":{"tags":["Execution"],"summary":"Gnosis App Kpi Token Offer Claimers (last_7d)","description":"**Required Access:** `tier0` (no API key required)\n\nKPI: distinct token-offer claimers in the last 7 full days.\n\n**Columns:**\n- **as_of_date** (`Date`): Date the snapshot is computed as of (max date in the underlying data).","operationId":"api_execution_gnosis_app_kpi_token_offer_claimers_7d_get_v1_execution_gnosis_app_kpi_token_offer_claimers_last_7d_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"as_of_date":{"type":"string","format":"date","description":"Date the snapshot is computed as of (max date in the underlying data)."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/gnosis_app_kpi_token_offer_claims/last_7d":{"get":{"tags":["Execution"],"summary":"Gnosis App Kpi Token Offer Claims (last_7d)","description":"**Required Access:** `tier0` (no API key required)\n\nKPI: token-offer claim count in the last 7 full days with pct change vs prior 7d.\n\n**Columns:**\n- **as_of_date** (`Date`): Date the snapshot is computed as of (max date in the underlying data).","operationId":"api_execution_gnosis_app_kpi_token_offer_claims_7d_get_v1_execution_gnosis_app_kpi_token_offer_claims_last_7d_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"as_of_date":{"type":"string","format":"date","description":"Date the snapshot is computed as of (max date in the underlying data)."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/gnosis_app_kpi_token_offer_volume/last_7d":{"get":{"tags":["Execution"],"summary":"Gnosis App Kpi Token Offer Volume (last_7d)","description":"**Required Access:** `tier0` (no API key required)\n\nKPI: token-offer received-side USD volume in the last 7 full days.\n\n**Columns:**\n- **as_of_date** (`Date`): Date the snapshot is computed as of (max date in the underlying data).","operationId":"api_execution_gnosis_app_kpi_token_offer_volume_7d_get_v1_execution_gnosis_app_kpi_token_offer_volume_last_7d_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"as_of_date":{"type":"string","format":"date","description":"Date the snapshot is computed as of (max date in the underlying data)."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/gnosis_app_kpi_topup_volume/last_7d":{"get":{"tags":["Execution"],"summary":"Gnosis App Kpi Topup Volume (last_7d)","description":"**Required Access:** `tier0` (no API key required)\n\nKPI: topup USD volume in the last 7 full days.\n\n**Columns:**\n- **as_of_date** (`Date`): Date the snapshot is computed as of (max date in the underlying data).","operationId":"api_execution_gnosis_app_kpi_topup_volume_7d_get_v1_execution_gnosis_app_kpi_topup_volume_last_7d_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"as_of_date":{"type":"string","format":"date","description":"Date the snapshot is computed as of (max date in the underlying data)."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/gnosis_app_kpi_topups/last_7d":{"get":{"tags":["Execution"],"summary":"Gnosis App Kpi Topups (last_7d)","description":"**Required Access:** `tier0` (no API key required)\n\nKPI: topup count in the last 7 full days.\n\n**Columns:**\n- **as_of_date** (`Date`): Date the snapshot is computed as of (max date in the underlying data).","operationId":"api_execution_gnosis_app_kpi_topups_7d_get_v1_execution_gnosis_app_kpi_topups_last_7d_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"as_of_date":{"type":"string","format":"date","description":"Date the snapshot is computed as of (max date in the underlying data)."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/gnosis_app_kpi_total_users/snapshot":{"get":{"tags":["Execution"],"summary":"Gnosis App Kpi Total Users (snapshot)","description":"**Required Access:** `tier0` (no API key required)\n\nKPI: total distinct GA users to date. Returns (value, change_pct).\n\n**Columns:**\n- **as_of_date** (`Date`): Date the snapshot is computed as of (max date in the underlying data).","operationId":"api_execution_gnosis_app_kpi_total_users_get_v1_execution_gnosis_app_kpi_total_users_snapshot_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"as_of_date":{"type":"string","format":"date","description":"Date the snapshot is computed as of (max date in the underlying data)."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/gnosis_app_kpi_wau/last_week":{"get":{"tags":["Execution"],"summary":"Gnosis App Kpi Wau (last_week)","description":"**Required Access:** `tier0` (no API key required)\n\nKPI: WAU for the latest complete week with pct change vs prior.\n\n**Columns:**\n- **as_of_date** (`Date`): Date the snapshot is computed as of (max date in the underlying data).","operationId":"api_execution_gnosis_app_kpi_wau_latest_get_v1_execution_gnosis_app_kpi_wau_last_week_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"as_of_date":{"type":"string","format":"date","description":"Date the snapshot is computed as of (max date in the underlying data)."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/gnosis_app_kpi_weekly_active_users/last_week":{"get":{"tags":["Execution"],"summary":"Gnosis App Kpi Weekly Active Users (last_week)","description":"**Required Access:** `tier0` (no API key required)\n\nKPI: latest complete week's Gnosis App WAU (Lineage A, fct_execution_gnosis_app_users_weekly.active_users — same population/columns as DAU & MAU) with WoW pct change.\n\n**Columns:**\n- **as_of_date** (`Date`): Date the snapshot is computed as of (max date in the underlying data).","operationId":"api_execution_gnosis_app_kpi_weekly_active_users_latest_get_v1_execution_gnosis_app_kpi_weekly_active_users_last_week_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"as_of_date":{"type":"string","format":"date","description":"Date the snapshot is computed as of (max date in the underlying data)."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/gnosis_app_kpi_weekly_economically_active_users/last_week":{"get":{"tags":["Execution"],"summary":"Gnosis App Kpi Weekly Economically Active Users (last_week)","description":"**Required Access:** `tier0` (no API key required)\n\nKPI: latest complete week's WEAU (non-blacklisted only) with WoW pct change.\n\n**Columns:**\n- **as_of_date** (`Date`): Date the snapshot is computed as of (max date in the underlying data).","operationId":"api_execution_gnosis_app_kpi_weekly_economically_active_users_latest_get_v1_execution_gnosis_app_kpi_weekly_economically_active_users_last_week_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"as_of_date":{"type":"string","format":"date","description":"Date the snapshot is computed as of (max date in the underlying data)."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/gnosis_app_marketplace_buys/daily":{"get":{"tags":["Execution"],"summary":"Gnosis App Marketplace Buys (daily)","description":"**Required Access:** `tier1`\n\nFastAPI endpoint view of fct_execution_gnosis_app_marketplace_buys_daily.\nSupports query params: offer_name, start_date, end_date.\n\n\n**Declared Filters:**\n- **offer_name**: = on `offer_name` (Offer name (as declared in createGateway))\n- **start_date**: >= on `date` (Inclusive start date)\n- **end_date**: <= on `date` (Inclusive end date)\n\n**Sort:**\n- `date DESC`\n\n**Columns:**\n- **date** (`Date`): Calendar date (UTC).\n- **offer_name** (`String`): Human-readable offer name.\n- **n_buys** (`UInt64`): Number of buy events.\n- **n_payers** (`UInt64`): Distinct paying addresses.\n- **volume_token** (`Nullable(Float64)`): Volume in native token units.","operationId":"api_execution_gnosis_app_marketplace_buys_daily_get_v1_execution_gnosis_app_marketplace_buys_daily_get","security":[{"APIKeyHeader":[]}],"responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"date":{"type":"string","format":"date","description":"Calendar date (UTC)."},"offer_name":{"type":"string","description":"Human-readable offer name."},"n_buys":{"type":"integer","description":"Number of buy events."},"n_payers":{"type":"integer","description":"Distinct paying addresses."},"volume_token":{"type":"number","description":"Volume in native token units."}}}}}}}},"parameters":[{"name":"offer_name","in":"query","required":false,"description":"Offer name (as declared in createGateway)","schema":{"type":"string"}},{"name":"start_date","in":"query","required":false,"description":"Inclusive start date","schema":{"type":"string","format":"date"}},{"name":"end_date","in":"query","required":false,"description":"Inclusive end date","schema":{"type":"string","format":"date"}}]}},"/v1/execution/gnosis_app_marketplace_buys_cumulative/daily":{"get":{"tags":["Execution"],"summary":"Gnosis App Marketplace Buys Cumulative (daily)","description":"**Required Access:** `tier1`\n\nFastAPI endpoint view of\nfct_execution_gnosis_app_marketplace_buys_cumulative_daily. Supports\nquery params: offer_name, start_date, end_date.\n\n\n**Declared Filters:**\n- **offer_name**: = on `offer_name` (Offer name)\n- **start_date**: >= on `date` (Inclusive start date)\n- **end_date**: <= on `date` (Inclusive end date)\n\n**Sort:**\n- `date DESC`\n\n**Columns:**\n- **date** (`Date`): Calendar date (UTC).\n- **offer_name** (`String`): Human-readable offer name.\n- **n_buys** (`UInt64`): Number of buy events.\n- **n_new_payers** (`UInt64`): Distinct addresses paying for the first time.\n- **cumulative_buys** (`UInt64`): Running total of buys.\n- **cumulative_payers** (`UInt64`): Running total of distinct payers.","operationId":"api_execution_gnosis_app_marketplace_buys_cumulative_daily_get_v1_execution_gnosis_app_marketplace_buys_cumulative_daily_get","security":[{"APIKeyHeader":[]}],"responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"date":{"type":"string","format":"date","description":"Calendar date (UTC)."},"offer_name":{"type":"string","description":"Human-readable offer name."},"n_buys":{"type":"integer","description":"Number of buy events."},"n_new_payers":{"type":"integer","description":"Distinct addresses paying for the first time."},"cumulative_buys":{"type":"integer","description":"Running total of buys."},"cumulative_payers":{"type":"integer","description":"Running total of distinct payers."}}}}}}}},"parameters":[{"name":"offer_name","in":"query","required":false,"description":"Offer name","schema":{"type":"string"}},{"name":"start_date","in":"query","required":false,"description":"Inclusive start date","schema":{"type":"string","format":"date"}},{"name":"end_date","in":"query","required":false,"description":"Inclusive end date","schema":{"type":"string","format":"date"}}]}},"/v1/execution/gnosis_app_marketplace_offers/snapshot":{"get":{"tags":["Execution"],"summary":"Gnosis App Marketplace Offers (snapshot)","description":"**Required Access:** `tier1`\n\nFastAPI endpoint view of fct_execution_gnosis_app_marketplace_offers_latest.\nSupports query param: offer_name.\n\n\n**Declared Filters:**\n- **offer_name**: = on `offer_name` (Offer name)\n\n**Sort:**\n- `total_buys DESC`\n\n**Columns:**\n- **offer_name** (`String`): Human-readable offer name.\n- **gateway_address** (`String`): Payment gateway contract address.\n- **created_at** (`DateTime`): Creation timestamp.\n- **total_buys** (`UInt64`): Total buys.\n- **total_payers** (`UInt64`): Total distinct payers.\n- **first_buy_at** (`Nullable(DateTime)`): Timestamp of the address's first buy.\n- **last_buy_at** (`Nullable(DateTime)`): Timestamp of the address's most recent buy.\n- **as_of_date** (`Date`): Date the snapshot is computed as of (max date in the underlying data).","operationId":"api_execution_gnosis_app_marketplace_offers_latest_get_v1_execution_gnosis_app_marketplace_offers_snapshot_get","security":[{"APIKeyHeader":[]}],"responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"offer_name":{"type":"string","description":"Human-readable offer name."},"gateway_address":{"type":"string","description":"Payment gateway contract address."},"created_at":{"type":"string","format":"date-time","description":"Creation timestamp."},"total_buys":{"type":"integer","description":"Total buys."},"total_payers":{"type":"integer","description":"Total distinct payers."},"first_buy_at":{"type":"string","format":"date-time","description":"Timestamp of the address's first buy."},"last_buy_at":{"type":"string","format":"date-time","description":"Timestamp of the address's most recent buy."},"as_of_date":{"type":"string","format":"date","description":"Date the snapshot is computed as of (max date in the underlying data)."}}}}}}}},"parameters":[{"name":"offer_name","in":"query","required":false,"description":"Offer name","schema":{"type":"string"}}]}},"/v1/execution/gnosis_app_purchase_freq_distribution/latest":{"get":{"tags":["Execution"],"summary":"Gnosis App Purchase Freq Distribution (latest)","description":"**Required Access:** `tier1`\n\nDistribution histogram of last-30d purchase counts per user (buckets 1/2/3/4-5/6-10/11+).\n\n**Columns:**\n- **as_of_date** (`Date`): Date the snapshot is computed as of (max date in the underlying data).","operationId":"api_execution_gnosis_app_purchase_freq_distribution_latest_get_v1_execution_gnosis_app_purchase_freq_distribution_latest_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"as_of_date":{"type":"string","format":"date","description":"Date the snapshot is computed as of (max date in the underlying data)."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/gnosis_app_retention/monthly":{"get":{"tags":["Execution"],"summary":"Gnosis App Retention (monthly)","description":"**Required Access:** `tier1`\n\nFastAPI view over fct_execution_gnosis_app_retention_monthly. Params: start_month, end_month.\n\n**Declared Filters:**\n- **start_month**: >= on `cohort_month` (Inclusive start cohort month)\n- **end_month**: <= on `cohort_month` (Inclusive end cohort month)\n\n**Sort:**\n- `cohort_month DESC`\n\n**Columns:**\n- **cohort_month** (`Date`): Onboard month (toStartOfMonth of the first 'onboard' row); the cohort anchor.\n- **x** (`String`): Activity month as a string (toString(activity_month)); x-axis of the retention grid.\n- **y** (`String`): Onboard cohort month as a string (toString(cohort_month)); y-axis of the retention grid.\n- **retention_pct** (`Float64`): Share of the onboard cohort active in activity_month (users / initial_users x 100).\n- **value_abs** (`UInt64`): Distinct cohort users active in this cell (renamed from users).\n- **amount_retention_pct** (`Nullable(Float64)`): Activity USD as a share of the cohort's earliest activity-month USD (x100).\n- **value_usd** (`Nullable(Float64)`): USD amount transacted by the cohort in activity_month (renamed from amount_usd).","operationId":"api_execution_gnosis_app_retention_monthly_get_v1_execution_gnosis_app_retention_monthly_get","security":[{"APIKeyHeader":[]}],"responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"cohort_month":{"type":"string","format":"date","description":"Onboard month (toStartOfMonth of the first 'onboard' row); the cohort anchor."},"x":{"type":"string","description":"Activity month as a string (toString(activity_month)); x-axis of the retention grid."},"y":{"type":"string","description":"Onboard cohort month as a string (toString(cohort_month)); y-axis of the retention grid."},"retention_pct":{"type":"number","description":"Share of the onboard cohort active in activity_month (users / initial_users x 100)."},"value_abs":{"type":"integer","description":"Distinct cohort users active in this cell (renamed from users)."},"amount_retention_pct":{"type":"number","description":"Activity USD as a share of the cohort's earliest activity-month USD (x100)."},"value_usd":{"type":"number","description":"USD amount transacted by the cohort in activity_month (renamed from amount_usd)."}}}}}}}},"parameters":[{"name":"start_month","in":"query","required":false,"description":"Inclusive start cohort month","schema":{"type":"string","format":"date"}},{"name":"end_month","in":"query","required":false,"description":"Inclusive end cohort month","schema":{"type":"string","format":"date"}}]}},"/v1/execution/gnosis_app_retention_by_action/monthly":{"get":{"tags":["Execution"],"summary":"Gnosis App Retention By Action (monthly)","description":"**Required Access:** `tier1`\n\nFastAPI view over fct_execution_gnosis_app_retention_by_action_monthly. Params: activity_kind, start_month, end_month.\n\n**Declared Filters:**\n- **activity_kind**: = on `activity_kind` (Activity kind to slice retention on)\n- **start_month**: >= on `cohort_month` (Inclusive start cohort month)\n- **end_month**: <= on `cohort_month` (Inclusive end cohort month)\n\n**Sort:**\n- `cohort_month DESC`\n\n**Columns:**\n- **cohort_month** (`Date`): Onboard month (first 'onboard' row); shared across all activity_kinds.\n- **x** (`String`): Activity month as a string (toString(activity_month)); x-axis of the retention grid.\n- **y** (`String`): Onboard cohort month as a string (toString(cohort_month)); y-axis of the retention grid.\n- **activity_kind** (`String`): Type of activity the retention is sliced on (swap_filled / swap_signed / topup / marketplace_buy / token_offer_claim / circles_* / ...).\n- **retention_pct** (`Float64`): Share of the onboard cohort doing this action in activity_month (users / initial_users x 100).\n- **value_abs** (`UInt64`): Distinct cohort users doing this activity_kind in activity_month (renamed from users).\n- **initial_users** (`UInt64`): Onboard-cohort size = distinct users onboarded in cohort_month (retention denominator).","operationId":"api_execution_gnosis_app_retention_by_action_monthly_get_v1_execution_gnosis_app_retention_by_action_monthly_get","security":[{"APIKeyHeader":[]}],"responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"cohort_month":{"type":"string","format":"date","description":"Onboard month (first 'onboard' row); shared across all activity_kinds."},"x":{"type":"string","description":"Activity month as a string (toString(activity_month)); x-axis of the retention grid."},"y":{"type":"string","description":"Onboard cohort month as a string (toString(cohort_month)); y-axis of the retention grid."},"activity_kind":{"type":"string","description":"Type of activity the retention is sliced on (swap_filled / swap_signed / topup / marketplace_buy / token_offer_claim / circles_* / ...)."},"retention_pct":{"type":"number","description":"Share of the onboard cohort doing this action in activity_month (users / initial_users x 100)."},"value_abs":{"type":"integer","description":"Distinct cohort users doing this activity_kind in activity_month (renamed from users)."},"initial_users":{"type":"integer","description":"Onboard-cohort size = distinct users onboarded in cohort_month (retention denominator)."}}}}}}}},"parameters":[{"name":"activity_kind","in":"query","required":false,"description":"Activity kind to slice retention on","schema":{"type":"string"}},{"name":"start_month","in":"query","required":false,"description":"Inclusive start cohort month","schema":{"type":"string","format":"date"}},{"name":"end_month","in":"query","required":false,"description":"Inclusive end cohort month","schema":{"type":"string","format":"date"}}]}},"/v1/execution/gnosis_app_swap_fees/daily":{"get":{"tags":["Execution"],"summary":"Gnosis App Swap Fees (daily)","description":"**Required Access:** `tier1`\n\nDaily CoW protocol fee revenue from GA swaps (filled trades, pro-rated to USD).\n\n**Columns:**\n- **date** (`Date`): Calendar date (UTC).\n- **n_filled_swaps** (`UInt64`): Number of filled swaps on this date.\n- **n_distinct_takers** (`UInt64`): Distinct taker (GA user) addresses with a filled swap on this date.\n- **volume_usd** (`Nullable(Float64)`): Filled-swap USD volume on this date.\n- **fee_native_total** (`Nullable(Float64)`): Sum of fee_amount in sold-token native units.\n- **fee_usd_total** (`Nullable(Float64)`): Pro-rated fee in USD.\n- **fee_pct_of_volume** (`Nullable(Float64)`): fee_usd_total / volume_usd × 100.","operationId":"api_execution_gnosis_app_swap_fees_daily_get_v1_execution_gnosis_app_swap_fees_daily_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"date":{"type":"string","format":"date","description":"Calendar date (UTC)."},"n_filled_swaps":{"type":"integer","description":"Number of filled swaps on this date."},"n_distinct_takers":{"type":"integer","description":"Distinct taker (GA user) addresses with a filled swap on this date."},"volume_usd":{"type":"number","description":"Filled-swap USD volume on this date."},"fee_native_total":{"type":"number","description":"Sum of fee_amount in sold-token native units."},"fee_usd_total":{"type":"number","description":"Pro-rated fee in USD."},"fee_pct_of_volume":{"type":"number","description":"fee_usd_total / volume_usd × 100."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/gnosis_app_swap_fees/weekly":{"get":{"tags":["Execution"],"summary":"Gnosis App Swap Fees (weekly)","description":"**Required Access:** `tier1`\n\nWeekly rollup of swap_fees_daily.\n\n**Columns:**\n- **week** (`Date`): Monday-aligned start of the week (UTC).\n- **n_filled_swaps** (`UInt64`): Number of filled swaps in this week.\n- **volume_usd** (`Nullable(Float64)`): Filled-swap USD volume in this week.\n- **fee_native_total** (`Nullable(Float64)`): Sum of fee_amount in sold-token native units.\n- **fee_usd_total** (`Nullable(Float64)`): Pro-rated fee in USD.\n- **fee_pct_of_volume** (`Nullable(Float64)`): fee_usd_total / volume_usd × 100.","operationId":"api_execution_gnosis_app_swap_fees_weekly_get_v1_execution_gnosis_app_swap_fees_weekly_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"week":{"type":"string","format":"date","description":"Monday-aligned start of the week (UTC)."},"n_filled_swaps":{"type":"integer","description":"Number of filled swaps in this week."},"volume_usd":{"type":"number","description":"Filled-swap USD volume in this week."},"fee_native_total":{"type":"number","description":"Sum of fee_amount in sold-token native units."},"fee_usd_total":{"type":"number","description":"Pro-rated fee in USD."},"fee_pct_of_volume":{"type":"number","description":"fee_usd_total / volume_usd × 100."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/gnosis_app_swap_fees/monthly":{"get":{"tags":["Execution"],"summary":"Gnosis App Swap Fees (monthly)","description":"**Required Access:** `tier1`\n\nMonthly rollup of swap_fees_daily.\n\n**Columns:**\n- **month** (`Date`): First day of the month (UTC).\n- **n_filled_swaps** (`UInt64`): Number of filled swaps in this month.\n- **volume_usd** (`Nullable(Float64)`): Filled-swap USD volume in this month.\n- **fee_native_total** (`Nullable(Float64)`): Sum of fee_amount in sold-token native units.\n- **fee_usd_total** (`Nullable(Float64)`): Pro-rated fee in USD.\n- **fee_pct_of_volume** (`Nullable(Float64)`): fee_usd_total / volume_usd × 100.","operationId":"api_execution_gnosis_app_swap_fees_monthly_get_v1_execution_gnosis_app_swap_fees_monthly_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"month":{"type":"string","format":"date","description":"First day of the month (UTC)."},"n_filled_swaps":{"type":"integer","description":"Number of filled swaps in this month."},"volume_usd":{"type":"number","description":"Filled-swap USD volume in this month."},"fee_native_total":{"type":"number","description":"Sum of fee_amount in sold-token native units."},"fee_usd_total":{"type":"number","description":"Pro-rated fee in USD."},"fee_pct_of_volume":{"type":"number","description":"fee_usd_total / volume_usd × 100."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/gnosis_app_swaps/daily":{"get":{"tags":["Execution"],"summary":"Gnosis App Swaps (daily)","description":"**Required Access:** `tier1`\n\nFastAPI endpoint view of fct_execution_gnosis_app_swaps_daily. Supports\nquery params: start_date, end_date.\n\n\n**Declared Filters:**\n- **start_date**: >= on `date` (Inclusive start date)\n- **end_date**: <= on `date` (Inclusive end date)\n\n**Sort:**\n- `date DESC`\n\n**Columns:**\n- **date** (`Date`): Calendar date (UTC).\n- **n_swaps** (`UInt64`): Number of swap orders.\n- **n_swaps_filled** (`UInt64`): Number of swap orders that filled.\n- **n_swaps_unfilled** (`UInt64`): Number of swap orders that did not fill.\n- **n_swappers** (`UInt64`): Distinct addresses that swapped.\n- **n_orders** (`UInt64`): Number of distinct orders.\n- **volume_usd_filled** (`Nullable(Float64)`): USD volume of filled swaps.\n- **volume_usd_priced** (`Nullable(Float64)`): USD volume for trades with a USD price available.\n- **n_filled_unpriced** (`UInt64`): Filled swaps with no USD price available.","operationId":"api_execution_gnosis_app_swaps_daily_get_v1_execution_gnosis_app_swaps_daily_get","security":[{"APIKeyHeader":[]}],"responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"date":{"type":"string","format":"date","description":"Calendar date (UTC)."},"n_swaps":{"type":"integer","description":"Number of swap orders."},"n_swaps_filled":{"type":"integer","description":"Number of swap orders that filled."},"n_swaps_unfilled":{"type":"integer","description":"Number of swap orders that did not fill."},"n_swappers":{"type":"integer","description":"Distinct addresses that swapped."},"n_orders":{"type":"integer","description":"Number of distinct orders."},"volume_usd_filled":{"type":"number","description":"USD volume of filled swaps."},"volume_usd_priced":{"type":"number","description":"USD volume for trades with a USD price available."},"n_filled_unpriced":{"type":"integer","description":"Filled swaps with no USD price available."}}}}}}}},"parameters":[{"name":"start_date","in":"query","required":false,"description":"Inclusive start date","schema":{"type":"string","format":"date"}},{"name":"end_date","in":"query","required":false,"description":"Inclusive end date","schema":{"type":"string","format":"date"}}]}},"/v1/execution/gnosis_app_swaps/weekly":{"get":{"tags":["Execution"],"summary":"Gnosis App Swaps (weekly)","description":"**Required Access:** `tier1`\n\nFastAPI view over fct_execution_gnosis_app_swaps_weekly.\n\n**Declared Filters:**\n- **start_date**: >= on `week` (Inclusive start week)\n- **end_date**: <= on `week` (Inclusive end week)\n\n**Sort:**\n- `week DESC`\n\n**Columns:**\n- **week** (`Date`): Monday-aligned start of the week (UTC).\n- **n_swaps** (`UInt64`): Number of swap orders.\n- **n_swaps_filled** (`UInt64`): Number of swap orders that filled.\n- **n_swaps_unfilled** (`UInt64`): Number of swap orders that did not fill.\n- **n_swappers** (`UInt64`): Distinct addresses that swapped.\n- **n_orders** (`UInt64`): Number of distinct orders.\n- **volume_usd_filled** (`Nullable(Float64)`): USD volume of filled swaps.","operationId":"api_execution_gnosis_app_swaps_weekly_get_v1_execution_gnosis_app_swaps_weekly_get","security":[{"APIKeyHeader":[]}],"responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"week":{"type":"string","format":"date","description":"Monday-aligned start of the week (UTC)."},"n_swaps":{"type":"integer","description":"Number of swap orders."},"n_swaps_filled":{"type":"integer","description":"Number of swap orders that filled."},"n_swaps_unfilled":{"type":"integer","description":"Number of swap orders that did not fill."},"n_swappers":{"type":"integer","description":"Distinct addresses that swapped."},"n_orders":{"type":"integer","description":"Number of distinct orders."},"volume_usd_filled":{"type":"number","description":"USD volume of filled swaps."}}}}}}}},"parameters":[{"name":"start_date","in":"query","required":false,"description":"Inclusive start week","schema":{"type":"string","format":"date"}},{"name":"end_date","in":"query","required":false,"description":"Inclusive end week","schema":{"type":"string","format":"date"}}]}},"/v1/execution/gnosis_app_swaps/monthly":{"get":{"tags":["Execution"],"summary":"Gnosis App Swaps (monthly)","description":"**Required Access:** `tier1`\n\nFastAPI view over fct_execution_gnosis_app_swaps_monthly.\n\n**Declared Filters:**\n- **start_month**: >= on `month` (Inclusive start month)\n- **end_month**: <= on `month` (Inclusive end month)\n\n**Sort:**\n- `month DESC`\n\n**Columns:**\n- **month** (`Date`): First day of the month (UTC).\n- **n_swaps** (`UInt64`): Number of swap orders.\n- **n_swaps_filled** (`UInt64`): Number of swap orders that filled.\n- **n_swaps_unfilled** (`UInt64`): Number of swap orders that did not fill.\n- **n_swappers** (`UInt64`): Distinct addresses that swapped.\n- **n_orders** (`UInt64`): Number of distinct orders.\n- **volume_usd_filled** (`Nullable(Float64)`): USD volume of filled swaps.","operationId":"api_execution_gnosis_app_swaps_monthly_get_v1_execution_gnosis_app_swaps_monthly_get","security":[{"APIKeyHeader":[]}],"responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"month":{"type":"string","format":"date","description":"First day of the month (UTC)."},"n_swaps":{"type":"integer","description":"Number of swap orders."},"n_swaps_filled":{"type":"integer","description":"Number of swap orders that filled."},"n_swaps_unfilled":{"type":"integer","description":"Number of swap orders that did not fill."},"n_swappers":{"type":"integer","description":"Distinct addresses that swapped."},"n_orders":{"type":"integer","description":"Number of distinct orders."},"volume_usd_filled":{"type":"number","description":"USD volume of filled swaps."}}}}}}}},"parameters":[{"name":"start_month","in":"query","required":false,"description":"Inclusive start month","schema":{"type":"string","format":"date"}},{"name":"end_month","in":"query","required":false,"description":"Inclusive end month","schema":{"type":"string","format":"date"}}]}},"/v1/execution/gnosis_app_swaps_by_pair/daily":{"get":{"tags":["Execution"],"summary":"Gnosis App Swaps By Pair (daily)","description":"**Required Access:** `tier1`\n\nFastAPI view over fct_execution_gnosis_app_swaps_by_pair_daily. Params: pair, start_date, end_date.\n\n**Declared Filters:**\n- **pair**: = on `pair` (Token pair label (e.g. 'CRC → EURe'))\n- **start_date**: >= on `date` (Inclusive start date)\n- **end_date**: <= on `date` (Inclusive end date)\n\n**Sort:**\n- `date DESC`\n\n**Columns:**\n- **date** (`Date`): Calendar date (UTC).\n- **pair** (`String`): Token pair label (sold -> bought).\n- **token_sold_symbol** (`Nullable(String)`): Symbol of the token sold.\n- **token_bought_symbol** (`Nullable(String)`): Symbol of the token bought.\n- **n_swaps** (`UInt64`): Number of swap orders.\n- **n_swaps_filled** (`UInt64`): Number of swap orders that filled.\n- **n_swappers** (`UInt64`): Distinct addresses that swapped.\n- **volume_usd_filled** (`Nullable(Float64)`): USD volume of filled swaps.","operationId":"api_execution_gnosis_app_swaps_by_pair_daily_get_v1_execution_gnosis_app_swaps_by_pair_daily_get","security":[{"APIKeyHeader":[]}],"responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"date":{"type":"string","format":"date","description":"Calendar date (UTC)."},"pair":{"type":"string","description":"Token pair label (sold -> bought)."},"token_sold_symbol":{"type":"string","description":"Symbol of the token sold."},"token_bought_symbol":{"type":"string","description":"Symbol of the token bought."},"n_swaps":{"type":"integer","description":"Number of swap orders."},"n_swaps_filled":{"type":"integer","description":"Number of swap orders that filled."},"n_swappers":{"type":"integer","description":"Distinct addresses that swapped."},"volume_usd_filled":{"type":"number","description":"USD volume of filled swaps."}}}}}}}},"parameters":[{"name":"pair","in":"query","required":false,"description":"Token pair label (e.g. 'CRC → EURe')","schema":{"type":"string"}},{"name":"start_date","in":"query","required":false,"description":"Inclusive start date","schema":{"type":"string","format":"date"}},{"name":"end_date","in":"query","required":false,"description":"Inclusive end date","schema":{"type":"string","format":"date"}}]}},"/v1/execution/gnosis_app_swaps_by_solver/daily":{"get":{"tags":["Execution"],"summary":"Gnosis App Swaps By Solver (daily)","description":"**Required Access:** `tier1`\n\nFastAPI view over fct_execution_gnosis_app_swaps_by_solver_daily. Params: solver, start_date, end_date.\n\n**Declared Filters:**\n- **solver**: = on `solver` (Solver address)\n- **start_date**: >= on `date` (Inclusive start date)\n- **end_date**: <= on `date` (Inclusive end date)\n\n**Sort:**\n- `date DESC`\n\n**Columns:**\n- **date** (`Date`): Calendar date (UTC).\n- **solver** (`String`): CoW solver that settled the trade.\n- **n_swaps_filled** (`UInt64`): Number of swap orders that filled.\n- **n_swappers** (`UInt64`): Distinct addresses that swapped.\n- **volume_usd_filled** (`Nullable(Float64)`): USD volume of filled swaps.","operationId":"api_execution_gnosis_app_swaps_by_solver_daily_get_v1_execution_gnosis_app_swaps_by_solver_daily_get","security":[{"APIKeyHeader":[]}],"responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"date":{"type":"string","format":"date","description":"Calendar date (UTC)."},"solver":{"type":"string","description":"CoW solver that settled the trade."},"n_swaps_filled":{"type":"integer","description":"Number of swap orders that filled."},"n_swappers":{"type":"integer","description":"Distinct addresses that swapped."},"volume_usd_filled":{"type":"number","description":"USD volume of filled swaps."}}}}}}}},"parameters":[{"name":"solver","in":"query","required":false,"description":"Solver address","schema":{"type":"string"}},{"name":"start_date","in":"query","required":false,"description":"Inclusive start date","schema":{"type":"string","format":"date"}},{"name":"end_date","in":"query","required":false,"description":"Inclusive end date","schema":{"type":"string","format":"date"}}]}},"/v1/execution/gnosis_app_time_to_first_conversion_cohort/monthly":{"get":{"tags":["Execution"],"summary":"Gnosis App Time To First Conversion Cohort (monthly)","description":"**Required Access:** `tier1`\n\nTime from onboard to a user's FIRST event of each conversion kind, bucketed\nby onboard-month cohort. Long format: one row per (cohort_month,\nconversion_kind) over topup / swap_filled / marketplace_buy /\ntoken_offer_claim. Built on int_execution_gnosis_app_first_conversion.\n\nModeling assumptions:\n  * cohort_month = toStartOfMonth(first_seen_at), the heuristic onboard\n    month. The current (partial) month is excluded.\n  * n_in_cohort = all users onboarded that month; n_converted = those with a\n    non-NULL first_<kind>_at (a NULL first_*_at means the user never did that\n    action). pct_converted = n_converted / n_in_cohort x 100.\n  * median/p25/p75_days are over CONVERTERS ONLY, as\n    dateDiff('day', first_seen_at, first_conversion_at), FLOORED AT 0: the\n    heuristic onboard date can postdate a user's real first action (negative\n    raw diff), and those users are reported as 0-day rather than negative.\n\n\n**Columns:**\n- **cohort_month** (`Date`): Onboard month (toStartOfMonth of first_seen_at).\n- **conversion_kind** (`String`): topup / swap_filled / marketplace_buy / token_offer_claim.\n- **n_in_cohort** (`UInt64`): Users onboarded in cohort_month (denominator).\n- **n_converted** (`UInt64`): Users with a non-NULL first event of this kind.\n- **pct_converted** (`Float64`): n_converted / n_in_cohort x 100.\n- **median_days** (`Float64`): Median days onboard->first conversion, converters only, floored at 0.\n- **p25_days** (`Float64`): 25th-pct days onboard->first conversion, converters only, floored at 0.\n- **p75_days** (`Float64`): 75th-pct days onboard->first conversion, converters only, floored at 0.","operationId":"api_execution_gnosis_app_time_to_first_conversion_cohort_monthly_get_v1_execution_gnosis_app_time_to_first_conversion_cohort_monthly_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"cohort_month":{"type":"string","format":"date","description":"Onboard month (toStartOfMonth of first_seen_at)."},"conversion_kind":{"type":"string","description":"topup / swap_filled / marketplace_buy / token_offer_claim."},"n_in_cohort":{"type":"integer","description":"Users onboarded in cohort_month (denominator)."},"n_converted":{"type":"integer","description":"Users with a non-NULL first event of this kind."},"pct_converted":{"type":"number","description":"n_converted / n_in_cohort x 100."},"median_days":{"type":"number","description":"Median days onboard->first conversion, converters only, floored at 0."},"p25_days":{"type":"number","description":"25th-pct days onboard->first conversion, converters only, floored at 0."},"p75_days":{"type":"number","description":"75th-pct days onboard->first conversion, converters only, floored at 0."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/gnosis_app_token_offer_claim_funnel/daily":{"get":{"tags":["Execution"],"summary":"Gnosis App Token Offer Claim Funnel (daily)","description":"**Required Access:** `tier1`\n\nDaily per-offer token-offer claim conversion (claims, claimers, USD received, claim_rate_pct).\n\n**Columns:**\n- **date** (`Date`): Calendar date (UTC).\n- **offer_address** (`String`): Address of the token offer (nextOffer).\n- **n_claims** (`UInt64`): Number of token-offer claims on this date/offer.\n- **n_claimers** (`UInt64`): Distinct addresses that claimed.\n- **amount_received_usd** (`Float64`): USD value of offer tokens received by claimers.\n- **n_active_pool_30d** (`UInt64`): Rolling 30-day active GA users (proxy eligible pool / funnel denominator).\n- **claim_rate_pct** (`Nullable(Float64)`): n_claimers / n_active_pool_30d × 100 (NULL when the pool is empty).","operationId":"api_execution_gnosis_app_token_offer_claim_funnel_daily_get_v1_execution_gnosis_app_token_offer_claim_funnel_daily_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"date":{"type":"string","format":"date","description":"Calendar date (UTC)."},"offer_address":{"type":"string","description":"Address of the token offer (nextOffer)."},"n_claims":{"type":"integer","description":"Number of token-offer claims on this date/offer."},"n_claimers":{"type":"integer","description":"Distinct addresses that claimed."},"amount_received_usd":{"type":"number","description":"USD value of offer tokens received by claimers."},"n_active_pool_30d":{"type":"integer","description":"Rolling 30-day active GA users (proxy eligible pool / funnel denominator)."},"claim_rate_pct":{"type":"number","description":"n_claimers / n_active_pool_30d × 100 (NULL when the pool is empty)."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/gnosis_app_token_offer_claims/daily":{"get":{"tags":["Execution"],"summary":"Gnosis App Token Offer Claims (daily)","description":"**Required Access:** `tier1`\n\nFastAPI view over fct_execution_gnosis_app_token_offer_claims_daily. Params: start_date, end_date.\n\n**Declared Filters:**\n- **start_date**: >= on `date` (Inclusive start date)\n- **end_date**: <= on `date` (Inclusive end date)\n\n**Sort:**\n- `date DESC`\n\n**Columns:**\n- **date** (`Date`): Calendar date (UTC).\n- **n_claims** (`UInt64`): Number of token-offer claims.\n- **n_claimers** (`UInt64`): Distinct addresses that claimed.\n- **n_offers** (`UInt64`): Distinct token offers.\n- **volume_received_token** (`Float64`): Token amount received by claimers (native units), rounded to 6 decimals.\n- **volume_received_usd** (`Float64`): USD value received by claimers, rounded to 2 decimals.\n- **volume_spent_crc** (`Float64`): CRC spent by claimers, rounded to 2 decimals.","operationId":"api_execution_gnosis_app_token_offer_claims_daily_get_v1_execution_gnosis_app_token_offer_claims_daily_get","security":[{"APIKeyHeader":[]}],"responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"date":{"type":"string","format":"date","description":"Calendar date (UTC)."},"n_claims":{"type":"integer","description":"Number of token-offer claims."},"n_claimers":{"type":"integer","description":"Distinct addresses that claimed."},"n_offers":{"type":"integer","description":"Distinct token offers."},"volume_received_token":{"type":"number","description":"Token amount received by claimers (native units), rounded to 6 decimals."},"volume_received_usd":{"type":"number","description":"USD value received by claimers, rounded to 2 decimals."},"volume_spent_crc":{"type":"number","description":"CRC spent by claimers, rounded to 2 decimals."}}}}}}}},"parameters":[{"name":"start_date","in":"query","required":false,"description":"Inclusive start date","schema":{"type":"string","format":"date"}},{"name":"end_date","in":"query","required":false,"description":"Inclusive end date","schema":{"type":"string","format":"date"}}]}},"/v1/execution/gnosis_app_token_offer_claims/weekly":{"get":{"tags":["Execution"],"summary":"Gnosis App Token Offer Claims (weekly)","description":"**Required Access:** `tier1`\n\nFastAPI view over fct_execution_gnosis_app_token_offer_claims_weekly. Params: start_date, end_date.\n\n**Declared Filters:**\n- **start_date**: >= on `week` (Inclusive start week)\n- **end_date**: <= on `week` (Inclusive end week)\n\n**Sort:**\n- `week DESC`\n\n**Columns:**\n- **week** (`Date`): Monday-aligned start of the week (UTC).\n- **n_claims** (`UInt64`): Number of token-offer claims.\n- **n_claimers** (`UInt64`): Distinct addresses that claimed.\n- **n_offers** (`UInt64`): Distinct token offers.\n- **volume_received_token** (`Float64`): Token amount received by claimers (native units), rounded to 6 decimals.\n- **volume_received_usd** (`Float64`): USD value received by claimers, rounded to 2 decimals.\n- **volume_spent_crc** (`Float64`): CRC spent by claimers, rounded to 2 decimals.","operationId":"api_execution_gnosis_app_token_offer_claims_weekly_get_v1_execution_gnosis_app_token_offer_claims_weekly_get","security":[{"APIKeyHeader":[]}],"responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"week":{"type":"string","format":"date","description":"Monday-aligned start of the week (UTC)."},"n_claims":{"type":"integer","description":"Number of token-offer claims."},"n_claimers":{"type":"integer","description":"Distinct addresses that claimed."},"n_offers":{"type":"integer","description":"Distinct token offers."},"volume_received_token":{"type":"number","description":"Token amount received by claimers (native units), rounded to 6 decimals."},"volume_received_usd":{"type":"number","description":"USD value received by claimers, rounded to 2 decimals."},"volume_spent_crc":{"type":"number","description":"CRC spent by claimers, rounded to 2 decimals."}}}}}}}},"parameters":[{"name":"start_date","in":"query","required":false,"description":"Inclusive start week","schema":{"type":"string","format":"date"}},{"name":"end_date","in":"query","required":false,"description":"Inclusive end week","schema":{"type":"string","format":"date"}}]}},"/v1/execution/gnosis_app_token_offer_claims/monthly":{"get":{"tags":["Execution"],"summary":"Gnosis App Token Offer Claims (monthly)","description":"**Required Access:** `tier1`\n\nFastAPI view over fct_execution_gnosis_app_token_offer_claims_monthly. Params: start_date, end_date.\n\n**Declared Filters:**\n- **start_date**: >= on `month` (Inclusive start month)\n- **end_date**: <= on `month` (Inclusive end month)\n\n**Sort:**\n- `month DESC`\n\n**Columns:**\n- **month** (`Date`): First day of the month (UTC).\n- **n_claims** (`UInt64`): Number of token-offer claims.\n- **n_claimers** (`UInt64`): Distinct addresses that claimed.\n- **n_offers** (`UInt64`): Distinct token offers.\n- **volume_received_token** (`Float64`): Token amount received by claimers (native units), rounded to 6 decimals.\n- **volume_received_usd** (`Float64`): USD value received by claimers, rounded to 2 decimals.\n- **volume_spent_crc** (`Float64`): CRC spent by claimers, rounded to 2 decimals.","operationId":"api_execution_gnosis_app_token_offer_claims_monthly_get_v1_execution_gnosis_app_token_offer_claims_monthly_get","security":[{"APIKeyHeader":[]}],"responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"month":{"type":"string","format":"date","description":"First day of the month (UTC)."},"n_claims":{"type":"integer","description":"Number of token-offer claims."},"n_claimers":{"type":"integer","description":"Distinct addresses that claimed."},"n_offers":{"type":"integer","description":"Distinct token offers."},"volume_received_token":{"type":"number","description":"Token amount received by claimers (native units), rounded to 6 decimals."},"volume_received_usd":{"type":"number","description":"USD value received by claimers, rounded to 2 decimals."},"volume_spent_crc":{"type":"number","description":"CRC spent by claimers, rounded to 2 decimals."}}}}}}}},"parameters":[{"name":"start_date","in":"query","required":false,"description":"Inclusive start month","schema":{"type":"string","format":"date"}},{"name":"end_date","in":"query","required":false,"description":"Inclusive end month","schema":{"type":"string","format":"date"}}]}},"/v1/execution/gnosis_app_token_offer_claims_by_offer/daily":{"get":{"tags":["Execution"],"summary":"Gnosis App Token Offer Claims By Offer (daily)","description":"**Required Access:** `tier1`\n\nFastAPI view over fct_execution_gnosis_app_token_offer_claims_by_offer_daily. Params: offer_address, cycle_address, offer_token_symbol, start_date, end_date.\n\n**Declared Filters:**\n- **offer_address**: = on `offer_address` (Specific offer (nextOffer) address, 0x-prefixed)\n- **cycle_address**: = on `cycle_address` (Specific offer-cycle contract address, 0x-prefixed)\n- **offer_token_symbol**: = on `offer_token_symbol` (Symbol of the offered token (e.g. 'GNO'))\n- **start_date**: >= on `date` (Inclusive start date)\n- **end_date**: <= on `date` (Inclusive end date)\n\n**Sort:**\n- `date DESC`\n\n**Columns:**\n- **date** (`Date`): Calendar date (UTC).\n- **offer_address** (`String`): Address of the token offer (nextOffer).\n- **cycle_address** (`Nullable(String)`): Address of the offer cycle, if any.\n- **offer_token_symbol** (`Nullable(String)`): Symbol of the token sold by the offer.\n- **n_claims** (`UInt64`): Number of token-offer claims.\n- **n_claimers** (`UInt64`): Distinct addresses that claimed.\n- **volume_received_token** (`Float64`): Token amount received by claimers (native units), rounded to 6 decimals.\n- **volume_received_usd** (`Float64`): USD value received by claimers, rounded to 2 decimals.\n- **volume_spent_crc** (`Float64`): CRC spent by claimers, rounded to 2 decimals.\n- **offer_price_in_crc** (`Nullable(Float64)`): Offer sticker price in CRC at creation time, rounded to 6 decimals.","operationId":"api_execution_gnosis_app_token_offer_claims_by_offer_daily_get_v1_execution_gnosis_app_token_offer_claims_by_offer_daily_get","security":[{"APIKeyHeader":[]}],"responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"date":{"type":"string","format":"date","description":"Calendar date (UTC)."},"offer_address":{"type":"string","description":"Address of the token offer (nextOffer)."},"cycle_address":{"type":"string","description":"Address of the offer cycle, if any."},"offer_token_symbol":{"type":"string","description":"Symbol of the token sold by the offer."},"n_claims":{"type":"integer","description":"Number of token-offer claims."},"n_claimers":{"type":"integer","description":"Distinct addresses that claimed."},"volume_received_token":{"type":"number","description":"Token amount received by claimers (native units), rounded to 6 decimals."},"volume_received_usd":{"type":"number","description":"USD value received by claimers, rounded to 2 decimals."},"volume_spent_crc":{"type":"number","description":"CRC spent by claimers, rounded to 2 decimals."},"offer_price_in_crc":{"type":"number","description":"Offer sticker price in CRC at creation time, rounded to 6 decimals."}}}}}}}},"parameters":[{"name":"offer_address","in":"query","required":false,"description":"Specific offer (nextOffer) address, 0x-prefixed","schema":{"type":"string"}},{"name":"cycle_address","in":"query","required":false,"description":"Specific offer-cycle contract address, 0x-prefixed","schema":{"type":"string"}},{"name":"offer_token_symbol","in":"query","required":false,"description":"Symbol of the offered token (e.g. 'GNO')","schema":{"type":"string"}},{"name":"start_date","in":"query","required":false,"description":"Inclusive start date","schema":{"type":"string","format":"date"}},{"name":"end_date","in":"query","required":false,"description":"Inclusive end date","schema":{"type":"string","format":"date"}}]}},"/v1/execution/gnosis_app_token_offer_claims_cohort/monthly":{"get":{"tags":["Execution"],"summary":"Gnosis App Token Offer Claims Cohort (monthly)","description":"**Required Access:** `tier1`\n\nFastAPI view over fct_execution_gnosis_app_token_offer_claims_cohort_monthly. Params: start_month, end_month.\n\n**Declared Filters:**\n- **start_month**: >= on `cohort_month` (Inclusive start cohort month)\n- **end_month**: <= on `cohort_month` (Inclusive end cohort month)\n\n**Sort:**\n- `cohort_month DESC`\n\n**Columns:**\n- **cohort_month** (`Date`): Month of the user's first activity (cohort anchor).\n- **x** (`String`): Activity month as a string (toString(activity_month)); x-axis of the retention grid.\n- **y** (`String`): First-claim cohort month as a string (toString(cohort_month)); y-axis of the retention grid.\n- **retention_pct** (`Float64`): Share of the first-claim cohort still claiming in activity_month (users / initial_users x 100).\n- **value_abs** (`UInt64`): Distinct cohort users in this cell (renamed from users).\n- **amount_retention_pct** (`Nullable(Float64)`): Retained USD amount as a share of the cohort's initial amount (x100).\n- **value_usd** (`Nullable(Float64)`): USD amount (renamed from amount_usd).","operationId":"api_execution_gnosis_app_token_offer_claims_cohort_monthly_get_v1_execution_gnosis_app_token_offer_claims_cohort_monthly_get","security":[{"APIKeyHeader":[]}],"responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"cohort_month":{"type":"string","format":"date","description":"Month of the user's first activity (cohort anchor)."},"x":{"type":"string","description":"Activity month as a string (toString(activity_month)); x-axis of the retention grid."},"y":{"type":"string","description":"First-claim cohort month as a string (toString(cohort_month)); y-axis of the retention grid."},"retention_pct":{"type":"number","description":"Share of the first-claim cohort still claiming in activity_month (users / initial_users x 100)."},"value_abs":{"type":"integer","description":"Distinct cohort users in this cell (renamed from users)."},"amount_retention_pct":{"type":"number","description":"Retained USD amount as a share of the cohort's initial amount (x100)."},"value_usd":{"type":"number","description":"USD amount (renamed from amount_usd)."}}}}}}}},"parameters":[{"name":"start_month","in":"query","required":false,"description":"Inclusive start cohort month","schema":{"type":"string","format":"date"}},{"name":"end_month","in":"query","required":false,"description":"Inclusive end cohort month","schema":{"type":"string","format":"date"}}]}},"/v1/execution/gnosis_app_user_activity/daily":{"get":{"tags":["Execution"],"summary":"Gnosis App User Activity (daily)","description":"**Required Access:** `tier1`\n\nAccount-facing Gnosis App activity view.\n\n**Declared Filters:**\n- **address**: IN on `address`\n- **activity_kind**: = on `activity_kind`\n- **start_date**: >= on `date`\n- **end_date**: <= on `date`\n\n**Pagination:**\n- **limit**: default `200`, max `5000`\n- **offset**: default `0`\n\n**Sort:**\n- `date DESC`\n\n**Columns:**\n- **activity_kind** (`String`): See enum above.\n- **address** (`Nullable(String)`)\n- **date** (`Date`)","operationId":"api_execution_gnosis_app_user_activity_daily_get_v1_execution_gnosis_app_user_activity_daily_get","security":[{"APIKeyHeader":[]}],"responses":{"200":{"description":"Paginated response","content":{"application/json":{"schema":{"type":"object","required":["items","pagination"],"properties":{"items":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"activity_kind":{"type":"string","description":"See enum above."},"address":{"type":"string"},"date":{"type":"string","format":"date"}}}},"pagination":{"type":"object","required":["limit","offset","returned","has_more"],"properties":{"limit":{"type":"integer","minimum":1},"offset":{"type":"integer","minimum":0},"returned":{"type":"integer","minimum":0},"has_more":{"type":"boolean"}}}}}}}}},"parameters":[{"name":"address","in":"query","required":false,"description":"List filter. Accepts repeated query params or CSV.","style":"form","explode":true,"schema":{"type":"array","items":{"type":"string"},"maxItems":20}},{"name":"activity_kind","in":"query","required":false,"description":"","schema":{"type":"string"}},{"name":"start_date","in":"query","required":false,"description":"","schema":{"type":"string","format":"date"}},{"name":"end_date","in":"query","required":false,"description":"","schema":{"type":"string","format":"date"}},{"name":"limit","in":"query","required":false,"description":"Row limit","schema":{"type":"integer","minimum":1,"maximum":5000,"default":200}},{"name":"offset","in":"query","required":false,"description":"Row offset","schema":{"type":"integer","minimum":0,"default":0}}]},"post":{"tags":["Execution"],"summary":"Gnosis App User Activity (daily) (POST)","description":"**Required Access:** `tier1`\n\nAccount-facing Gnosis App activity view.\n\n**Declared Filters:**\n- **address**: IN on `address`\n- **activity_kind**: = on `activity_kind`\n- **start_date**: >= on `date`\n- **end_date**: <= on `date`\n\n**Pagination:**\n- **limit**: default `200`, max `5000`\n- **offset**: default `0`\n\n**Sort:**\n- `date DESC`\n\n**Columns:**\n- **activity_kind** (`String`): See enum above.\n- **address** (`Nullable(String)`)\n- **date** (`Date`)","operationId":"api_execution_gnosis_app_user_activity_daily_post_v1_execution_gnosis_app_user_activity_daily_post","security":[{"APIKeyHeader":[]}],"requestBody":{"content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/api_execution_gnosis_app_user_activity_daily_PostBody"},{"type":"null"}],"title":" Body"}}}},"responses":{"200":{"description":"Paginated response","content":{"application/json":{"schema":{"type":"object","required":["items","pagination"],"properties":{"items":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"activity_kind":{"type":"string","description":"See enum above."},"address":{"type":"string"},"date":{"type":"string","format":"date"}}}},"pagination":{"type":"object","required":["limit","offset","returned","has_more"],"properties":{"limit":{"type":"integer","minimum":1},"offset":{"type":"integer","minimum":0},"returned":{"type":"integer","minimum":0},"has_more":{"type":"boolean"}}}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/execution/gnosis_app_user_profile/latest":{"get":{"tags":["Execution"],"summary":"Gnosis App User Profile (latest)","description":"**Required Access:** `tier1`\n\nAccount-facing Gnosis App profile view from production current-user models.\n\n**Declared Filters:**\n- **address**: IN on `address`\n\n**Pagination:**\n- **limit**: default `20`, max `200`\n- **offset**: default `0`\n\n**Columns:**\n- **address** (`Nullable(String)`)\n- **as_of_date** (`Date`): Date the snapshot is computed as of (max date in the underlying data).","operationId":"api_execution_gnosis_app_user_profile_latest_get_v1_execution_gnosis_app_user_profile_latest_get","security":[{"APIKeyHeader":[]}],"responses":{"200":{"description":"Paginated response","content":{"application/json":{"schema":{"type":"object","required":["items","pagination"],"properties":{"items":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"address":{"type":"string"},"as_of_date":{"type":"string","format":"date","description":"Date the snapshot is computed as of (max date in the underlying data)."}}}},"pagination":{"type":"object","required":["limit","offset","returned","has_more"],"properties":{"limit":{"type":"integer","minimum":1},"offset":{"type":"integer","minimum":0},"returned":{"type":"integer","minimum":0},"has_more":{"type":"boolean"}}}}}}}}},"parameters":[{"name":"address","in":"query","required":false,"description":"List filter. Accepts repeated query params or CSV.","style":"form","explode":true,"schema":{"type":"array","items":{"type":"string"},"maxItems":20}},{"name":"limit","in":"query","required":false,"description":"Row limit","schema":{"type":"integer","minimum":1,"maximum":200,"default":20}},{"name":"offset","in":"query","required":false,"description":"Row offset","schema":{"type":"integer","minimum":0,"default":0}}]},"post":{"tags":["Execution"],"summary":"Gnosis App User Profile (latest) (POST)","description":"**Required Access:** `tier1`\n\nAccount-facing Gnosis App profile view from production current-user models.\n\n**Declared Filters:**\n- **address**: IN on `address`\n\n**Pagination:**\n- **limit**: default `20`, max `200`\n- **offset**: default `0`\n\n**Columns:**\n- **address** (`Nullable(String)`)\n- **as_of_date** (`Date`): Date the snapshot is computed as of (max date in the underlying data).","operationId":"api_execution_gnosis_app_user_profile_latest_post_v1_execution_gnosis_app_user_profile_latest_post","security":[{"APIKeyHeader":[]}],"requestBody":{"content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/api_execution_gnosis_app_user_profile_latest_PostBody"},{"type":"null"}],"title":" Body"}}}},"responses":{"200":{"description":"Paginated response","content":{"application/json":{"schema":{"type":"object","required":["items","pagination"],"properties":{"items":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"address":{"type":"string"},"as_of_date":{"type":"string","format":"date","description":"Date the snapshot is computed as of (max date in the underlying data)."}}}},"pagination":{"type":"object","required":["limit","offset","returned","has_more"],"properties":{"limit":{"type":"integer","minimum":1},"offset":{"type":"integer","minimum":0},"returned":{"type":"integer","minimum":0},"has_more":{"type":"boolean"}}}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/execution/gnosis_app_users/daily":{"get":{"tags":["Execution"],"summary":"Gnosis App Users (daily)","description":"**Required Access:** `tier1`\n\nFastAPI view over fct_execution_gnosis_app_users_daily. Params: start_date, end_date.\n\n**Declared Filters:**\n- **start_date**: >= on `date` (Inclusive start date)\n- **end_date**: <= on `date` (Inclusive end date)\n\n**Sort:**\n- `date DESC`\n\n**Columns:**\n- **date** (`Date`): Calendar date (UTC).\n- **new_users** (`UInt64`): Distinct addresses whose first-ever activity was on this date.\n- **cumulative_users** (`UInt64`): Running total of distinct users up to and including this date.\n- **active_users** (`UInt64`): Distinct addresses with any non-onboard activity on this date.\n- **returning_users** (`UInt64`): Active this date and also active in the immediately prior period.\n- **reactivated_users** (`UInt64`): Active this date after a dormancy gap, having been active earlier.","operationId":"api_execution_gnosis_app_users_daily_get_v1_execution_gnosis_app_users_daily_get","security":[{"APIKeyHeader":[]}],"responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"date":{"type":"string","format":"date","description":"Calendar date (UTC)."},"new_users":{"type":"integer","description":"Distinct addresses whose first-ever activity was on this date."},"cumulative_users":{"type":"integer","description":"Running total of distinct users up to and including this date."},"active_users":{"type":"integer","description":"Distinct addresses with any non-onboard activity on this date."},"returning_users":{"type":"integer","description":"Active this date and also active in the immediately prior period."},"reactivated_users":{"type":"integer","description":"Active this date after a dormancy gap, having been active earlier."}}}}}}}},"parameters":[{"name":"start_date","in":"query","required":false,"description":"Inclusive start date","schema":{"type":"string","format":"date"}},{"name":"end_date","in":"query","required":false,"description":"Inclusive end date","schema":{"type":"string","format":"date"}}]}},"/v1/execution/gnosis_app_users/weekly":{"get":{"tags":["Execution"],"summary":"Gnosis App Users (weekly)","description":"**Required Access:** `tier1`\n\nFastAPI view over fct_execution_gnosis_app_users_weekly. Params: start_date, end_date.\n\n**Declared Filters:**\n- **start_date**: >= on `week` (Inclusive start week)\n- **end_date**: <= on `week` (Inclusive end week)\n\n**Sort:**\n- `week DESC`\n\n**Columns:**\n- **week** (`Date`): Monday-aligned start of the week (UTC).\n- **new_users** (`UInt64`): Distinct addresses whose first-ever activity was in this week.\n- **cumulative_users** (`UInt64`): Running total of distinct users up to and including this week.\n- **active_users** (`UInt64`): Distinct addresses with any non-onboard activity in this week.\n- **returning_users** (`UInt64`): Active this week and also active in the immediately prior week.\n- **reactivated_users** (`UInt64`): Active this week after a dormancy gap, having been active earlier.","operationId":"api_execution_gnosis_app_users_weekly_get_v1_execution_gnosis_app_users_weekly_get","security":[{"APIKeyHeader":[]}],"responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"week":{"type":"string","format":"date","description":"Monday-aligned start of the week (UTC)."},"new_users":{"type":"integer","description":"Distinct addresses whose first-ever activity was in this week."},"cumulative_users":{"type":"integer","description":"Running total of distinct users up to and including this week."},"active_users":{"type":"integer","description":"Distinct addresses with any non-onboard activity in this week."},"returning_users":{"type":"integer","description":"Active this week and also active in the immediately prior week."},"reactivated_users":{"type":"integer","description":"Active this week after a dormancy gap, having been active earlier."}}}}}}}},"parameters":[{"name":"start_date","in":"query","required":false,"description":"Inclusive start week","schema":{"type":"string","format":"date"}},{"name":"end_date","in":"query","required":false,"description":"Inclusive end week","schema":{"type":"string","format":"date"}}]}},"/v1/execution/gnosis_app_users/monthly":{"get":{"tags":["Execution"],"summary":"Gnosis App Users (monthly)","description":"**Required Access:** `tier1`\n\nFastAPI view over fct_execution_gnosis_app_users_monthly. Params: start_month, end_month.\n\n**Declared Filters:**\n- **start_date**: >= on `month` (Inclusive start month)\n- **end_date**: <= on `month` (Inclusive end month)\n\n**Sort:**\n- `month DESC`\n\n**Columns:**\n- **month** (`Date`): First day of the month (UTC).\n- **new_users** (`UInt64`): Distinct addresses whose first-ever activity was in this month.\n- **cumulative_users** (`UInt64`): Running total of distinct users up to and including this month.\n- **active_users** (`UInt64`): Distinct addresses with any non-onboard activity in this month.\n- **returning_users** (`UInt64`): Active this month and also active in the immediately prior month.\n- **reactivated_users** (`UInt64`): Active this month after a dormancy gap, having been active earlier.","operationId":"api_execution_gnosis_app_users_monthly_get_v1_execution_gnosis_app_users_monthly_get","security":[{"APIKeyHeader":[]}],"responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"month":{"type":"string","format":"date","description":"First day of the month (UTC)."},"new_users":{"type":"integer","description":"Distinct addresses whose first-ever activity was in this month."},"cumulative_users":{"type":"integer","description":"Running total of distinct users up to and including this month."},"active_users":{"type":"integer","description":"Distinct addresses with any non-onboard activity in this month."},"returning_users":{"type":"integer","description":"Active this month and also active in the immediately prior month."},"reactivated_users":{"type":"integer","description":"Active this month after a dormancy gap, having been active earlier."}}}}}}}},"parameters":[{"name":"start_date","in":"query","required":false,"description":"Inclusive start month","schema":{"type":"string","format":"date"}},{"name":"end_date","in":"query","required":false,"description":"Inclusive end month","schema":{"type":"string","format":"date"}}]}},"/v1/execution/gnosis_app_weekly_active_users/weekly":{"get":{"tags":["Execution"],"summary":"Gnosis App Weekly Active Users (weekly)","description":"**Required Access:** `tier1`\n\nGnosis App Weekly Active Users (WAU) time-series over fct_execution_gnosis_app_users_weekly.active_users (in-app active population; same as DAU/MAU lineage; latest incomplete week excluded). WEAU is a strict subset.\n\n**Columns:**\n- **week** (`Date`): Monday-aligned start of the week (UTC). Time-series grain.\n- **active_users** (`UInt64`): Distinct in-app active Gnosis App users in the week (headline WAU; any non-onboard activity).\n- **new_users** (`UInt64`): Users whose first-ever activity (onboarding) was this week.\n- **returning_users** (`UInt64`): Active this week AND active the previous week.\n- **reactivated_users** (`UInt64`): Active this week, not active in the prior 4 weeks, but active earlier.","operationId":"api_execution_gnosis_app_weekly_active_users_get_v1_execution_gnosis_app_weekly_active_users_weekly_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"week":{"type":"string","format":"date","description":"Monday-aligned start of the week (UTC). Time-series grain."},"active_users":{"type":"integer","description":"Distinct in-app active Gnosis App users in the week (headline WAU; any non-onboard activity)."},"new_users":{"type":"integer","description":"Users whose first-ever activity (onboarding) was this week."},"returning_users":{"type":"integer","description":"Active this week AND active the previous week."},"reactivated_users":{"type":"integer","description":"Active this week, not active in the prior 4 weeks, but active earlier."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/gnosis_app_weekly_active_users_incl_gpay/weekly":{"get":{"tags":["Execution"],"summary":"Gnosis App Weekly Active Users Incl Gpay (weekly)","description":"**Required Access:** `tier1`\n\nGnosis App Weekly Active Users (WAU), Gnosis-Pay-inclusive variant of api_execution_gnosis_app_weekly_active_users: 'active' additionally counts any user-initiated Gnosis Pay card-wallet transaction (spend/withdrawal/off-ramp/fiat top-up) attributed to the safe's Gnosis App owner. Latest incomplete week excluded; WEAU remains a strict subset of the base WAU.\n\n**Columns:**\n- **week** (`Date`): Monday-aligned start of the week (UTC). Time-series grain.\n- **active_users** (`UInt64`): Distinct active Gnosis App users in the week, additionally including GA owners whose only activity was a Gnosis Pay card-wallet transaction.\n- **new_users** (`UInt64`): Users whose first-ever activity (onboarding) was this week.\n- **returning_users** (`UInt64`): Active this week AND active the previous week.\n- **reactivated_users** (`UInt64`): Active this week, not active in the prior 4 weeks, but active earlier.","operationId":"api_execution_gnosis_app_weekly_active_users_incl_gpay_get_v1_execution_gnosis_app_weekly_active_users_incl_gpay_weekly_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"week":{"type":"string","format":"date","description":"Monday-aligned start of the week (UTC). Time-series grain."},"active_users":{"type":"integer","description":"Distinct active Gnosis App users in the week, additionally including GA owners whose only activity was a Gnosis Pay card-wallet transaction."},"new_users":{"type":"integer","description":"Users whose first-ever activity (onboarding) was this week."},"returning_users":{"type":"integer","description":"Active this week AND active the previous week."},"reactivated_users":{"type":"integer","description":"Active this week, not active in the prior 4 weeks, but active earlier."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/gnosis_app_weekly_economically_active_users/weekly":{"get":{"tags":["Execution"],"summary":"Gnosis App Weekly Economically Active Users (weekly)","description":"**Required Access:** `tier1`\n\nTime-series view over fct_execution_gnosis_app_weekly_economically_active_users (latest week excluded).\n\n**Columns:**\n- **week** (`Date`): Monday-aligned start of the week (UTC). Time-series grain.\n- **is_blacklisted** (`Bool`): True if the address appears in the circles blacklist snapshot.\n- **cnt** (`UInt64`): Distinct economically active addresses in this week × blacklist bucket.","operationId":"api_execution_gnosis_app_weekly_economically_active_users_get_v1_execution_gnosis_app_weekly_economically_active_users_weekly_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"week":{"type":"string","format":"date","description":"Monday-aligned start of the week (UTC). Time-series grain."},"is_blacklisted":{"type":"boolean","description":"True if the address appears in the circles blacklist snapshot."},"cnt":{"type":"integer","description":"Distinct economically active addresses in this week × blacklist bucket."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/gpay_accounts/daily":{"get":{"tags":["Execution"],"summary":"Gpay Accounts (daily)","description":"**Required Access:** `tier1`\n\nDaily time series of the cumulative number of deployed Gnosis Pay accounts.\n\n**Columns:**\n- **date** (`Date`): The calendar date (account deploy date).\n- **value** (`Float64`): The cumulative number of deployed Gnosis Pay accounts up to and including the date.","operationId":"api_execution_gpay_accounts_daily_get_v1_execution_gpay_accounts_daily_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"date":{"type":"string","format":"date","description":"The calendar date (account deploy date)."},"value":{"type":"number","description":"The cumulative number of deployed Gnosis Pay accounts up to and including the date."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/gpay_active_users/weekly":{"get":{"tags":["Execution"],"summary":"Gpay Active Users (weekly)","description":"**Required Access:** `tier1`\n\nWeekly time series of Gnosis Pay active user counts.\n\n**Columns:**\n- **date** (`Date`): The first day of the ISO week.\n- **value** (`UInt64`): The number of active users in this week.","operationId":"api_execution_gpay_active_users_weekly_get_v1_execution_gpay_active_users_weekly_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"date":{"type":"string","format":"date","description":"The first day of the ISO week."},"value":{"type":"integer","description":"The number of active users in this week."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/gpay_active_users/last_7d":{"get":{"tags":["Execution"],"summary":"Gpay Active Users (last_7d)","description":"**Required Access:** `tier0` (no API key required)\n\n7-day active user count with period-over-period change percentage for Gnosis Pay.\n\n**Columns:**\n- **value** (`Float64`): The number of active users in the last 7 days.\n- **change_pct** (`Float64`): The percentage change compared to the previous 7-day period.\n- **as_of_date** (`Date`): Date the snapshot is computed as of (max date in the underlying data).","operationId":"api_execution_gpay_active_users_7d_get_v1_execution_gpay_active_users_last_7d_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"value":{"type":"number","description":"The number of active users in the last 7 days."},"change_pct":{"type":"number","description":"The percentage change compared to the previous 7-day period."},"as_of_date":{"type":"string","format":"date","description":"Date the snapshot is computed as of (max date in the underlying data)."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/gpay_activity_by_action/daily":{"get":{"tags":["Execution"],"summary":"Gpay Activity By Action (daily)","description":"**Required Access:** `tier1`\n\nDaily Gnosis Pay activity metrics broken down by action type, with counts and volumes.\n\n**Declared Filters:**\n- **action**: = on `action` (Action type (Payment, Cashback, etc.))\n- **start_date**: >= on `date` (Inclusive start date)\n- **end_date**: <= on `date` (Inclusive end date)\n\n**Sort:**\n- `date DESC`\n\n**Columns:**\n- **date** (`Date`): The calendar date.\n- **action** (`String`): The activity type (e.g., Payment, Deposit, Withdrawal, Cashback).\n- **activity_count** (`UInt64`): The number of transactions for this action on this date.\n- **volume_usd** (`Float64`): The total USD volume for this action on this date.\n- **volume_native** (`Float64`): The total native token volume for this action on this date.","operationId":"api_execution_gpay_activity_by_action_daily_get_v1_execution_gpay_activity_by_action_daily_get","security":[{"APIKeyHeader":[]}],"responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"date":{"type":"string","format":"date","description":"The calendar date."},"action":{"type":"string","description":"The activity type (e.g., Payment, Deposit, Withdrawal, Cashback)."},"activity_count":{"type":"integer","description":"The number of transactions for this action on this date."},"volume_usd":{"type":"number","description":"The total USD volume for this action on this date."},"volume_native":{"type":"number","description":"The total native token volume for this action on this date."}}}}}}}},"parameters":[{"name":"action","in":"query","required":false,"description":"Action type (Payment, Cashback, etc.)","schema":{"type":"string"}},{"name":"start_date","in":"query","required":false,"description":"Inclusive start date","schema":{"type":"string","format":"date"}},{"name":"end_date","in":"query","required":false,"description":"Inclusive end date","schema":{"type":"string","format":"date"}}]}},"/v1/execution/gpay_activity_by_action/weekly":{"get":{"tags":["Execution"],"summary":"Gpay Activity By Action (weekly)","description":"**Required Access:** `tier1`\n\nWeekly Gnosis Pay activity metrics broken down by action type, with counts and volumes.\n\n**Declared Filters:**\n- **action**: = on `action` (Action type)\n- **start_date**: >= on `week` (Inclusive start date)\n- **end_date**: <= on `week` (Inclusive end date)\n\n**Sort:**\n- `week DESC`\n\n**Columns:**\n- **week** (`Date`): The first day of the ISO week.\n- **action** (`String`): The activity type (e.g., Payment, Deposit, Withdrawal, Cashback).\n- **activity_count** (`UInt64`): The number of transactions for this action in this week.\n- **volume_usd** (`Float64`): The total USD volume for this action in this week.\n- **volume_native** (`Float64`): The total native token volume for this action in this week.","operationId":"api_execution_gpay_activity_by_action_weekly_get_v1_execution_gpay_activity_by_action_weekly_get","security":[{"APIKeyHeader":[]}],"responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"week":{"type":"string","format":"date","description":"The first day of the ISO week."},"action":{"type":"string","description":"The activity type (e.g., Payment, Deposit, Withdrawal, Cashback)."},"activity_count":{"type":"integer","description":"The number of transactions for this action in this week."},"volume_usd":{"type":"number","description":"The total USD volume for this action in this week."},"volume_native":{"type":"number","description":"The total native token volume for this action in this week."}}}}}}}},"parameters":[{"name":"action","in":"query","required":false,"description":"Action type","schema":{"type":"string"}},{"name":"start_date","in":"query","required":false,"description":"Inclusive start date","schema":{"type":"string","format":"date"}},{"name":"end_date","in":"query","required":false,"description":"Inclusive end date","schema":{"type":"string","format":"date"}}]}},"/v1/execution/gpay_activity_by_action/monthly":{"get":{"tags":["Execution"],"summary":"Gpay Activity By Action (monthly)","description":"**Required Access:** `tier1`\n\nMonthly Gnosis Pay activity metrics broken down by action type, with counts and volumes.\n\n**Declared Filters:**\n- **action**: = on `action` (Action type)\n- **start_date**: >= on `month` (Inclusive start date)\n- **end_date**: <= on `month` (Inclusive end date)\n\n**Sort:**\n- `month DESC`\n\n**Columns:**\n- **month** (`Date`): The first day of the month.\n- **action** (`String`): The activity type (e.g., Payment, Deposit, Withdrawal, Cashback).\n- **activity_count** (`UInt64`): The number of transactions for this action in this month.\n- **volume_usd** (`Float64`): The total USD volume for this action in this month.\n- **volume_native** (`Float64`): The total native token volume for this action in this month.","operationId":"api_execution_gpay_activity_by_action_monthly_get_v1_execution_gpay_activity_by_action_monthly_get","security":[{"APIKeyHeader":[]}],"responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"month":{"type":"string","format":"date","description":"The first day of the month."},"action":{"type":"string","description":"The activity type (e.g., Payment, Deposit, Withdrawal, Cashback)."},"activity_count":{"type":"integer","description":"The number of transactions for this action in this month."},"volume_usd":{"type":"number","description":"The total USD volume for this action in this month."},"volume_native":{"type":"number","description":"The total native token volume for this action in this month."}}}}}}}},"parameters":[{"name":"action","in":"query","required":false,"description":"Action type","schema":{"type":"string"}},{"name":"start_date","in":"query","required":false,"description":"Inclusive start date","schema":{"type":"string","format":"date"}},{"name":"end_date","in":"query","required":false,"description":"Inclusive end date","schema":{"type":"string","format":"date"}}]}},"/v1/execution/gpay_balance_cohorts_holders/daily":{"get":{"tags":["Execution"],"summary":"Gpay Balance Cohorts Holders (daily)","description":"**Required Access:** `tier1`\n\nDaily count of Gnosis Pay wallet holders in each balance cohort bucket by token.\n\n**Declared Filters:**\n- **token**: = on `token` (Token symbol)\n- **start_date**: >= on `date` (Inclusive start date)\n- **end_date**: <= on `date` (Inclusive end date)\n\n**Sort:**\n- `date DESC`\n\n**Columns:**\n- **date** (`Date`): The calendar date of the balance snapshot.\n- **token** (`String`): The token symbol.\n- **cohort_unit** (`String`): The unit used for cohort bucketing (e.g., USD, native).\n- **label** (`String`): The balance range bucket label.\n- **value** (`UInt64`): The number of holders in this cohort bucket.","operationId":"api_execution_gpay_balance_cohorts_holders_daily_get_v1_execution_gpay_balance_cohorts_holders_daily_get","security":[{"APIKeyHeader":[]}],"responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"date":{"type":"string","format":"date","description":"The calendar date of the balance snapshot."},"token":{"type":"string","description":"The token symbol."},"cohort_unit":{"type":"string","description":"The unit used for cohort bucketing (e.g., USD, native)."},"label":{"type":"string","description":"The balance range bucket label."},"value":{"type":"integer","description":"The number of holders in this cohort bucket."}}}}}}}},"parameters":[{"name":"token","in":"query","required":false,"description":"Token symbol","schema":{"type":"string"}},{"name":"start_date","in":"query","required":false,"description":"Inclusive start date","schema":{"type":"string","format":"date"}},{"name":"end_date","in":"query","required":false,"description":"Inclusive end date","schema":{"type":"string","format":"date"}}]}},"/v1/execution/gpay_balance_cohorts_value/daily":{"get":{"tags":["Execution"],"summary":"Gpay Balance Cohorts Value (daily)","description":"**Required Access:** `tier1`\n\nDaily total value held in each balance cohort bucket by token, in native and USD.\n\n**Declared Filters:**\n- **token**: = on `token` (Token symbol)\n- **start_date**: >= on `date` (Inclusive start date)\n- **end_date**: <= on `date` (Inclusive end date)\n\n**Sort:**\n- `date DESC`\n\n**Columns:**\n- **date** (`Date`): The calendar date of the balance snapshot.\n- **token** (`String`): The token symbol.\n- **cohort_unit** (`String`): The unit used for cohort bucketing.\n- **label** (`String`): The balance range bucket label.\n- **value_native** (`Float64`): The total native token value in this bucket.\n- **value_usd** (`Float64`): The total USD value in this bucket.","operationId":"api_execution_gpay_balance_cohorts_value_daily_get_v1_execution_gpay_balance_cohorts_value_daily_get","security":[{"APIKeyHeader":[]}],"responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"date":{"type":"string","format":"date","description":"The calendar date of the balance snapshot."},"token":{"type":"string","description":"The token symbol."},"cohort_unit":{"type":"string","description":"The unit used for cohort bucketing."},"label":{"type":"string","description":"The balance range bucket label."},"value_native":{"type":"number","description":"The total native token value in this bucket."},"value_usd":{"type":"number","description":"The total USD value in this bucket."}}}}}}}},"parameters":[{"name":"token","in":"query","required":false,"description":"Token symbol","schema":{"type":"string"}},{"name":"start_date","in":"query","required":false,"description":"Inclusive start date","schema":{"type":"string","format":"date"}},{"name":"end_date","in":"query","required":false,"description":"Inclusive end date","schema":{"type":"string","format":"date"}}]}},"/v1/execution/gpay_balances_by_token/daily":{"get":{"tags":["Execution"],"summary":"Gpay Balances By Token (daily)","description":"**Required Access:** `tier1`\n\nDaily total Gnosis Pay wallet balances by token in USD.\n\n**Declared Filters:**\n- **token**: = on `label` (Token symbol)\n- **start_date**: >= on `date` (Inclusive start date)\n- **end_date**: <= on `date` (Inclusive end date)\n\n**Sort:**\n- `date DESC`\n\n**Columns:**\n- **date** (`Date`): The calendar date of the balance snapshot.\n- **label** (`String`): The token symbol.\n- **value** (`Float64`): The total balance in USD for this token.","operationId":"api_execution_gpay_balances_by_token_daily_get_v1_execution_gpay_balances_by_token_daily_get","security":[{"APIKeyHeader":[]}],"responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"date":{"type":"string","format":"date","description":"The calendar date of the balance snapshot."},"label":{"type":"string","description":"The token symbol."},"value":{"type":"number","description":"The total balance in USD for this token."}}}}}}}},"parameters":[{"name":"token","in":"query","required":false,"description":"Token symbol","schema":{"type":"string"}},{"name":"start_date","in":"query","required":false,"description":"Inclusive start date","schema":{"type":"string","format":"date"}},{"name":"end_date","in":"query","required":false,"description":"Inclusive end date","schema":{"type":"string","format":"date"}}]}},"/v1/execution/gpay_balances_native/daily":{"get":{"tags":["Execution"],"summary":"Gpay Balances Native (daily)","description":"**Required Access:** `tier1`\n\nDaily total Gnosis Pay wallet balances by token in native units.\n\n**Declared Filters:**\n- **token**: = on `label` (Token symbol)\n- **start_date**: >= on `date` (Inclusive start date)\n- **end_date**: <= on `date` (Inclusive end date)\n\n**Sort:**\n- `date DESC`\n\n**Columns:**\n- **date** (`Date`): The calendar date of the balance snapshot.\n- **label** (`String`): The token symbol.\n- **value** (`Float64`): The total balance in native token units.","operationId":"api_execution_gpay_balances_native_daily_get_v1_execution_gpay_balances_native_daily_get","security":[{"APIKeyHeader":[]}],"responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"date":{"type":"string","format":"date","description":"The calendar date of the balance snapshot."},"label":{"type":"string","description":"The token symbol."},"value":{"type":"number","description":"The total balance in native token units."}}}}}}}},"parameters":[{"name":"token","in":"query","required":false,"description":"Token symbol","schema":{"type":"string"}},{"name":"start_date","in":"query","required":false,"description":"Inclusive start date","schema":{"type":"string","format":"date"}},{"name":"end_date","in":"query","required":false,"description":"Inclusive end date","schema":{"type":"string","format":"date"}}]}},"/v1/execution/gpay_balances_usd/daily":{"get":{"tags":["Execution"],"summary":"Gpay Balances Usd (daily)","description":"**Required Access:** `tier1`\n\nDaily total Gnosis Pay wallet balances by token in USD.\n\n**Declared Filters:**\n- **token**: = on `label` (Token symbol)\n- **start_date**: >= on `date` (Inclusive start date)\n- **end_date**: <= on `date` (Inclusive end date)\n\n**Sort:**\n- `date DESC`\n\n**Columns:**\n- **date** (`Date`): The calendar date of the balance snapshot.\n- **label** (`String`): The token symbol.\n- **value** (`Float64`): The total balance in USD for this token.","operationId":"api_execution_gpay_balances_usd_daily_get_v1_execution_gpay_balances_usd_daily_get","security":[{"APIKeyHeader":[]}],"responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"date":{"type":"string","format":"date","description":"The calendar date of the balance snapshot."},"label":{"type":"string","description":"The token symbol."},"value":{"type":"number","description":"The total balance in USD for this token."}}}}}}}},"parameters":[{"name":"token","in":"query","required":false,"description":"Token symbol","schema":{"type":"string"}},{"name":"start_date","in":"query","required":false,"description":"Inclusive start date","schema":{"type":"string","format":"date"}},{"name":"end_date","in":"query","required":false,"description":"Inclusive end date","schema":{"type":"string","format":"date"}}]}},"/v1/execution/gpay_cashback/weekly":{"get":{"tags":["Execution"],"summary":"Gpay Cashback (weekly)","description":"**Required Access:** `tier1`\n\nWeekly cashback amounts distributed by unit.\n\n**Columns:**\n- **unit** (`String`): The cashback unit (e.g., USD, GNO).\n- **date** (`Date`): The first day of the ISO week.\n- **value** (`Float64`): The cashback amount for this week.","operationId":"api_execution_gpay_cashback_weekly_get_v1_execution_gpay_cashback_weekly_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"unit":{"type":"string","description":"The cashback unit (e.g., USD, GNO)."},"date":{"type":"string","format":"date","description":"The first day of the ISO week."},"value":{"type":"number","description":"The cashback amount for this week."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/gpay_cashback/7d":{"get":{"tags":["Execution"],"summary":"Gpay Cashback (7d)","description":"**Required Access:** `tier0` (no API key required)\n\n7-day cashback summary with unit breakdown and period-over-period change percentage.\n\n**Columns:**\n- **unit** (`String`): The cashback unit (e.g., USD, GNO).\n- **value** (`Float64`): The total cashback amount in the last 7 days.\n- **change_pct** (`Float64`): The percentage change compared to the previous 7-day period.\n- **as_of_date** (`Date`): Date the snapshot is computed as of (max date in the underlying data).","operationId":"api_execution_gpay_cashback_7d_get_v1_execution_gpay_cashback_7d_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"unit":{"type":"string","description":"The cashback unit (e.g., USD, GNO)."},"value":{"type":"number","description":"The total cashback amount in the last 7 days."},"change_pct":{"type":"number","description":"The percentage change compared to the previous 7-day period."},"as_of_date":{"type":"string","format":"date","description":"Date the snapshot is computed as of (max date in the underlying data)."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/gpay_cashback_cohort_retention/monthly":{"get":{"tags":["Execution"],"summary":"Gpay Cashback Cohort Retention (monthly)","description":"**Required Access:** `tier1`\n\nMonthly cashback cohort retention heatmap data showing retention and amount percentages across cohorts.\n\n**Columns:**\n- **x** (`String`): The activity month (x-axis of the heatmap).\n- **y** (`String`): The cohort month (y-axis of the heatmap).\n- **retention_pct** (`Float64`): The user retention percentage for this cohort in this month.\n- **value_abs** (`UInt64`): The absolute number of retained users.\n- **amount_retention_pct** (`Float64`): The cashback amount retention percentage.\n- **value_usd** (`Float64`): The total cashback amount in USD.","operationId":"api_execution_gpay_cashback_cohort_retention_monthly_get_v1_execution_gpay_cashback_cohort_retention_monthly_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"x":{"type":"string","description":"The activity month (x-axis of the heatmap)."},"y":{"type":"string","description":"The cohort month (y-axis of the heatmap)."},"retention_pct":{"type":"number","description":"The user retention percentage for this cohort in this month."},"value_abs":{"type":"integer","description":"The absolute number of retained users."},"amount_retention_pct":{"type":"number","description":"The cashback amount retention percentage."},"value_usd":{"type":"number","description":"The total cashback amount in USD."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/gpay_cashback_cohort_retention_users/monthly":{"get":{"tags":["Execution"],"summary":"Gpay Cashback Cohort Retention Users (monthly)","description":"**Required Access:** `tier1`\n\nMonthly cashback cohort sizes over time, formatted for time series visualization.\n\n**Columns:**\n- **date** (`Date`): The activity month.\n- **label** (`String`): The cohort month label.\n- **value** (`UInt64`): The number of active users from this cohort.","operationId":"api_execution_gpay_cashback_cohort_retention_users_monthly_get_v1_execution_gpay_cashback_cohort_retention_users_monthly_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"date":{"type":"string","format":"date","description":"The activity month."},"label":{"type":"string","description":"The cohort month label."},"value":{"type":"integer","description":"The number of active users from this cohort."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/gpay_cashback_cumulative/weekly":{"get":{"tags":["Execution"],"summary":"Gpay Cashback Cumulative (weekly)","description":"**Required Access:** `tier1`\n\nCumulative cashback distributed over time by unit.\n\n**Columns:**\n- **unit** (`String`): The cashback unit (e.g., USD, GNO).\n- **date** (`Date`): The calendar date.\n- **value** (`Float64`): The cumulative cashback amount up to this date.","operationId":"api_execution_gpay_cashback_cumulative_get_v1_execution_gpay_cashback_cumulative_weekly_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"unit":{"type":"string","description":"The cashback unit (e.g., USD, GNO)."},"date":{"type":"string","format":"date","description":"The calendar date."},"value":{"type":"number","description":"The cumulative cashback amount up to this date."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/gpay_cashback_dist/weekly":{"get":{"tags":["Execution"],"summary":"Gpay Cashback Dist (weekly)","description":"**Required Access:** `tier1`\n\nWeekly cashback distribution percentiles for Gnosis Pay users.\n\n**Columns:**\n- **date** (`Date`): The first day of the ISO week.\n- **q05** (`Float64`): The 5th percentile of cashback amounts.\n- **q10** (`Float64`): The 10th percentile of cashback amounts.\n- **q25** (`Float64`): The 25th percentile of cashback amounts.\n- **q50** (`Float64`): The median cashback amount.\n- **q75** (`Float64`): The 75th percentile of cashback amounts.\n- **q90** (`Float64`): The 90th percentile of cashback amounts.\n- **q95** (`Float64`): The 95th percentile of cashback amounts.\n- **average** (`Float64`): The average cashback amount.","operationId":"api_execution_gpay_cashback_dist_weekly_get_v1_execution_gpay_cashback_dist_weekly_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"date":{"type":"string","format":"date","description":"The first day of the ISO week."},"q05":{"type":"number","description":"The 5th percentile of cashback amounts."},"q10":{"type":"number","description":"The 10th percentile of cashback amounts."},"q25":{"type":"number","description":"The 25th percentile of cashback amounts."},"q50":{"type":"number","description":"The median cashback amount."},"q75":{"type":"number","description":"The 75th percentile of cashback amounts."},"q90":{"type":"number","description":"The 90th percentile of cashback amounts."},"q95":{"type":"number","description":"The 95th percentile of cashback amounts."},"average":{"type":"number","description":"The average cashback amount."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/gpay_cashback_impact/monthly":{"get":{"tags":["Execution"],"summary":"Gpay Cashback Impact (monthly)","description":"**Required Access:** `tier1`\n\nMonthly cashback impact analysis comparing payment behavior between user segments. Passes through all columns from the fact model.\n\n**Columns:**\n- **month** (`Date`): The first day of the month.\n- **segment** (`String`): The user segment (e.g., cashback recipient, non-cashback).\n- **users** (`UInt64`): The number of users in this segment.\n- **payment_volume_usd** (`Float64`): The total payment volume in USD for this segment.\n- **payment_count** (`UInt64`): The total number of payments for this segment.\n- **avg_volume_per_user** (`Float64`): The average payment volume per user in USD.\n- **avg_tx_per_user** (`Float64`): The average number of transactions per user.\n- **deposit_volume_usd** (`Float64`): The total deposit volume in USD for this segment.\n- **withdrawal_volume_usd** (`Float64`): The total withdrawal volume in USD for this segment.\n- **net_flow_usd** (`Float64`): The net flow (deposits minus withdrawals) in USD.\n- **pct_of_total_volume** (`Float64`): The percentage of total payment volume this segment represents.\n- **pct_of_total_users** (`Float64`): The percentage of total users this segment represents.","operationId":"api_execution_gpay_cashback_impact_monthly_get_v1_execution_gpay_cashback_impact_monthly_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"month":{"type":"string","format":"date","description":"The first day of the month."},"segment":{"type":"string","description":"The user segment (e.g., cashback recipient, non-cashback)."},"users":{"type":"integer","description":"The number of users in this segment."},"payment_volume_usd":{"type":"number","description":"The total payment volume in USD for this segment."},"payment_count":{"type":"integer","description":"The total number of payments for this segment."},"avg_volume_per_user":{"type":"number","description":"The average payment volume per user in USD."},"avg_tx_per_user":{"type":"number","description":"The average number of transactions per user."},"deposit_volume_usd":{"type":"number","description":"The total deposit volume in USD for this segment."},"withdrawal_volume_usd":{"type":"number","description":"The total withdrawal volume in USD for this segment."},"net_flow_usd":{"type":"number","description":"The net flow (deposits minus withdrawals) in USD."},"pct_of_total_volume":{"type":"number","description":"The percentage of total payment volume this segment represents."},"pct_of_total_users":{"type":"number","description":"The percentage of total users this segment represents."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/gpay_cashback_recipients/weekly":{"get":{"tags":["Execution"],"summary":"Gpay Cashback Recipients (weekly)","description":"**Required Access:** `tier1`\n\nWeekly time series of unique Gnosis Pay cashback recipient counts.\n\n**Columns:**\n- **date** (`Date`): The first day of the ISO week.\n- **value** (`UInt64`): The number of unique cashback recipients in this week.","operationId":"api_execution_gpay_cashback_recipients_weekly_get_v1_execution_gpay_cashback_recipients_weekly_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"date":{"type":"string","format":"date","description":"The first day of the ISO week."},"value":{"type":"integer","description":"The number of unique cashback recipients in this week."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/gpay_cashback_recipients/7d":{"get":{"tags":["Execution"],"summary":"Gpay Cashback Recipients (7d)","description":"**Required Access:** `tier0` (no API key required)\n\n7-day unique cashback recipient count with period-over-period change percentage.\n\n**Columns:**\n- **value** (`Float64`): The number of unique cashback recipients in the last 7 days.\n- **change_pct** (`Float64`): The percentage change compared to the previous 7-day period.\n- **as_of_date** (`Date`): Date the snapshot is computed as of (max date in the underlying data).","operationId":"api_execution_gpay_cashback_recipients_7d_get_v1_execution_gpay_cashback_recipients_7d_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"value":{"type":"number","description":"The number of unique cashback recipients in the last 7 days."},"change_pct":{"type":"number","description":"The percentage change compared to the previous 7-day period."},"as_of_date":{"type":"string","format":"date","description":"Date the snapshot is computed as of (max date in the underlying data)."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/gpay_cashback_recipients_total/all_time":{"get":{"tags":["Execution"],"summary":"Gpay Cashback Recipients Total (all_time)","description":"**Required Access:** `tier0` (no API key required)\n\nAll-time total count of unique Gnosis Pay cashback recipients.\n\n**Columns:**\n- **value** (`Float64`): The total number of unique cashback recipients.\n- **as_of_date** (`Date`): Date the snapshot is computed as of (max date in the underlying data).","operationId":"api_execution_gpay_cashback_recipients_total_get_v1_execution_gpay_cashback_recipients_total_all_time_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"value":{"type":"number","description":"The total number of unique cashback recipients."},"as_of_date":{"type":"string","format":"date","description":"Date the snapshot is computed as of (max date in the underlying data)."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/gpay_cashback_total/all_time":{"get":{"tags":["Execution"],"summary":"Gpay Cashback Total (all_time)","description":"**Required Access:** `tier0` (no API key required)\n\nAll-time total cashback distributed by unit.\n\n**Columns:**\n- **unit** (`String`): The cashback unit (e.g., USD, GNO).\n- **value** (`Float64`): The total cashback amount.\n- **as_of_date** (`Date`): Date the snapshot is computed as of (max date in the underlying data).","operationId":"api_execution_gpay_cashback_total_get_v1_execution_gpay_cashback_total_all_time_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"unit":{"type":"string","description":"The cashback unit (e.g., USD, GNO)."},"value":{"type":"number","description":"The total cashback amount."},"as_of_date":{"type":"string","format":"date","description":"Date the snapshot is computed as of (max date in the underlying data)."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/gpay_churn/monthly":{"get":{"tags":["Execution"],"summary":"Gpay Churn (monthly)","description":"**Required Access:** `tier1`\n\nMonthly user churn breakdown for Gnosis Pay showing user segments and rates by activity scope.\n\n**Declared Filters:**\n- **scope**: = on `scope` (Churn scope)\n- **start_date**: >= on `month` (Inclusive start month)\n- **end_date**: <= on `month` (Inclusive end month)\n\n**Sort:**\n- `month DESC`\n\n**Columns:**\n- **scope** (`String`): The activity scope for churn calculation (e.g., all, payment).\n- **month** (`Date`): The first day of the month.\n- **new_users** (`UInt64`): Users active for the first time this month.\n- **retained_users** (`UInt64`): Users active in both this and the previous month.\n- **returning_users** (`UInt64`): Users returning after a period of inactivity.\n- **churned_users** (`UInt64`): Users active last month but not this month.\n- **total_active** (`UInt64`): Total active users this month.\n- **churn_rate** (`Float64`): The percentage of last month's users who churned.\n- **retention_rate** (`Float64`): The percentage of last month's users who were retained.","operationId":"api_execution_gpay_churn_monthly_get_v1_execution_gpay_churn_monthly_get","security":[{"APIKeyHeader":[]}],"responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"scope":{"type":"string","description":"The activity scope for churn calculation (e.g., all, payment)."},"month":{"type":"string","format":"date","description":"The first day of the month."},"new_users":{"type":"integer","description":"Users active for the first time this month."},"retained_users":{"type":"integer","description":"Users active in both this and the previous month."},"returning_users":{"type":"integer","description":"Users returning after a period of inactivity."},"churned_users":{"type":"integer","description":"Users active last month but not this month."},"total_active":{"type":"integer","description":"Total active users this month."},"churn_rate":{"type":"number","description":"The percentage of last month's users who churned."},"retention_rate":{"type":"number","description":"The percentage of last month's users who were retained."}}}}}}}},"parameters":[{"name":"scope","in":"query","required":false,"description":"Churn scope","schema":{"type":"string"}},{"name":"start_date","in":"query","required":false,"description":"Inclusive start month","schema":{"type":"string","format":"date"}},{"name":"end_date","in":"query","required":false,"description":"Inclusive end month","schema":{"type":"string","format":"date"}}]}},"/v1/execution/gpay_churn_rates/monthly":{"get":{"tags":["Execution"],"summary":"Gpay Churn Rates (monthly)","description":"**Required Access:** `tier1`\n\nMonthly churn and retention rates for Gnosis Pay by activity scope.\n\n**Declared Filters:**\n- **scope**: = on `scope` (Churn scope)\n- **start_date**: >= on `month` (Inclusive start month)\n- **end_date**: <= on `month` (Inclusive end month)\n\n**Sort:**\n- `month DESC`\n\n**Columns:**\n- **scope** (`String`): The activity scope (e.g., all, payment).\n- **month** (`Date`): The first day of the month.\n- **churn_rate** (`Float64`): The churn rate for the month.\n- **retention_rate** (`Float64`): The retention rate for the month.","operationId":"api_execution_gpay_churn_rates_monthly_get_v1_execution_gpay_churn_rates_monthly_get","security":[{"APIKeyHeader":[]}],"responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"scope":{"type":"string","description":"The activity scope (e.g., all, payment)."},"month":{"type":"string","format":"date","description":"The first day of the month."},"churn_rate":{"type":"number","description":"The churn rate for the month."},"retention_rate":{"type":"number","description":"The retention rate for the month."}}}}}}}},"parameters":[{"name":"scope","in":"query","required":false,"description":"Churn scope","schema":{"type":"string"}},{"name":"start_date","in":"query","required":false,"description":"Inclusive start month","schema":{"type":"string","format":"date"}},{"name":"end_date","in":"query","required":false,"description":"Inclusive end month","schema":{"type":"string","format":"date"}}]}},"/v1/execution/gpay_flows_snapshots/in_ranges":{"get":{"tags":["Execution"],"summary":"Gpay Flows Snapshots (in_ranges)","description":"**Required Access:** `tier1`\n\nToken flow patterns between Gnosis Pay wallet labels for API consumption.\n\n**Declared Filters:**\n- **symbol**: = on `symbol` (Token symbol)\n- **window**: = on `window` (Time window (1D, 7D, 30D, 90D))\n\n**Columns:**\n- **window** (`String`): The time window for the flow snapshot (e.g., 7D, 30D, All).\n- **symbol** (`String`): The token symbol involved in the flow.\n- **from_label** (`String`): The source label of the flow.\n- **to_label** (`String`): The destination label of the flow.\n- **amount_usd** (`Float64`): The total USD value of the flow.\n- **tf_cnt** (`UInt64`): The number of individual transfers in the flow.\n- **as_of_date** (`Date`): Date the snapshot is computed as of (max date in the underlying data).","operationId":"api_execution_gpay_flows_snapshot_get_v1_execution_gpay_flows_snapshots_in_ranges_get","security":[{"APIKeyHeader":[]}],"responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"window":{"type":"string","description":"The time window for the flow snapshot (e.g., 7D, 30D, All)."},"symbol":{"type":"string","description":"The token symbol involved in the flow."},"from_label":{"type":"string","description":"The source label of the flow."},"to_label":{"type":"string","description":"The destination label of the flow."},"amount_usd":{"type":"number","description":"The total USD value of the flow."},"tf_cnt":{"type":"integer","description":"The number of individual transfers in the flow."},"as_of_date":{"type":"string","format":"date","description":"Date the snapshot is computed as of (max date in the underlying data)."}}}}}}}},"parameters":[{"name":"symbol","in":"query","required":false,"description":"Token symbol","schema":{"type":"string"}},{"name":"window","in":"query","required":false,"description":"Time window (1D, 7D, 30D, 90D)","schema":{"type":"string"}}]}},"/v1/execution/gpay_funded_addresses/daily":{"get":{"tags":["Execution"],"summary":"Gpay Funded Addresses (daily)","description":"**Required Access:** `tier1`\n\nDaily time series of cumulative funded Gnosis Pay wallet addresses.\n\n**Columns:**\n- **date** (`Date`): The calendar date.\n- **value** (`UInt64`): The cumulative number of funded wallet addresses.","operationId":"api_execution_gpay_funded_addresses_daily_get_v1_execution_gpay_funded_addresses_daily_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"date":{"type":"string","format":"date","description":"The calendar date."},"value":{"type":"integer","description":"The cumulative number of funded wallet addresses."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/gpay_funded_addresses/weekly":{"get":{"tags":["Execution"],"summary":"Gpay Funded Addresses (weekly)","description":"**Required Access:** `tier1`\n\nWeekly time series of cumulative funded Gnosis Pay wallet addresses.\n\n**Columns:**\n- **date** (`Date`): The first day of the ISO week.\n- **value** (`UInt64`): The cumulative number of funded wallet addresses.","operationId":"api_execution_gpay_funded_addresses_weekly_get_v1_execution_gpay_funded_addresses_weekly_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"date":{"type":"string","format":"date","description":"The first day of the ISO week."},"value":{"type":"integer","description":"The cumulative number of funded wallet addresses."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/gpay_funded_addresses/monthly":{"get":{"tags":["Execution"],"summary":"Gpay Funded Addresses (monthly)","description":"**Required Access:** `tier1`\n\nMonthly time series of cumulative funded Gnosis Pay wallet addresses.\n\n**Columns:**\n- **date** (`Date`): The first day of the month.\n- **value** (`UInt64`): The cumulative number of funded wallet addresses.","operationId":"api_execution_gpay_funded_addresses_monthly_get_v1_execution_gpay_funded_addresses_monthly_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"date":{"type":"string","format":"date","description":"The first day of the month."},"value":{"type":"integer","description":"The cumulative number of funded wallet addresses."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/gpay_gno_balance/daily":{"get":{"tags":["Execution"],"summary":"Gpay Gno Balance (daily)","description":"**Required Access:** `tier1`\n\nDaily total GNO token balance across all Gnosis Pay wallets.\n\n**Columns:**\n- **date** (`Date`): The calendar date.\n- **value** (`Float64`): The total GNO balance across all wallets.","operationId":"api_execution_gpay_gno_balance_daily_get_v1_execution_gpay_gno_balance_daily_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"date":{"type":"string","format":"date","description":"The calendar date."},"value":{"type":"number","description":"The total GNO balance across all wallets."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/gpay_gno_total_balance/all_time":{"get":{"tags":["Execution"],"summary":"Gpay Gno Total Balance (all_time)","description":"**Required Access:** `tier0` (no API key required)\n\nCurrent total GNO token balance across all Gnosis Pay wallets.\n\n**Columns:**\n- **value** (`Float64`): The total GNO balance.\n- **as_of_date** (`Date`): Date the snapshot is computed as of (max date in the underlying data).","operationId":"api_execution_gpay_gno_total_balance_get_v1_execution_gpay_gno_total_balance_all_time_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"value":{"type":"number","description":"The total GNO balance."},"as_of_date":{"type":"string","format":"date","description":"Date the snapshot is computed as of (max date in the underlying data)."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/gpay_kpi/monthly":{"get":{"tags":["Execution"],"summary":"Gpay Kpi (monthly)","description":"**Required Access:** `tier1`\n\nMonthly KPIs for Gnosis Pay, passing through all columns from the fact model.\n\n**Columns:**\n- **month** (`Date`): The first day of the month.\n- **mau** (`UInt64`): Monthly active users across all activity types.\n- **payment_mau** (`UInt64`): Monthly active users who made payments.\n- **deposit_mau** (`UInt64`): Monthly active users who made deposits.\n- **withdrawal_mau** (`UInt64`): Monthly active users who made withdrawals.\n- **cashback_mau** (`UInt64`): Monthly active users who received cashback.\n- **total_payment_volume_usd** (`Float64`): Total payment volume in USD for the month.\n- **total_payment_count** (`UInt64`): Total number of payments in the month.\n- **total_deposit_volume_usd** (`Float64`): Total deposit volume in USD for the month.\n- **total_withdrawal_volume_usd** (`Float64`): Total withdrawal volume in USD for the month.\n- **net_flow_usd** (`Float64`): Net flow (deposits minus withdrawals) in USD for the month.\n- **cashback_total_usd** (`Float64`): Total cashback distributed in USD for the month.\n- **cashback_total_gno** (`Float64`): Total cashback distributed in GNO tokens for the month.\n- **refund_total_usd** (`Float64`): Total refund value in USD for the month.\n- **reversal_total_usd** (`Float64`): Total reversal value in USD for the month.\n- **arpu** (`Float64`): Average revenue per user in USD.\n- **avg_tx_per_user** (`Float64`): Average number of transactions per active user.\n- **repeat_purchase_rate** (`Float64`): Percentage of users who made more than one payment.","operationId":"api_execution_gpay_kpi_monthly_get_v1_execution_gpay_kpi_monthly_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"month":{"type":"string","format":"date","description":"The first day of the month."},"mau":{"type":"integer","description":"Monthly active users across all activity types."},"payment_mau":{"type":"integer","description":"Monthly active users who made payments."},"deposit_mau":{"type":"integer","description":"Monthly active users who made deposits."},"withdrawal_mau":{"type":"integer","description":"Monthly active users who made withdrawals."},"cashback_mau":{"type":"integer","description":"Monthly active users who received cashback."},"total_payment_volume_usd":{"type":"number","description":"Total payment volume in USD for the month."},"total_payment_count":{"type":"integer","description":"Total number of payments in the month."},"total_deposit_volume_usd":{"type":"number","description":"Total deposit volume in USD for the month."},"total_withdrawal_volume_usd":{"type":"number","description":"Total withdrawal volume in USD for the month."},"net_flow_usd":{"type":"number","description":"Net flow (deposits minus withdrawals) in USD for the month."},"cashback_total_usd":{"type":"number","description":"Total cashback distributed in USD for the month."},"cashback_total_gno":{"type":"number","description":"Total cashback distributed in GNO tokens for the month."},"refund_total_usd":{"type":"number","description":"Total refund value in USD for the month."},"reversal_total_usd":{"type":"number","description":"Total reversal value in USD for the month."},"arpu":{"type":"number","description":"Average revenue per user in USD."},"avg_tx_per_user":{"type":"number","description":"Average number of transactions per active user."},"repeat_purchase_rate":{"type":"number","description":"Percentage of users who made more than one payment."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/gpay_owner_balances_by_token/daily":{"get":{"tags":["Execution"],"summary":"Gpay Owner Balances By Token (daily)","description":"**Required Access:** `tier1`\n\nDaily total Gnosis Pay owner balances by token in USD.\n\n**Declared Filters:**\n- **token**: = on `label` (Token symbol)\n- **start_date**: >= on `date` (Inclusive start date)\n- **end_date**: <= on `date` (Inclusive end date)\n\n**Sort:**\n- `date DESC`\n\n**Columns:**\n- **date** (`Date`): The calendar date of the balance snapshot.\n- **label** (`String`): The token symbol.\n- **value** (`Float64`): The total owner balance in USD for this token.","operationId":"api_execution_gpay_owner_balances_by_token_daily_get_v1_execution_gpay_owner_balances_by_token_daily_get","security":[{"APIKeyHeader":[]}],"responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"date":{"type":"string","format":"date","description":"The calendar date of the balance snapshot."},"label":{"type":"string","description":"The token symbol."},"value":{"type":"number","description":"The total owner balance in USD for this token."}}}}}}}},"parameters":[{"name":"token","in":"query","required":false,"description":"Token symbol","schema":{"type":"string"}},{"name":"start_date","in":"query","required":false,"description":"Inclusive start date","schema":{"type":"string","format":"date"}},{"name":"end_date","in":"query","required":false,"description":"Inclusive end date","schema":{"type":"string","format":"date"}}]}},"/v1/execution/gpay_owner_total_balance/all_time":{"get":{"tags":["Execution"],"summary":"Gpay Owner Total Balance (all_time)","description":"**Required Access:** `tier0` (no API key required)\n\nCurrent total balance across all Gnosis Pay wallet owners in USD.\n\n**Columns:**\n- **value** (`Float64`): The total owner balance in USD.\n- **as_of_date** (`Date`): Date the snapshot is computed as of (max date in the underlying data).","operationId":"api_execution_gpay_owner_total_balance_get_v1_execution_gpay_owner_total_balance_all_time_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"value":{"type":"number","description":"The total owner balance in USD."},"as_of_date":{"type":"string","format":"date","description":"Date the snapshot is computed as of (max date in the underlying data)."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/gpay_payments/last_7d":{"get":{"tags":["Execution"],"summary":"Gpay Payments (last_7d)","description":"**Required Access:** `tier0` (no API key required)\n\n7-day payment count with period-over-period change percentage.\n\n**Columns:**\n- **value** (`Float64`): The total number of payments in the last 7 days.\n- **change_pct** (`Float64`): The percentage change compared to the previous 7-day period.\n- **as_of_date** (`Date`): Date the snapshot is computed as of (max date in the underlying data).","operationId":"api_execution_gpay_payments_7d_get_v1_execution_gpay_payments_last_7d_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"value":{"type":"number","description":"The total number of payments in the last 7 days."},"change_pct":{"type":"number","description":"The percentage change compared to the previous 7-day period."},"as_of_date":{"type":"string","format":"date","description":"Date the snapshot is computed as of (max date in the underlying data)."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/gpay_payments/hourly":{"get":{"tags":["Execution"],"summary":"Gpay Payments (hourly)","description":"**Required Access:** `tier1`\n\nHourly payment counts by token for Gnosis Pay.\n\n**Declared Filters:**\n- **token**: = on `label` (Token symbol)\n- **start_date**: >= on `date` (Inclusive start date)\n- **end_date**: <= on `date` (Inclusive end date)\n\n**Sort:**\n- `date DESC`\n\n**Columns:**\n- **date** (`DateTime`): The hour timestamp of the payment activity.\n- **label** (`String`): The token symbol.\n- **value** (`UInt64`): The number of payments in this hour for this token.","operationId":"api_execution_gpay_payments_hourly_get_v1_execution_gpay_payments_hourly_get","security":[{"APIKeyHeader":[]}],"responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"date":{"type":"string","format":"date-time","description":"The hour timestamp of the payment activity."},"label":{"type":"string","description":"The token symbol."},"value":{"type":"integer","description":"The number of payments in this hour for this token."}}}}}}}},"parameters":[{"name":"token","in":"query","required":false,"description":"Token symbol","schema":{"type":"string"}},{"name":"start_date","in":"query","required":false,"description":"Inclusive start date","schema":{"type":"string","format":"date"}},{"name":"end_date","in":"query","required":false,"description":"Inclusive end date","schema":{"type":"string","format":"date"}}]}},"/v1/execution/gpay_payments_by_token/daily":{"get":{"tags":["Execution"],"summary":"Gpay Payments By Token (daily)","description":"**Required Access:** `tier1`\n\nDaily payment counts by token for Gnosis Pay.\n\n**Declared Filters:**\n- **token**: = on `label` (Token symbol)\n- **start_date**: >= on `date` (Inclusive start date)\n- **end_date**: <= on `date` (Inclusive end date)\n\n**Sort:**\n- `date DESC`\n\n**Columns:**\n- **date** (`Date`): The calendar date.\n- **label** (`String`): The token symbol.\n- **value** (`UInt64`): The number of payments for this token on this date.","operationId":"api_execution_gpay_payments_by_token_daily_get_v1_execution_gpay_payments_by_token_daily_get","security":[{"APIKeyHeader":[]}],"responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"date":{"type":"string","format":"date","description":"The calendar date."},"label":{"type":"string","description":"The token symbol."},"value":{"type":"integer","description":"The number of payments for this token on this date."}}}}}}}},"parameters":[{"name":"token","in":"query","required":false,"description":"Token symbol","schema":{"type":"string"}},{"name":"start_date","in":"query","required":false,"description":"Inclusive start date","schema":{"type":"string","format":"date"}},{"name":"end_date","in":"query","required":false,"description":"Inclusive end date","schema":{"type":"string","format":"date"}}]}},"/v1/execution/gpay_payments_by_token/weekly":{"get":{"tags":["Execution"],"summary":"Gpay Payments By Token (weekly)","description":"**Required Access:** `tier1`\n\nWeekly payment counts by token for Gnosis Pay.\n\n**Declared Filters:**\n- **token**: = on `label` (Token symbol)\n- **start_date**: >= on `date` (Inclusive start date)\n- **end_date**: <= on `date` (Inclusive end date)\n\n**Sort:**\n- `date DESC`\n\n**Columns:**\n- **date** (`Date`): The first day of the ISO week.\n- **label** (`String`): The token symbol.\n- **value** (`UInt64`): The number of payments for this token in this week.","operationId":"api_execution_gpay_payments_by_token_weekly_get_v1_execution_gpay_payments_by_token_weekly_get","security":[{"APIKeyHeader":[]}],"responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"date":{"type":"string","format":"date","description":"The first day of the ISO week."},"label":{"type":"string","description":"The token symbol."},"value":{"type":"integer","description":"The number of payments for this token in this week."}}}}}}}},"parameters":[{"name":"token","in":"query","required":false,"description":"Token symbol","schema":{"type":"string"}},{"name":"start_date","in":"query","required":false,"description":"Inclusive start date","schema":{"type":"string","format":"date"}},{"name":"end_date","in":"query","required":false,"description":"Inclusive end date","schema":{"type":"string","format":"date"}}]}},"/v1/execution/gpay_payments_by_token/monthly":{"get":{"tags":["Execution"],"summary":"Gpay Payments By Token (monthly)","description":"**Required Access:** `tier1`\n\nMonthly payment counts by token for Gnosis Pay.\n\n**Declared Filters:**\n- **token**: = on `label` (Token symbol)\n- **start_date**: >= on `date` (Inclusive start date)\n- **end_date**: <= on `date` (Inclusive end date)\n\n**Sort:**\n- `date DESC`\n\n**Columns:**\n- **date** (`Date`): The first day of the month.\n- **label** (`String`): The token symbol.\n- **value** (`UInt64`): The number of payments for this token in this month.","operationId":"api_execution_gpay_payments_by_token_monthly_get_v1_execution_gpay_payments_by_token_monthly_get","security":[{"APIKeyHeader":[]}],"responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"date":{"type":"string","format":"date","description":"The first day of the month."},"label":{"type":"string","description":"The token symbol."},"value":{"type":"integer","description":"The number of payments for this token in this month."}}}}}}}},"parameters":[{"name":"token","in":"query","required":false,"description":"Token symbol","schema":{"type":"string"}},{"name":"start_date","in":"query","required":false,"description":"Inclusive start date","schema":{"type":"string","format":"date"}},{"name":"end_date","in":"query","required":false,"description":"Inclusive end date","schema":{"type":"string","format":"date"}}]}},"/v1/execution/gpay_retention/monthly":{"get":{"tags":["Execution"],"summary":"Gpay Retention (monthly)","description":"**Required Access:** `tier1`\n\nMonthly cohort user counts over time, formatted for time series visualization.\n\n**Columns:**\n- **date** (`String`): The activity month.\n- **label** (`String`): The cohort month label.\n- **value** (`UInt64`): The number of active users from this cohort.","operationId":"api_execution_gpay_retention_monthly_get_v1_execution_gpay_retention_monthly_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"date":{"type":"string","description":"The activity month."},"label":{"type":"string","description":"The cohort month label."},"value":{"type":"integer","description":"The number of active users from this cohort."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/gpay_retention_by_action/monthly":{"get":{"tags":["Execution"],"summary":"Gpay Retention By Action (monthly)","description":"**Required Access:** `tier1`\n\nMonthly cohort retention heatmap data for Gnosis Pay broken down by action type.\n\n**Declared Filters:**\n- **action**: = on `action` (Action type)\n\n**Columns:**\n- **x** (`String`): The activity month (x-axis of the heatmap).\n- **y** (`String`): The cohort month (y-axis of the heatmap).\n- **action** (`String`): The activity type (e.g., Payment, Deposit, Withdrawal).\n- **retention_pct** (`Float64`): The user retention percentage.\n- **value_abs** (`UInt64`): The absolute number of retained users.\n- **amount_retention_pct** (`Float64`): The amount retention percentage.\n- **value_usd** (`Float64`): The total USD amount for the cohort in this month.","operationId":"api_execution_gpay_retention_by_action_monthly_get_v1_execution_gpay_retention_by_action_monthly_get","security":[{"APIKeyHeader":[]}],"responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"x":{"type":"string","description":"The activity month (x-axis of the heatmap)."},"y":{"type":"string","description":"The cohort month (y-axis of the heatmap)."},"action":{"type":"string","description":"The activity type (e.g., Payment, Deposit, Withdrawal)."},"retention_pct":{"type":"number","description":"The user retention percentage."},"value_abs":{"type":"integer","description":"The absolute number of retained users."},"amount_retention_pct":{"type":"number","description":"The amount retention percentage."},"value_usd":{"type":"number","description":"The total USD amount for the cohort in this month."}}}}}}}},"parameters":[{"name":"action","in":"query","required":false,"description":"Action type","schema":{"type":"string"}}]}},"/v1/execution/gpay_retention_by_action_users/monthly":{"get":{"tags":["Execution"],"summary":"Gpay Retention By Action Users (monthly)","description":"**Required Access:** `tier1`\n\nMonthly cohort user counts over time by action type, formatted for time series visualization.\n\n**Declared Filters:**\n- **action**: = on `action` (Action type)\n\n**Columns:**\n- **action** (`String`): The activity type (e.g., Payment, Deposit, Withdrawal).\n- **date** (`Date`): The activity month.\n- **label** (`String`): The cohort month label.\n- **value** (`UInt64`): The number of active users from this cohort.","operationId":"api_execution_gpay_retention_by_action_users_monthly_get_v1_execution_gpay_retention_by_action_users_monthly_get","security":[{"APIKeyHeader":[]}],"responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"action":{"type":"string","description":"The activity type (e.g., Payment, Deposit, Withdrawal)."},"date":{"type":"string","format":"date","description":"The activity month."},"label":{"type":"string","description":"The cohort month label."},"value":{"type":"integer","description":"The number of active users from this cohort."}}}}}}}},"parameters":[{"name":"action","in":"query","required":false,"description":"Action type","schema":{"type":"string"}}]}},"/v1/execution/gpay_retention_pct/monthly":{"get":{"tags":["Execution"],"summary":"Gpay Retention Pct (monthly)","description":"**Required Access:** `tier1`\n\nMonthly cohort retention heatmap data for all Gnosis Pay activity.\n\n**Columns:**\n- **x** (`String`): The activity month (x-axis of the heatmap).\n- **y** (`String`): The cohort month (y-axis of the heatmap).\n- **retention_pct** (`Float64`): The user retention percentage.\n- **value_abs** (`UInt64`): The absolute number of retained users.\n- **amount_retention_pct** (`Float64`): The amount retention percentage.\n- **value_usd** (`Float64`): The total USD amount for the cohort in this month.","operationId":"api_execution_gpay_retention_pct_monthly_get_v1_execution_gpay_retention_pct_monthly_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"x":{"type":"string","description":"The activity month (x-axis of the heatmap)."},"y":{"type":"string","description":"The cohort month (y-axis of the heatmap)."},"retention_pct":{"type":"number","description":"The user retention percentage."},"value_abs":{"type":"integer","description":"The absolute number of retained users."},"amount_retention_pct":{"type":"number","description":"The amount retention percentage."},"value_usd":{"type":"number","description":"The total USD amount for the cohort in this month."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/gpay_retention_volume/monthly":{"get":{"tags":["Execution"],"summary":"Gpay Retention Volume (monthly)","description":"**Required Access:** `tier1`\n\nMonthly cohort volume retention over time, formatted for time series visualization.\n\n**Columns:**\n- **date** (`Date`): The activity month.\n- **label** (`String`): The cohort month label.\n- **value** (`Float64`): The total USD volume for this cohort in this month.","operationId":"api_execution_gpay_retention_volume_monthly_get_v1_execution_gpay_retention_volume_monthly_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"date":{"type":"string","format":"date","description":"The activity month."},"label":{"type":"string","description":"The cohort month label."},"value":{"type":"number","description":"The total USD volume for this cohort in this month."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/gpay_total_accounts/all_time":{"get":{"tags":["Execution"],"summary":"Gpay Total Accounts (all_time)","description":"**Required Access:** `tier0` (no API key required)\n\nAll-time total count of deployed Gnosis Pay accounts (Safes that enabled a Gnosis Pay Zodiac module - Delay / Roles / Spender), including accounts that never made a payment. Migrated Safes from the June 2026 migration are collapsed to a single account. This is the true \"accounts deployed\" figure, versus api_execution_gpay_total_funded which counts only wallets that made a first payment.\n\n**Columns:**\n- **value** (`Float64`): The total number of deployed Gnosis Pay accounts.\n- **as_of_date** (`Date`): Date the snapshot is computed as of (max date in the underlying data).","operationId":"api_execution_gpay_total_accounts_get_v1_execution_gpay_total_accounts_all_time_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"value":{"type":"number","description":"The total number of deployed Gnosis Pay accounts."},"as_of_date":{"type":"string","format":"date","description":"Date the snapshot is computed as of (max date in the underlying data)."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/gpay_total_balance/all_time":{"get":{"tags":["Execution"],"summary":"Gpay Total Balance (all_time)","description":"**Required Access:** `tier0` (no API key required)\n\nCurrent total balance across all Gnosis Pay wallets in USD.\n\n**Columns:**\n- **value** (`Float64`): The total balance in USD.\n- **as_of_date** (`Date`): Date the snapshot is computed as of (max date in the underlying data).","operationId":"api_execution_gpay_total_balance_get_v1_execution_gpay_total_balance_all_time_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"value":{"type":"number","description":"The total balance in USD."},"as_of_date":{"type":"string","format":"date","description":"Date the snapshot is computed as of (max date in the underlying data)."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/gpay_total_funded/all_time":{"get":{"tags":["Execution"],"summary":"Gpay Total Funded (all_time)","description":"**Required Access:** `tier0` (no API key required)\n\nAll-time total count of funded Gnosis Pay wallets (users who made at least one payment).\n\n**Columns:**\n- **value** (`Float64`): The total number of funded wallets.\n- **as_of_date** (`Date`): Date the snapshot is computed as of (max date in the underlying data).","operationId":"api_execution_gpay_total_funded_get_v1_execution_gpay_total_funded_all_time_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"value":{"type":"number","description":"The total number of funded wallets."},"as_of_date":{"type":"string","format":"date","description":"Date the snapshot is computed as of (max date in the underlying data)."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/gpay_total_payments/all_time":{"get":{"tags":["Execution"],"summary":"Gpay Total Payments (all_time)","description":"**Required Access:** `tier0` (no API key required)\n\nAll-time total count of Gnosis Pay payments.\n\n**Columns:**\n- **value** (`Float64`): The total number of payments.\n- **as_of_date** (`Date`): Date the snapshot is computed as of (max date in the underlying data).","operationId":"api_execution_gpay_total_payments_get_v1_execution_gpay_total_payments_all_time_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"value":{"type":"number","description":"The total number of payments."},"as_of_date":{"type":"string","format":"date","description":"Date the snapshot is computed as of (max date in the underlying data)."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/gpay_total_volume/all_time":{"get":{"tags":["Execution"],"summary":"Gpay Total Volume (all_time)","description":"**Required Access:** `tier0` (no API key required)\n\nAll-time total payment volume for Gnosis Pay in USD.\n\n**Columns:**\n- **value** (`Float64`): The total payment volume in USD.\n- **as_of_date** (`Date`): Date the snapshot is computed as of (max date in the underlying data).","operationId":"api_execution_gpay_total_volume_get_v1_execution_gpay_total_volume_all_time_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"value":{"type":"number","description":"The total payment volume in USD."},"as_of_date":{"type":"string","format":"date","description":"Date the snapshot is computed as of (max date in the underlying data)."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/gpay_user_activity/latest":{"get":{"tags":["Execution"],"summary":"Gpay User Activity (latest)","description":"**Required Access:** `tier0` (no API key required)\n\nIndividual transaction-level activity for a specific Gnosis Pay user, filtered by wallet address.\n\n**Declared Filters:**\n- **wallet_address**: IN on `wallet_address` (Wallet address(es))\n- **action**: = on `action` (Action type (Payment, Cashback, Fiat Top Up, etc.))\n- **symbol**: = on `symbol` (Token symbol)\n- **start_date**: >= on `date` (Inclusive start date)\n- **end_date**: <= on `date` (Inclusive end date)\n\n**Pagination:**\n- **limit**: default `100`, max `5000`\n- **offset**: default `0`\n\n**Sort:**\n- `date DESC`\n\n**Columns:**\n- **transaction_hash** (`String`): The unique hash identifier for the transaction.\n- **wallet_address** (`String`): The Gnosis Pay wallet address.\n- **timestamp** (`DateTime64(0, 'UTC')`): The UTC timestamp of the transaction.\n- **date** (`Date`): The calendar date of the transaction.\n- **action** (`String`): The activity type (e.g., Payment, Deposit, Withdrawal, Cashback).\n- **symbol** (`String`): The token symbol involved in the transaction.\n- **direction** (`String`): The direction of the transaction (e.g., inbound, outbound).\n- **amount** (`Float64`): The decimal-adjusted token amount.\n- **amount_usd** (`Float64`): The USD-equivalent value of the transaction.\n- **counterparty** (`String`): The counterparty address in the transaction.","operationId":"api_execution_gpay_user_activity_get_v1_execution_gpay_user_activity_latest_get","security":[{"APIKeyHeader":[]}],"responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"transaction_hash":{"type":"string","description":"The unique hash identifier for the transaction."},"wallet_address":{"type":"string","description":"The Gnosis Pay wallet address."},"timestamp":{"type":"string","format":"date-time","description":"The UTC timestamp of the transaction."},"date":{"type":"string","format":"date","description":"The calendar date of the transaction."},"action":{"type":"string","description":"The activity type (e.g., Payment, Deposit, Withdrawal, Cashback)."},"symbol":{"type":"string","description":"The token symbol involved in the transaction."},"direction":{"type":"string","description":"The direction of the transaction (e.g., inbound, outbound)."},"amount":{"type":"number","description":"The decimal-adjusted token amount."},"amount_usd":{"type":"number","description":"The USD-equivalent value of the transaction."},"counterparty":{"type":"string","description":"The counterparty address in the transaction."}}}}}}}},"parameters":[{"name":"wallet_address","in":"query","required":false,"description":"Wallet address(es). Accepts repeated query params or CSV.","style":"form","explode":true,"schema":{"type":"array","items":{"type":"string"},"maxItems":20}},{"name":"action","in":"query","required":false,"description":"Action type (Payment, Cashback, Fiat Top Up, etc.)","schema":{"type":"string"}},{"name":"symbol","in":"query","required":false,"description":"Token symbol","schema":{"type":"string"}},{"name":"start_date","in":"query","required":false,"description":"Inclusive start date","schema":{"type":"string","format":"date"}},{"name":"end_date","in":"query","required":false,"description":"Inclusive end date","schema":{"type":"string","format":"date"}},{"name":"limit","in":"query","required":false,"description":"Row limit","schema":{"type":"integer","minimum":1,"maximum":5000,"default":100}},{"name":"offset","in":"query","required":false,"description":"Row offset","schema":{"type":"integer","minimum":0,"default":0}}]},"post":{"tags":["Execution"],"summary":"Gpay User Activity (latest) (POST)","description":"**Required Access:** `tier0` (no API key required)\n\nIndividual transaction-level activity for a specific Gnosis Pay user, filtered by wallet address.\n\n**Declared Filters:**\n- **wallet_address**: IN on `wallet_address` (Wallet address(es))\n- **action**: = on `action` (Action type (Payment, Cashback, Fiat Top Up, etc.))\n- **symbol**: = on `symbol` (Token symbol)\n- **start_date**: >= on `date` (Inclusive start date)\n- **end_date**: <= on `date` (Inclusive end date)\n\n**Pagination:**\n- **limit**: default `100`, max `5000`\n- **offset**: default `0`\n\n**Sort:**\n- `date DESC`\n\n**Columns:**\n- **transaction_hash** (`String`): The unique hash identifier for the transaction.\n- **wallet_address** (`String`): The Gnosis Pay wallet address.\n- **timestamp** (`DateTime64(0, 'UTC')`): The UTC timestamp of the transaction.\n- **date** (`Date`): The calendar date of the transaction.\n- **action** (`String`): The activity type (e.g., Payment, Deposit, Withdrawal, Cashback).\n- **symbol** (`String`): The token symbol involved in the transaction.\n- **direction** (`String`): The direction of the transaction (e.g., inbound, outbound).\n- **amount** (`Float64`): The decimal-adjusted token amount.\n- **amount_usd** (`Float64`): The USD-equivalent value of the transaction.\n- **counterparty** (`String`): The counterparty address in the transaction.","operationId":"api_execution_gpay_user_activity_post_v1_execution_gpay_user_activity_latest_post","security":[{"APIKeyHeader":[]}],"requestBody":{"content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/api_execution_gpay_user_activity_PostBody"},{"type":"null"}],"title":" Body"}}}},"responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"transaction_hash":{"type":"string","description":"The unique hash identifier for the transaction."},"wallet_address":{"type":"string","description":"The Gnosis Pay wallet address."},"timestamp":{"type":"string","format":"date-time","description":"The UTC timestamp of the transaction."},"date":{"type":"string","format":"date","description":"The calendar date of the transaction."},"action":{"type":"string","description":"The activity type (e.g., Payment, Deposit, Withdrawal, Cashback)."},"symbol":{"type":"string","description":"The token symbol involved in the transaction."},"direction":{"type":"string","description":"The direction of the transaction (e.g., inbound, outbound)."},"amount":{"type":"number","description":"The decimal-adjusted token amount."},"amount_usd":{"type":"number","description":"The USD-equivalent value of the transaction."},"counterparty":{"type":"string","description":"The counterparty address in the transaction."}}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/execution/gpay_user_balances/latest":{"get":{"tags":["Execution"],"summary":"Gpay User Balances (latest)","description":"**Required Access:** `tier0` (no API key required)\n\nSimple API view over latest Gnosis Pay wallet balances.\n\n**Declared Filters:**\n- **wallet_address**: IN on `wallet_address`\n- **token**: = on `token`\n\n**Pagination:**\n- **limit**: default `100`, max `5000`\n- **offset**: default `0`\n\n**Sort:**\n- `value_usd DESC`\n\n**Columns:**\n- **value_usd** (`Float64`): Total USD value of the wallet's holdings of the token at the latest snapshot date.\n- **wallet_address** (`Nullable(String)`): The Gnosis Pay Safe wallet address holding the balance.\n- **token** (`String`): The token symbol for the balance.\n- **as_of_date** (`Date`): Date the snapshot is computed as of (max date in the underlying data).","operationId":"api_execution_gpay_user_balances_latest_get_v1_execution_gpay_user_balances_latest_get","security":[{"APIKeyHeader":[]}],"responses":{"200":{"description":"Paginated response","content":{"application/json":{"schema":{"type":"object","required":["items","pagination"],"properties":{"items":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"value_usd":{"type":"number","description":"Total USD value of the wallet's holdings of the token at the latest snapshot date."},"wallet_address":{"type":"string","description":"The Gnosis Pay Safe wallet address holding the balance."},"token":{"type":"string","description":"The token symbol for the balance."},"as_of_date":{"type":"string","format":"date","description":"Date the snapshot is computed as of (max date in the underlying data)."}}}},"pagination":{"type":"object","required":["limit","offset","returned","has_more"],"properties":{"limit":{"type":"integer","minimum":1},"offset":{"type":"integer","minimum":0},"returned":{"type":"integer","minimum":0},"has_more":{"type":"boolean"}}}}}}}}},"parameters":[{"name":"wallet_address","in":"query","required":false,"description":"List filter. Accepts repeated query params or CSV.","style":"form","explode":true,"schema":{"type":"array","items":{"type":"string"},"maxItems":20}},{"name":"token","in":"query","required":false,"description":"","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"Row limit","schema":{"type":"integer","minimum":1,"maximum":5000,"default":100}},{"name":"offset","in":"query","required":false,"description":"Row offset","schema":{"type":"integer","minimum":0,"default":0}}]},"post":{"tags":["Execution"],"summary":"Gpay User Balances (latest) (POST)","description":"**Required Access:** `tier0` (no API key required)\n\nSimple API view over latest Gnosis Pay wallet balances.\n\n**Declared Filters:**\n- **wallet_address**: IN on `wallet_address`\n- **token**: = on `token`\n\n**Pagination:**\n- **limit**: default `100`, max `5000`\n- **offset**: default `0`\n\n**Sort:**\n- `value_usd DESC`\n\n**Columns:**\n- **value_usd** (`Float64`): Total USD value of the wallet's holdings of the token at the latest snapshot date.\n- **wallet_address** (`Nullable(String)`): The Gnosis Pay Safe wallet address holding the balance.\n- **token** (`String`): The token symbol for the balance.\n- **as_of_date** (`Date`): Date the snapshot is computed as of (max date in the underlying data).","operationId":"api_execution_gpay_user_balances_latest_post_v1_execution_gpay_user_balances_latest_post","security":[{"APIKeyHeader":[]}],"requestBody":{"content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/api_execution_gpay_user_balances_latest_PostBody"},{"type":"null"}],"title":" Body"}}}},"responses":{"200":{"description":"Paginated response","content":{"application/json":{"schema":{"type":"object","required":["items","pagination"],"properties":{"items":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"value_usd":{"type":"number","description":"Total USD value of the wallet's holdings of the token at the latest snapshot date."},"wallet_address":{"type":"string","description":"The Gnosis Pay Safe wallet address holding the balance."},"token":{"type":"string","description":"The token symbol for the balance."},"as_of_date":{"type":"string","format":"date","description":"Date the snapshot is computed as of (max date in the underlying data)."}}}},"pagination":{"type":"object","required":["limit","offset","returned","has_more"],"properties":{"limit":{"type":"integer","minimum":1},"offset":{"type":"integer","minimum":0},"returned":{"type":"integer","minimum":0},"has_more":{"type":"boolean"}}}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/execution/gpay_user_balances/daily":{"get":{"tags":["Execution"],"summary":"Gpay User Balances (daily)","description":"**Required Access:** `tier0` (no API key required)\n\nDaily token balances for a specific Gnosis Pay user in native and USD values.\n\n**Declared Filters:**\n- **wallet_address**: IN on `wallet_address` (Wallet address(es))\n- **token**: = on `token` (Token symbol)\n- **start_date**: >= on `date` (Inclusive start date)\n- **end_date**: <= on `date` (Inclusive end date)\n\n**Pagination:**\n- **limit**: default `100`, max `5000`\n- **offset**: default `0`\n\n**Sort:**\n- `date DESC`\n\n**Columns:**\n- **wallet_address** (`String`): The Gnosis Pay wallet address.\n- **date** (`Date`): The calendar date of the balance snapshot.\n- **label** (`String`): The token symbol.\n- **token** (`String`): The token contract address.\n- **value_native** (`Float64`): The token balance in native units.\n- **value_usd** (`Float64`): The token balance in USD.","operationId":"api_execution_gpay_user_balances_daily_get_v1_execution_gpay_user_balances_daily_get","security":[{"APIKeyHeader":[]}],"responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"wallet_address":{"type":"string","description":"The Gnosis Pay wallet address."},"date":{"type":"string","format":"date","description":"The calendar date of the balance snapshot."},"label":{"type":"string","description":"The token symbol."},"token":{"type":"string","description":"The token contract address."},"value_native":{"type":"number","description":"The token balance in native units."},"value_usd":{"type":"number","description":"The token balance in USD."}}}}}}}},"parameters":[{"name":"wallet_address","in":"query","required":false,"description":"Wallet address(es). Accepts repeated query params or CSV.","style":"form","explode":true,"schema":{"type":"array","items":{"type":"string"},"maxItems":20}},{"name":"token","in":"query","required":false,"description":"Token symbol","schema":{"type":"string"}},{"name":"start_date","in":"query","required":false,"description":"Inclusive start date","schema":{"type":"string","format":"date"}},{"name":"end_date","in":"query","required":false,"description":"Inclusive end date","schema":{"type":"string","format":"date"}},{"name":"limit","in":"query","required":false,"description":"Row limit","schema":{"type":"integer","minimum":1,"maximum":5000,"default":100}},{"name":"offset","in":"query","required":false,"description":"Row offset","schema":{"type":"integer","minimum":0,"default":0}}]},"post":{"tags":["Execution"],"summary":"Gpay User Balances (daily) (POST)","description":"**Required Access:** `tier0` (no API key required)\n\nDaily token balances for a specific Gnosis Pay user in native and USD values.\n\n**Declared Filters:**\n- **wallet_address**: IN on `wallet_address` (Wallet address(es))\n- **token**: = on `token` (Token symbol)\n- **start_date**: >= on `date` (Inclusive start date)\n- **end_date**: <= on `date` (Inclusive end date)\n\n**Pagination:**\n- **limit**: default `100`, max `5000`\n- **offset**: default `0`\n\n**Sort:**\n- `date DESC`\n\n**Columns:**\n- **wallet_address** (`String`): The Gnosis Pay wallet address.\n- **date** (`Date`): The calendar date of the balance snapshot.\n- **label** (`String`): The token symbol.\n- **token** (`String`): The token contract address.\n- **value_native** (`Float64`): The token balance in native units.\n- **value_usd** (`Float64`): The token balance in USD.","operationId":"api_execution_gpay_user_balances_daily_post_v1_execution_gpay_user_balances_daily_post","security":[{"APIKeyHeader":[]}],"requestBody":{"content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/api_execution_gpay_user_balances_daily_PostBody"},{"type":"null"}],"title":" Body"}}}},"responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"wallet_address":{"type":"string","description":"The Gnosis Pay wallet address."},"date":{"type":"string","format":"date","description":"The calendar date of the balance snapshot."},"label":{"type":"string","description":"The token symbol."},"token":{"type":"string","description":"The token contract address."},"value_native":{"type":"number","description":"The token balance in native units."},"value_usd":{"type":"number","description":"The token balance in USD."}}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/execution/gpay_user_cashback/daily":{"get":{"tags":["Execution"],"summary":"Gpay User Cashback (daily)","description":"**Required Access:** `tier0` (no API key required)\n\nDaily cashback amounts for a specific Gnosis Pay user.\n\n**Declared Filters:**\n- **wallet_address**: IN on `wallet_address` (Wallet address(es))\n- **start_date**: >= on `date` (Inclusive start date)\n- **end_date**: <= on `date` (Inclusive end date)\n\n**Pagination:**\n- **limit**: default `100`, max `5000`\n- **offset**: default `0`\n\n**Sort:**\n- `date DESC`\n\n**Columns:**\n- **wallet_address** (`String`): The Gnosis Pay wallet address.\n- **date** (`Date`): The calendar date.\n- **value** (`Float64`): The cashback amount received on this date.","operationId":"api_execution_gpay_user_cashback_daily_get_v1_execution_gpay_user_cashback_daily_get","security":[{"APIKeyHeader":[]}],"responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"wallet_address":{"type":"string","description":"The Gnosis Pay wallet address."},"date":{"type":"string","format":"date","description":"The calendar date."},"value":{"type":"number","description":"The cashback amount received on this date."}}}}}}}},"parameters":[{"name":"wallet_address","in":"query","required":false,"description":"Wallet address(es). Accepts repeated query params or CSV.","style":"form","explode":true,"schema":{"type":"array","items":{"type":"string"},"maxItems":20}},{"name":"start_date","in":"query","required":false,"description":"Inclusive start date","schema":{"type":"string","format":"date"}},{"name":"end_date","in":"query","required":false,"description":"Inclusive end date","schema":{"type":"string","format":"date"}},{"name":"limit","in":"query","required":false,"description":"Row limit","schema":{"type":"integer","minimum":1,"maximum":5000,"default":100}},{"name":"offset","in":"query","required":false,"description":"Row offset","schema":{"type":"integer","minimum":0,"default":0}}]},"post":{"tags":["Execution"],"summary":"Gpay User Cashback (daily) (POST)","description":"**Required Access:** `tier0` (no API key required)\n\nDaily cashback amounts for a specific Gnosis Pay user.\n\n**Declared Filters:**\n- **wallet_address**: IN on `wallet_address` (Wallet address(es))\n- **start_date**: >= on `date` (Inclusive start date)\n- **end_date**: <= on `date` (Inclusive end date)\n\n**Pagination:**\n- **limit**: default `100`, max `5000`\n- **offset**: default `0`\n\n**Sort:**\n- `date DESC`\n\n**Columns:**\n- **wallet_address** (`String`): The Gnosis Pay wallet address.\n- **date** (`Date`): The calendar date.\n- **value** (`Float64`): The cashback amount received on this date.","operationId":"api_execution_gpay_user_cashback_daily_post_v1_execution_gpay_user_cashback_daily_post","security":[{"APIKeyHeader":[]}],"requestBody":{"content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/api_execution_gpay_user_cashback_daily_PostBody"},{"type":"null"}],"title":" Body"}}}},"responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"wallet_address":{"type":"string","description":"The Gnosis Pay wallet address."},"date":{"type":"string","format":"date","description":"The calendar date."},"value":{"type":"number","description":"The cashback amount received on this date."}}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/execution/gpay_user_lifetime_metrics/all_time":{"get":{"tags":["Execution"],"summary":"Gpay User Lifetime Metrics (all_time)","description":"**Required Access:** `tier0` (no API key required)\n\nLifetime metrics for a specific Gnosis Pay user, passing through all columns from the fact model.\n\n**Declared Filters:**\n- **wallet_address**: IN on `wallet_address` (Wallet address(es))\n\n**Columns:**\n- **wallet_address** (`String`): The Gnosis Pay wallet address.\n- **first_activity_date** (`Date`): The date of the wallet's first recorded activity.\n- **last_activity_date** (`Date`): The date of the wallet's most recent activity.\n- **tenure_days** (`UInt64`): The number of days between first and last activity.\n- **active_months** (`UInt64`): The number of distinct months the wallet was active.\n- **total_payment_volume_usd** (`Float64`): Lifetime total payment volume in USD.\n- **total_payment_count** (`UInt64`): Lifetime total number of payments.\n- **total_deposit_volume_usd** (`Float64`): Lifetime total deposit volume in USD.\n- **total_withdrawal_volume_usd** (`Float64`): Lifetime total withdrawal volume in USD.\n- **net_flow_usd** (`Float64`): Lifetime net flow (deposits minus withdrawals) in USD.\n- **total_cashback_usd** (`Float64`): Lifetime total cashback received in USD.\n- **total_cashback_gno** (`Float64`): Lifetime total cashback received in GNO tokens.\n- **total_refund_usd** (`Float64`): Lifetime total refund value in USD.\n- **total_refund_count** (`UInt64`): Lifetime total number of refunds.\n- **avg_monthly_payment_volume_usd** (`Float64`): Average monthly payment volume in USD across active months.\n- **as_of_date** (`Date`): Date the snapshot is computed as of (max date in the underlying data).","operationId":"api_execution_gpay_user_lifetime_metrics_get_v1_execution_gpay_user_lifetime_metrics_all_time_get","security":[{"APIKeyHeader":[]}],"responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"wallet_address":{"type":"string","description":"The Gnosis Pay wallet address."},"first_activity_date":{"type":"string","format":"date","description":"The date of the wallet's first recorded activity."},"last_activity_date":{"type":"string","format":"date","description":"The date of the wallet's most recent activity."},"tenure_days":{"type":"integer","description":"The number of days between first and last activity."},"active_months":{"type":"integer","description":"The number of distinct months the wallet was active."},"total_payment_volume_usd":{"type":"number","description":"Lifetime total payment volume in USD."},"total_payment_count":{"type":"integer","description":"Lifetime total number of payments."},"total_deposit_volume_usd":{"type":"number","description":"Lifetime total deposit volume in USD."},"total_withdrawal_volume_usd":{"type":"number","description":"Lifetime total withdrawal volume in USD."},"net_flow_usd":{"type":"number","description":"Lifetime net flow (deposits minus withdrawals) in USD."},"total_cashback_usd":{"type":"number","description":"Lifetime total cashback received in USD."},"total_cashback_gno":{"type":"number","description":"Lifetime total cashback received in GNO tokens."},"total_refund_usd":{"type":"number","description":"Lifetime total refund value in USD."},"total_refund_count":{"type":"integer","description":"Lifetime total number of refunds."},"avg_monthly_payment_volume_usd":{"type":"number","description":"Average monthly payment volume in USD across active months."},"as_of_date":{"type":"string","format":"date","description":"Date the snapshot is computed as of (max date in the underlying data)."}}}}}}}},"parameters":[{"name":"wallet_address","in":"query","required":false,"description":"Wallet address(es). Accepts repeated query params or CSV.","style":"form","explode":true,"schema":{"type":"array","items":{"type":"string"},"maxItems":50}}]},"post":{"tags":["Execution"],"summary":"Gpay User Lifetime Metrics (all_time) (POST)","description":"**Required Access:** `tier0` (no API key required)\n\nLifetime metrics for a specific Gnosis Pay user, passing through all columns from the fact model.\n\n**Declared Filters:**\n- **wallet_address**: IN on `wallet_address` (Wallet address(es))\n\n**Columns:**\n- **wallet_address** (`String`): The Gnosis Pay wallet address.\n- **first_activity_date** (`Date`): The date of the wallet's first recorded activity.\n- **last_activity_date** (`Date`): The date of the wallet's most recent activity.\n- **tenure_days** (`UInt64`): The number of days between first and last activity.\n- **active_months** (`UInt64`): The number of distinct months the wallet was active.\n- **total_payment_volume_usd** (`Float64`): Lifetime total payment volume in USD.\n- **total_payment_count** (`UInt64`): Lifetime total number of payments.\n- **total_deposit_volume_usd** (`Float64`): Lifetime total deposit volume in USD.\n- **total_withdrawal_volume_usd** (`Float64`): Lifetime total withdrawal volume in USD.\n- **net_flow_usd** (`Float64`): Lifetime net flow (deposits minus withdrawals) in USD.\n- **total_cashback_usd** (`Float64`): Lifetime total cashback received in USD.\n- **total_cashback_gno** (`Float64`): Lifetime total cashback received in GNO tokens.\n- **total_refund_usd** (`Float64`): Lifetime total refund value in USD.\n- **total_refund_count** (`UInt64`): Lifetime total number of refunds.\n- **avg_monthly_payment_volume_usd** (`Float64`): Average monthly payment volume in USD across active months.\n- **as_of_date** (`Date`): Date the snapshot is computed as of (max date in the underlying data).","operationId":"api_execution_gpay_user_lifetime_metrics_post_v1_execution_gpay_user_lifetime_metrics_all_time_post","security":[{"APIKeyHeader":[]}],"requestBody":{"content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/api_execution_gpay_user_lifetime_metrics_PostBody"},{"type":"null"}],"title":" Body"}}}},"responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"wallet_address":{"type":"string","description":"The Gnosis Pay wallet address."},"first_activity_date":{"type":"string","format":"date","description":"The date of the wallet's first recorded activity."},"last_activity_date":{"type":"string","format":"date","description":"The date of the wallet's most recent activity."},"tenure_days":{"type":"integer","description":"The number of days between first and last activity."},"active_months":{"type":"integer","description":"The number of distinct months the wallet was active."},"total_payment_volume_usd":{"type":"number","description":"Lifetime total payment volume in USD."},"total_payment_count":{"type":"integer","description":"Lifetime total number of payments."},"total_deposit_volume_usd":{"type":"number","description":"Lifetime total deposit volume in USD."},"total_withdrawal_volume_usd":{"type":"number","description":"Lifetime total withdrawal volume in USD."},"net_flow_usd":{"type":"number","description":"Lifetime net flow (deposits minus withdrawals) in USD."},"total_cashback_usd":{"type":"number","description":"Lifetime total cashback received in USD."},"total_cashback_gno":{"type":"number","description":"Lifetime total cashback received in GNO tokens."},"total_refund_usd":{"type":"number","description":"Lifetime total refund value in USD."},"total_refund_count":{"type":"integer","description":"Lifetime total number of refunds."},"avg_monthly_payment_volume_usd":{"type":"number","description":"Average monthly payment volume in USD across active months."},"as_of_date":{"type":"string","format":"date","description":"Date the snapshot is computed as of (max date in the underlying data)."}}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/execution/gpay_user_payments/daily":{"get":{"tags":["Execution"],"summary":"Gpay User Payments (daily)","description":"**Required Access:** `tier0` (no API key required)\n\nDaily payment amounts by token for a specific Gnosis Pay user.\n\n**Declared Filters:**\n- **wallet_address**: IN on `wallet_address` (Wallet address(es))\n- **token**: = on `label` (Token symbol)\n- **start_date**: >= on `date` (Inclusive start date)\n- **end_date**: <= on `date` (Inclusive end date)\n\n**Pagination:**\n- **limit**: default `100`, max `5000`\n- **offset**: default `0`\n\n**Sort:**\n- `date DESC`\n\n**Columns:**\n- **wallet_address** (`String`): The Gnosis Pay wallet address.\n- **date** (`Date`): The calendar date.\n- **label** (`String`): The token symbol.\n- **value** (`Float64`): The payment amount in USD on this date.","operationId":"api_execution_gpay_user_payments_daily_get_v1_execution_gpay_user_payments_daily_get","security":[{"APIKeyHeader":[]}],"responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"wallet_address":{"type":"string","description":"The Gnosis Pay wallet address."},"date":{"type":"string","format":"date","description":"The calendar date."},"label":{"type":"string","description":"The token symbol."},"value":{"type":"number","description":"The payment amount in USD on this date."}}}}}}}},"parameters":[{"name":"wallet_address","in":"query","required":false,"description":"Wallet address(es). Accepts repeated query params or CSV.","style":"form","explode":true,"schema":{"type":"array","items":{"type":"string"},"maxItems":20}},{"name":"token","in":"query","required":false,"description":"Token symbol","schema":{"type":"string"}},{"name":"start_date","in":"query","required":false,"description":"Inclusive start date","schema":{"type":"string","format":"date"}},{"name":"end_date","in":"query","required":false,"description":"Inclusive end date","schema":{"type":"string","format":"date"}},{"name":"limit","in":"query","required":false,"description":"Row limit","schema":{"type":"integer","minimum":1,"maximum":5000,"default":100}},{"name":"offset","in":"query","required":false,"description":"Row offset","schema":{"type":"integer","minimum":0,"default":0}}]},"post":{"tags":["Execution"],"summary":"Gpay User Payments (daily) (POST)","description":"**Required Access:** `tier0` (no API key required)\n\nDaily payment amounts by token for a specific Gnosis Pay user.\n\n**Declared Filters:**\n- **wallet_address**: IN on `wallet_address` (Wallet address(es))\n- **token**: = on `label` (Token symbol)\n- **start_date**: >= on `date` (Inclusive start date)\n- **end_date**: <= on `date` (Inclusive end date)\n\n**Pagination:**\n- **limit**: default `100`, max `5000`\n- **offset**: default `0`\n\n**Sort:**\n- `date DESC`\n\n**Columns:**\n- **wallet_address** (`String`): The Gnosis Pay wallet address.\n- **date** (`Date`): The calendar date.\n- **label** (`String`): The token symbol.\n- **value** (`Float64`): The payment amount in USD on this date.","operationId":"api_execution_gpay_user_payments_daily_post_v1_execution_gpay_user_payments_daily_post","security":[{"APIKeyHeader":[]}],"requestBody":{"content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/api_execution_gpay_user_payments_daily_PostBody"},{"type":"null"}],"title":" Body"}}}},"responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"wallet_address":{"type":"string","description":"The Gnosis Pay wallet address."},"date":{"type":"string","format":"date","description":"The calendar date."},"label":{"type":"string","description":"The token symbol."},"value":{"type":"number","description":"The payment amount in USD on this date."}}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/execution/gpay_user_top_wallets/snapshot":{"get":{"tags":["Execution"],"summary":"Gpay User Top Wallets (snapshot)","description":"**Required Access:** `tier1`\n\nAPI view of the top 50 Gnosis Pay wallets by lifetime payment volume. One row per wallet_address, selected from fct_execution_gpay_user_lifetime_metrics where total_payment_count > 0 and ordered by total_payment_volume_usd then tenure_days descending. Adds as_of_date (max date in int_execution_gpay_activity_daily). Tier1 endpoint (api:gpay_user_top_wallets, granularity:snapshot).\n\n\n**Columns:**\n- **wallet_address** (`String`): The Gnosis Pay wallet address, one of the top 50 by lifetime payment volume.\n- **as_of_date** (`Date`): Date the snapshot is computed as of (max date in int_execution_gpay_activity_daily).","operationId":"api_execution_gpay_user_top_wallets_get_v1_execution_gpay_user_top_wallets_snapshot_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"wallet_address":{"type":"string","description":"The Gnosis Pay wallet address, one of the top 50 by lifetime payment volume."},"as_of_date":{"type":"string","format":"date","description":"Date the snapshot is computed as of (max date in int_execution_gpay_activity_daily)."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/gpay_user_total_cashback/all_time":{"get":{"tags":["Execution"],"summary":"Gpay User Total Cashback (all_time)","description":"**Required Access:** `tier0` (no API key required)\n\nAll-time total cashback for a specific Gnosis Pay user.\n\n**Declared Filters:**\n- **wallet_address**: IN on `wallet_address` (Wallet address(es))\n\n**Columns:**\n- **wallet_address** (`String`): The Gnosis Pay wallet address.\n- **value** (`Float64`): The total cashback amount in USD.\n- **as_of_date** (`Date`): Date the snapshot is computed as of (max date in the underlying data).","operationId":"api_execution_gpay_user_total_cashback_get_v1_execution_gpay_user_total_cashback_all_time_get","security":[{"APIKeyHeader":[]}],"responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"wallet_address":{"type":"string","description":"The Gnosis Pay wallet address."},"value":{"type":"number","description":"The total cashback amount in USD."},"as_of_date":{"type":"string","format":"date","description":"Date the snapshot is computed as of (max date in the underlying data)."}}}}}}}},"parameters":[{"name":"wallet_address","in":"query","required":false,"description":"Wallet address(es). Accepts repeated query params or CSV.","style":"form","explode":true,"schema":{"type":"array","items":{"type":"string"},"maxItems":50}}]},"post":{"tags":["Execution"],"summary":"Gpay User Total Cashback (all_time) (POST)","description":"**Required Access:** `tier0` (no API key required)\n\nAll-time total cashback for a specific Gnosis Pay user.\n\n**Declared Filters:**\n- **wallet_address**: IN on `wallet_address` (Wallet address(es))\n\n**Columns:**\n- **wallet_address** (`String`): The Gnosis Pay wallet address.\n- **value** (`Float64`): The total cashback amount in USD.\n- **as_of_date** (`Date`): Date the snapshot is computed as of (max date in the underlying data).","operationId":"api_execution_gpay_user_total_cashback_post_v1_execution_gpay_user_total_cashback_all_time_post","security":[{"APIKeyHeader":[]}],"requestBody":{"content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/api_execution_gpay_user_total_cashback_PostBody"},{"type":"null"}],"title":" Body"}}}},"responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"wallet_address":{"type":"string","description":"The Gnosis Pay wallet address."},"value":{"type":"number","description":"The total cashback amount in USD."},"as_of_date":{"type":"string","format":"date","description":"Date the snapshot is computed as of (max date in the underlying data)."}}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/execution/gpay_user_total_payments/all_time":{"get":{"tags":["Execution"],"summary":"Gpay User Total Payments (all_time)","description":"**Required Access:** `tier0` (no API key required)\n\nAll-time total payment count for a specific Gnosis Pay user.\n\n**Declared Filters:**\n- **wallet_address**: IN on `wallet_address` (Wallet address(es))\n\n**Columns:**\n- **wallet_address** (`String`): The Gnosis Pay wallet address.\n- **value** (`UInt64`): The total number of payments.\n- **as_of_date** (`Date`): Date the snapshot is computed as of (max date in the underlying data).","operationId":"api_execution_gpay_user_total_payments_get_v1_execution_gpay_user_total_payments_all_time_get","security":[{"APIKeyHeader":[]}],"responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"wallet_address":{"type":"string","description":"The Gnosis Pay wallet address."},"value":{"type":"integer","description":"The total number of payments."},"as_of_date":{"type":"string","format":"date","description":"Date the snapshot is computed as of (max date in the underlying data)."}}}}}}}},"parameters":[{"name":"wallet_address","in":"query","required":false,"description":"Wallet address(es). Accepts repeated query params or CSV.","style":"form","explode":true,"schema":{"type":"array","items":{"type":"string"},"maxItems":50}}]},"post":{"tags":["Execution"],"summary":"Gpay User Total Payments (all_time) (POST)","description":"**Required Access:** `tier0` (no API key required)\n\nAll-time total payment count for a specific Gnosis Pay user.\n\n**Declared Filters:**\n- **wallet_address**: IN on `wallet_address` (Wallet address(es))\n\n**Columns:**\n- **wallet_address** (`String`): The Gnosis Pay wallet address.\n- **value** (`UInt64`): The total number of payments.\n- **as_of_date** (`Date`): Date the snapshot is computed as of (max date in the underlying data).","operationId":"api_execution_gpay_user_total_payments_post_v1_execution_gpay_user_total_payments_all_time_post","security":[{"APIKeyHeader":[]}],"requestBody":{"content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/api_execution_gpay_user_total_payments_PostBody"},{"type":"null"}],"title":" Body"}}}},"responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"wallet_address":{"type":"string","description":"The Gnosis Pay wallet address."},"value":{"type":"integer","description":"The total number of payments."},"as_of_date":{"type":"string","format":"date","description":"Date the snapshot is computed as of (max date in the underlying data)."}}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/execution/gpay_user_total_volume/all_time":{"get":{"tags":["Execution"],"summary":"Gpay User Total Volume (all_time)","description":"**Required Access:** `tier0` (no API key required)\n\nAll-time total payment volume for a specific Gnosis Pay user.\n\n**Declared Filters:**\n- **wallet_address**: IN on `wallet_address` (Wallet address(es))\n\n**Columns:**\n- **wallet_address** (`String`): The Gnosis Pay wallet address.\n- **value** (`Float64`): The total payment volume in USD.\n- **as_of_date** (`Date`): Date the snapshot is computed as of (max date in the underlying data).","operationId":"api_execution_gpay_user_total_volume_get_v1_execution_gpay_user_total_volume_all_time_get","security":[{"APIKeyHeader":[]}],"responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"wallet_address":{"type":"string","description":"The Gnosis Pay wallet address."},"value":{"type":"number","description":"The total payment volume in USD."},"as_of_date":{"type":"string","format":"date","description":"Date the snapshot is computed as of (max date in the underlying data)."}}}}}}}},"parameters":[{"name":"wallet_address","in":"query","required":false,"description":"Wallet address(es). Accepts repeated query params or CSV.","style":"form","explode":true,"schema":{"type":"array","items":{"type":"string"},"maxItems":50}}]},"post":{"tags":["Execution"],"summary":"Gpay User Total Volume (all_time) (POST)","description":"**Required Access:** `tier0` (no API key required)\n\nAll-time total payment volume for a specific Gnosis Pay user.\n\n**Declared Filters:**\n- **wallet_address**: IN on `wallet_address` (Wallet address(es))\n\n**Columns:**\n- **wallet_address** (`String`): The Gnosis Pay wallet address.\n- **value** (`Float64`): The total payment volume in USD.\n- **as_of_date** (`Date`): Date the snapshot is computed as of (max date in the underlying data).","operationId":"api_execution_gpay_user_total_volume_post_v1_execution_gpay_user_total_volume_all_time_post","security":[{"APIKeyHeader":[]}],"requestBody":{"content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/api_execution_gpay_user_total_volume_PostBody"},{"type":"null"}],"title":" Body"}}}},"responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"wallet_address":{"type":"string","description":"The Gnosis Pay wallet address."},"value":{"type":"number","description":"The total payment volume in USD."},"as_of_date":{"type":"string","format":"date","description":"Date the snapshot is computed as of (max date in the underlying data)."}}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/execution/gpay_volume/last_7d":{"get":{"tags":["Execution"],"summary":"Gpay Volume (last_7d)","description":"**Required Access:** `tier0` (no API key required)\n\n7-day payment volume with period-over-period change percentage.\n\n**Columns:**\n- **value** (`Float64`): The total payment volume in USD in the last 7 days.\n- **change_pct** (`Float64`): The percentage change compared to the previous 7-day period.\n- **as_of_date** (`Date`): Date the snapshot is computed as of (max date in the underlying data).","operationId":"api_execution_gpay_volume_7d_get_v1_execution_gpay_volume_last_7d_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"value":{"type":"number","description":"The total payment volume in USD in the last 7 days."},"change_pct":{"type":"number","description":"The percentage change compared to the previous 7-day period."},"as_of_date":{"type":"string","format":"date","description":"Date the snapshot is computed as of (max date in the underlying data)."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/gpay_volume_payments_by_token/daily":{"get":{"tags":["Execution"],"summary":"Gpay Volume Payments By Token (daily)","description":"**Required Access:** `tier1`\n\nDaily payment volume by token in USD for Gnosis Pay.\n\n**Declared Filters:**\n- **token**: = on `label` (Token symbol)\n- **start_date**: >= on `date` (Inclusive start date)\n- **end_date**: <= on `date` (Inclusive end date)\n\n**Sort:**\n- `date DESC`\n\n**Columns:**\n- **date** (`Date`): The calendar date.\n- **label** (`String`): The token symbol.\n- **value** (`Float64`): The payment volume in USD for this token on this date.","operationId":"api_execution_gpay_volume_payments_by_token_daily_get_v1_execution_gpay_volume_payments_by_token_daily_get","security":[{"APIKeyHeader":[]}],"responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"date":{"type":"string","format":"date","description":"The calendar date."},"label":{"type":"string","description":"The token symbol."},"value":{"type":"number","description":"The payment volume in USD for this token on this date."}}}}}}}},"parameters":[{"name":"token","in":"query","required":false,"description":"Token symbol","schema":{"type":"string"}},{"name":"start_date","in":"query","required":false,"description":"Inclusive start date","schema":{"type":"string","format":"date"}},{"name":"end_date","in":"query","required":false,"description":"Inclusive end date","schema":{"type":"string","format":"date"}}]}},"/v1/execution/gpay_volume_payments_by_token/weekly":{"get":{"tags":["Execution"],"summary":"Gpay Volume Payments By Token (weekly)","description":"**Required Access:** `tier1`\n\nWeekly payment volume by token in USD for Gnosis Pay.\n\n**Declared Filters:**\n- **token**: = on `label` (Token symbol)\n- **start_date**: >= on `date` (Inclusive start date)\n- **end_date**: <= on `date` (Inclusive end date)\n\n**Sort:**\n- `date DESC`\n\n**Columns:**\n- **date** (`Date`): The first day of the ISO week.\n- **label** (`String`): The token symbol.\n- **value** (`Float64`): The payment volume in USD for this token in this week.","operationId":"api_execution_gpay_volume_payments_by_token_weekly_get_v1_execution_gpay_volume_payments_by_token_weekly_get","security":[{"APIKeyHeader":[]}],"responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"date":{"type":"string","format":"date","description":"The first day of the ISO week."},"label":{"type":"string","description":"The token symbol."},"value":{"type":"number","description":"The payment volume in USD for this token in this week."}}}}}}}},"parameters":[{"name":"token","in":"query","required":false,"description":"Token symbol","schema":{"type":"string"}},{"name":"start_date","in":"query","required":false,"description":"Inclusive start date","schema":{"type":"string","format":"date"}},{"name":"end_date","in":"query","required":false,"description":"Inclusive end date","schema":{"type":"string","format":"date"}}]}},"/v1/execution/gpay_volume_payments_by_token/monthly":{"get":{"tags":["Execution"],"summary":"Gpay Volume Payments By Token (monthly)","description":"**Required Access:** `tier1`\n\nMonthly payment volume by token in USD for Gnosis Pay.\n\n**Declared Filters:**\n- **token**: = on `label` (Token symbol)\n- **start_date**: >= on `date` (Inclusive start date)\n- **end_date**: <= on `date` (Inclusive end date)\n\n**Sort:**\n- `date DESC`\n\n**Columns:**\n- **date** (`Date`): The first day of the month.\n- **label** (`String`): The token symbol.\n- **value** (`Float64`): The payment volume in USD for this token in this month.","operationId":"api_execution_gpay_volume_payments_by_token_monthly_get_v1_execution_gpay_volume_payments_by_token_monthly_get","security":[{"APIKeyHeader":[]}],"responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"date":{"type":"string","format":"date","description":"The first day of the month."},"label":{"type":"string","description":"The token symbol."},"value":{"type":"number","description":"The payment volume in USD for this token in this month."}}}}}}}},"parameters":[{"name":"token","in":"query","required":false,"description":"Token symbol","schema":{"type":"string"}},{"name":"start_date","in":"query","required":false,"description":"Inclusive start date","schema":{"type":"string","format":"date"}},{"name":"end_date","in":"query","required":false,"description":"Inclusive end date","schema":{"type":"string","format":"date"}}]}},"/v1/execution/gpay_wallet_balance_composition/latest":{"get":{"tags":["Execution"],"summary":"Gpay Wallet Balance Composition (latest)","description":"**Required Access:** `tier1`\n\nCurrent balance composition of a Gnosis Pay wallet by token.\n\n**Columns:**\n- **name** (`String`): The token symbol or name.\n- **value** (`Float64`): The balance amount in USD.\n- **as_of_date** (`Date`): Date the snapshot is computed as of (max date in the underlying data).","operationId":"api_execution_gpay_wallet_balance_composition_get_v1_execution_gpay_wallet_balance_composition_latest_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"name":{"type":"string","description":"The token symbol or name."},"value":{"type":"number","description":"The balance amount in USD."},"as_of_date":{"type":"string","format":"date","description":"Date the snapshot is computed as of (max date in the underlying data)."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/holders_per_token/latest":{"get":{"tags":["Execution"],"summary":"Holders Per Token (latest)","description":"**Required Access:** `tier1`\n\nThis model provides the latest snapshot of the number of holders for each API token, aggregated by token symbol, to support analysis of token holder trends over time.\n\n**Columns:**\n- **token** (`String`): The symbol identifier of the API token.\n- **value** (`UInt64`): The maximum number of holders for the token up to the most recent date before today.\n- **as_of_date** (`Date`): Date the snapshot is computed as of (max date in the underlying data).","operationId":"api_execution_tokens_holders_latest_by_token_get_v1_execution_holders_per_token_latest_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"token":{"type":"string","description":"The symbol identifier of the API token."},"value":{"type":"integer","description":"The maximum number of holders for the token up to the most recent date before today."},"as_of_date":{"type":"string","format":"date","description":"Date the snapshot is computed as of (max date in the underlying data)."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/holders_per_token/daily":{"get":{"tags":["Execution"],"summary":"Holders Per Token (daily)","description":"**Required Access:** `tier1`\n\nThe api_execution_tokens_holders_daily model provides daily aggregated data on the number of unique token holders for each token, supporting analysis of token distribution trends over time.\n\n**Declared Filters:**\n- **token**: = on `token` (Token symbol)\n- **token_class**: = on `token_class` (Token class (native, stablecoin, bridged, etc.))\n- **start_date**: >= on `date` (Inclusive start date)\n- **end_date**: <= on `date` (Inclusive end date)\n\n**Sort:**\n- `date DESC`\n\n**Columns:**\n- **date** (`Date`): The specific calendar date for the recorded data point, formatted as YYYY-MM-DD.\n- **token** (`String`): The symbol identifier of the token, representing the specific digital asset.\n- **token_class** (`String`): The classification or category of the token, indicating its type or purpose.\n- **value** (`UInt64`): The number of unique holders for the token on the given date.","operationId":"api_execution_tokens_holders_daily_get_v1_execution_holders_per_token_daily_get","security":[{"APIKeyHeader":[]}],"responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"date":{"type":"string","format":"date","description":"The specific calendar date for the recorded data point, formatted as YYYY-MM-DD."},"token":{"type":"string","description":"The symbol identifier of the token, representing the specific digital asset."},"token_class":{"type":"string","description":"The classification or category of the token, indicating its type or purpose."},"value":{"type":"integer","description":"The number of unique holders for the token on the given date."}}}}}}}},"parameters":[{"name":"token","in":"query","required":false,"description":"Token symbol","schema":{"type":"string"}},{"name":"token_class","in":"query","required":false,"description":"Token class (native, stablecoin, bridged, etc.)","schema":{"type":"string"}},{"name":"start_date","in":"query","required":false,"description":"Inclusive start date","schema":{"type":"string","format":"date"}},{"name":"end_date","in":"query","required":false,"description":"Inclusive end date","schema":{"type":"string","format":"date"}}]}},"/v1/execution/projects_and_sectors_count/total":{"get":{"tags":["Execution"],"summary":"Projects And Sectors Count (total)","description":"**Required Access:** `tier0` (no API key required)\n\nThis view aggregates the total number of distinct projects and sectors crawled, providing a high-level overview of data coverage for the API.\n\n**Columns:**\n- **value1** (`Float64`): The total count of unique projects identified in the dataset.\n- **value2** (`Float64`): The total count of unique sectors associated with the projects.\n- **as_of_date** (`Date`): Date the snapshot is computed as of (max date in the underlying data).","operationId":"api_crawlers_data_distinct_projects_sectors_totals_get_v1_execution_projects_and_sectors_count_total_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"value1":{"type":"number","description":"The total count of unique projects identified in the dataset."},"value2":{"type":"number","description":"The total count of unique sectors associated with the projects."},"as_of_date":{"type":"string","format":"date","description":"Date the snapshot is computed as of (max date in the underlying data)."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/rwa_backedfi_prices/daily":{"get":{"tags":["Execution"],"summary":"Rwa Backedfi Prices (daily)","description":"**Required Access:** `tier1`\n\nThe api_execution_rwa_backedfi_prices_daily model provides daily pricing data for RWA-backed financial instruments to support analytics and reporting.\n\n**Columns:**\n- **bticker** (`String`): Unique identifier for the financial instrument, typically a ticker symbol.\n- **date** (`Date`): The date of the recorded price, formatted as YYYY-MM-DD.\n- **price** (`UInt64`): The daily price of the instrument, expressed in its respective currency units.","operationId":"api_execution_rwa_backedfi_prices_daily_get_v1_execution_rwa_backedfi_prices_daily_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"bticker":{"type":"string","description":"Unique identifier for the financial instrument, typically a ticker symbol."},"date":{"type":"string","format":"date","description":"The date of the recorded price, formatted as YYYY-MM-DD."},"price":{"type":"integer","description":"The daily price of the instrument, expressed in its respective currency units."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/safe_details/latest":{"get":{"tags":["Execution"],"summary":"Safe Details (latest)","description":"**Required Access:** `tier2`\n\nOne row per Safe contract with deployment metadata + current-owner-count\n+ current-threshold. Powers the Safe-section summary card in the Account\nPortfolio tab without needing a second aggregation round-trip.\n`require_any_of: [safe_address]`.\n\n\n**Declared Filters:**\n- **safe_address**: = on `safe_address` (Safe contract address)\n\n**Pagination:**\n- **limit**: default `100`, max `1000`\n- **offset**: default `0`\n\n**Columns:**\n- **safe_address** (`String`): The Safe proxy address (lowercase, 0x-prefixed).\n- **creation_version** (`String`): Safe contract version this proxy was set up against. One of 0.1.0, 1.0.0, 1.1.0, 1.1.1, 1.1.1Circles, 1.2.0, 1.3.0, 1.3.0L2, 1.4.1, 1.4.1L2.\n\n- **is_l2** (`UInt8`): 1 if the Safe was deployed against a SafeL2 singleton (emits L2-specific transaction events).\n- **creation_singleton** (`String`): The singleton/mastercopy address the proxy delegatecalls into (lowercase, 0x-prefixed).\n- **deployment_date** (`Date`): Calendar date of the Safe's creation transaction (block_date of the setup() delegatecall).\n- **deployment_timestamp** (`DateTime64(0, 'UTC')`): UTC timestamp of the block containing the setup() delegatecall.\n- **deployment_tx_hash** (`String`): Transaction hash that contained the setup() delegatecall.\n- **current_owner_count** (`UInt64`): Number of current owners of the Safe (0 when no current-owner rows exist).\n- **current_threshold** (`Nullable(UInt32)`): Confirmations currently required by this Safe. NULL when no current-owner rows exist.\n- **as_of_date** (`Date`): Date the snapshot is computed as of (max date in the underlying data).","operationId":"api_execution_safe_details_latest_get_v1_execution_safe_details_latest_get","security":[{"APIKeyHeader":[]}],"responses":{"200":{"description":"Paginated response","content":{"application/json":{"schema":{"type":"object","required":["items","pagination"],"properties":{"items":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"safe_address":{"type":"string","description":"The Safe proxy address (lowercase, 0x-prefixed)."},"creation_version":{"type":"string","description":"Safe contract version this proxy was set up against. One of 0.1.0, 1.0.0, 1.1.0, 1.1.1, 1.1.1Circles, 1.2.0, 1.3.0, 1.3.0L2, 1.4.1, 1.4.1L2.\n"},"is_l2":{"type":"integer","description":"1 if the Safe was deployed against a SafeL2 singleton (emits L2-specific transaction events)."},"creation_singleton":{"type":"string","description":"The singleton/mastercopy address the proxy delegatecalls into (lowercase, 0x-prefixed)."},"deployment_date":{"type":"string","format":"date","description":"Calendar date of the Safe's creation transaction (block_date of the setup() delegatecall)."},"deployment_timestamp":{"type":"string","format":"date-time","description":"UTC timestamp of the block containing the setup() delegatecall."},"deployment_tx_hash":{"type":"string","description":"Transaction hash that contained the setup() delegatecall."},"current_owner_count":{"type":"integer","description":"Number of current owners of the Safe (0 when no current-owner rows exist)."},"current_threshold":{"type":"integer","description":"Confirmations currently required by this Safe. NULL when no current-owner rows exist."},"as_of_date":{"type":"string","format":"date","description":"Date the snapshot is computed as of (max date in the underlying data)."}}}},"pagination":{"type":"object","required":["limit","offset","returned","has_more"],"properties":{"limit":{"type":"integer","minimum":1},"offset":{"type":"integer","minimum":0},"returned":{"type":"integer","minimum":0},"has_more":{"type":"boolean"}}}}}}}}},"parameters":[{"name":"safe_address","in":"query","required":false,"description":"Safe contract address","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"Row limit","schema":{"type":"integer","minimum":1,"maximum":1000,"default":100}},{"name":"offset","in":"query","required":false,"description":"Row offset","schema":{"type":"integer","minimum":0,"default":0}}]},"post":{"tags":["Execution"],"summary":"Safe Details (latest) (POST)","description":"**Required Access:** `tier2`\n\nOne row per Safe contract with deployment metadata + current-owner-count\n+ current-threshold. Powers the Safe-section summary card in the Account\nPortfolio tab without needing a second aggregation round-trip.\n`require_any_of: [safe_address]`.\n\n\n**Declared Filters:**\n- **safe_address**: = on `safe_address` (Safe contract address)\n\n**Pagination:**\n- **limit**: default `100`, max `1000`\n- **offset**: default `0`\n\n**Columns:**\n- **safe_address** (`String`): The Safe proxy address (lowercase, 0x-prefixed).\n- **creation_version** (`String`): Safe contract version this proxy was set up against. One of 0.1.0, 1.0.0, 1.1.0, 1.1.1, 1.1.1Circles, 1.2.0, 1.3.0, 1.3.0L2, 1.4.1, 1.4.1L2.\n\n- **is_l2** (`UInt8`): 1 if the Safe was deployed against a SafeL2 singleton (emits L2-specific transaction events).\n- **creation_singleton** (`String`): The singleton/mastercopy address the proxy delegatecalls into (lowercase, 0x-prefixed).\n- **deployment_date** (`Date`): Calendar date of the Safe's creation transaction (block_date of the setup() delegatecall).\n- **deployment_timestamp** (`DateTime64(0, 'UTC')`): UTC timestamp of the block containing the setup() delegatecall.\n- **deployment_tx_hash** (`String`): Transaction hash that contained the setup() delegatecall.\n- **current_owner_count** (`UInt64`): Number of current owners of the Safe (0 when no current-owner rows exist).\n- **current_threshold** (`Nullable(UInt32)`): Confirmations currently required by this Safe. NULL when no current-owner rows exist.\n- **as_of_date** (`Date`): Date the snapshot is computed as of (max date in the underlying data).","operationId":"api_execution_safe_details_latest_post_v1_execution_safe_details_latest_post","security":[{"APIKeyHeader":[]}],"requestBody":{"content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/api_execution_safe_details_latest_PostBody"},{"type":"null"}],"title":" Body"}}}},"responses":{"200":{"description":"Paginated response","content":{"application/json":{"schema":{"type":"object","required":["items","pagination"],"properties":{"items":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"safe_address":{"type":"string","description":"The Safe proxy address (lowercase, 0x-prefixed)."},"creation_version":{"type":"string","description":"Safe contract version this proxy was set up against. One of 0.1.0, 1.0.0, 1.1.0, 1.1.1, 1.1.1Circles, 1.2.0, 1.3.0, 1.3.0L2, 1.4.1, 1.4.1L2.\n"},"is_l2":{"type":"integer","description":"1 if the Safe was deployed against a SafeL2 singleton (emits L2-specific transaction events)."},"creation_singleton":{"type":"string","description":"The singleton/mastercopy address the proxy delegatecalls into (lowercase, 0x-prefixed)."},"deployment_date":{"type":"string","format":"date","description":"Calendar date of the Safe's creation transaction (block_date of the setup() delegatecall)."},"deployment_timestamp":{"type":"string","format":"date-time","description":"UTC timestamp of the block containing the setup() delegatecall."},"deployment_tx_hash":{"type":"string","description":"Transaction hash that contained the setup() delegatecall."},"current_owner_count":{"type":"integer","description":"Number of current owners of the Safe (0 when no current-owner rows exist)."},"current_threshold":{"type":"integer","description":"Confirmations currently required by this Safe. NULL when no current-owner rows exist."},"as_of_date":{"type":"string","format":"date","description":"Date the snapshot is computed as of (max date in the underlying data)."}}}},"pagination":{"type":"object","required":["limit","offset","returned","has_more"],"properties":{"limit":{"type":"integer","minimum":1},"offset":{"type":"integer","minimum":0},"returned":{"type":"integer","minimum":0},"has_more":{"type":"boolean"}}}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/execution/safes_current_owners/latest":{"get":{"tags":["Execution"],"summary":"Safes Current Owners (latest)","description":"**Required Access:** `tier2`\n\nPer-Safe owner list (add-only snapshot). One row per (safe, owner) pair\nwhere the last observed event for that pair is `safe_setup` or\n`added_owner`. Supports filtering on either side so the Account Portfolio\ntab can query \"who owns this safe?\" (filter by `safe_address`) and\n\"which safes does this address own?\" (filter by `owner_address`) against\nthe same view. Denormalises `current_threshold` to save a per-owner join.\n\n\n**Declared Filters:**\n- **safe_address**: = on `safe_address` (Safe contract address — returns every current owner of this Safe)\n- **owner_address**: = on `owner_address` (Owner (EOA or contract) address — returns every Safe this address currently owns)\n\n**Pagination:**\n- **limit**: default `500`, max `5000`\n- **offset**: default `0`\n\n**Sort:**\n- `became_owner_at DESC`\n\n**User Sort:**\n- **sort_by**: one of `safe_address`, `owner_address`, `became_owner_at`\n- **sort_direction**: `ASC` or `DESC` (defaults to `ASC` when `sort_by` is provided)\n\n**Columns:**\n- **safe_address** (`Nullable(String)`): The Safe address (lowercase, 0x-prefixed).\n- **owner_address** (`Nullable(String)`): A current owner of the Safe (lowercase, 0x-prefixed).\n- **became_owner_at** (`DateTime64(0, 'UTC')`): Timestamp of the event that added (or set up) this owner. For an owner who was removed and re-added, this is the re-add time, not the original setup time.\n- **current_threshold** (`Nullable(UInt32)`): Confirmations currently required by this Safe (denormalised per owner row).\n- **as_of_date** (`Date`): Date the snapshot is computed as of (max date in the underlying data).","operationId":"api_execution_safes_current_owners_get_v1_execution_safes_current_owners_latest_get","security":[{"APIKeyHeader":[]}],"responses":{"200":{"description":"Paginated response","content":{"application/json":{"schema":{"type":"object","required":["items","pagination"],"properties":{"items":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"safe_address":{"type":"string","description":"The Safe address (lowercase, 0x-prefixed)."},"owner_address":{"type":"string","description":"A current owner of the Safe (lowercase, 0x-prefixed)."},"became_owner_at":{"type":"string","format":"date-time","description":"Timestamp of the event that added (or set up) this owner. For an owner who was removed and re-added, this is the re-add time, not the original setup time."},"current_threshold":{"type":"integer","description":"Confirmations currently required by this Safe (denormalised per owner row)."},"as_of_date":{"type":"string","format":"date","description":"Date the snapshot is computed as of (max date in the underlying data)."}}}},"pagination":{"type":"object","required":["limit","offset","returned","has_more"],"properties":{"limit":{"type":"integer","minimum":1},"offset":{"type":"integer","minimum":0},"returned":{"type":"integer","minimum":0},"has_more":{"type":"boolean"}}}}}}}}},"parameters":[{"name":"safe_address","in":"query","required":false,"description":"Safe contract address — returns every current owner of this Safe","schema":{"type":"string"}},{"name":"owner_address","in":"query","required":false,"description":"Owner (EOA or contract) address — returns every Safe this address currently owns","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"Row limit","schema":{"type":"integer","minimum":1,"maximum":5000,"default":500}},{"name":"offset","in":"query","required":false,"description":"Row offset","schema":{"type":"integer","minimum":0,"default":0}},{"name":"sort_by","in":"query","required":false,"description":"Sort column","schema":{"type":"string","enum":["safe_address","owner_address","became_owner_at"]}},{"name":"sort_direction","in":"query","required":false,"description":"Sort direction. Defaults to ASC when sort_by is provided.","schema":{"type":"string","enum":["ASC","DESC"],"default":"ASC"}}]},"post":{"tags":["Execution"],"summary":"Safes Current Owners (latest) (POST)","description":"**Required Access:** `tier2`\n\nPer-Safe owner list (add-only snapshot). One row per (safe, owner) pair\nwhere the last observed event for that pair is `safe_setup` or\n`added_owner`. Supports filtering on either side so the Account Portfolio\ntab can query \"who owns this safe?\" (filter by `safe_address`) and\n\"which safes does this address own?\" (filter by `owner_address`) against\nthe same view. Denormalises `current_threshold` to save a per-owner join.\n\n\n**Declared Filters:**\n- **safe_address**: = on `safe_address` (Safe contract address — returns every current owner of this Safe)\n- **owner_address**: = on `owner_address` (Owner (EOA or contract) address — returns every Safe this address currently owns)\n\n**Pagination:**\n- **limit**: default `500`, max `5000`\n- **offset**: default `0`\n\n**Sort:**\n- `became_owner_at DESC`\n\n**User Sort:**\n- **sort_by**: one of `safe_address`, `owner_address`, `became_owner_at`\n- **sort_direction**: `ASC` or `DESC` (defaults to `ASC` when `sort_by` is provided)\n\n**Columns:**\n- **safe_address** (`Nullable(String)`): The Safe address (lowercase, 0x-prefixed).\n- **owner_address** (`Nullable(String)`): A current owner of the Safe (lowercase, 0x-prefixed).\n- **became_owner_at** (`DateTime64(0, 'UTC')`): Timestamp of the event that added (or set up) this owner. For an owner who was removed and re-added, this is the re-add time, not the original setup time.\n- **current_threshold** (`Nullable(UInt32)`): Confirmations currently required by this Safe (denormalised per owner row).\n- **as_of_date** (`Date`): Date the snapshot is computed as of (max date in the underlying data).","operationId":"api_execution_safes_current_owners_post_v1_execution_safes_current_owners_latest_post","security":[{"APIKeyHeader":[]}],"requestBody":{"content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/api_execution_safes_current_owners_PostBody"},{"type":"null"}],"title":" Body"}}}},"responses":{"200":{"description":"Paginated response","content":{"application/json":{"schema":{"type":"object","required":["items","pagination"],"properties":{"items":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"safe_address":{"type":"string","description":"The Safe address (lowercase, 0x-prefixed)."},"owner_address":{"type":"string","description":"A current owner of the Safe (lowercase, 0x-prefixed)."},"became_owner_at":{"type":"string","format":"date-time","description":"Timestamp of the event that added (or set up) this owner. For an owner who was removed and re-added, this is the re-add time, not the original setup time."},"current_threshold":{"type":"integer","description":"Confirmations currently required by this Safe (denormalised per owner row)."},"as_of_date":{"type":"string","format":"date","description":"Date the snapshot is computed as of (max date in the underlying data)."}}}},"pagination":{"type":"object","required":["limit","offset","returned","has_more"],"properties":{"limit":{"type":"integer","minimum":1},"offset":{"type":"integer","minimum":0},"returned":{"type":"integer","minimum":0},"has_more":{"type":"boolean"}}}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/execution/state_size/daily":{"get":{"tags":["Execution"],"summary":"State Size (daily)","description":"**Required Access:** `tier1`\n\nThe api_execution_state_full_size_daily model provides daily aggregated data on the size of API execution states, facilitating trend analysis and capacity planning.\n\n**Columns:**\n- **date** (`Date`): The specific calendar date for the recorded data point.\n- **value** (`Float64`): The size of the execution state in gigabytes, calculated by dividing bytes by 10^9.","operationId":"api_execution_state_full_size_daily_get_v1_execution_state_size_daily_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"date":{"type":"string","format":"date","description":"The specific calendar date for the recorded data point."},"value":{"type":"number","description":"The size of the execution state in gigabytes, calculated by dividing bytes by 10^9."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/token_balances/daily":{"get":{"tags":["Execution"],"summary":"Token Balances (daily)","description":"**Required Access:** `tier1`\n\nDaily per-wallet token balance feed for downstream API consumers.\nSourced from int_execution_tokens_balances_daily. The view is wired\nto the API metadata layer with REQUIRED filters (symbol OR address) and\noptional date-range filters to prevent unbounded scans.\n\n\n**Declared Filters:**\n- **symbol**: = on `symbol` (Token symbol)\n- **address**: IN on `address` (Wallet address list)\n- **start_date**: >= on `date` (Inclusive start date)\n- **end_date**: <= on `date` (Inclusive end date)\n\n**Pagination:**\n- **limit**: default `100`, max `5000`\n- **offset**: default `0`\n\n**Sort:**\n- `date DESC`\n\n**Columns:**\n- **date** (`Date`)\n- **token_address** (`String`)\n- **symbol** (`String`)\n- **address** (`String`): Holder wallet address (lowercase).\n- **balance** (`Float64`): Balance in native units.\n- **balance_usd** (`Float64`): Balance in USD.","operationId":"api_execution_tokens_balances_daily_get_v1_execution_token_balances_daily_get","security":[{"APIKeyHeader":[]}],"responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"date":{"type":"string","format":"date"},"token_address":{"type":"string"},"symbol":{"type":"string"},"address":{"type":"string","description":"Holder wallet address (lowercase)."},"balance":{"type":"number","description":"Balance in native units."},"balance_usd":{"type":"number","description":"Balance in USD."}}}}}}}},"parameters":[{"name":"symbol","in":"query","required":false,"description":"Token symbol","schema":{"type":"string"}},{"name":"address","in":"query","required":false,"description":"Wallet address list. Accepts repeated query params or CSV.","style":"form","explode":true,"schema":{"type":"array","items":{"type":"string"},"maxItems":200}},{"name":"start_date","in":"query","required":false,"description":"Inclusive start date","schema":{"type":"string","format":"date"}},{"name":"end_date","in":"query","required":false,"description":"Inclusive end date","schema":{"type":"string","format":"date"}},{"name":"limit","in":"query","required":false,"description":"Row limit","schema":{"type":"integer","minimum":1,"maximum":5000,"default":100}},{"name":"offset","in":"query","required":false,"description":"Row offset","schema":{"type":"integer","minimum":0,"default":0}}]},"post":{"tags":["Execution"],"summary":"Token Balances (daily) (POST)","description":"**Required Access:** `tier1`\n\nDaily per-wallet token balance feed for downstream API consumers.\nSourced from int_execution_tokens_balances_daily. The view is wired\nto the API metadata layer with REQUIRED filters (symbol OR address) and\noptional date-range filters to prevent unbounded scans.\n\n\n**Declared Filters:**\n- **symbol**: = on `symbol` (Token symbol)\n- **address**: IN on `address` (Wallet address list)\n- **start_date**: >= on `date` (Inclusive start date)\n- **end_date**: <= on `date` (Inclusive end date)\n\n**Pagination:**\n- **limit**: default `100`, max `5000`\n- **offset**: default `0`\n\n**Sort:**\n- `date DESC`\n\n**Columns:**\n- **date** (`Date`)\n- **token_address** (`String`)\n- **symbol** (`String`)\n- **address** (`String`): Holder wallet address (lowercase).\n- **balance** (`Float64`): Balance in native units.\n- **balance_usd** (`Float64`): Balance in USD.","operationId":"api_execution_tokens_balances_daily_post_v1_execution_token_balances_daily_post","security":[{"APIKeyHeader":[]}],"requestBody":{"content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/api_execution_tokens_balances_daily_PostBody"},{"type":"null"}],"title":" Body"}}}},"responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"date":{"type":"string","format":"date"},"token_address":{"type":"string"},"symbol":{"type":"string"},"address":{"type":"string","description":"Holder wallet address (lowercase)."},"balance":{"type":"number","description":"Balance in native units."},"balance_usd":{"type":"number","description":"Balance in USD."}}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/execution/tokens_overview/latest":{"get":{"tags":["Execution"],"summary":"Tokens Overview (latest)","description":"**Required Access:** `tier1`\n\nThin API view over fct_execution_tokens_overview_by_class_latest — supply/holders KPI cards per token class with 7-day change.\n\n**Columns:**\n- **token_class** (`String`)\n- **label** (`String`)\n- **value** (`Float64`)\n- **change_pct** (`Float64`)\n- **as_of_date** (`Date`): Date the snapshot is computed as of (max date in the underlying data).","operationId":"api_execution_tokens_overview_latest_get_v1_execution_tokens_overview_latest_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"token_class":{"type":"string"},"label":{"type":"string"},"value":{"type":"number"},"change_pct":{"type":"number"},"as_of_date":{"type":"string","format":"date","description":"Date the snapshot is computed as of (max date in the underlying data)."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/tokens_supply/latest":{"get":{"tags":["Execution"],"summary":"Tokens Supply (latest)","description":"**Required Access:** `tier1`\n\nThis model provides the latest supply values for each API token based on daily recorded data, enabling tracking of token supply trends over time.\n\n**Columns:**\n- **token** (`String`): The symbol identifier of the API token.\n- **value** (`Float64`): The most recent supply value of the token, as of the latest date prior to today.\n- **as_of_date** (`Date`): Date the snapshot is computed as of (max date in the underlying data).","operationId":"api_execution_tokens_supply_latest_by_token_get_v1_execution_tokens_supply_latest_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"token":{"type":"string","description":"The symbol identifier of the API token."},"value":{"type":"number","description":"The most recent supply value of the token, as of the latest date prior to today."},"as_of_date":{"type":"string","format":"date","description":"Date the snapshot is computed as of (max date in the underlying data)."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/tokens_supply/daily":{"get":{"tags":["Execution"],"summary":"Tokens Supply (daily)","description":"**Required Access:** `tier1`\n\nThe api_execution_tokens_supply_daily model provides daily aggregated data on the supply of different API tokens, supporting analysis of token availability over time.\n\n**Declared Filters:**\n- **token**: = on `token` (Token symbol)\n- **token_class**: = on `token_class` (Token class (native, stablecoin, bridged, etc.))\n- **start_date**: >= on `date` (Inclusive start date)\n- **end_date**: <= on `date` (Inclusive end date)\n\n**Sort:**\n- `date DESC`\n\n**Columns:**\n- **date** (`Date`): The specific calendar date for the recorded token supply data.\n- **token** (`String`): The identifier of the API token, representing different token types or instances.\n- **token_class** (`String`): The classification or category of the token, indicating its type or usage context.\n- **value** (`Float64`): The total supply of the token on the given date, measured in units consistent with the supply metric.","operationId":"api_execution_tokens_supply_daily_get_v1_execution_tokens_supply_daily_get","security":[{"APIKeyHeader":[]}],"responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"date":{"type":"string","format":"date","description":"The specific calendar date for the recorded token supply data."},"token":{"type":"string","description":"The identifier of the API token, representing different token types or instances."},"token_class":{"type":"string","description":"The classification or category of the token, indicating its type or usage context."},"value":{"type":"number","description":"The total supply of the token on the given date, measured in units consistent with the supply metric."}}}}}}}},"parameters":[{"name":"token","in":"query","required":false,"description":"Token symbol","schema":{"type":"string"}},{"name":"token_class","in":"query","required":false,"description":"Token class (native, stablecoin, bridged, etc.)","schema":{"type":"string"}},{"name":"start_date","in":"query","required":false,"description":"Inclusive start date","schema":{"type":"string","format":"date"}},{"name":"end_date","in":"query","required":false,"description":"Inclusive end date","schema":{"type":"string","format":"date"}}]}},"/v1/execution/tokens_supply_by_sector/latest":{"get":{"tags":["Execution"],"summary":"Tokens Supply By Sector (latest)","description":"**Required Access:** `tier1`\n\nThin API view over fct_execution_tokens_supply_by_sector_latest — supply distribution by holder sector for the latest day, per token class.\n\n**Columns:**\n- **token_class** (`String`)\n- **label** (`String`): Sector name (renamed from sector).\n- **value** (`Float64`)\n- **value_usd** (`Float64`)\n- **percentage** (`Float64`)\n- **as_of_date** (`Date`): Date the snapshot is computed as of (max date in the underlying data).","operationId":"api_execution_tokens_supply_by_sector_latest_get_v1_execution_tokens_supply_by_sector_latest_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"token_class":{"type":"string"},"label":{"type":"string","description":"Sector name (renamed from sector)."},"value":{"type":"number"},"value_usd":{"type":"number"},"percentage":{"type":"number"},"as_of_date":{"type":"string","format":"date","description":"Date the snapshot is computed as of (max date in the underlying data)."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/tokens_supply_distribution/latest":{"get":{"tags":["Execution"],"summary":"Tokens Supply Distribution (latest)","description":"**Required Access:** `tier1`\n\nThin API view over fct_execution_tokens_supply_distribution_latest — per-token share of supply within token class on the latest day.\n\n**Columns:**\n- **token_class** (`String`)\n- **token** (`String`)\n- **value** (`Float64`)\n- **value_usd** (`Float64`)\n- **percentage** (`Float64`)\n- **as_of_date** (`Date`): Date the snapshot is computed as of (max date in the underlying data).","operationId":"api_execution_tokens_supply_distribution_latest_get_v1_execution_tokens_supply_distribution_latest_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"token_class":{"type":"string"},"token":{"type":"string"},"value":{"type":"number"},"value_usd":{"type":"number"},"percentage":{"type":"number"},"as_of_date":{"type":"string","format":"date","description":"Date the snapshot is computed as of (max date in the underlying data)."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/tokens_top_holders/latest":{"get":{"tags":["Execution"],"summary":"Tokens Top Holders (latest)","description":"**Required Access:** `tier1`\n\nThin API view over fct_execution_tokens_top_holders_latest. Returns all holders ranked by balance, with concentration and label columns. Dashboard applies WHERE symbol = {filter} and LIMIT as needed.\n\n\n**Columns:**\n- **rank** (`UInt64`): Holder rank within token, ordered by balance_usd descending.\n- **token_address** (`String`): Contract address of the token (lowercase).\n- **symbol** (`String`): Token symbol.\n- **token_class** (`String`): Token classification.\n- **address** (`String`): Holder wallet or contract address.\n- **label** (`String`): Project label from crawlers_data_labels. NULL if unlabeled.\n- **label_sector** (`String`): Sector from crawlers_data_labels. NULL if unlabeled.\n- **balance** (`Float64`): Token balance in native units.\n- **balance_usd** (`Float64`): Token balance in USD.\n- **pct_of_total** (`Float64`): Holder's share of total token supply as percentage.\n- **cumulative_pct** (`Float64`): Running cumulative share of supply from rank 1 downward.\n- **change_usd_7d** (`Float64`): USD balance change vs 7 days ago.\n- **unwound_from** (`Array(String)`): Array of container addresses this row was unwound from. Empty for direct holders.\n- **is_terminal_ubo** (`Nullable(UInt8)`): 1 = label-confirmed end-holder, 0 = undecomposed labeled container, NULL = unclassified.\n- **as_of_date** (`Date`): Date the snapshot is computed as of (max date in the underlying data).","operationId":"api_execution_tokens_top_holders_latest_get_v1_execution_tokens_top_holders_latest_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"rank":{"type":"integer","description":"Holder rank within token, ordered by balance_usd descending."},"token_address":{"type":"string","description":"Contract address of the token (lowercase)."},"symbol":{"type":"string","description":"Token symbol."},"token_class":{"type":"string","description":"Token classification."},"address":{"type":"string","description":"Holder wallet or contract address."},"label":{"type":"string","description":"Project label from crawlers_data_labels. NULL if unlabeled."},"label_sector":{"type":"string","description":"Sector from crawlers_data_labels. NULL if unlabeled."},"balance":{"type":"number","description":"Token balance in native units."},"balance_usd":{"type":"number","description":"Token balance in USD."},"pct_of_total":{"type":"number","description":"Holder's share of total token supply as percentage."},"cumulative_pct":{"type":"number","description":"Running cumulative share of supply from rank 1 downward."},"change_usd_7d":{"type":"number","description":"USD balance change vs 7 days ago."},"unwound_from":{"items":{"type":"string"},"type":"array","description":"Array of container addresses this row was unwound from. Empty for direct holders."},"is_terminal_ubo":{"type":"integer","description":"1 = label-confirmed end-holder, 0 = undecomposed labeled container, NULL = unclassified."},"as_of_date":{"type":"string","format":"date","description":"Date the snapshot is computed as of (max date in the underlying data)."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/tokens_ubo_coverage/latest":{"get":{"tags":["Execution"],"summary":"Tokens Ubo Coverage (latest)","description":"**Required Access:** `tier1`\n\nThin API view over fct_execution_tokens_ubo_coverage_latest.\n\n\n**Columns:**\n- **token_address** (`String`): Contract address of the token (lowercase).\n- **symbol** (`String`): Token symbol.\n- **token_class** (`String`): Token classification.\n- **total_usd** (`Float64`): Total USD value of all positive-balance holders for this token on the latest snapshot date.\n- **pct_direct_terminal** (`Float64`): Share of supply held by direct holders that are label-confirmed terminals.\n- **pct_unwound_terminal** (`Float64`): Share of supply unwound into label-confirmed terminal addresses.\n- **pct_unwound_other** (`Float64`): Share of supply unwound but landing on unclassified or container addresses.\n- **pct_known_container** (`Float64`): Share of supply still held by labeled containers not yet decomposed.\n- **pct_unclassified** (`Float64`): Share of supply held by addresses with no label.\n- **pct_unwound_total** (`Float64`): Total share of supply that flowed through any unwind path.\n- **as_of_date** (`Date`): Date the snapshot is computed as of (max date in the underlying data).","operationId":"api_execution_tokens_ubo_coverage_latest_get_v1_execution_tokens_ubo_coverage_latest_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"token_address":{"type":"string","description":"Contract address of the token (lowercase)."},"symbol":{"type":"string","description":"Token symbol."},"token_class":{"type":"string","description":"Token classification."},"total_usd":{"type":"number","description":"Total USD value of all positive-balance holders for this token on the latest snapshot date."},"pct_direct_terminal":{"type":"number","description":"Share of supply held by direct holders that are label-confirmed terminals."},"pct_unwound_terminal":{"type":"number","description":"Share of supply unwound into label-confirmed terminal addresses."},"pct_unwound_other":{"type":"number","description":"Share of supply unwound but landing on unclassified or container addresses."},"pct_known_container":{"type":"number","description":"Share of supply still held by labeled containers not yet decomposed."},"pct_unclassified":{"type":"number","description":"Share of supply held by addresses with no label."},"pct_unwound_total":{"type":"number","description":"Total share of supply that flowed through any unwind path."},"as_of_date":{"type":"string","format":"date","description":"Date the snapshot is computed as of (max date in the underlying data)."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/tokens_ubo_venue_breakdown/latest":{"get":{"tags":["Execution"],"summary":"Tokens Ubo Venue Breakdown (latest)","description":"**Required Access:** `tier1`\n\nThin API view over fct_execution_tokens_ubo_venue_breakdown_latest. One row per (token_address, venue), ordered by token and balance_usd descending, with as_of_date (max date in int_execution_tokens_balances_daily) appended. Tier1 endpoint (api:tokens_ubo_venue_breakdown, granularity:latest).\n\n\n**Columns:**\n- **token_address** (`String`): Contract address of the token (lowercase).\n- **symbol** (`String`): Token symbol.\n- **token_class** (`String`): Token classification.\n- **venue** (`String`): UBO venue for this slice — a protocol name or the residual 'direct' row.\n- **balance** (`Float64`): Supply held by this venue for the token, in native units.\n- **balance_usd** (`Float64`): Supply held by this venue for the token, in USD.\n- **percentage** (`Float64`): Venue's share of the token's total positive balance, in percent.\n- **as_of_date** (`Date`): Date the snapshot is computed as of (max date in the underlying data).","operationId":"api_execution_tokens_ubo_venue_breakdown_latest_get_v1_execution_tokens_ubo_venue_breakdown_latest_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"token_address":{"type":"string","description":"Contract address of the token (lowercase)."},"symbol":{"type":"string","description":"Token symbol."},"token_class":{"type":"string","description":"Token classification."},"venue":{"type":"string","description":"UBO venue for this slice — a protocol name or the residual 'direct' row."},"balance":{"type":"number","description":"Supply held by this venue for the token, in native units."},"balance_usd":{"type":"number","description":"Supply held by this venue for the token, in USD."},"percentage":{"type":"number","description":"Venue's share of the token's total positive balance, in percent."},"as_of_date":{"type":"string","format":"date","description":"Date the snapshot is computed as of (max date in the underlying data)."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/tokens_volume/daily":{"get":{"tags":["Execution"],"summary":"Tokens Volume (daily)","description":"**Required Access:** `tier1`\n\nThe api_execution_tokens_volume_daily model provides daily aggregated data on the trading volume of different tokens in both native token units and USD, supporting analysis of token liquidity and trading activity over time.\n\n**Declared Filters:**\n- **token**: = on `token` (Token symbol)\n- **token_class**: = on `token_class` (Token class (native, stablecoin, bridged, etc.))\n- **start_date**: >= on `date` (Inclusive start date)\n- **end_date**: <= on `date` (Inclusive end date)\n\n**Sort:**\n- `date DESC`\n\n**Columns:**\n- **date** (`Date`): The specific calendar date for the recorded trading volume data.\n- **token** (`String`): The identifier of the token for which the volume is reported.\n- **token_class** (`String`): The classification category of the token, such as utility or security token.\n- **value_native** (`Float64`): The total trading volume for the token on the given date in native token units.\n- **value_usd** (`Float64`): The total USD trading volume for the token on the given date.","operationId":"api_execution_tokens_volume_daily_get_v1_execution_tokens_volume_daily_get","security":[{"APIKeyHeader":[]}],"responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"date":{"type":"string","format":"date","description":"The specific calendar date for the recorded trading volume data."},"token":{"type":"string","description":"The identifier of the token for which the volume is reported."},"token_class":{"type":"string","description":"The classification category of the token, such as utility or security token."},"value_native":{"type":"number","description":"The total trading volume for the token on the given date in native token units."},"value_usd":{"type":"number","description":"The total USD trading volume for the token on the given date."}}}}}}}},"parameters":[{"name":"token","in":"query","required":false,"description":"Token symbol","schema":{"type":"string"}},{"name":"token_class","in":"query","required":false,"description":"Token class (native, stablecoin, bridged, etc.)","schema":{"type":"string"}},{"name":"start_date","in":"query","required":false,"description":"Inclusive start date","schema":{"type":"string","format":"date"}},{"name":"end_date","in":"query","required":false,"description":"Inclusive end date","schema":{"type":"string","format":"date"}}]}},"/v1/execution/transactions_count/last_7d":{"get":{"tags":["Execution"],"summary":"Transactions Count (last_7d)","description":"**Required Access:** `tier0` (no API key required)\n\nThe api_execution_transactions_7d model provides a snapshot of the total number of API execution transactions and their percentage change over the last seven days, supporting operational and performance monitoring.\n\n**Columns:**\n- **value** (`Float64`): The total count of API execution transactions recorded over the past 7 days.\n- **change_pct** (`Float64`): The percentage change in the number of transactions compared to the previous period.\n- **as_of_date** (`Date`): Date the snapshot is computed as of (max date in the underlying data).","operationId":"api_execution_transactions_7d_get_v1_execution_transactions_count_last_7d_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"value":{"type":"number","description":"The total count of API execution transactions recorded over the past 7 days."},"change_pct":{"type":"number","description":"The percentage change in the number of transactions compared to the previous period."},"as_of_date":{"type":"string","format":"date","description":"Date the snapshot is computed as of (max date in the underlying data)."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/transactions_count/all_time":{"get":{"tags":["Execution"],"summary":"Transactions Count (all_time)","description":"**Required Access:** `tier0` (no API key required)\n\nThe api_execution_transactions_total model provides a consolidated count of API execution transactions over the entire available time span, enabling analysis of total transaction volume.\n\n**Columns:**\n- **value** (`Float64`): The total number of API execution transactions recorded, representing a cumulative count across all time periods.\n- **as_of_date** (`Date`): Date the snapshot is computed as of (max date in the underlying data).","operationId":"api_execution_transactions_total_get_v1_execution_transactions_count_all_time_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"value":{"type":"number","description":"The total number of API execution transactions recorded, representing a cumulative count across all time periods."},"as_of_date":{"type":"string","format":"date","description":"Date the snapshot is computed as of (max date in the underlying data)."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/transactions_count_per_project/all_time":{"get":{"tags":["Execution"],"summary":"Transactions Count Per Project (all_time)","description":"**Required Access:** `tier0` (no API key required)\n\nThis view aggregates the total number of API execution transactions across all projects over the entire time period, providing insights into overall transaction volume.\n\n**Columns:**\n- **label** (`String`): A static label indicating the metric type, in this case 'Transactions'.\n- **value** (`Float64`): The total count of API execution transactions for all projects over the entire time window.\n- **as_of_date** (`Date`): Date the snapshot is computed as of (max date in the underlying data).","operationId":"api_execution_transactions_by_project_total_get_v1_execution_transactions_count_per_project_all_time_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"label":{"type":"string","description":"A static label indicating the metric type, in this case 'Transactions'."},"value":{"type":"number","description":"The total count of API execution transactions for all projects over the entire time window."},"as_of_date":{"type":"string","format":"date","description":"Date the snapshot is computed as of (max date in the underlying data)."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/transactions_count_per_project_top20/in_ranges":{"get":{"tags":["Execution"],"summary":"Transactions Count Per Project Top20 (in_ranges)","description":"**Required Access:** `tier0` (no API key required)\n\nThis view aggregates the top 20 API transaction counts per project within specified time ranges, providing insights into transaction volume distribution and identifying less active projects.\n\n**Columns:**\n- **window** (`String`): The time range for the transaction data, such as 'All', '7D', '30D', or '90D'.\n- **bucket** (`String`): A categorical label representing individual project identifiers or transaction groupings.\n- **value** (`Float64`): The total number of transactions for each bucket within the specified time range.\n- **range** (`String`): Aggregation window (All, 7D, 30D, 90D).\n- **label** (`String`): Project label (or \"Others\").\n- **as_of_date** (`Date`): Date the snapshot is computed as of (max date in the underlying data).","operationId":"api_execution_transactions_by_project_ranges_top20_get_v1_execution_transactions_count_per_project_top20_in_ranges_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"window":{"type":"string","description":"The time range for the transaction data, such as 'All', '7D', '30D', or '90D'."},"bucket":{"type":"string","description":"A categorical label representing individual project identifiers or transaction groupings."},"value":{"type":"number","description":"The total number of transactions for each bucket within the specified time range."},"range":{"type":"string","description":"Aggregation window (All, 7D, 30D, 90D)."},"label":{"type":"string","description":"Project label (or \"Others\")."},"as_of_date":{"type":"string","format":"date","description":"Date the snapshot is computed as of (max date in the underlying data)."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/transactions_count_per_project_top5/monthly":{"get":{"tags":["Execution"],"summary":"Transactions Count Per Project Top5 (monthly)","description":"**Required Access:** `tier1`\n\nThis view aggregates the top 5 projects by transaction count on a monthly basis, enabling analysis of project activity trends over time.\n\n**Columns:**\n- **date** (`Date`): The month and year of the transaction data, formatted as YYYY-MM.\n- **label** (`String`): The identifier or name of the project associated with the transaction count.\n- **value** (`Float64`): The number of transactions for the project during the specified month.","operationId":"api_execution_transactions_by_project_monthly_top5_get_v1_execution_transactions_count_per_project_top5_monthly_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"date":{"type":"string","format":"date","description":"The month and year of the transaction data, formatted as YYYY-MM."},"label":{"type":"string","description":"The identifier or name of the project associated with the transaction count."},"value":{"type":"number","description":"The number of transactions for the project during the specified month."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/transactions_count_per_sector/daily":{"get":{"tags":["Execution"],"summary":"Transactions Count Per Sector (daily)","description":"**Required Access:** `tier1`\n\nThe api_execution_transactions_by_sector_daily model provides daily aggregated counts of API execution transactions categorized by sector, enabling trend analysis and performance monitoring over time.\n\n**Columns:**\n- **date** (`Date`): The specific date for which the transaction data is recorded, formatted as a date.\n- **label** (`String`): The sector label associated with the transaction count, representing different business sectors.\n- **value** (`UInt64`): The total number of API execution transactions for the given sector on the specified date.","operationId":"api_execution_transactions_by_sector_daily_get_v1_execution_transactions_count_per_sector_daily_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"date":{"type":"string","format":"date","description":"The specific date for which the transaction data is recorded, formatted as a date."},"label":{"type":"string","description":"The sector label associated with the transaction count, representing different business sectors."},"value":{"type":"integer","description":"The total number of API execution transactions for the given sector on the specified date."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/transactions_count_per_sector/weekly":{"get":{"tags":["Execution"],"summary":"Transactions Count Per Sector (weekly)","description":"**Required Access:** `tier1`\n\nThe api_execution_transactions_by_sector_weekly model aggregates the number of API execution transactions per sector on a weekly basis to support trend analysis and reporting.\n\n**Columns:**\n- **date** (`Date`): The starting date of the week for which the transaction data is aggregated, formatted as a date.\n- **label** (`String`): The sector label representing the specific business sector associated with the transactions.\n- **value** (`UInt64`): The total number of API execution transactions recorded for the sector during the week.","operationId":"api_execution_transactions_by_sector_weekly_get_v1_execution_transactions_count_per_sector_weekly_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"date":{"type":"string","format":"date","description":"The starting date of the week for which the transaction data is aggregated, formatted as a date."},"label":{"type":"string","description":"The sector label representing the specific business sector associated with the transactions."},"value":{"type":"integer","description":"The total number of API execution transactions recorded for the sector during the week."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/transactions_count_per_sector/hourly":{"get":{"tags":["Execution"],"summary":"Transactions Count Per Sector (hourly)","description":"**Required Access:** `tier1`\n\nThis view aggregates the total number of API execution transactions per sector on an hourly basis, providing insights into transaction volume trends across different sectors over time.\n\n**Columns:**\n- **date** (`Date`): The specific hour timestamp representing the time period for the transaction count, in hourly granularity.\n- **label** (`String`): The sector label categorizing the transactions, used for segmentation analysis.\n- **value** (`UInt64`): The total number of API execution transactions recorded during the specified hour for the given sector.","operationId":"api_execution_transactions_by_sector_hourly_get_v1_execution_transactions_count_per_sector_hourly_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"date":{"type":"string","format":"date","description":"The specific hour timestamp representing the time period for the transaction count, in hourly granularity."},"label":{"type":"string","description":"The sector label categorizing the transactions, used for segmentation analysis."},"value":{"type":"integer","description":"The total number of API execution transactions recorded during the specified hour for the given sector."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/transactions_count_per_type/daily":{"get":{"tags":["Execution"],"summary":"Transactions Count Per Type (daily)","description":"**Required Access:** `tier1`\n\nThe api_execution_transactions_cnt_daily model provides a daily summary of successful API transaction counts categorized by transaction type, supporting operational monitoring and trend analysis.\n\n**Columns:**\n- **date** (`Date`): The specific calendar date for which the transaction data is aggregated.\n- **transaction_type** (`String`): The category or type of API transaction being counted.\n- **value** (`UInt64`): The number of successful transactions of the specified type on the given date.","operationId":"api_execution_transactions_cnt_daily_get_v1_execution_transactions_count_per_type_daily_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"date":{"type":"string","format":"date","description":"The specific calendar date for which the transaction data is aggregated."},"transaction_type":{"type":"string","description":"The category or type of API transaction being counted."},"value":{"type":"integer","description":"The number of successful transactions of the specified type on the given date."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/transactions_count_per_type/all_time":{"get":{"tags":["Execution"],"summary":"Transactions Count Per Type (all_time)","description":"**Required Access:** `tier0` (no API key required)\n\nThis view aggregates the total number of successful API transactions grouped by transaction type across all time, providing insights into transaction volume per category.\n\n**Columns:**\n- **transaction_type** (`String`): The category or type of API transaction being counted.\n- **value** (`UInt64`): The total count of successful transactions for the specified transaction type.\n- **as_of_date** (`Date`): Date the snapshot is computed as of (max date in the underlying data).","operationId":"api_execution_transactions_cnt_total_get_v1_execution_transactions_count_per_type_all_time_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"transaction_type":{"type":"string","description":"The category or type of API transaction being counted."},"value":{"type":"integer","description":"The total count of successful transactions for the specified transaction type."},"as_of_date":{"type":"string","format":"date","description":"Date the snapshot is computed as of (max date in the underlying data)."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/transactions_fees/last_7d":{"get":{"tags":["Execution"],"summary":"Transactions Fees (last_7d)","description":"**Required Access:** `tier0` (no API key required)\n\nThe api_execution_transactions_fees_native_7d model provides a snapshot of native transaction fees and their percentage change over the last 7 days, supporting analysis of fee trends and performance metrics.\n\n**Columns:**\n- **value** (`Float64`): The total amount of native transaction fees collected over the past 7 days.\n- **change_pct** (`Float64`): The percentage change in native transaction fees compared to the previous period.\n- **as_of_date** (`Date`): Date the snapshot is computed as of (max date in the underlying data).","operationId":"api_execution_transactions_fees_native_7d_get_v1_execution_transactions_fees_last_7d_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"value":{"type":"number","description":"The total amount of native transaction fees collected over the past 7 days."},"change_pct":{"type":"number","description":"The percentage change in native transaction fees compared to the previous period."},"as_of_date":{"type":"string","format":"date","description":"Date the snapshot is computed as of (max date in the underlying data)."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/transactions_fees/all_time":{"get":{"tags":["Execution"],"summary":"Transactions Fees (all_time)","description":"**Required Access:** `tier0` (no API key required)\n\nThe `api_execution_transactions_fees_native_total` model aggregates total native execution transaction fees over all time periods for analytical purposes, supporting business insights into fee accumulation.\n\n**Columns:**\n- **value** (`Float64`): The total amount of native execution transaction fees, represented as a numeric value, aggregated across all relevant transactions.\n- **as_of_date** (`Date`): Date the snapshot is computed as of (max date in the underlying data).","operationId":"api_execution_transactions_fees_native_total_get_v1_execution_transactions_fees_all_time_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"value":{"type":"number","description":"The total amount of native execution transaction fees, represented as a numeric value, aggregated across all relevant transactions."},"as_of_date":{"type":"string","format":"date","description":"Date the snapshot is computed as of (max date in the underlying data)."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/transactions_fees_per_project/all_time":{"get":{"tags":["Execution"],"summary":"Transactions Fees Per Project (all_time)","description":"**Required Access:** `tier0` (no API key required)\n\nThis view aggregates total native execution transaction fees per project over the entire available time span, enabling analysis of fee distribution across projects.\n\n**Columns:**\n- **label** (`String`): The category label, fixed as 'FeesNative', indicating the metric pertains to native transaction fees.\n- **value** (`Float64`): The total amount of native execution transaction fees accumulated across all projects, expressed as a numeric value.\n- **as_of_date** (`Date`): Date the snapshot is computed as of (max date in the underlying data).","operationId":"api_execution_transactions_fees_native_by_project_total_get_v1_execution_transactions_fees_per_project_all_time_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"label":{"type":"string","description":"The category label, fixed as 'FeesNative', indicating the metric pertains to native transaction fees."},"value":{"type":"number","description":"The total amount of native execution transaction fees accumulated across all projects, expressed as a numeric value."},"as_of_date":{"type":"string","format":"date","description":"Date the snapshot is computed as of (max date in the underlying data)."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/transactions_fees_per_project_top20/in_ranges":{"get":{"tags":["Execution"],"summary":"Transactions Fees Per Project Top20 (in_ranges)","description":"**Required Access:** `tier0` (no API key required)\n\nThis view aggregates the top 20 native API transaction fee buckets by project for different time ranges, providing insights into fee distribution and volume.\n\n**Columns:**\n- **window** (`String`): The time range for the data snapshot, such as 'All', '7D', '30D', or '90D'.\n- **bucket** (`String`): The specific fee range or category bucket for transactions.\n- **value** (`Float64`): The total sum of native API transaction fees within the specified bucket and time range.\n- **range** (`String`): Aggregation window (All, 7D, 30D, 90D).\n- **label** (`String`): Project label (or \"Others\").\n- **as_of_date** (`Date`): Date the snapshot is computed as of (max date in the underlying data).","operationId":"api_execution_transactions_fees_native_by_project_ranges_top20_get_v1_execution_transactions_fees_per_project_top20_in_ranges_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"window":{"type":"string","description":"The time range for the data snapshot, such as 'All', '7D', '30D', or '90D'."},"bucket":{"type":"string","description":"The specific fee range or category bucket for transactions."},"value":{"type":"number","description":"The total sum of native API transaction fees within the specified bucket and time range."},"range":{"type":"string","description":"Aggregation window (All, 7D, 30D, 90D)."},"label":{"type":"string","description":"Project label (or \"Others\")."},"as_of_date":{"type":"string","format":"date","description":"Date the snapshot is computed as of (max date in the underlying data)."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/transactions_fees_per_project_top5/monthly":{"get":{"tags":["Execution"],"summary":"Transactions Fees Per Project Top5 (monthly)","description":"**Required Access:** `tier1`\n\nThis view aggregates the top 5 projects by native transaction fees on a monthly basis, providing insights into fee distribution and trends over time.\n\n**Columns:**\n- **date** (`Date`): The month and year of the data point, formatted as YYYY-MM.\n- **label** (`String`): Identifier for the project or category associated with the fee data.\n- **value** (`Float64`): The total native transaction fees for the project in the specified month, in the relevant currency units.","operationId":"api_execution_transactions_fees_native_by_project_monthly_top5_get_v1_execution_transactions_fees_per_project_top5_monthly_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"date":{"type":"string","format":"date","description":"The month and year of the data point, formatted as YYYY-MM."},"label":{"type":"string","description":"Identifier for the project or category associated with the fee data."},"value":{"type":"number","description":"The total native transaction fees for the project in the specified month, in the relevant currency units."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/transactions_fees_per_sector/daily":{"get":{"tags":["Execution"],"summary":"Transactions Fees Per Sector (daily)","description":"**Required Access:** `tier1`\n\nThis view aggregates daily native transaction fees by sector, providing insights into sector-specific fee trends over time for operational and strategic analysis.\n\n**Columns:**\n- **date** (`Date`): The calendar date for the recorded transaction fees, formatted as YYYY-MM-DD.\n- **label** (`String`): The sector name associated with the transaction fees, serving as a categorical identifier.\n- **value** (`UInt64`): The total sum of native transaction fees for the sector on the given date, expressed in the relevant currency units.","operationId":"api_execution_transactions_fees_native_by_sector_daily_get_v1_execution_transactions_fees_per_sector_daily_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"date":{"type":"string","format":"date","description":"The calendar date for the recorded transaction fees, formatted as YYYY-MM-DD."},"label":{"type":"string","description":"The sector name associated with the transaction fees, serving as a categorical identifier."},"value":{"type":"integer","description":"The total sum of native transaction fees for the sector on the given date, expressed in the relevant currency units."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/transactions_fees_per_sector/weekly":{"get":{"tags":["Execution"],"summary":"Transactions Fees Per Sector (weekly)","description":"**Required Access:** `tier1`\n\nThis view aggregates native transaction fees by sector on a weekly basis to support analysis of fee trends across different industry sectors.\n\n**Columns:**\n- **date** (`Date`): The starting date of the week for which the transaction fees are aggregated, formatted as a date.\n- **label** (`String`): The name or identifier of the sector associated with the transaction fees.\n- **value** (`UInt64`): The total sum of native transaction fees for the sector during the specified week, in the relevant currency units.","operationId":"api_execution_transactions_fees_native_by_sector_weekly_get_v1_execution_transactions_fees_per_sector_weekly_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"date":{"type":"string","format":"date","description":"The starting date of the week for which the transaction fees are aggregated, formatted as a date."},"label":{"type":"string","description":"The name or identifier of the sector associated with the transaction fees."},"value":{"type":"integer","description":"The total sum of native transaction fees for the sector during the specified week, in the relevant currency units."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/transactions_fees_per_sector/hourly":{"get":{"tags":["Execution"],"summary":"Transactions Fees Per Sector (hourly)","description":"**Required Access:** `tier1`\n\nThis view aggregates native transaction fees by sector on an hourly basis, providing insights into fee distribution across different sectors over time.\n\n**Columns:**\n- **date** (`Date`): The specific hour for which the transaction fee data is aggregated, formatted as a timestamp.\n- **label** (`String`): The sector category associated with the transaction fees.\n- **value** (`UInt64`): The total sum of native transaction fees for the sector during the hour, rounded to two decimal places.","operationId":"api_execution_transactions_fees_native_by_sector_hourly_get_v1_execution_transactions_fees_per_sector_hourly_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"date":{"type":"string","format":"date","description":"The specific hour for which the transaction fee data is aggregated, formatted as a timestamp."},"label":{"type":"string","description":"The sector category associated with the transaction fees."},"value":{"type":"integer","description":"The total sum of native transaction fees for the sector during the hour, rounded to two decimal places."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/transactions_gas_share_per_project/daily":{"get":{"tags":["Execution"],"summary":"Transactions Gas Share Per Project (daily)","description":"**Required Access:** `tier1`\n\nThis view calculates the daily share of gas used by each project in relation to the total gas consumption across all projects, providing insights into project-specific gas usage patterns over time.\n\n**Columns:**\n- **date** (`Date`): The specific date for which the gas share data is recorded.\n- **day_gas_used** (`UInt64`): Total gas used across all projects on the given date, measured in gas units.\n- **label** (`String`): Project label or name associated with the transaction.\n- **value** (`Float64`): Percentage of gas share for the project on the given date, rounded to 2 decimal places.","operationId":"api_execution_transactions_gas_share_by_project_daily_get_v1_execution_transactions_gas_share_per_project_daily_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"date":{"type":"string","format":"date","description":"The specific date for which the gas share data is recorded."},"day_gas_used":{"type":"integer","description":"Total gas used across all projects on the given date, measured in gas units."},"label":{"type":"string","description":"Project label or name associated with the transaction."},"value":{"type":"number","description":"Percentage of gas share for the project on the given date, rounded to 2 decimal places."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/transactions_gas_used/daily":{"get":{"tags":["Execution"],"summary":"Transactions Gas Used (daily)","description":"**Required Access:** `tier1`\n\nThis view aggregates daily gas consumption and pricing metrics for successful API transaction executions, facilitating performance and cost analysis at a daily granularity.\n\n**Columns:**\n- **date** (`Date`): The calendar date for the recorded transaction data.\n- **transaction_type** (`String`): The category or type of API transaction performed on the given date.\n- **gas_used** (`UInt64`): Total amount of gas consumed by transactions of the specified type on that date, measured in units of gas.\n- **gas_price_avg** (`Float64`): Average gas price (e.g., in gwei) paid during transactions of the specified type on that date.\n- **gas_price_median** (`Float64`): Median gas price (e.g., in gwei) paid during transactions of the specified type on that date.","operationId":"api_execution_transactions_gas_used_daily_get_v1_execution_transactions_gas_used_daily_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"date":{"type":"string","format":"date","description":"The calendar date for the recorded transaction data."},"transaction_type":{"type":"string","description":"The category or type of API transaction performed on the given date."},"gas_used":{"type":"integer","description":"Total amount of gas consumed by transactions of the specified type on that date, measured in units of gas."},"gas_price_avg":{"type":"number","description":"Average gas price (e.g., in gwei) paid during transactions of the specified type on that date."},"gas_price_median":{"type":"number","description":"Median gas price (e.g., in gwei) paid during transactions of the specified type on that date."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/transactions_gas_used/weekly":{"get":{"tags":["Execution"],"summary":"Transactions Gas Used (weekly)","description":"**Required Access:** `tier1`\n\nThis view aggregates weekly gas usage for successful API transactions, categorized by transaction type, to support performance and cost analysis over time.\n\n**Columns:**\n- **date** (`DateTime64`): The starting date of the week for which the gas usage data is aggregated.\n- **label** (`String`): The transaction type or category associated with the gas usage.\n- **gas_price_avg** (`UInt64`): The average gas price (in wei) during the week for successful transactions, if included.\n- **gas_price_median** (`Float64`): The median gas price (in wei) during the week for successful transactions, if included.\n- **value** (`UInt64`): Total gas used in transactions on this date.","operationId":"api_execution_transactions_gas_used_weekly_get_v1_execution_transactions_gas_used_weekly_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"date":{"type":"string","format":"date-time","description":"The starting date of the week for which the gas usage data is aggregated."},"label":{"type":"string","description":"The transaction type or category associated with the gas usage."},"gas_price_avg":{"type":"integer","description":"The average gas price (in wei) during the week for successful transactions, if included."},"gas_price_median":{"type":"number","description":"The median gas price (in wei) during the week for successful transactions, if included."},"value":{"type":"integer","description":"Total gas used in transactions on this date."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/transactions_initiators_count/daily":{"get":{"tags":["Execution"],"summary":"Transactions Initiators Count (daily)","description":"**Required Access:** `tier1`\n\nDaily unique initiator accounts on Gnosis Chain. Uses bitmap merge for accurate deduplication — no double-counting across sectors or projects.\n\n**Columns:**\n- **date** (`Date`): The calendar date.\n- **value** (`UInt64`): True unique count of addresses that initiated at least one transaction on this date.","operationId":"api_execution_transactions_active_accounts_daily_get_v1_execution_transactions_initiators_count_daily_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"date":{"type":"string","format":"date","description":"The calendar date."},"value":{"type":"integer","description":"True unique count of addresses that initiated at least one transaction on this date."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/transactions_initiators_count/last_7d":{"get":{"tags":["Execution"],"summary":"Transactions Initiators Count (last_7d)","description":"**Required Access:** `tier0` (no API key required)\n\nThis view provides a snapshot of the number of active accounts involved in API transactions over the last 7 days, enabling monitoring of account engagement trends.\n\n**Columns:**\n- **value** (`Float64`): The total count of active accounts within the last 7 days.\n- **change_pct** (`Float64`): The percentage change in active accounts compared to the previous period.\n- **as_of_date** (`Date`): Date the snapshot is computed as of (max date in the underlying data).","operationId":"api_execution_transactions_active_accounts_7d_get_v1_execution_transactions_initiators_count_last_7d_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"value":{"type":"number","description":"The total count of active accounts within the last 7 days."},"change_pct":{"type":"number","description":"The percentage change in active accounts compared to the previous period."},"as_of_date":{"type":"string","format":"date","description":"Date the snapshot is computed as of (max date in the underlying data)."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/transactions_initiators_count/all_time":{"get":{"tags":["Execution"],"summary":"Transactions Initiators Count (all_time)","description":"**Required Access:** `tier0` (no API key required)\n\nThe `api_execution_transactions_active_accounts_total` model provides a snapshot of the total number of active accounts involved in API execution transactions over all time, supporting business insights into account engagement levels.\n\n**Columns:**\n- **value** (`Float64`): The total count of active accounts involved in API execution transactions, representing a numeric value at a specific point in time.\n- **as_of_date** (`Date`): Date the snapshot is computed as of (max date in the underlying data).","operationId":"api_execution_transactions_active_accounts_total_get_v1_execution_transactions_initiators_count_all_time_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"value":{"type":"number","description":"The total count of active accounts involved in API execution transactions, representing a numeric value at a specific point in time."},"as_of_date":{"type":"string","format":"date","description":"Date the snapshot is computed as of (max date in the underlying data)."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/transactions_initiators_count_per_project/all_time":{"get":{"tags":["Execution"],"summary":"Transactions Initiators Count Per Project (all_time)","description":"**Required Access:** `tier0` (no API key required)\n\nThis view provides a snapshot of the total number of active accounts involved in API execution transactions across all projects, aggregated over the entire time period.\n\n**Columns:**\n- **label** (`String`): A categorical label indicating the metric type, here representing 'ActiveAccounts'.\n- **value** (`Float64`): The total count of active accounts engaged in API execution transactions, representing an aggregate number.\n- **as_of_date** (`Date`): Date the snapshot is computed as of (max date in the underlying data).","operationId":"api_execution_transactions_active_accounts_by_project_total_get_v1_execution_transactions_initiators_count_per_project_all_time_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"label":{"type":"string","description":"A categorical label indicating the metric type, here representing 'ActiveAccounts'."},"value":{"type":"number","description":"The total count of active accounts engaged in API execution transactions, representing an aggregate number."},"as_of_date":{"type":"string","format":"date","description":"Date the snapshot is computed as of (max date in the underlying data)."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/transactions_initiators_count_per_project_top20/in_ranges":{"get":{"tags":["Execution"],"summary":"Transactions Initiators Count Per Project Top20 (in_ranges)","description":"**Required Access:** `tier0` (no API key required)\n\nThis model identifies the top 20 project ranges with the highest number of active accounts over different time windows, aggregating smaller ranges into an 'Others' category for analysis.\n\n**Columns:**\n- **window** (`String`): The time window for the snapshot, such as 'All', '7D', '30D', or '90D', indicating the period over which active accounts are measured.\n- **bucket** (`String`): A specific range or category representing a subset of active accounts, used for segmentation within each time window.\n- **value** (`Float64`): The count of active accounts within the specified bucket and time window, represented as a floating-point number.\n- **range** (`String`): Aggregation window (All, 7D, 30D, 90D).\n- **label** (`String`): Project label (or \"Others\").\n- **as_of_date** (`Date`): Date the snapshot is computed as of (max date in the underlying data).","operationId":"api_execution_transactions_active_accounts_by_project_ranges_top20_get_v1_execution_transactions_initiators_count_per_project_top20_in_ranges_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"window":{"type":"string","description":"The time window for the snapshot, such as 'All', '7D', '30D', or '90D', indicating the period over which active accounts are measured."},"bucket":{"type":"string","description":"A specific range or category representing a subset of active accounts, used for segmentation within each time window."},"value":{"type":"number","description":"The count of active accounts within the specified bucket and time window, represented as a floating-point number."},"range":{"type":"string","description":"Aggregation window (All, 7D, 30D, 90D)."},"label":{"type":"string","description":"Project label (or \"Others\")."},"as_of_date":{"type":"string","format":"date","description":"Date the snapshot is computed as of (max date in the underlying data)."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/transactions_initiators_count_per_project_top5/monthly":{"get":{"tags":["Execution"],"summary":"Transactions Initiators Count Per Project Top5 (monthly)","description":"**Required Access:** `tier1`\n\nThis view aggregates the number of active accounts involved in API execution transactions, focusing on the top 5 projects on a monthly basis to support performance and usage analysis.\n\n**Columns:**\n- **date** (`Date`): The month and year for the recorded metrics, formatted as YYYY-MM.\n- **label** (`String`): Identifier for the project or category associated with the active accounts, typically representing project names or labels.\n- **value** (`Float64`): The count of active accounts for the specified project and month.","operationId":"api_execution_transactions_active_accounts_by_project_monthly_top5_get_v1_execution_transactions_initiators_count_per_project_top5_monthly_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"date":{"type":"string","format":"date","description":"The month and year for the recorded metrics, formatted as YYYY-MM."},"label":{"type":"string","description":"Identifier for the project or category associated with the active accounts, typically representing project names or labels."},"value":{"type":"number","description":"The count of active accounts for the specified project and month."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/transactions_initiators_count_per_sector/daily":{"get":{"tags":["Execution"],"summary":"Transactions Initiators Count Per Sector (daily)","description":"**Required Access:** `tier1`\n\nThis view provides daily counts of active accounts involved in API transaction initiations, segmented by sector, to monitor sector-specific activity trends over time.\n\n**Columns:**\n- **date** (`Date`): The date of the recorded transaction activity, formatted as YYYY-MM-DD.\n- **label** (`String`): The sector name associated with the transaction activity.\n- **value** (`UInt64`): The number of unique active accounts for the given sector on the specified date.","operationId":"api_execution_transactions_active_accounts_by_sector_daily_get_v1_execution_transactions_initiators_count_per_sector_daily_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"date":{"type":"string","format":"date","description":"The date of the recorded transaction activity, formatted as YYYY-MM-DD."},"label":{"type":"string","description":"The sector name associated with the transaction activity."},"value":{"type":"integer","description":"The number of unique active accounts for the given sector on the specified date."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/transactions_initiators_count_per_sector/weekly":{"get":{"tags":["Execution"],"summary":"Transactions Initiators Count Per Sector (weekly)","description":"**Required Access:** `tier1`\n\nThis view provides weekly counts of active accounts involved in API execution transactions, segmented by sector, to support monitoring and analysis of transaction activity across different business sectors.\n\n**Columns:**\n- **date** (`Date`): The starting date of the week for which the data is aggregated, formatted as a date.\n- **label** (`String`): The sector name associated with the transaction activity.\n- **value** (`UInt64`): The number of active accounts engaged in API execution transactions during the specified week.","operationId":"api_execution_transactions_active_accounts_by_sector_weekly_get_v1_execution_transactions_initiators_count_per_sector_weekly_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"date":{"type":"string","format":"date","description":"The starting date of the week for which the data is aggregated, formatted as a date."},"label":{"type":"string","description":"The sector name associated with the transaction activity."},"value":{"type":"integer","description":"The number of active accounts engaged in API execution transactions during the specified week."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/transactions_initiators_count_per_sector/hourly":{"get":{"tags":["Execution"],"summary":"Transactions Initiators Count Per Sector (hourly)","description":"**Required Access:** `tier1`\n\nThis view aggregates the count of active accounts involved in API execution transactions, segmented by sector and hourly granularity for performance monitoring and analysis.\n\n**Columns:**\n- **date** (`Date`): The specific hour timestamp representing the time window of the data, in UTC.\n- **label** (`String`): The sector label categorizing the accounts based on their business sector.\n- **value** (`UInt64`): A bitmap-encoded count of unique active accounts within each sector for the given hour.","operationId":"api_execution_transactions_active_accounts_by_sector_hourly_get_v1_execution_transactions_initiators_count_per_sector_hourly_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"date":{"type":"string","format":"date","description":"The specific hour timestamp representing the time window of the data, in UTC."},"label":{"type":"string","description":"The sector label categorizing the accounts based on their business sector."},"value":{"type":"integer","description":"A bitmap-encoded count of unique active accounts within each sector for the given hour."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/transactions_xdai_value/daily":{"get":{"tags":["Execution"],"summary":"Transactions Xdai Value (daily)","description":"**Required Access:** `tier1`\n\nThis view aggregates daily transaction values for API executions on the xDai network, providing insights into transaction volume and value metrics for operational analysis.\n\n**Columns:**\n- **date** (`Date`): The calendar date for the transaction data, formatted as YYYY-MM-DD.\n- **transaction_type** (`String`): The category or type of transaction processed on that date.\n- **xdai_value** (`Float64`): The total value of successful transactions in xDai units for the given date and transaction type.\n- **xdai_value_avg** (`Float64`): The average transaction value in xDai for successful transactions on that date and type.\n- **xdai_value_median** (`Float64`): The median transaction value in xDai for successful transactions on that date and type.","operationId":"api_execution_transactions_value_daily_get_v1_execution_transactions_xdai_value_daily_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"date":{"type":"string","format":"date","description":"The calendar date for the transaction data, formatted as YYYY-MM-DD."},"transaction_type":{"type":"string","description":"The category or type of transaction processed on that date."},"xdai_value":{"type":"number","description":"The total value of successful transactions in xDai units for the given date and transaction type."},"xdai_value_avg":{"type":"number","description":"The average transaction value in xDai for successful transactions on that date and type."},"xdai_value_median":{"type":"number","description":"The median transaction value in xDai for successful transactions on that date and type."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/yields_opportunities/latest":{"get":{"tags":["Execution"],"summary":"Yields Opportunities (latest)","description":"**Required Access:** `tier1`\n\nThin API view over fct_execution_yields_opportunities_latest, sorted by\nyield_apr/yield_apy descending. Powers the yields opportunities table on\nthe yields dashboard (lending markets and LP pools side-by-side).\n\n\n**Columns:**\n- **type** (`String`): 'LP' or 'Lending'.\n- **token** (`String`): Base token symbol (e.g. WETH, USDC.e).\n- **name** (`String`): Display name. For LPs the pair and address suffix; for lending the token symbol.\n- **address** (`String`): Contract address. For LPs the pool contract; for lending the reserve token contract. Used for Blockscout links.\n- **pool_key** (`Nullable(String)`): Exact full pool label for LP opportunities, matching the labels used by pool-filtered metrics. NULL for lending markets.\n- **rate_trend_14d** (`Array(Float64)`): Last 14 daily yield points ordered oldest to newest. LP rows use fee_apr_7d; lending rows use supply APY.\n- **yield_apr** (`Nullable(Float64)`): Fee APR (LP rows).\n- **yield_apy** (`Nullable(Float64)`): Supply APY (lending rows).\n- **borrow_apy** (`Nullable(Float64)`): Variable borrow APY (lending only, NULL for LPs).\n- **tvl** (`Nullable(Float64)`): Total value locked in USD (LP pools only, NULL for lending).\n- **total_supplied** (`Nullable(Float64)`): Total supplied in USD (lending only, NULL for LPs). Sum of all deposit positions.\n- **total_borrowed** (`Nullable(Float64)`): Total borrowed in USD (lending only, NULL for LPs). Derived from total_supplied * utilization_rate / 100.\n- **fees_7d** (`Nullable(Float64)`): Fees accrued over the last 7 days in USD (LP only, NULL for lending).\n- **volume_usd_7d** (`Nullable(Float64)`): Total trading volume in USD over the last 7 days (LP only, NULL for lending).\n- **net_apr_7d** (`Nullable(Float64)`): Net APR after LVR (fee_apr_7d + lvr_apr_7d). LP only, NULL for lending.\n- **utilization_rate** (`Nullable(Float64)`): Lending utilization rate as a percentage (total_borrows / total_supply * 100). Lending only, NULL for LPs.\n- **protocol** (`String`): Protocol name (e.g. Uniswap V3, Swapr V3, Aave V3).\n- **fee_pct** (`Nullable(Float64)`): Pool swap fee as a percentage (e.g. 0.3 = 0.3%). Static for Uniswap V3, latest dynamic fee for Swapr V3 and Balancer V3. NULL for lending markets.\n- **as_of_date** (`Date`): Date the snapshot is computed as of (max date in the underlying data).","operationId":"api_execution_yields_opportunities_latest_get_v1_execution_yields_opportunities_latest_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"type":{"type":"string","description":"'LP' or 'Lending'."},"token":{"type":"string","description":"Base token symbol (e.g. WETH, USDC.e)."},"name":{"type":"string","description":"Display name. For LPs the pair and address suffix; for lending the token symbol."},"address":{"type":"string","description":"Contract address. For LPs the pool contract; for lending the reserve token contract. Used for Blockscout links."},"pool_key":{"type":"string","description":"Exact full pool label for LP opportunities, matching the labels used by pool-filtered metrics. NULL for lending markets."},"rate_trend_14d":{"items":{"type":"number"},"type":"array","description":"Last 14 daily yield points ordered oldest to newest. LP rows use fee_apr_7d; lending rows use supply APY."},"yield_apr":{"type":"number","description":"Fee APR (LP rows)."},"yield_apy":{"type":"number","description":"Supply APY (lending rows)."},"borrow_apy":{"type":"number","description":"Variable borrow APY (lending only, NULL for LPs)."},"tvl":{"type":"number","description":"Total value locked in USD (LP pools only, NULL for lending)."},"total_supplied":{"type":"number","description":"Total supplied in USD (lending only, NULL for LPs). Sum of all deposit positions."},"total_borrowed":{"type":"number","description":"Total borrowed in USD (lending only, NULL for LPs). Derived from total_supplied * utilization_rate / 100."},"fees_7d":{"type":"number","description":"Fees accrued over the last 7 days in USD (LP only, NULL for lending)."},"volume_usd_7d":{"type":"number","description":"Total trading volume in USD over the last 7 days (LP only, NULL for lending)."},"net_apr_7d":{"type":"number","description":"Net APR after LVR (fee_apr_7d + lvr_apr_7d). LP only, NULL for lending."},"utilization_rate":{"type":"number","description":"Lending utilization rate as a percentage (total_borrows / total_supply * 100). Lending only, NULL for LPs."},"protocol":{"type":"string","description":"Protocol name (e.g. Uniswap V3, Swapr V3, Aave V3)."},"fee_pct":{"type":"number","description":"Pool swap fee as a percentage (e.g. 0.3 = 0.3%). Static for Uniswap V3, latest dynamic fee for Swapr V3 and Balancer V3. NULL for lending markets."},"as_of_date":{"type":"string","format":"date","description":"Date the snapshot is computed as of (max date in the underlying data)."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/yields_overview_lending_best_apy/latest":{"get":{"tags":["Execution"],"summary":"Yields Overview Lending Best Apy (latest)","description":"**Required Access:** `tier1`\n\nOverview KPI card for the best lending supply APY currently available (with the token symbol as label) and 7-day change.\n\n**Columns:**\n- **value** (`Float64`): Best supply APY as a percentage.\n- **change_pct** (`Nullable(Float64)`): Percent change vs the value 7 days earlier.\n- **label** (`Nullable(String)`): Token symbol offering the best APY.\n- **as_of_date** (`Date`): Date the snapshot is computed as of (max date in the underlying data).","operationId":"api_execution_yields_overview_lending_best_apy_get_v1_execution_yields_overview_lending_best_apy_latest_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"value":{"type":"number","description":"Best supply APY as a percentage."},"change_pct":{"type":"number","description":"Percent change vs the value 7 days earlier."},"label":{"type":"string","description":"Token symbol offering the best APY."},"as_of_date":{"type":"string","format":"date","description":"Date the snapshot is computed as of (max date in the underlying data)."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/yields_overview_lending_lenders/latest":{"get":{"tags":["Execution"],"summary":"Yields Overview Lending Lenders (latest)","description":"**Required Access:** `tier1`\n\nOverview KPI card for total distinct Aave V3 lenders on Gnosis with 7-day change percentage.\n\n**Columns:**\n- **value** (`Float64`): Total distinct Aave V3 lenders (latest).\n- **change_pct** (`Nullable(Float64)`): Percent change vs the value 7 days earlier.\n- **label** (`Nullable(String)`): Optional display label for the metric.\n- **as_of_date** (`Date`): Date the snapshot is computed as of (max date in the underlying data).","operationId":"api_execution_yields_overview_lending_lenders_get_v1_execution_yields_overview_lending_lenders_latest_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"value":{"type":"number","description":"Total distinct Aave V3 lenders (latest)."},"change_pct":{"type":"number","description":"Percent change vs the value 7 days earlier."},"label":{"type":"string","description":"Optional display label for the metric."},"as_of_date":{"type":"string","format":"date","description":"Date the snapshot is computed as of (max date in the underlying data)."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/yields_overview_lending_tvl/latest":{"get":{"tags":["Execution"],"summary":"Yields Overview Lending Tvl (latest)","description":"**Required Access:** `tier1`\n\nOverview KPI card for total Aave V3 lending TVL with 7-day change percentage.\n\n**Columns:**\n- **value** (`Float64`): Total Aave V3 lending TVL in USD (latest).\n- **change_pct** (`Float64`): Percent change vs the value 7 days earlier.\n- **label** (`String`): Optional display label for the metric.\n- **as_of_date** (`Date`): Date the snapshot is computed as of (max date in the underlying data).","operationId":"api_execution_yields_overview_lending_tvl_get_v1_execution_yields_overview_lending_tvl_latest_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"value":{"type":"number","description":"Total Aave V3 lending TVL in USD (latest)."},"change_pct":{"type":"number","description":"Percent change vs the value 7 days earlier."},"label":{"type":"string","description":"Optional display label for the metric."},"as_of_date":{"type":"string","format":"date","description":"Date the snapshot is computed as of (max date in the underlying data)."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/yields_overview_lp_best_apr/latest":{"get":{"tags":["Execution"],"summary":"Yields Overview Lp Best Apr (latest)","description":"**Required Access:** `tier1`\n\nOverview KPI card for the best LP fee APR currently available (with the pool name as label) and 7-day change.\n\n**Columns:**\n- **value** (`Float64`): Best LP fee APR as a percentage.\n- **change_pct** (`Nullable(Float64)`): Percent change vs the value 7 days earlier.\n- **label** (`Nullable(String)`): Display name of the pool with the best APR.\n- **as_of_date** (`Date`): Date the snapshot is computed as of (max date in the underlying data).","operationId":"api_execution_yields_overview_lp_best_apr_get_v1_execution_yields_overview_lp_best_apr_latest_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"value":{"type":"number","description":"Best LP fee APR as a percentage."},"change_pct":{"type":"number","description":"Percent change vs the value 7 days earlier."},"label":{"type":"string","description":"Display name of the pool with the best APR."},"as_of_date":{"type":"string","format":"date","description":"Date the snapshot is computed as of (max date in the underlying data)."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/yields_overview_lp_tvl/latest":{"get":{"tags":["Execution"],"summary":"Yields Overview Lp Tvl (latest)","description":"**Required Access:** `tier1`\n\nOverview KPI card for total LP TVL across Uniswap V3, Swapr V3, Balancer V2/V3 on Gnosis with 7-day change.\n\n**Columns:**\n- **value** (`Float64`): Total LP TVL in USD across all tracked DEX protocols (latest).\n- **change_pct** (`Nullable(Float64)`): Percent change vs the value 7 days earlier.\n- **label** (`Nullable(String)`): Optional display label for the metric.\n- **as_of_date** (`Date`): Date the snapshot is computed as of (max date in the underlying data).","operationId":"api_execution_yields_overview_lp_tvl_get_v1_execution_yields_overview_lp_tvl_latest_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"value":{"type":"number","description":"Total LP TVL in USD across all tracked DEX protocols (latest)."},"change_pct":{"type":"number","description":"Percent change vs the value 7 days earlier."},"label":{"type":"string","description":"Optional display label for the metric."},"as_of_date":{"type":"string","format":"date","description":"Date the snapshot is computed as of (max date in the underlying data)."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/yields_overview_sdai_apy/latest":{"get":{"tags":["Execution"],"summary":"Yields Overview Sdai Apy (latest)","description":"**Required Access:** `tier1`\n\nOverview KPI card for Savings xDAI (sDAI) APY with 7-day change percentage.\n\n**Columns:**\n- **value** (`Float64`): Current Savings xDAI (sDAI) APY as a percentage.\n- **change_pct** (`Nullable(Float64)`): Percent change vs the value 7 days earlier.\n- **label** (`Nullable(String)`): Optional display label for the metric.\n- **as_of_date** (`Date`): Date the snapshot is computed as of (max date in the underlying data).","operationId":"api_execution_yields_overview_sdai_apy_get_v1_execution_yields_overview_sdai_apy_latest_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"value":{"type":"number","description":"Current Savings xDAI (sDAI) APY as a percentage."},"change_pct":{"type":"number","description":"Percent change vs the value 7 days earlier."},"label":{"type":"string","description":"Optional display label for the metric."},"as_of_date":{"type":"string","format":"date","description":"Date the snapshot is computed as of (max date in the underlying data)."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/yields_overview_sdai_supply/latest":{"get":{"tags":["Execution"],"summary":"Yields Overview Sdai Supply (latest)","description":"**Required Access:** `tier1`\n\nOverview KPI card for total sDAI supply with 7-day change percentage.\n\n**Columns:**\n- **value** (`Float64`): Total Savings xDAI (sDAI) supply (latest).\n- **change_pct** (`Nullable(Float64)`): Percent change vs the value 7 days earlier.\n- **label** (`Nullable(String)`): Optional display label for the metric.\n- **as_of_date** (`Date`): Date the snapshot is computed as of (max date in the underlying data).","operationId":"api_execution_yields_overview_sdai_supply_get_v1_execution_yields_overview_sdai_supply_latest_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"value":{"type":"number","description":"Total Savings xDAI (sDAI) supply (latest)."},"change_pct":{"type":"number","description":"Percent change vs the value 7 days earlier."},"label":{"type":"string","description":"Optional display label for the metric."},"as_of_date":{"type":"string","format":"date","description":"Date the snapshot is computed as of (max date in the underlying data)."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/yields_user_activity/latest":{"get":{"tags":["Execution"],"summary":"Yields User Activity (latest)","description":"**Required Access:** `tier1`\n\nPer-event user activity feed across LP and lending positions (deposits,\nwithdrawals, fee collections, supply/repay, etc.). One row per on-chain\naction. Sourced from int_execution_yields_user_activity.\n\n\n**Columns:**\n- **block_timestamp** (`DateTime`): UTC timestamp of the on-chain LP or lending event.\n- **date** (`Date`): Calendar day of the event (derived from block_timestamp).\n- **transaction_hash** (`String`): Transaction hash of the event.\n- **protocol** (`String`): Protocol name — a DEX (Uniswap V3, Swapr V3, Balancer) for LP events or a lending market (Aave V3, SparkLend) for lending events.\n- **position_address** (`String`): Pool or reserve address depending on the action type.\n- **wallet_address** (`String`): Wallet address that performed the action.\n- **action** (`String`): Action label (e.g. 'Deposit', 'Withdraw', 'CollectFees', 'Supply', 'Repay').\n- **token_symbol** (`String`): Token symbol of the amount moved.\n- **token_address** (`String`): Token address of the amount moved (for lending, the reserve address).\n- **amount** (`Float64`): Action amount in native units.\n- **amount_usd** (`Nullable(Float64)`): Action amount in USD (NULL when pricing is unavailable).\n- **source** (`String`): Source model identifier — distinguishes LP vs lending events.","operationId":"api_execution_yields_user_activity_get_v1_execution_yields_user_activity_latest_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"block_timestamp":{"type":"string","format":"date-time","description":"UTC timestamp of the on-chain LP or lending event."},"date":{"type":"string","format":"date","description":"Calendar day of the event (derived from block_timestamp)."},"transaction_hash":{"type":"string","description":"Transaction hash of the event."},"protocol":{"type":"string","description":"Protocol name — a DEX (Uniswap V3, Swapr V3, Balancer) for LP events or a lending market (Aave V3, SparkLend) for lending events."},"position_address":{"type":"string","description":"Pool or reserve address depending on the action type."},"wallet_address":{"type":"string","description":"Wallet address that performed the action."},"action":{"type":"string","description":"Action label (e.g. 'Deposit', 'Withdraw', 'CollectFees', 'Supply', 'Repay')."},"token_symbol":{"type":"string","description":"Token symbol of the amount moved."},"token_address":{"type":"string","description":"Token address of the amount moved (for lending, the reserve address)."},"amount":{"type":"number","description":"Action amount in native units."},"amount_usd":{"type":"number","description":"Action amount in USD (NULL when pricing is unavailable)."},"source":{"type":"string","description":"Source model identifier — distinguishes LP vs lending events."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/yields_user_fee_collections/daily":{"get":{"tags":["Execution"],"summary":"Yields User Fee Collections (daily)","description":"**Required Access:** `tier1`\n\nThin API view over fct_execution_yields_user_fee_collections_daily — per-day, per-pool LP fee collection amounts for the user portfolio fee-income chart.\n\n**Columns:**\n- **date** (`Date`): Calendar day of the fee collections.\n- **provider** (`String`): LP wallet address that collected the fees.\n- **pool_address** (`String`): Pool contract address the fees were collected from.\n- **protocol** (`String`): DEX protocol name (Uniswap V3, Swapr V3, Balancer).\n- **fees_usd** (`Float64`): Total fees collected in USD on this day for this position.","operationId":"api_execution_yields_user_fee_collections_daily_get_v1_execution_yields_user_fee_collections_daily_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"date":{"type":"string","format":"date","description":"Calendar day of the fee collections."},"provider":{"type":"string","description":"LP wallet address that collected the fees."},"pool_address":{"type":"string","description":"Pool contract address the fees were collected from."},"protocol":{"type":"string","description":"DEX protocol name (Uniswap V3, Swapr V3, Balancer)."},"fees_usd":{"type":"number","description":"Total fees collected in USD on this day for this position."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/yields_user_kpis/all_time":{"get":{"tags":["Execution"],"summary":"Yields User Kpis (all_time)","description":"**Required Access:** `tier1`\n\nThin API view over fct_execution_yields_user_lifetime_metrics for the\n\"user portfolio KPIs\" widget. One row per wallet across LP and lending\npositions.\n\n\n**Columns:**\n- **wallet_address** (`String`): Wallet address (LP provider and/or lending user).\n- **total_lp_fees_usd** (`Float64`): Lifetime LP fees collected in USD across all pools.\n- **total_lending_balance_usd** (`Float64`): Current total lending supply balance in USD.\n- **active_lp_positions** (`UInt64`): Count of currently active LP positions.\n- **in_range_positions** (`UInt64`): Count of active V3 LP positions where current tick is within range.\n- **out_of_range_positions** (`UInt64`): Count of active V3 LP positions where current tick is outside range.\n- **active_lending_positions** (`UInt64`): Count of Aave V3 reserves with positive balance.\n- **first_yield_date** (`DateTime`): Earliest interaction with any yield source.\n- **tenure_days** (`Int64`): Days since first yield interaction.\n- **as_of_date** (`Date`): Date the snapshot is computed as of (max date in the underlying data).","operationId":"api_execution_yields_user_kpis_get_v1_execution_yields_user_kpis_all_time_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"wallet_address":{"type":"string","description":"Wallet address (LP provider and/or lending user)."},"total_lp_fees_usd":{"type":"number","description":"Lifetime LP fees collected in USD across all pools."},"total_lending_balance_usd":{"type":"number","description":"Current total lending supply balance in USD."},"active_lp_positions":{"type":"integer","description":"Count of currently active LP positions."},"in_range_positions":{"type":"integer","description":"Count of active V3 LP positions where current tick is within range."},"out_of_range_positions":{"type":"integer","description":"Count of active V3 LP positions where current tick is outside range."},"active_lending_positions":{"type":"integer","description":"Count of Aave V3 reserves with positive balance."},"first_yield_date":{"type":"string","format":"date-time","description":"Earliest interaction with any yield source."},"tenure_days":{"type":"integer","description":"Days since first yield interaction."},"as_of_date":{"type":"string","format":"date","description":"Date the snapshot is computed as of (max date in the underlying data)."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/yields_user_lending_balances/daily":{"get":{"tags":["Execution"],"summary":"Yields User Lending Balances (daily)","description":"**Required Access:** `tier1`\n\nDaily supply balance series per (user, reserve) across Aave V3. Rounded\nto 6 native decimals and 2 USD decimals for display. Sourced from\nint_execution_lending_aave_user_balances_daily.\n\n\n**Columns:**\n- **date** (`Date`): Calendar day of the supply balance snapshot.\n- **user_address** (`String`): Address of the aToken holder (lending user).\n- **reserve_address** (`String`): Address of the underlying reserve token.\n- **symbol** (`String`): Reserve token symbol from lending_market_mapping.\n- **balance** (`Float64`): Supply balance in native units.\n- **balance_usd** (`Float64`): Supply balance in USD.","operationId":"api_execution_yields_user_lending_balances_daily_get_v1_execution_yields_user_lending_balances_daily_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"date":{"type":"string","format":"date","description":"Calendar day of the supply balance snapshot."},"user_address":{"type":"string","description":"Address of the aToken holder (lending user)."},"reserve_address":{"type":"string","description":"Address of the underlying reserve token."},"symbol":{"type":"string","description":"Reserve token symbol from lending_market_mapping."},"balance":{"type":"number","description":"Supply balance in native units."},"balance_usd":{"type":"number","description":"Supply balance in USD."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/yields_user_lending_positions/latest":{"get":{"tags":["Execution"],"summary":"Yields User Lending Positions (latest)","description":"**Required Access:** `tier1`\n\nThin API view over fct_execution_yields_user_lending_positions_latest — current Aave V3 lending positions per user with supply APY.\n\n**Columns:**\n- **user_address** (`String`): Address of the aToken holder (lending user).\n- **reserve_address** (`String`): Address of the underlying reserve token.\n- **symbol** (`String`): Reserve token symbol from lending_market_mapping.\n- **balance** (`Float64`): Current supply balance in native token units.\n- **balance_usd** (`Float64`): Current supply balance in USD.\n- **supply_apy** (`Nullable(Float64)`): Current supply APY from fct_execution_yields_opportunities_latest.\n- **protocol** (`String`): Lending protocol name (Aave V3 or SparkLend).\n- **as_of_date** (`Date`): Date the snapshot is computed as of (max date in the underlying data).","operationId":"api_execution_yields_user_lending_positions_get_v1_execution_yields_user_lending_positions_latest_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"user_address":{"type":"string","description":"Address of the aToken holder (lending user)."},"reserve_address":{"type":"string","description":"Address of the underlying reserve token."},"symbol":{"type":"string","description":"Reserve token symbol from lending_market_mapping."},"balance":{"type":"number","description":"Current supply balance in native token units."},"balance_usd":{"type":"number","description":"Current supply balance in USD."},"supply_apy":{"type":"number","description":"Current supply APY from fct_execution_yields_opportunities_latest."},"protocol":{"type":"string","description":"Lending protocol name (Aave V3 or SparkLend)."},"as_of_date":{"type":"string","format":"date","description":"Date the snapshot is computed as of (max date in the underlying data)."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/yields_user_lp_positions/latest":{"get":{"tags":["Execution"],"summary":"Yields User Lp Positions (latest)","description":"**Required Access:** `tier1`\n\nCurrent LP positions per wallet across Uniswap V3, Swapr V3, and Balancer\nV2/V3. One row per (provider, pool_address[, tick_range]) with capital\nflows, fees collected, and in-range status. Sourced from\nint_execution_yields_user_lp_positions.\n\n\n**Columns:**\n- **provider** (`String`): LP provider wallet address.\n- **pool_address** (`String`): Pool contract address (lowercase, with 0x prefix).\n- **protocol** (`String`): DEX protocol name (Uniswap V3, Swapr V3, Balancer V2, Balancer V3).\n- **tick_lower** (`Nullable(Int64)`): V3 lower tick (NULL for non-V3 pools).\n- **tick_upper** (`Nullable(Int64)`): V3 upper tick (NULL for non-V3 pools).\n- **capital_in_usd** (`Float64`): Cumulative USD value of deposits into the position.\n- **capital_out_usd** (`Float64`): Cumulative USD value of withdrawals from the position.\n- **fees_collected_usd** (`Float64`): Cumulative LP fees collected in USD.\n- **is_active** (`UInt8`): 1 if the position currently holds liquidity.\n- **is_in_range** (`Nullable(UInt8)`): 1 if pool current tick is within [tick_lower, tick_upper] (V3 only).\n- **pool_current_tick** (`Nullable(Int64)`): Latest tick from Swap events on this pool (V3 only). NULL if no swaps recorded.\n- **has_unpriced_tokens** (`UInt8`): 1 if at least one token in the pool lacks USD pricing.\n- **entry_date** (`Date`): Date of the first event for this position.\n- **last_action_date** (`Date`): Date of the most recent event for this position.\n- **as_of_date** (`Date`): Date the snapshot is computed as of (max date in the underlying data).","operationId":"api_execution_yields_user_lp_positions_get_v1_execution_yields_user_lp_positions_latest_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"provider":{"type":"string","description":"LP provider wallet address."},"pool_address":{"type":"string","description":"Pool contract address (lowercase, with 0x prefix)."},"protocol":{"type":"string","description":"DEX protocol name (Uniswap V3, Swapr V3, Balancer V2, Balancer V3)."},"tick_lower":{"type":"integer","description":"V3 lower tick (NULL for non-V3 pools)."},"tick_upper":{"type":"integer","description":"V3 upper tick (NULL for non-V3 pools)."},"capital_in_usd":{"type":"number","description":"Cumulative USD value of deposits into the position."},"capital_out_usd":{"type":"number","description":"Cumulative USD value of withdrawals from the position."},"fees_collected_usd":{"type":"number","description":"Cumulative LP fees collected in USD."},"is_active":{"type":"integer","description":"1 if the position currently holds liquidity."},"is_in_range":{"type":"integer","description":"1 if pool current tick is within [tick_lower, tick_upper] (V3 only)."},"pool_current_tick":{"type":"integer","description":"Latest tick from Swap events on this pool (V3 only). NULL if no swaps recorded."},"has_unpriced_tokens":{"type":"integer","description":"1 if at least one token in the pool lacks USD pricing."},"entry_date":{"type":"string","format":"date","description":"Date of the first event for this position."},"last_action_date":{"type":"string","format":"date","description":"Date of the most recent event for this position."},"as_of_date":{"type":"string","format":"date","description":"Date the snapshot is computed as of (max date in the underlying data)."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/execution/yields_user_top_wallets/snapshot":{"get":{"tags":["Execution"],"summary":"Yields User Top Wallets (snapshot)","description":"**Required Access:** `tier1`\n\nAllow-list of ~50 wallet addresses surfaced as \"top wallets\" on the user\nportfolio landing dashboard. Combines top Uniswap/Swapr LPs, wallets\nactive in both LP and lending, and top lenders, with stable priority\nordering.\n\n\n**Columns:**\n- **wallet_address** (`String`): Wallet address surfaced as a top yields-portfolio wallet.\n- **as_of_date** (`Date`): Date the snapshot is computed as of (max date in the underlying data).","operationId":"api_execution_yields_user_top_wallets_get_v1_execution_yields_user_top_wallets_snapshot_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"wallet_address":{"type":"string","description":"Wallet address surfaced as a top yields-portfolio wallet."},"as_of_date":{"type":"string","format":"date","description":"Date the snapshot is computed as of (max date in the underlying data)."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/mmm/mmm_spine/weekly":{"get":{"tags":["Mmm"],"summary":"Mmm Spine (weekly)","description":"**Required Access:** `tier1`\n\nAPI view passthrough over `fct_execution_mmm_spine_weekly`. Tier1\nendpoint (`api:mmm_spine_weekly`), requires `X-API-Key`. The MMM\nanalyst persona reads this directly to pull a complete (kpi, media,\ncontrol) weekly spine without hand-rolling the union — a single\n`SELECT * FROM api_execution_mmm_spine_weekly WHERE week >= today()\n- INTERVAL 730 DAY` returns the regression input dataset.\n\n\n**Columns:**\n- **week** (`Date`): ISO Monday-start week date.","operationId":"api_execution_mmm_spine_weekly_get_v1_mmm_mmm_spine_weekly_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"week":{"type":"string","format":"date","description":"ISO Monday-start week date."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/mta/gnosis_app_attribution/rolling_180d/30d":{"get":{"tags":["Mta"],"summary":"Gnosis App Attribution (rolling_180d) [30d]","description":"**Required Access:** `tier1`\n\nAPI view passthrough over `fct_execution_gnosis_app_attribution_30d`.\nTier1 endpoint (`api:gnosis_app_attribution_30d`), requires\n`X-API-Key`. Granularity tag `granularity:rolling_180d` documents\nthat the underlying mart aggregates over the trailing 180 days of\nconversions.\n\n\n**Columns:**\n- **conversion_kind** (`LowCardinality(String)`): Conversion target.\n- **event_kind** (`LowCardinality(String)`): Touchpoint kind being credited.\n- **conversions_with_touch** (`UInt64`): Distinct conversions that saw this `event_kind` in their journey.\n- **first_touch** (`Float64`): Sum of first-touch credits.\n- **last_touch** (`Float64`): Sum of last-touch credits.\n- **linear** (`Float64`): Sum of linear credits.\n- **time_decay_hl_7d** (`Float64`): Sum of time-decay credits (HL=7d).\n- **total_conversions** (`UInt64`): Total conversions of this kind in the 180-day window.\n- **computed_at** (`DateTime`): Materialisation timestamp.\n- **as_of_date** (`Date`): Date the snapshot is computed as of (max date in the underlying data).","operationId":"api_execution_gnosis_app_attribution_30d_get_v1_mta_gnosis_app_attribution_rolling_180d_30d_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"conversion_kind":{"type":"string","description":"Conversion target."},"event_kind":{"type":"string","description":"Touchpoint kind being credited."},"conversions_with_touch":{"type":"integer","description":"Distinct conversions that saw this `event_kind` in their journey."},"first_touch":{"type":"number","description":"Sum of first-touch credits."},"last_touch":{"type":"number","description":"Sum of last-touch credits."},"linear":{"type":"number","description":"Sum of linear credits."},"time_decay_hl_7d":{"type":"number","description":"Sum of time-decay credits (HL=7d)."},"total_conversions":{"type":"integer","description":"Total conversions of this kind in the 180-day window."},"computed_at":{"type":"string","format":"date-time","description":"Materialisation timestamp."},"as_of_date":{"type":"string","format":"date","description":"Date the snapshot is computed as of (max date in the underlying data)."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/mta/gnosis_app_attribution/rolling_180d/60d":{"get":{"tags":["Mta"],"summary":"Gnosis App Attribution (rolling_180d) [60d]","description":"**Required Access:** `tier1`\n\nAPI view passthrough over `fct_execution_gnosis_app_attribution_60d`.\nTier1 endpoint (`api:gnosis_app_attribution_60d`), requires\n`X-API-Key`. Granularity tag `granularity:rolling_180d` documents\nthat the underlying mart aggregates over the trailing 180 days of\nconversions.\n\n\n**Columns:**\n- **conversion_kind** (`LowCardinality(String)`): Conversion target.\n- **event_kind** (`LowCardinality(String)`): Touchpoint kind being credited.\n- **conversions_with_touch** (`UInt64`): Distinct conversions that saw this `event_kind` in their journey.\n- **first_touch** (`Float64`): Sum of first-touch credits.\n- **last_touch** (`Float64`): Sum of last-touch credits.\n- **linear** (`Float64`): Sum of linear credits.\n- **time_decay_hl_7d** (`Float64`): Sum of time-decay credits (HL=7d).\n- **total_conversions** (`UInt64`): Total conversions of this kind in the 180-day window.\n- **computed_at** (`DateTime`): Materialisation timestamp.\n- **as_of_date** (`Date`): Date the snapshot is computed as of (max date in the underlying data).","operationId":"api_execution_gnosis_app_attribution_60d_get_v1_mta_gnosis_app_attribution_rolling_180d_60d_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"conversion_kind":{"type":"string","description":"Conversion target."},"event_kind":{"type":"string","description":"Touchpoint kind being credited."},"conversions_with_touch":{"type":"integer","description":"Distinct conversions that saw this `event_kind` in their journey."},"first_touch":{"type":"number","description":"Sum of first-touch credits."},"last_touch":{"type":"number","description":"Sum of last-touch credits."},"linear":{"type":"number","description":"Sum of linear credits."},"time_decay_hl_7d":{"type":"number","description":"Sum of time-decay credits (HL=7d)."},"total_conversions":{"type":"integer","description":"Total conversions of this kind in the 180-day window."},"computed_at":{"type":"string","format":"date-time","description":"Materialisation timestamp."},"as_of_date":{"type":"string","format":"date","description":"Date the snapshot is computed as of (max date in the underlying data)."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/mta/gnosis_app_attribution/rolling_180d/7d":{"get":{"tags":["Mta"],"summary":"Gnosis App Attribution (rolling_180d) [7d]","description":"**Required Access:** `tier1`\n\nAPI view passthrough over `fct_execution_gnosis_app_attribution_7d`.\nTier1 endpoint (`api:gnosis_app_attribution_7d`), requires\n`X-API-Key`. Granularity tag `granularity:rolling_180d` documents\nthat the underlying mart aggregates over the trailing 180 days of\nconversions.\n\n\n**Columns:**\n- **conversion_kind** (`LowCardinality(String)`): Conversion target.\n- **event_kind** (`LowCardinality(String)`): Touchpoint kind being credited.\n- **conversions_with_touch** (`UInt64`): Distinct conversions that saw this `event_kind` in their journey.\n- **first_touch** (`Float64`): Sum of first-touch credits.\n- **last_touch** (`Float64`): Sum of last-touch credits.\n- **linear** (`Float64`): Sum of linear credits.\n- **time_decay_hl_7d** (`Float64`): Sum of time-decay credits (HL=7d).\n- **total_conversions** (`UInt64`): Total conversions of this kind in the 180-day window.\n- **computed_at** (`DateTime`): Materialisation timestamp.\n- **as_of_date** (`Date`): Date the snapshot is computed as of (max date in the underlying data).","operationId":"api_execution_gnosis_app_attribution_7d_get_v1_mta_gnosis_app_attribution_rolling_180d_7d_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"conversion_kind":{"type":"string","description":"Conversion target."},"event_kind":{"type":"string","description":"Touchpoint kind being credited."},"conversions_with_touch":{"type":"integer","description":"Distinct conversions that saw this `event_kind` in their journey."},"first_touch":{"type":"number","description":"Sum of first-touch credits."},"last_touch":{"type":"number","description":"Sum of last-touch credits."},"linear":{"type":"number","description":"Sum of linear credits."},"time_decay_hl_7d":{"type":"number","description":"Sum of time-decay credits (HL=7d)."},"total_conversions":{"type":"integer","description":"Total conversions of this kind in the 180-day window."},"computed_at":{"type":"string","format":"date-time","description":"Materialisation timestamp."},"as_of_date":{"type":"string","format":"date","description":"Date the snapshot is computed as of (max date in the underlying data)."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/mta/gnosis_app_funnel_summary/latest":{"get":{"tags":["Mta"],"summary":"Gnosis App Funnel Summary (latest)","description":"**Required Access:** `tier1`\n\nCumulative conversion funnel per funnel/step: the number of distinct users who reached at least each step. Point-in-time snapshot backing the \"Conversion Funnel\" chart.\n\n\n**Columns:**\n- **as_of_date** (`Date`): Snapshot date the funnel counts were computed (today, UTC).\n- **funnel_name** (`String`): Name of the conversion funnel.\n- **level** (`UInt8`): Funnel step index (0-based windowFunnel level).\n- **step_label** (`String`): Human-readable step label (e.g. 'Step 1').\n- **n_users** (`UInt64`): Distinct users who reached at least this step.","operationId":"api_execution_gnosis_app_funnel_summary_get_v1_mta_gnosis_app_funnel_summary_latest_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"as_of_date":{"type":"string","format":"date","description":"Snapshot date the funnel counts were computed (today, UTC)."},"funnel_name":{"type":"string","description":"Name of the conversion funnel."},"level":{"type":"integer","description":"Funnel step index (0-based windowFunnel level)."},"step_label":{"type":"string","description":"Human-readable step label (e.g. 'Step 1')."},"n_users":{"type":"integer","description":"Distinct users who reached at least this step."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/mta/gpay_attribution/rolling_180d/30d":{"get":{"tags":["Mta"],"summary":"Gpay Attribution (rolling_180d) [30d]","description":"**Required Access:** `tier1`\n\nAPI view passthrough over `fct_execution_gpay_attribution_30d`.\nTier1 endpoint (`api:gpay_attribution_30d`), requires `X-API-Key`.\n`granularity:rolling_180d` documents the underlying window. The\n`identity_role` column lets API callers filter to owner-grain,\ntreasury-grain, or delegate-grain at query time.\n\n\n**Columns:**\n- **conversion_kind** (`LowCardinality(String)`): Conversion target.\n- **identity_role** (`LowCardinality(String)`): Role grain.\n- **event_kind** (`LowCardinality(String)`): Touchpoint kind being credited.\n- **conversions_with_touch** (`UInt64`): Distinct conversions that saw this `event_kind` in their journey.\n- **first_touch** (`Float64`): Sum of first-touch credits.\n- **last_touch** (`Float64`): Sum of last-touch credits.\n- **linear** (`Float64`): Sum of linear credits.\n- **time_decay_hl_7d** (`Float64`): Sum of time-decay credits (HL=7d).\n- **total_conversions** (`UInt64`): Total conversions of this (kind, role) in the 180-day window.\n- **computed_at** (`DateTime`): Materialisation timestamp.\n- **as_of_date** (`Date`): Date the snapshot is computed as of (max date in the underlying data).","operationId":"api_execution_gpay_attribution_30d_get_v1_mta_gpay_attribution_rolling_180d_30d_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"conversion_kind":{"type":"string","description":"Conversion target."},"identity_role":{"type":"string","description":"Role grain."},"event_kind":{"type":"string","description":"Touchpoint kind being credited."},"conversions_with_touch":{"type":"integer","description":"Distinct conversions that saw this `event_kind` in their journey."},"first_touch":{"type":"number","description":"Sum of first-touch credits."},"last_touch":{"type":"number","description":"Sum of last-touch credits."},"linear":{"type":"number","description":"Sum of linear credits."},"time_decay_hl_7d":{"type":"number","description":"Sum of time-decay credits (HL=7d)."},"total_conversions":{"type":"integer","description":"Total conversions of this (kind, role) in the 180-day window."},"computed_at":{"type":"string","format":"date-time","description":"Materialisation timestamp."},"as_of_date":{"type":"string","format":"date","description":"Date the snapshot is computed as of (max date in the underlying data)."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/mta/gpay_attribution/rolling_180d/60d":{"get":{"tags":["Mta"],"summary":"Gpay Attribution (rolling_180d) [60d]","description":"**Required Access:** `tier1`\n\nAPI view passthrough over `fct_execution_gpay_attribution_60d`.\nTier1 endpoint (`api:gpay_attribution_60d`), requires `X-API-Key`.\n`granularity:rolling_180d` documents the underlying window.\n\n\n**Columns:**\n- **conversion_kind** (`LowCardinality(String)`): Conversion target.\n- **identity_role** (`LowCardinality(String)`): Role grain.\n- **event_kind** (`LowCardinality(String)`): Touchpoint kind being credited.\n- **conversions_with_touch** (`UInt64`): Distinct conversions that saw this `event_kind` in their journey.\n- **first_touch** (`Float64`): Sum of first-touch credits.\n- **last_touch** (`Float64`): Sum of last-touch credits.\n- **linear** (`Float64`): Sum of linear credits.\n- **time_decay_hl_7d** (`Float64`): Sum of time-decay credits (HL=7d).\n- **total_conversions** (`UInt64`): Total conversions of this (kind, role) in the 180-day window.\n- **computed_at** (`DateTime`): Materialisation timestamp.\n- **as_of_date** (`Date`): Date the snapshot is computed as of (max date in the underlying data).","operationId":"api_execution_gpay_attribution_60d_get_v1_mta_gpay_attribution_rolling_180d_60d_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"conversion_kind":{"type":"string","description":"Conversion target."},"identity_role":{"type":"string","description":"Role grain."},"event_kind":{"type":"string","description":"Touchpoint kind being credited."},"conversions_with_touch":{"type":"integer","description":"Distinct conversions that saw this `event_kind` in their journey."},"first_touch":{"type":"number","description":"Sum of first-touch credits."},"last_touch":{"type":"number","description":"Sum of last-touch credits."},"linear":{"type":"number","description":"Sum of linear credits."},"time_decay_hl_7d":{"type":"number","description":"Sum of time-decay credits (HL=7d)."},"total_conversions":{"type":"integer","description":"Total conversions of this (kind, role) in the 180-day window."},"computed_at":{"type":"string","format":"date-time","description":"Materialisation timestamp."},"as_of_date":{"type":"string","format":"date","description":"Date the snapshot is computed as of (max date in the underlying data)."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/mta/gpay_attribution/rolling_180d/7d":{"get":{"tags":["Mta"],"summary":"Gpay Attribution (rolling_180d) [7d]","description":"**Required Access:** `tier1`\n\nAPI view passthrough over `fct_execution_gpay_attribution_7d`.\nTier1 endpoint (`api:gpay_attribution_7d`), requires `X-API-Key`.\n`granularity:rolling_180d` documents the underlying window. The\n`identity_role` column lets API callers filter to owner-grain,\ntreasury-grain, or delegate-grain at query time.\n\n\n**Columns:**\n- **conversion_kind** (`LowCardinality(String)`): Conversion target.\n- **identity_role** (`LowCardinality(String)`): Role grain.\n- **event_kind** (`LowCardinality(String)`): Touchpoint kind being credited.\n- **conversions_with_touch** (`UInt64`): Distinct conversions that saw this `event_kind` in their journey.\n- **first_touch** (`Float64`): Sum of first-touch credits.\n- **last_touch** (`Float64`): Sum of last-touch credits.\n- **linear** (`Float64`): Sum of linear credits.\n- **time_decay_hl_7d** (`Float64`): Sum of time-decay credits (HL=7d).\n- **total_conversions** (`UInt64`): Total conversions of this (kind, role) in the 180-day window.\n- **computed_at** (`DateTime`): Materialisation timestamp.\n- **as_of_date** (`Date`): Date the snapshot is computed as of (max date in the underlying data).","operationId":"api_execution_gpay_attribution_7d_get_v1_mta_gpay_attribution_rolling_180d_7d_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"conversion_kind":{"type":"string","description":"Conversion target."},"identity_role":{"type":"string","description":"Role grain."},"event_kind":{"type":"string","description":"Touchpoint kind being credited."},"conversions_with_touch":{"type":"integer","description":"Distinct conversions that saw this `event_kind` in their journey."},"first_touch":{"type":"number","description":"Sum of first-touch credits."},"last_touch":{"type":"number","description":"Sum of last-touch credits."},"linear":{"type":"number","description":"Sum of linear credits."},"time_decay_hl_7d":{"type":"number","description":"Sum of time-decay credits (HL=7d)."},"total_conversions":{"type":"integer","description":"Total conversions of this (kind, role) in the 180-day window."},"computed_at":{"type":"string","format":"date-time","description":"Materialisation timestamp."},"as_of_date":{"type":"string","format":"date","description":"Date the snapshot is computed as of (max date in the underlying data)."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/p2p/clients_count/latest":{"get":{"tags":["P2P"],"summary":"Clients Count (latest)","description":"**Required Access:** `tier0` (no API key required)\n\nThis view provides the latest counts and percentage changes of P2P clients for discv4 and discv5 protocols, enabling monitoring of client growth trends over the most recent week.\n\n**Columns:**\n- **date** (`Date`): The date corresponding to the latest available data for the client counts.\n- **discv4_count** (`UInt64`): The total number of discv4 clients recorded on the latest date.\n- **change_discv4_pct** (`Float64`): Percentage change in Discv4 clients compared to 7 days prior.\n- **discv5_count** (`UInt64`): Number of Discv5 clients for the latest date.\n- **change_discv5_pct** (`Float64`): Percentage change in Discv5 clients compared to 7 days prior.","operationId":"api_p2p_clients_latest_get_v1_p2p_clients_count_latest_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"date":{"type":"string","format":"date","description":"The date corresponding to the latest available data for the client counts."},"discv4_count":{"type":"integer","description":"The total number of discv4 clients recorded on the latest date."},"change_discv4_pct":{"type":"number","description":"Percentage change in Discv4 clients compared to 7 days prior."},"discv5_count":{"type":"integer","description":"Number of Discv5 clients for the latest date."},"change_discv5_pct":{"type":"number","description":"Percentage change in Discv5 clients compared to 7 days prior."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/p2p/discv4_clients_count/latest":{"get":{"tags":["P2P"],"summary":"Discv4 Clients Count (latest)","description":"**Required Access:** `tier0` (no API key required)\n\nThe api_p2p_discv4_clients_latest view provides the most recent aggregated counts of Discv4 P2P clients, facilitating real-time monitoring of client metrics at the latest date.\n\n**Columns:**\n- **metric** (`String`): The name of the specific client metric being reported.\n- **label** (`String`): A categorical identifier or subcategory associated with the metric.\n- **value** (`UInt64`): The numeric value of the metric, representing client counts or measurements.\n- **as_of_date** (`Date`): Date the snapshot is computed as of (max date in the underlying data).","operationId":"api_p2p_discv4_clients_latest_get_v1_p2p_discv4_clients_count_latest_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"metric":{"type":"string","description":"The name of the specific client metric being reported."},"label":{"type":"string","description":"A categorical identifier or subcategory associated with the metric."},"value":{"type":"integer","description":"The numeric value of the metric, representing client counts or measurements."},"as_of_date":{"type":"string","format":"date","description":"Date the snapshot is computed as of (max date in the underlying data)."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/p2p/discv4_clients_count/daily":{"get":{"tags":["P2P"],"summary":"Discv4 Clients Count (daily)","description":"**Required Access:** `tier1`\n\nThe api_p2p_discv4_clients_daily view tracks daily metrics related to the number of Discv4 clients in the P2P network, supporting operational monitoring and trend analysis.\n\n**Columns:**\n- **date** (`Date`): The specific calendar date for the recorded metrics, formatted as YYYY-MM-DD.\n- **metric** (`String`): The type of metric being reported, such as client counts or other relevant measurements.\n- **label** (`String`): A categorical identifier providing additional context or segmentation for the metric, such as client type or network segment.\n- **value** (`UInt64`): The numeric measurement corresponding to the metric and label, representing counts or other quantitative data.","operationId":"api_p2p_discv4_clients_daily_get_v1_p2p_discv4_clients_count_daily_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"date":{"type":"string","format":"date","description":"The specific calendar date for the recorded metrics, formatted as YYYY-MM-DD."},"metric":{"type":"string","description":"The type of metric being reported, such as client counts or other relevant measurements."},"label":{"type":"string","description":"A categorical identifier providing additional context or segmentation for the metric, such as client type or network segment."},"value":{"type":"integer","description":"The numeric measurement corresponding to the metric and label, representing counts or other quantitative data."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/p2p/discv5_clients_count/latest":{"get":{"tags":["P2P"],"summary":"Discv5 Clients Count (latest)","description":"**Required Access:** `tier0` (no API key required)\n\nThe api_p2p_discv5_clients_latest model provides a snapshot of the latest Discv5 peer-to-peer client metrics, enabling real-time monitoring of client counts and statuses.\n\n**Columns:**\n- **metric** (`String`): The name of the specific metric being reported, such as client count or status indicator.\n- **label** (`String`): A descriptive label categorizing the metric, such as client type or status category.\n- **value** (`UInt64`): The numerical value associated with the metric and label, representing counts or measurements at the latest date.\n- **as_of_date** (`Date`): Date the snapshot is computed as of (max date in the underlying data).","operationId":"api_p2p_discv5_clients_latest_get_v1_p2p_discv5_clients_count_latest_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"metric":{"type":"string","description":"The name of the specific metric being reported, such as client count or status indicator."},"label":{"type":"string","description":"A descriptive label categorizing the metric, such as client type or status category."},"value":{"type":"integer","description":"The numerical value associated with the metric and label, representing counts or measurements at the latest date."},"as_of_date":{"type":"string","format":"date","description":"Date the snapshot is computed as of (max date in the underlying data)."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/p2p/discv5_clients_count/daily":{"get":{"tags":["P2P"],"summary":"Discv5 Clients Count (daily)","description":"**Required Access:** `tier1`\n\nThe api_p2p_discv5_clients_daily model tracks daily metrics related to Discv5 clients in the P2P network, providing insights into client activity and distribution over time.\n\n**Columns:**\n- **date** (`Date`): The specific day for which the metrics are recorded, formatted as YYYY-MM-DD.\n- **metric** (`String`): The type of metric being measured, indicating the aspect of Discv5 clients (e.g., total count, active clients).\n- **label** (`String`): A categorical identifier that further classifies the metric, such as client version or network segment.\n- **value** (`UInt64`): The numerical measurement of the metric for the given date and label.","operationId":"api_p2p_discv5_clients_daily_get_v1_p2p_discv5_clients_count_daily_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"date":{"type":"string","format":"date","description":"The specific day for which the metrics are recorded, formatted as YYYY-MM-DD."},"metric":{"type":"string","description":"The type of metric being measured, indicating the aspect of Discv5 clients (e.g., total count, active clients)."},"label":{"type":"string","description":"A categorical identifier that further classifies the metric, such as client version or network segment."},"value":{"type":"integer","description":"The numerical measurement of the metric for the given date and label."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/p2p/discv5_current_fork_count/daily":{"get":{"tags":["P2P"],"summary":"Discv5 Current Fork Count (daily)","description":"**Required Access:** `tier1`\n\nThe `api_p2p_discv5_current_fork_daily` view tracks the daily count of current Discv5 network forks, providing insights into network stability and changes over time.\n\n**Columns:**\n- **date** (`Date`): The specific calendar date for the recorded fork counts, formatted as YYYY-MM-DD.\n- **fork** (`String`): Identifier or name of the specific network fork being tracked.\n- **cnt** (`UInt64`): The number of nodes or instances associated with the specified fork on the given date.","operationId":"api_p2p_discv5_current_fork_daily_get_v1_p2p_discv5_current_fork_count_daily_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"date":{"type":"string","format":"date","description":"The specific calendar date for the recorded fork counts, formatted as YYYY-MM-DD."},"fork":{"type":"string","description":"Identifier or name of the specific network fork being tracked."},"cnt":{"type":"integer","description":"The number of nodes or instances associated with the specified fork on the given date."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/p2p/discv5_next_fork_count/daily":{"get":{"tags":["P2P"],"summary":"Discv5 Next Fork Count (daily)","description":"**Required Access:** `tier1`\n\nThe api_p2p_discv5_next_fork_daily model provides daily counts of upcoming Discv5 network forks, enabling monitoring of network upgrade activity over time.\n\n**Columns:**\n- **date** (`Date`): The specific calendar date for the recorded fork count, formatted as YYYY-MM-DD.\n- **fork** (`String`): Identifier or version of the upcoming fork being tracked.\n- **cnt** (`UInt64`): The number of occurrences or instances of the specified fork on the given date.","operationId":"api_p2p_discv5_next_fork_daily_get_v1_p2p_discv5_next_fork_count_daily_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"date":{"type":"string","format":"date","description":"The specific calendar date for the recorded fork count, formatted as YYYY-MM-DD."},"fork":{"type":"string","description":"Identifier or version of the upcoming fork being tracked."},"cnt":{"type":"integer","description":"The number of occurrences or instances of the specified fork on the given date."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/p2p/network_topology/latest":{"get":{"tags":["P2P"],"summary":"Network Topology (latest)","description":"**Required Access:** `tier0` (no API key required)\n\nThe api_p2p_topology_latest model provides a real-time view of peer-to-peer network topology, capturing the latest connections and their geographic and organizational attributes for analysis and monitoring.\n\n**Columns:**\n- **protocol** (`String`): The communication protocol used between peers, such as TCP or UDP.\n- **date** (`Date`): The date when the topology data was recorded, in YYYY-MM-DD format.\n- **peer_discovery_id_prefix** (`UInt64`): Prefix of the unique identifier for the peer discovered in the network.\n- **peer_client** (`String`): The client software or implementation used by the peer.\n- **peer_city** (`String`): City where the peer is located.\n- **peer_country** (`String`): Country where the peer is located.\n- **peer_org** (`String`): Organization associated with the peer, if available.\n- **peer_lat** (`Float64`): Latitude coordinate of the peer's geographic location.\n- **peer_lon** (`Float64`): Longitude coordinate of the peer's geographic location.\n- **neighbor_discovery_id_prefix** (`UInt64`): Prefix of the unique identifier for the neighboring peer.\n- **neighbor_client** (`String`): Client software or implementation used by the neighboring peer.\n- **neighbor_city** (`String`): City where the neighboring peer is located.\n- **neighbor_country** (`String`): Country where the neighboring peer is located.\n- **neighbor_org** (`String`): Organization associated with the neighboring peer, if available.\n- **neighbor_lat** (`Float64`): Latitude coordinate of the neighboring peer's location.\n- **neighbor_lon** (`Float64`): Longitude coordinate of the neighboring peer's location.\n- **cnt** (`UInt64`): Count of occurrences or connections between the peer and neighbor, representing the connection strength or frequency.","operationId":"api_p2p_topology_latest_get_v1_p2p_network_topology_latest_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"protocol":{"type":"string","description":"The communication protocol used between peers, such as TCP or UDP."},"date":{"type":"string","format":"date","description":"The date when the topology data was recorded, in YYYY-MM-DD format."},"peer_discovery_id_prefix":{"type":"integer","description":"Prefix of the unique identifier for the peer discovered in the network."},"peer_client":{"type":"string","description":"The client software or implementation used by the peer."},"peer_city":{"type":"string","description":"City where the peer is located."},"peer_country":{"type":"string","description":"Country where the peer is located."},"peer_org":{"type":"string","description":"Organization associated with the peer, if available."},"peer_lat":{"type":"number","description":"Latitude coordinate of the peer's geographic location."},"peer_lon":{"type":"number","description":"Longitude coordinate of the peer's geographic location."},"neighbor_discovery_id_prefix":{"type":"integer","description":"Prefix of the unique identifier for the neighboring peer."},"neighbor_client":{"type":"string","description":"Client software or implementation used by the neighboring peer."},"neighbor_city":{"type":"string","description":"City where the neighboring peer is located."},"neighbor_country":{"type":"string","description":"Country where the neighboring peer is located."},"neighbor_org":{"type":"string","description":"Organization associated with the neighboring peer, if available."},"neighbor_lat":{"type":"number","description":"Latitude coordinate of the neighboring peer's location."},"neighbor_lon":{"type":"number","description":"Longitude coordinate of the neighboring peer's location."},"cnt":{"type":"integer","description":"Count of occurrences or connections between the peer and neighbor, representing the connection strength or frequency."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/p2p/visits_per_protocol/latest":{"get":{"tags":["P2P"],"summary":"Visits Per Protocol (latest)","description":"**Required Access:** `tier0` (no API key required)\n\nThis view provides the latest daily visit metrics for P2P protocols (discv4 and discv5), including total visits, success rates, and crawl counts, along with their percentage changes compared to the previous 7 days.\n\n**Columns:**\n- **date** (`Date`): The date for which the visit metrics are reported.\n- **crawls** (`UInt64`): The number of crawl attempts recorded on the specified date.\n- **discv4_total_visits** (`UInt64`): Total number of Discv4 visits in the latest data snapshot.\n- **discv4_pct_successful** (`Float64`): Percentage of successful Discv4 visits, rounded to one decimal.\n- **discv4_crawls** (`UInt64`): Number of Discv4 crawl attempts in the latest data.\n- **change_discv4_crawls_pct** (`Float64`): Percentage change in Discv4 crawls compared to the previous week.\n- **discv5_total_visits** (`UInt64`): Total number of Discv5 visits in the latest data snapshot.\n- **discv5_pct_successful** (`Float64`): Percentage of successful Discv5 visits, rounded to one decimal.\n- **discv5_crawls** (`UInt64`): Number of Discv5 crawl attempts in the latest data.\n- **change_discv5_crawls_pct** (`Float64`): Percentage change in Discv5 crawls compared to the previous week.","operationId":"api_p2p_visits_latest_get_v1_p2p_visits_per_protocol_latest_get","responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"items":{"properties":{"date":{"type":"string","format":"date","description":"The date for which the visit metrics are reported."},"crawls":{"type":"integer","description":"The number of crawl attempts recorded on the specified date."},"discv4_total_visits":{"type":"integer","description":"Total number of Discv4 visits in the latest data snapshot."},"discv4_pct_successful":{"type":"number","description":"Percentage of successful Discv4 visits, rounded to one decimal."},"discv4_crawls":{"type":"integer","description":"Number of Discv4 crawl attempts in the latest data."},"change_discv4_crawls_pct":{"type":"number","description":"Percentage change in Discv4 crawls compared to the previous week."},"discv5_total_visits":{"type":"integer","description":"Total number of Discv5 visits in the latest data snapshot."},"discv5_pct_successful":{"type":"number","description":"Percentage of successful Discv5 visits, rounded to one decimal."},"discv5_crawls":{"type":"integer","description":"Number of Discv5 crawl attempts in the latest data."},"change_discv5_crawls_pct":{"type":"number","description":"Percentage change in Discv5 crawls compared to the previous week."}},"additionalProperties":true,"type":"object"},"type":"array"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/quarterly_data/carbon_emissions/quarterly":{"get":{"tags":["Quarterly Data"],"summary":"Carbon Emissions (quarterly)","description":"**Required Access:** `tier0` (no API key required)\n\nQuarterly annualised CO2 emissions (tonnes/yr) from end-of-quarter snapshot, with estimation flag for periods using forward-filled carbon intensity.\n\n**Declared Filters:**\n- **quarter_from**: >= on `quarter` (Inclusive lower bound on quarter start date (e.g. 2024-01-01 for 2024-Q1))\n- **quarter_to**: <= on `quarter` (Inclusive upper bound on quarter start date)\n\n**Pagination:**\n- **limit**: default `200`, max `1000`\n- **offset**: default `0`\n\n**Sort:**\n- `quarter DESC`\n\n**Columns:**\n- **quarter** (`Date`): Quarter start date.\n- **co2_tonnes_yr** (`Float64`): Annualised CO2 emissions in tonnes per year at end of quarter.\n- **is_estimated** (`Bool`): True if the quarter's value uses forward-filled carbon intensity data.","operationId":"api_quarterly_data_carbon_emissions_get_v1_quarterly_data_carbon_emissions_quarterly_get","security":[{"APIKeyHeader":[]}],"responses":{"200":{"description":"Paginated response","content":{"application/json":{"schema":{"type":"object","required":["items","pagination"],"properties":{"items":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"quarter":{"type":"string","format":"date","description":"Quarter start date."},"co2_tonnes_yr":{"type":"number","description":"Annualised CO2 emissions in tonnes per year at end of quarter."},"is_estimated":{"type":"boolean","description":"True if the quarter's value uses forward-filled carbon intensity data."}}}},"pagination":{"type":"object","required":["limit","offset","returned","has_more"],"properties":{"limit":{"type":"integer","minimum":1},"offset":{"type":"integer","minimum":0},"returned":{"type":"integer","minimum":0},"has_more":{"type":"boolean"}}}}}}}}},"parameters":[{"name":"quarter_from","in":"query","required":false,"description":"Inclusive lower bound on quarter start date (e.g. 2024-01-01 for 2024-Q1)","schema":{"type":"string","format":"date"}},{"name":"quarter_to","in":"query","required":false,"description":"Inclusive upper bound on quarter start date","schema":{"type":"string","format":"date"}},{"name":"limit","in":"query","required":false,"description":"Row limit","schema":{"type":"integer","minimum":1,"maximum":1000,"default":200}},{"name":"offset","in":"query","required":false,"description":"Row offset","schema":{"type":"integer","minimum":0,"default":0}}]},"post":{"tags":["Quarterly Data"],"summary":"Carbon Emissions (quarterly) (POST)","description":"**Required Access:** `tier0` (no API key required)\n\nQuarterly annualised CO2 emissions (tonnes/yr) from end-of-quarter snapshot, with estimation flag for periods using forward-filled carbon intensity.\n\n**Declared Filters:**\n- **quarter_from**: >= on `quarter` (Inclusive lower bound on quarter start date (e.g. 2024-01-01 for 2024-Q1))\n- **quarter_to**: <= on `quarter` (Inclusive upper bound on quarter start date)\n\n**Pagination:**\n- **limit**: default `200`, max `1000`\n- **offset**: default `0`\n\n**Sort:**\n- `quarter DESC`\n\n**Columns:**\n- **quarter** (`Date`): Quarter start date.\n- **co2_tonnes_yr** (`Float64`): Annualised CO2 emissions in tonnes per year at end of quarter.\n- **is_estimated** (`Bool`): True if the quarter's value uses forward-filled carbon intensity data.","operationId":"api_quarterly_data_carbon_emissions_post_v1_quarterly_data_carbon_emissions_quarterly_post","security":[{"APIKeyHeader":[]}],"requestBody":{"content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/api_quarterly_data_carbon_emissions_PostBody"},{"type":"null"}],"title":" Body"}}}},"responses":{"200":{"description":"Paginated response","content":{"application/json":{"schema":{"type":"object","required":["items","pagination"],"properties":{"items":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"quarter":{"type":"string","format":"date","description":"Quarter start date."},"co2_tonnes_yr":{"type":"number","description":"Annualised CO2 emissions in tonnes per year at end of quarter."},"is_estimated":{"type":"boolean","description":"True if the quarter's value uses forward-filled carbon intensity data."}}}},"pagination":{"type":"object","required":["limit","offset","returned","has_more"],"properties":{"limit":{"type":"integer","minimum":1},"offset":{"type":"integer","minimum":0},"returned":{"type":"integer","minimum":0},"has_more":{"type":"boolean"}}}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/quarterly_data/circles_active_minters/quarterly":{"get":{"tags":["Quarterly Data"],"summary":"Circles Active Minters (quarterly)","description":"**Required Access:** `tier0` (no API key required)\n\nQuarterly peak of blacklist-excluded Circles v2 Active Minters (the +80% mint-coverage cohort). Matches the Dune circles-v2-kpis active-minters peak.\n\n**Declared Filters:**\n- **quarter_from**: >= on `quarter` (Inclusive lower bound on quarter start date (e.g. 2024-01-01 for 2024-Q1))\n- **quarter_to**: <= on `quarter` (Inclusive upper bound on quarter start date)\n\n**Pagination:**\n- **limit**: default `200`, max `1000`\n- **offset**: default `0`\n\n**Sort:**\n- `quarter DESC`\n\n**Columns:**\n- **quarter** (`Date`): Quarter start date.\n- **active_minters_peak** (`UInt64`): Highest daily blacklist-excluded active-minter count within the quarter.","operationId":"api_quarterly_data_circles_active_minters_get_v1_quarterly_data_circles_active_minters_quarterly_get","security":[{"APIKeyHeader":[]}],"responses":{"200":{"description":"Paginated response","content":{"application/json":{"schema":{"type":"object","required":["items","pagination"],"properties":{"items":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"quarter":{"type":"string","format":"date","description":"Quarter start date."},"active_minters_peak":{"type":"integer","description":"Highest daily blacklist-excluded active-minter count within the quarter."}}}},"pagination":{"type":"object","required":["limit","offset","returned","has_more"],"properties":{"limit":{"type":"integer","minimum":1},"offset":{"type":"integer","minimum":0},"returned":{"type":"integer","minimum":0},"has_more":{"type":"boolean"}}}}}}}}},"parameters":[{"name":"quarter_from","in":"query","required":false,"description":"Inclusive lower bound on quarter start date (e.g. 2024-01-01 for 2024-Q1)","schema":{"type":"string","format":"date"}},{"name":"quarter_to","in":"query","required":false,"description":"Inclusive upper bound on quarter start date","schema":{"type":"string","format":"date"}},{"name":"limit","in":"query","required":false,"description":"Row limit","schema":{"type":"integer","minimum":1,"maximum":1000,"default":200}},{"name":"offset","in":"query","required":false,"description":"Row offset","schema":{"type":"integer","minimum":0,"default":0}}]},"post":{"tags":["Quarterly Data"],"summary":"Circles Active Minters (quarterly) (POST)","description":"**Required Access:** `tier0` (no API key required)\n\nQuarterly peak of blacklist-excluded Circles v2 Active Minters (the +80% mint-coverage cohort). Matches the Dune circles-v2-kpis active-minters peak.\n\n**Declared Filters:**\n- **quarter_from**: >= on `quarter` (Inclusive lower bound on quarter start date (e.g. 2024-01-01 for 2024-Q1))\n- **quarter_to**: <= on `quarter` (Inclusive upper bound on quarter start date)\n\n**Pagination:**\n- **limit**: default `200`, max `1000`\n- **offset**: default `0`\n\n**Sort:**\n- `quarter DESC`\n\n**Columns:**\n- **quarter** (`Date`): Quarter start date.\n- **active_minters_peak** (`UInt64`): Highest daily blacklist-excluded active-minter count within the quarter.","operationId":"api_quarterly_data_circles_active_minters_post_v1_quarterly_data_circles_active_minters_quarterly_post","security":[{"APIKeyHeader":[]}],"requestBody":{"content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/api_quarterly_data_circles_active_minters_PostBody"},{"type":"null"}],"title":" Body"}}}},"responses":{"200":{"description":"Paginated response","content":{"application/json":{"schema":{"type":"object","required":["items","pagination"],"properties":{"items":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"quarter":{"type":"string","format":"date","description":"Quarter start date."},"active_minters_peak":{"type":"integer","description":"Highest daily blacklist-excluded active-minter count within the quarter."}}}},"pagination":{"type":"object","required":["limit","offset","returned","has_more"],"properties":{"limit":{"type":"integer","minimum":1},"offset":{"type":"integer","minimum":0},"returned":{"type":"integer","minimum":0},"has_more":{"type":"boolean"}}}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/quarterly_data/circles_active_trusts/quarterly":{"get":{"tags":["Quarterly Data"],"summary":"Circles Active Trusts (quarterly)","description":"**Required Access:** `tier0` (no API key required)\n\nEnd-of-quarter active trust links in Circles v2.\n\n**Declared Filters:**\n- **quarter_from**: >= on `quarter` (Inclusive lower bound on quarter start date (e.g. 2024-01-01 for 2024-Q1))\n- **quarter_to**: <= on `quarter` (Inclusive upper bound on quarter start date)\n\n**Pagination:**\n- **limit**: default `200`, max `1000`\n- **offset**: default `0`\n\n**Sort:**\n- `quarter DESC`\n\n**Columns:**\n- **quarter** (`Date`): Quarter start date.\n- **active_trusts** (`UInt64`): Total active trust links at end of quarter.","operationId":"api_quarterly_data_circles_active_trusts_get_v1_quarterly_data_circles_active_trusts_quarterly_get","security":[{"APIKeyHeader":[]}],"responses":{"200":{"description":"Paginated response","content":{"application/json":{"schema":{"type":"object","required":["items","pagination"],"properties":{"items":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"quarter":{"type":"string","format":"date","description":"Quarter start date."},"active_trusts":{"type":"integer","description":"Total active trust links at end of quarter."}}}},"pagination":{"type":"object","required":["limit","offset","returned","has_more"],"properties":{"limit":{"type":"integer","minimum":1},"offset":{"type":"integer","minimum":0},"returned":{"type":"integer","minimum":0},"has_more":{"type":"boolean"}}}}}}}}},"parameters":[{"name":"quarter_from","in":"query","required":false,"description":"Inclusive lower bound on quarter start date (e.g. 2024-01-01 for 2024-Q1)","schema":{"type":"string","format":"date"}},{"name":"quarter_to","in":"query","required":false,"description":"Inclusive upper bound on quarter start date","schema":{"type":"string","format":"date"}},{"name":"limit","in":"query","required":false,"description":"Row limit","schema":{"type":"integer","minimum":1,"maximum":1000,"default":200}},{"name":"offset","in":"query","required":false,"description":"Row offset","schema":{"type":"integer","minimum":0,"default":0}}]},"post":{"tags":["Quarterly Data"],"summary":"Circles Active Trusts (quarterly) (POST)","description":"**Required Access:** `tier0` (no API key required)\n\nEnd-of-quarter active trust links in Circles v2.\n\n**Declared Filters:**\n- **quarter_from**: >= on `quarter` (Inclusive lower bound on quarter start date (e.g. 2024-01-01 for 2024-Q1))\n- **quarter_to**: <= on `quarter` (Inclusive upper bound on quarter start date)\n\n**Pagination:**\n- **limit**: default `200`, max `1000`\n- **offset**: default `0`\n\n**Sort:**\n- `quarter DESC`\n\n**Columns:**\n- **quarter** (`Date`): Quarter start date.\n- **active_trusts** (`UInt64`): Total active trust links at end of quarter.","operationId":"api_quarterly_data_circles_active_trusts_post_v1_quarterly_data_circles_active_trusts_quarterly_post","security":[{"APIKeyHeader":[]}],"requestBody":{"content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/api_quarterly_data_circles_active_trusts_PostBody"},{"type":"null"}],"title":" Body"}}}},"responses":{"200":{"description":"Paginated response","content":{"application/json":{"schema":{"type":"object","required":["items","pagination"],"properties":{"items":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"quarter":{"type":"string","format":"date","description":"Quarter start date."},"active_trusts":{"type":"integer","description":"Total active trust links at end of quarter."}}}},"pagination":{"type":"object","required":["limit","offset","returned","has_more"],"properties":{"limit":{"type":"integer","minimum":1},"offset":{"type":"integer","minimum":0},"returned":{"type":"integer","minimum":0},"has_more":{"type":"boolean"}}}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/quarterly_data/circles_backers/quarterly":{"get":{"tags":["Quarterly Data"],"summary":"Circles Backers (quarterly)","description":"**Required Access:** `tier0` (no API key required)\n\nQuarterly currently-trusted Circles backers, as of quarter end (revocation-aware). A backer is an address currently trusted by the backers group avatar var('circles_target_group_address'); trust is revocable, so this count can fall. Distinct from the ever-backed cumulative series (api:circles_v2_backers_cumulative).\n\n\n**Declared Filters:**\n- **quarter_from**: >= on `quarter` (Inclusive lower bound on quarter start date (e.g. 2024-01-01 for 2024-Q1))\n- **quarter_to**: <= on `quarter` (Inclusive upper bound on quarter start date)\n\n**Pagination:**\n- **limit**: default `200`, max `1000`\n- **offset**: default `0`\n\n**Sort:**\n- `quarter DESC`\n\n**Columns:**\n- **quarter** (`Date`): Quarter start date.\n- **total_backers** (`UInt64`): Distinct backers currently trusted by the backers group as of the quarter's last day.","operationId":"api_quarterly_data_circles_backers_get_v1_quarterly_data_circles_backers_quarterly_get","security":[{"APIKeyHeader":[]}],"responses":{"200":{"description":"Paginated response","content":{"application/json":{"schema":{"type":"object","required":["items","pagination"],"properties":{"items":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"quarter":{"type":"string","format":"date","description":"Quarter start date."},"total_backers":{"type":"integer","description":"Distinct backers currently trusted by the backers group as of the quarter's last day."}}}},"pagination":{"type":"object","required":["limit","offset","returned","has_more"],"properties":{"limit":{"type":"integer","minimum":1},"offset":{"type":"integer","minimum":0},"returned":{"type":"integer","minimum":0},"has_more":{"type":"boolean"}}}}}}}}},"parameters":[{"name":"quarter_from","in":"query","required":false,"description":"Inclusive lower bound on quarter start date (e.g. 2024-01-01 for 2024-Q1)","schema":{"type":"string","format":"date"}},{"name":"quarter_to","in":"query","required":false,"description":"Inclusive upper bound on quarter start date","schema":{"type":"string","format":"date"}},{"name":"limit","in":"query","required":false,"description":"Row limit","schema":{"type":"integer","minimum":1,"maximum":1000,"default":200}},{"name":"offset","in":"query","required":false,"description":"Row offset","schema":{"type":"integer","minimum":0,"default":0}}]},"post":{"tags":["Quarterly Data"],"summary":"Circles Backers (quarterly) (POST)","description":"**Required Access:** `tier0` (no API key required)\n\nQuarterly currently-trusted Circles backers, as of quarter end (revocation-aware). A backer is an address currently trusted by the backers group avatar var('circles_target_group_address'); trust is revocable, so this count can fall. Distinct from the ever-backed cumulative series (api:circles_v2_backers_cumulative).\n\n\n**Declared Filters:**\n- **quarter_from**: >= on `quarter` (Inclusive lower bound on quarter start date (e.g. 2024-01-01 for 2024-Q1))\n- **quarter_to**: <= on `quarter` (Inclusive upper bound on quarter start date)\n\n**Pagination:**\n- **limit**: default `200`, max `1000`\n- **offset**: default `0`\n\n**Sort:**\n- `quarter DESC`\n\n**Columns:**\n- **quarter** (`Date`): Quarter start date.\n- **total_backers** (`UInt64`): Distinct backers currently trusted by the backers group as of the quarter's last day.","operationId":"api_quarterly_data_circles_backers_post_v1_quarterly_data_circles_backers_quarterly_post","security":[{"APIKeyHeader":[]}],"requestBody":{"content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/api_quarterly_data_circles_backers_PostBody"},{"type":"null"}],"title":" Body"}}}},"responses":{"200":{"description":"Paginated response","content":{"application/json":{"schema":{"type":"object","required":["items","pagination"],"properties":{"items":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"quarter":{"type":"string","format":"date","description":"Quarter start date."},"total_backers":{"type":"integer","description":"Distinct backers currently trusted by the backers group as of the quarter's last day."}}}},"pagination":{"type":"object","required":["limit","offset","returned","has_more"],"properties":{"limit":{"type":"integer","minimum":1},"offset":{"type":"integer","minimum":0},"returned":{"type":"integer","minimum":0},"has_more":{"type":"boolean"}}}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/quarterly_data/circles_humans/quarterly":{"get":{"tags":["Quarterly Data"],"summary":"Circles Humans (quarterly)","description":"**Required Access:** `tier0` (no API key required)\n\nEnd-of-quarter total registered human avatars in Circles v2.\n\n**Declared Filters:**\n- **quarter_from**: >= on `quarter` (Inclusive lower bound on quarter start date (e.g. 2024-01-01 for 2024-Q1))\n- **quarter_to**: <= on `quarter` (Inclusive upper bound on quarter start date)\n\n**Pagination:**\n- **limit**: default `200`, max `1000`\n- **offset**: default `0`\n\n**Sort:**\n- `quarter DESC`\n\n**Columns:**\n- **quarter** (`Date`): Quarter start date.\n- **registered_humans** (`UInt64`): Cumulative count of registered human avatars at end of quarter.","operationId":"api_quarterly_data_circles_humans_get_v1_quarterly_data_circles_humans_quarterly_get","security":[{"APIKeyHeader":[]}],"responses":{"200":{"description":"Paginated response","content":{"application/json":{"schema":{"type":"object","required":["items","pagination"],"properties":{"items":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"quarter":{"type":"string","format":"date","description":"Quarter start date."},"registered_humans":{"type":"integer","description":"Cumulative count of registered human avatars at end of quarter."}}}},"pagination":{"type":"object","required":["limit","offset","returned","has_more"],"properties":{"limit":{"type":"integer","minimum":1},"offset":{"type":"integer","minimum":0},"returned":{"type":"integer","minimum":0},"has_more":{"type":"boolean"}}}}}}}}},"parameters":[{"name":"quarter_from","in":"query","required":false,"description":"Inclusive lower bound on quarter start date (e.g. 2024-01-01 for 2024-Q1)","schema":{"type":"string","format":"date"}},{"name":"quarter_to","in":"query","required":false,"description":"Inclusive upper bound on quarter start date","schema":{"type":"string","format":"date"}},{"name":"limit","in":"query","required":false,"description":"Row limit","schema":{"type":"integer","minimum":1,"maximum":1000,"default":200}},{"name":"offset","in":"query","required":false,"description":"Row offset","schema":{"type":"integer","minimum":0,"default":0}}]},"post":{"tags":["Quarterly Data"],"summary":"Circles Humans (quarterly) (POST)","description":"**Required Access:** `tier0` (no API key required)\n\nEnd-of-quarter total registered human avatars in Circles v2.\n\n**Declared Filters:**\n- **quarter_from**: >= on `quarter` (Inclusive lower bound on quarter start date (e.g. 2024-01-01 for 2024-Q1))\n- **quarter_to**: <= on `quarter` (Inclusive upper bound on quarter start date)\n\n**Pagination:**\n- **limit**: default `200`, max `1000`\n- **offset**: default `0`\n\n**Sort:**\n- `quarter DESC`\n\n**Columns:**\n- **quarter** (`Date`): Quarter start date.\n- **registered_humans** (`UInt64`): Cumulative count of registered human avatars at end of quarter.","operationId":"api_quarterly_data_circles_humans_post_v1_quarterly_data_circles_humans_quarterly_post","security":[{"APIKeyHeader":[]}],"requestBody":{"content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/api_quarterly_data_circles_humans_PostBody"},{"type":"null"}],"title":" Body"}}}},"responses":{"200":{"description":"Paginated response","content":{"application/json":{"schema":{"type":"object","required":["items","pagination"],"properties":{"items":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"quarter":{"type":"string","format":"date","description":"Quarter start date."},"registered_humans":{"type":"integer","description":"Cumulative count of registered human avatars at end of quarter."}}}},"pagination":{"type":"object","required":["limit","offset","returned","has_more"],"properties":{"limit":{"type":"integer","minimum":1},"offset":{"type":"integer","minimum":0},"returned":{"type":"integer","minimum":0},"has_more":{"type":"boolean"}}}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/quarterly_data/circles_total_supply/quarterly":{"get":{"tags":["Quarterly Data"],"summary":"Circles Total Supply (quarterly)","description":"**Required Access:** `tier0` (no API key required)\n\nEnd-of-quarter Circles v2 token supply (raw and demurraged).\n\n**Declared Filters:**\n- **quarter_from**: >= on `quarter` (Inclusive lower bound on quarter start date (e.g. 2024-01-01 for 2024-Q1))\n- **quarter_to**: <= on `quarter` (Inclusive upper bound on quarter start date)\n\n**Pagination:**\n- **limit**: default `200`, max `1000`\n- **offset**: default `0`\n\n**Sort:**\n- `quarter DESC`\n\n**Columns:**\n- **quarter** (`Date`): Quarter start date.\n- **total_supply** (`Float64`): Total CRC token supply at end of quarter.\n- **total_supply_demurraged** (`Float64`): Total CRC token supply after demurrage at end of quarter.","operationId":"api_quarterly_data_circles_total_supply_get_v1_quarterly_data_circles_total_supply_quarterly_get","security":[{"APIKeyHeader":[]}],"responses":{"200":{"description":"Paginated response","content":{"application/json":{"schema":{"type":"object","required":["items","pagination"],"properties":{"items":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"quarter":{"type":"string","format":"date","description":"Quarter start date."},"total_supply":{"type":"number","description":"Total CRC token supply at end of quarter."},"total_supply_demurraged":{"type":"number","description":"Total CRC token supply after demurrage at end of quarter."}}}},"pagination":{"type":"object","required":["limit","offset","returned","has_more"],"properties":{"limit":{"type":"integer","minimum":1},"offset":{"type":"integer","minimum":0},"returned":{"type":"integer","minimum":0},"has_more":{"type":"boolean"}}}}}}}}},"parameters":[{"name":"quarter_from","in":"query","required":false,"description":"Inclusive lower bound on quarter start date (e.g. 2024-01-01 for 2024-Q1)","schema":{"type":"string","format":"date"}},{"name":"quarter_to","in":"query","required":false,"description":"Inclusive upper bound on quarter start date","schema":{"type":"string","format":"date"}},{"name":"limit","in":"query","required":false,"description":"Row limit","schema":{"type":"integer","minimum":1,"maximum":1000,"default":200}},{"name":"offset","in":"query","required":false,"description":"Row offset","schema":{"type":"integer","minimum":0,"default":0}}]},"post":{"tags":["Quarterly Data"],"summary":"Circles Total Supply (quarterly) (POST)","description":"**Required Access:** `tier0` (no API key required)\n\nEnd-of-quarter Circles v2 token supply (raw and demurraged).\n\n**Declared Filters:**\n- **quarter_from**: >= on `quarter` (Inclusive lower bound on quarter start date (e.g. 2024-01-01 for 2024-Q1))\n- **quarter_to**: <= on `quarter` (Inclusive upper bound on quarter start date)\n\n**Pagination:**\n- **limit**: default `200`, max `1000`\n- **offset**: default `0`\n\n**Sort:**\n- `quarter DESC`\n\n**Columns:**\n- **quarter** (`Date`): Quarter start date.\n- **total_supply** (`Float64`): Total CRC token supply at end of quarter.\n- **total_supply_demurraged** (`Float64`): Total CRC token supply after demurrage at end of quarter.","operationId":"api_quarterly_data_circles_total_supply_post_v1_quarterly_data_circles_total_supply_quarterly_post","security":[{"APIKeyHeader":[]}],"requestBody":{"content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/api_quarterly_data_circles_total_supply_PostBody"},{"type":"null"}],"title":" Body"}}}},"responses":{"200":{"description":"Paginated response","content":{"application/json":{"schema":{"type":"object","required":["items","pagination"],"properties":{"items":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"quarter":{"type":"string","format":"date","description":"Quarter start date."},"total_supply":{"type":"number","description":"Total CRC token supply at end of quarter."},"total_supply_demurraged":{"type":"number","description":"Total CRC token supply after demurrage at end of quarter."}}}},"pagination":{"type":"object","required":["limit","offset","returned","has_more"],"properties":{"limit":{"type":"integer","minimum":1},"offset":{"type":"integer","minimum":0},"returned":{"type":"integer","minimum":0},"has_more":{"type":"boolean"}}}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/quarterly_data/energy_consumption/quarterly":{"get":{"tags":["Quarterly Data"],"summary":"Energy Consumption (quarterly)","description":"**Required Access:** `tier0` (no API key required)\n\nQuarterly annualised energy consumption (MWh/yr) from end-of-quarter snapshot, with estimation flag for periods using forward-filled carbon intensity.\n\n**Declared Filters:**\n- **quarter_from**: >= on `quarter` (Inclusive lower bound on quarter start date (e.g. 2024-01-01 for 2024-Q1))\n- **quarter_to**: <= on `quarter` (Inclusive upper bound on quarter start date)\n\n**Pagination:**\n- **limit**: default `200`, max `1000`\n- **offset**: default `0`\n\n**Sort:**\n- `quarter DESC`\n\n**Columns:**\n- **quarter** (`Date`): Quarter start date.\n- **energy_mwh_yr** (`Float64`): Annualised energy consumption in MWh per year at end of quarter.\n- **is_estimated** (`Bool`): True if the quarter's value uses forward-filled carbon intensity data.","operationId":"api_quarterly_data_energy_consumption_get_v1_quarterly_data_energy_consumption_quarterly_get","security":[{"APIKeyHeader":[]}],"responses":{"200":{"description":"Paginated response","content":{"application/json":{"schema":{"type":"object","required":["items","pagination"],"properties":{"items":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"quarter":{"type":"string","format":"date","description":"Quarter start date."},"energy_mwh_yr":{"type":"number","description":"Annualised energy consumption in MWh per year at end of quarter."},"is_estimated":{"type":"boolean","description":"True if the quarter's value uses forward-filled carbon intensity data."}}}},"pagination":{"type":"object","required":["limit","offset","returned","has_more"],"properties":{"limit":{"type":"integer","minimum":1},"offset":{"type":"integer","minimum":0},"returned":{"type":"integer","minimum":0},"has_more":{"type":"boolean"}}}}}}}}},"parameters":[{"name":"quarter_from","in":"query","required":false,"description":"Inclusive lower bound on quarter start date (e.g. 2024-01-01 for 2024-Q1)","schema":{"type":"string","format":"date"}},{"name":"quarter_to","in":"query","required":false,"description":"Inclusive upper bound on quarter start date","schema":{"type":"string","format":"date"}},{"name":"limit","in":"query","required":false,"description":"Row limit","schema":{"type":"integer","minimum":1,"maximum":1000,"default":200}},{"name":"offset","in":"query","required":false,"description":"Row offset","schema":{"type":"integer","minimum":0,"default":0}}]},"post":{"tags":["Quarterly Data"],"summary":"Energy Consumption (quarterly) (POST)","description":"**Required Access:** `tier0` (no API key required)\n\nQuarterly annualised energy consumption (MWh/yr) from end-of-quarter snapshot, with estimation flag for periods using forward-filled carbon intensity.\n\n**Declared Filters:**\n- **quarter_from**: >= on `quarter` (Inclusive lower bound on quarter start date (e.g. 2024-01-01 for 2024-Q1))\n- **quarter_to**: <= on `quarter` (Inclusive upper bound on quarter start date)\n\n**Pagination:**\n- **limit**: default `200`, max `1000`\n- **offset**: default `0`\n\n**Sort:**\n- `quarter DESC`\n\n**Columns:**\n- **quarter** (`Date`): Quarter start date.\n- **energy_mwh_yr** (`Float64`): Annualised energy consumption in MWh per year at end of quarter.\n- **is_estimated** (`Bool`): True if the quarter's value uses forward-filled carbon intensity data.","operationId":"api_quarterly_data_energy_consumption_post_v1_quarterly_data_energy_consumption_quarterly_post","security":[{"APIKeyHeader":[]}],"requestBody":{"content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/api_quarterly_data_energy_consumption_PostBody"},{"type":"null"}],"title":" Body"}}}},"responses":{"200":{"description":"Paginated response","content":{"application/json":{"schema":{"type":"object","required":["items","pagination"],"properties":{"items":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"quarter":{"type":"string","format":"date","description":"Quarter start date."},"energy_mwh_yr":{"type":"number","description":"Annualised energy consumption in MWh per year at end of quarter."},"is_estimated":{"type":"boolean","description":"True if the quarter's value uses forward-filled carbon intensity data."}}}},"pagination":{"type":"object","required":["limit","offset","returned","has_more"],"properties":{"limit":{"type":"integer","minimum":1},"offset":{"type":"integer","minimum":0},"returned":{"type":"integer","minimum":0},"has_more":{"type":"boolean"}}}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/quarterly_data/gnosis_app_peak_swappers/quarterly":{"get":{"tags":["Quarterly Data"],"summary":"Gnosis App Peak Swappers (quarterly)","description":"**Required Access:** `tier0` (no API key required)\n\nPeak daily unique swappers on Gnosis App within the quarter.\n\n**Declared Filters:**\n- **quarter_from**: >= on `quarter` (Inclusive lower bound on quarter start date (e.g. 2024-01-01 for 2024-Q1))\n- **quarter_to**: <= on `quarter` (Inclusive upper bound on quarter start date)\n\n**Pagination:**\n- **limit**: default `200`, max `1000`\n- **offset**: default `0`\n\n**Sort:**\n- `quarter DESC`\n\n**Columns:**\n- **quarter** (`Date`): Quarter start date.\n- **peak_daily_swappers** (`UInt64`): Highest daily count of unique swap users in the quarter.\n- **peak_date** (`Date`): Calendar day (UTC) on which the peak daily swapper count occurred.","operationId":"api_quarterly_data_gnosis_app_peak_swappers_get_v1_quarterly_data_gnosis_app_peak_swappers_quarterly_get","security":[{"APIKeyHeader":[]}],"responses":{"200":{"description":"Paginated response","content":{"application/json":{"schema":{"type":"object","required":["items","pagination"],"properties":{"items":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"quarter":{"type":"string","format":"date","description":"Quarter start date."},"peak_daily_swappers":{"type":"integer","description":"Highest daily count of unique swap users in the quarter."},"peak_date":{"type":"string","format":"date","description":"Calendar day (UTC) on which the peak daily swapper count occurred."}}}},"pagination":{"type":"object","required":["limit","offset","returned","has_more"],"properties":{"limit":{"type":"integer","minimum":1},"offset":{"type":"integer","minimum":0},"returned":{"type":"integer","minimum":0},"has_more":{"type":"boolean"}}}}}}}}},"parameters":[{"name":"quarter_from","in":"query","required":false,"description":"Inclusive lower bound on quarter start date (e.g. 2024-01-01 for 2024-Q1)","schema":{"type":"string","format":"date"}},{"name":"quarter_to","in":"query","required":false,"description":"Inclusive upper bound on quarter start date","schema":{"type":"string","format":"date"}},{"name":"limit","in":"query","required":false,"description":"Row limit","schema":{"type":"integer","minimum":1,"maximum":1000,"default":200}},{"name":"offset","in":"query","required":false,"description":"Row offset","schema":{"type":"integer","minimum":0,"default":0}}]},"post":{"tags":["Quarterly Data"],"summary":"Gnosis App Peak Swappers (quarterly) (POST)","description":"**Required Access:** `tier0` (no API key required)\n\nPeak daily unique swappers on Gnosis App within the quarter.\n\n**Declared Filters:**\n- **quarter_from**: >= on `quarter` (Inclusive lower bound on quarter start date (e.g. 2024-01-01 for 2024-Q1))\n- **quarter_to**: <= on `quarter` (Inclusive upper bound on quarter start date)\n\n**Pagination:**\n- **limit**: default `200`, max `1000`\n- **offset**: default `0`\n\n**Sort:**\n- `quarter DESC`\n\n**Columns:**\n- **quarter** (`Date`): Quarter start date.\n- **peak_daily_swappers** (`UInt64`): Highest daily count of unique swap users in the quarter.\n- **peak_date** (`Date`): Calendar day (UTC) on which the peak daily swapper count occurred.","operationId":"api_quarterly_data_gnosis_app_peak_swappers_post_v1_quarterly_data_gnosis_app_peak_swappers_quarterly_post","security":[{"APIKeyHeader":[]}],"requestBody":{"content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/api_quarterly_data_gnosis_app_peak_swappers_PostBody"},{"type":"null"}],"title":" Body"}}}},"responses":{"200":{"description":"Paginated response","content":{"application/json":{"schema":{"type":"object","required":["items","pagination"],"properties":{"items":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"quarter":{"type":"string","format":"date","description":"Quarter start date."},"peak_daily_swappers":{"type":"integer","description":"Highest daily count of unique swap users in the quarter."},"peak_date":{"type":"string","format":"date","description":"Calendar day (UTC) on which the peak daily swapper count occurred."}}}},"pagination":{"type":"object","required":["limit","offset","returned","has_more"],"properties":{"limit":{"type":"integer","minimum":1},"offset":{"type":"integer","minimum":0},"returned":{"type":"integer","minimum":0},"has_more":{"type":"boolean"}}}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/quarterly_data/gnosis_app_swap_volume/quarterly":{"get":{"tags":["Quarterly Data"],"summary":"Gnosis App Swap Volume (quarterly)","description":"**Required Access:** `tier0` (no API key required)\n\nTotal swap volume in USD on Gnosis App per quarter.\n\n**Declared Filters:**\n- **quarter_from**: >= on `quarter` (Inclusive lower bound on quarter start date (e.g. 2024-01-01 for 2024-Q1))\n- **quarter_to**: <= on `quarter` (Inclusive upper bound on quarter start date)\n\n**Pagination:**\n- **limit**: default `200`, max `1000`\n- **offset**: default `0`\n\n**Sort:**\n- `quarter DESC`\n\n**Columns:**\n- **quarter** (`Date`): Quarter start date.\n- **volume_usd** (`Float64`): Sum of filled swap volume in USD during the quarter.","operationId":"api_quarterly_data_gnosis_app_swap_volume_get_v1_quarterly_data_gnosis_app_swap_volume_quarterly_get","security":[{"APIKeyHeader":[]}],"responses":{"200":{"description":"Paginated response","content":{"application/json":{"schema":{"type":"object","required":["items","pagination"],"properties":{"items":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"quarter":{"type":"string","format":"date","description":"Quarter start date."},"volume_usd":{"type":"number","description":"Sum of filled swap volume in USD during the quarter."}}}},"pagination":{"type":"object","required":["limit","offset","returned","has_more"],"properties":{"limit":{"type":"integer","minimum":1},"offset":{"type":"integer","minimum":0},"returned":{"type":"integer","minimum":0},"has_more":{"type":"boolean"}}}}}}}}},"parameters":[{"name":"quarter_from","in":"query","required":false,"description":"Inclusive lower bound on quarter start date (e.g. 2024-01-01 for 2024-Q1)","schema":{"type":"string","format":"date"}},{"name":"quarter_to","in":"query","required":false,"description":"Inclusive upper bound on quarter start date","schema":{"type":"string","format":"date"}},{"name":"limit","in":"query","required":false,"description":"Row limit","schema":{"type":"integer","minimum":1,"maximum":1000,"default":200}},{"name":"offset","in":"query","required":false,"description":"Row offset","schema":{"type":"integer","minimum":0,"default":0}}]},"post":{"tags":["Quarterly Data"],"summary":"Gnosis App Swap Volume (quarterly) (POST)","description":"**Required Access:** `tier0` (no API key required)\n\nTotal swap volume in USD on Gnosis App per quarter.\n\n**Declared Filters:**\n- **quarter_from**: >= on `quarter` (Inclusive lower bound on quarter start date (e.g. 2024-01-01 for 2024-Q1))\n- **quarter_to**: <= on `quarter` (Inclusive upper bound on quarter start date)\n\n**Pagination:**\n- **limit**: default `200`, max `1000`\n- **offset**: default `0`\n\n**Sort:**\n- `quarter DESC`\n\n**Columns:**\n- **quarter** (`Date`): Quarter start date.\n- **volume_usd** (`Float64`): Sum of filled swap volume in USD during the quarter.","operationId":"api_quarterly_data_gnosis_app_swap_volume_post_v1_quarterly_data_gnosis_app_swap_volume_quarterly_post","security":[{"APIKeyHeader":[]}],"requestBody":{"content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/api_quarterly_data_gnosis_app_swap_volume_PostBody"},{"type":"null"}],"title":" Body"}}}},"responses":{"200":{"description":"Paginated response","content":{"application/json":{"schema":{"type":"object","required":["items","pagination"],"properties":{"items":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"quarter":{"type":"string","format":"date","description":"Quarter start date."},"volume_usd":{"type":"number","description":"Sum of filled swap volume in USD during the quarter."}}}},"pagination":{"type":"object","required":["limit","offset","returned","has_more"],"properties":{"limit":{"type":"integer","minimum":1},"offset":{"type":"integer","minimum":0},"returned":{"type":"integer","minimum":0},"has_more":{"type":"boolean"}}}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/quarterly_data/gnosis_app_swaps/quarterly":{"get":{"tags":["Quarterly Data"],"summary":"Gnosis App Swaps (quarterly)","description":"**Required Access:** `tier0` (no API key required)\n\nTotal swap transactions on Gnosis App per quarter.\n\n**Declared Filters:**\n- **quarter_from**: >= on `quarter` (Inclusive lower bound on quarter start date (e.g. 2024-01-01 for 2024-Q1))\n- **quarter_to**: <= on `quarter` (Inclusive upper bound on quarter start date)\n\n**Pagination:**\n- **limit**: default `200`, max `1000`\n- **offset**: default `0`\n\n**Sort:**\n- `quarter DESC`\n\n**Columns:**\n- **quarter** (`Date`): Quarter start date.\n- **swaps** (`UInt64`): Total number of swap transactions in the quarter.","operationId":"api_quarterly_data_gnosis_app_swaps_get_v1_quarterly_data_gnosis_app_swaps_quarterly_get","security":[{"APIKeyHeader":[]}],"responses":{"200":{"description":"Paginated response","content":{"application/json":{"schema":{"type":"object","required":["items","pagination"],"properties":{"items":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"quarter":{"type":"string","format":"date","description":"Quarter start date."},"swaps":{"type":"integer","description":"Total number of swap transactions in the quarter."}}}},"pagination":{"type":"object","required":["limit","offset","returned","has_more"],"properties":{"limit":{"type":"integer","minimum":1},"offset":{"type":"integer","minimum":0},"returned":{"type":"integer","minimum":0},"has_more":{"type":"boolean"}}}}}}}}},"parameters":[{"name":"quarter_from","in":"query","required":false,"description":"Inclusive lower bound on quarter start date (e.g. 2024-01-01 for 2024-Q1)","schema":{"type":"string","format":"date"}},{"name":"quarter_to","in":"query","required":false,"description":"Inclusive upper bound on quarter start date","schema":{"type":"string","format":"date"}},{"name":"limit","in":"query","required":false,"description":"Row limit","schema":{"type":"integer","minimum":1,"maximum":1000,"default":200}},{"name":"offset","in":"query","required":false,"description":"Row offset","schema":{"type":"integer","minimum":0,"default":0}}]},"post":{"tags":["Quarterly Data"],"summary":"Gnosis App Swaps (quarterly) (POST)","description":"**Required Access:** `tier0` (no API key required)\n\nTotal swap transactions on Gnosis App per quarter.\n\n**Declared Filters:**\n- **quarter_from**: >= on `quarter` (Inclusive lower bound on quarter start date (e.g. 2024-01-01 for 2024-Q1))\n- **quarter_to**: <= on `quarter` (Inclusive upper bound on quarter start date)\n\n**Pagination:**\n- **limit**: default `200`, max `1000`\n- **offset**: default `0`\n\n**Sort:**\n- `quarter DESC`\n\n**Columns:**\n- **quarter** (`Date`): Quarter start date.\n- **swaps** (`UInt64`): Total number of swap transactions in the quarter.","operationId":"api_quarterly_data_gnosis_app_swaps_post_v1_quarterly_data_gnosis_app_swaps_quarterly_post","security":[{"APIKeyHeader":[]}],"requestBody":{"content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/api_quarterly_data_gnosis_app_swaps_PostBody"},{"type":"null"}],"title":" Body"}}}},"responses":{"200":{"description":"Paginated response","content":{"application/json":{"schema":{"type":"object","required":["items","pagination"],"properties":{"items":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"quarter":{"type":"string","format":"date","description":"Quarter start date."},"swaps":{"type":"integer","description":"Total number of swap transactions in the quarter."}}}},"pagination":{"type":"object","required":["limit","offset","returned","has_more"],"properties":{"limit":{"type":"integer","minimum":1},"offset":{"type":"integer","minimum":0},"returned":{"type":"integer","minimum":0},"has_more":{"type":"boolean"}}}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/quarterly_data/gnosis_app_swaps_filled/quarterly":{"get":{"tags":["Quarterly Data"],"summary":"Gnosis App Swaps Filled (quarterly)","description":"**Required Access:** `tier0` (no API key required)\n\nTotal filled swap transactions on Gnosis App per quarter.\n\n**Declared Filters:**\n- **quarter_from**: >= on `quarter` (Inclusive lower bound on quarter start date (e.g. 2024-01-01 for 2024-Q1))\n- **quarter_to**: <= on `quarter` (Inclusive upper bound on quarter start date)\n\n**Pagination:**\n- **limit**: default `200`, max `1000`\n- **offset**: default `0`\n\n**Sort:**\n- `quarter DESC`\n\n**Columns:**\n- **quarter** (`Date`): Quarter start date.\n- **swaps_filled** (`UInt64`): Total number of filled swap transactions in the quarter.","operationId":"api_quarterly_data_gnosis_app_swaps_filled_get_v1_quarterly_data_gnosis_app_swaps_filled_quarterly_get","security":[{"APIKeyHeader":[]}],"responses":{"200":{"description":"Paginated response","content":{"application/json":{"schema":{"type":"object","required":["items","pagination"],"properties":{"items":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"quarter":{"type":"string","format":"date","description":"Quarter start date."},"swaps_filled":{"type":"integer","description":"Total number of filled swap transactions in the quarter."}}}},"pagination":{"type":"object","required":["limit","offset","returned","has_more"],"properties":{"limit":{"type":"integer","minimum":1},"offset":{"type":"integer","minimum":0},"returned":{"type":"integer","minimum":0},"has_more":{"type":"boolean"}}}}}}}}},"parameters":[{"name":"quarter_from","in":"query","required":false,"description":"Inclusive lower bound on quarter start date (e.g. 2024-01-01 for 2024-Q1)","schema":{"type":"string","format":"date"}},{"name":"quarter_to","in":"query","required":false,"description":"Inclusive upper bound on quarter start date","schema":{"type":"string","format":"date"}},{"name":"limit","in":"query","required":false,"description":"Row limit","schema":{"type":"integer","minimum":1,"maximum":1000,"default":200}},{"name":"offset","in":"query","required":false,"description":"Row offset","schema":{"type":"integer","minimum":0,"default":0}}]},"post":{"tags":["Quarterly Data"],"summary":"Gnosis App Swaps Filled (quarterly) (POST)","description":"**Required Access:** `tier0` (no API key required)\n\nTotal filled swap transactions on Gnosis App per quarter.\n\n**Declared Filters:**\n- **quarter_from**: >= on `quarter` (Inclusive lower bound on quarter start date (e.g. 2024-01-01 for 2024-Q1))\n- **quarter_to**: <= on `quarter` (Inclusive upper bound on quarter start date)\n\n**Pagination:**\n- **limit**: default `200`, max `1000`\n- **offset**: default `0`\n\n**Sort:**\n- `quarter DESC`\n\n**Columns:**\n- **quarter** (`Date`): Quarter start date.\n- **swaps_filled** (`UInt64`): Total number of filled swap transactions in the quarter.","operationId":"api_quarterly_data_gnosis_app_swaps_filled_post_v1_quarterly_data_gnosis_app_swaps_filled_quarterly_post","security":[{"APIKeyHeader":[]}],"requestBody":{"content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/api_quarterly_data_gnosis_app_swaps_filled_PostBody"},{"type":"null"}],"title":" Body"}}}},"responses":{"200":{"description":"Paginated response","content":{"application/json":{"schema":{"type":"object","required":["items","pagination"],"properties":{"items":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"quarter":{"type":"string","format":"date","description":"Quarter start date."},"swaps_filled":{"type":"integer","description":"Total number of filled swap transactions in the quarter."}}}},"pagination":{"type":"object","required":["limit","offset","returned","has_more"],"properties":{"limit":{"type":"integer","minimum":1},"offset":{"type":"integer","minimum":0},"returned":{"type":"integer","minimum":0},"has_more":{"type":"boolean"}}}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/quarterly_data/gpay_active_users/quarterly":{"get":{"tags":["Quarterly Data"],"summary":"Gpay Active Users (quarterly)","description":"**Required Access:** `tier0` (no API key required)\n\nPeak monthly active users for Gnosis Pay within the quarter, on two bases: all-activity (peak_monthly_active_users) and payment-only (peak_monthly_payment_users). The payment basis is the one the quarterly report uses; the all-activity basis is inflated in June 2026 by the Safe-migration deposit/withdrawal churn.\n\n\n**Declared Filters:**\n- **quarter_from**: >= on `quarter` (Inclusive lower bound on quarter start date (e.g. 2024-01-01 for 2024-Q1))\n- **quarter_to**: <= on `quarter` (Inclusive upper bound on quarter start date)\n\n**Pagination:**\n- **limit**: default `200`, max `1000`\n- **offset**: default `0`\n\n**Sort:**\n- `quarter DESC`\n\n**Columns:**\n- **quarter** (`Date`): Quarter start date.\n- **peak_monthly_active_users** (`UInt64`): Highest monthly all-activity active-user count across the quarter's three months (any of payment, deposit, withdrawal, cashback).\n- **peak_monthly_payment_users** (`UInt64`): Highest monthly payment-active user count across the quarter's three months (distinct addresses making >=1 card payment; excludes deposit/withdrawal-only activity). This is the metric the quarterly report uses.","operationId":"api_quarterly_data_gpay_active_users_get_v1_quarterly_data_gpay_active_users_quarterly_get","security":[{"APIKeyHeader":[]}],"responses":{"200":{"description":"Paginated response","content":{"application/json":{"schema":{"type":"object","required":["items","pagination"],"properties":{"items":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"quarter":{"type":"string","format":"date","description":"Quarter start date."},"peak_monthly_active_users":{"type":"integer","description":"Highest monthly all-activity active-user count across the quarter's three months (any of payment, deposit, withdrawal, cashback)."},"peak_monthly_payment_users":{"type":"integer","description":"Highest monthly payment-active user count across the quarter's three months (distinct addresses making >=1 card payment; excludes deposit/withdrawal-only activity). This is the metric the quarterly report uses."}}}},"pagination":{"type":"object","required":["limit","offset","returned","has_more"],"properties":{"limit":{"type":"integer","minimum":1},"offset":{"type":"integer","minimum":0},"returned":{"type":"integer","minimum":0},"has_more":{"type":"boolean"}}}}}}}}},"parameters":[{"name":"quarter_from","in":"query","required":false,"description":"Inclusive lower bound on quarter start date (e.g. 2024-01-01 for 2024-Q1)","schema":{"type":"string","format":"date"}},{"name":"quarter_to","in":"query","required":false,"description":"Inclusive upper bound on quarter start date","schema":{"type":"string","format":"date"}},{"name":"limit","in":"query","required":false,"description":"Row limit","schema":{"type":"integer","minimum":1,"maximum":1000,"default":200}},{"name":"offset","in":"query","required":false,"description":"Row offset","schema":{"type":"integer","minimum":0,"default":0}}]},"post":{"tags":["Quarterly Data"],"summary":"Gpay Active Users (quarterly) (POST)","description":"**Required Access:** `tier0` (no API key required)\n\nPeak monthly active users for Gnosis Pay within the quarter, on two bases: all-activity (peak_monthly_active_users) and payment-only (peak_monthly_payment_users). The payment basis is the one the quarterly report uses; the all-activity basis is inflated in June 2026 by the Safe-migration deposit/withdrawal churn.\n\n\n**Declared Filters:**\n- **quarter_from**: >= on `quarter` (Inclusive lower bound on quarter start date (e.g. 2024-01-01 for 2024-Q1))\n- **quarter_to**: <= on `quarter` (Inclusive upper bound on quarter start date)\n\n**Pagination:**\n- **limit**: default `200`, max `1000`\n- **offset**: default `0`\n\n**Sort:**\n- `quarter DESC`\n\n**Columns:**\n- **quarter** (`Date`): Quarter start date.\n- **peak_monthly_active_users** (`UInt64`): Highest monthly all-activity active-user count across the quarter's three months (any of payment, deposit, withdrawal, cashback).\n- **peak_monthly_payment_users** (`UInt64`): Highest monthly payment-active user count across the quarter's three months (distinct addresses making >=1 card payment; excludes deposit/withdrawal-only activity). This is the metric the quarterly report uses.","operationId":"api_quarterly_data_gpay_active_users_post_v1_quarterly_data_gpay_active_users_quarterly_post","security":[{"APIKeyHeader":[]}],"requestBody":{"content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/api_quarterly_data_gpay_active_users_PostBody"},{"type":"null"}],"title":" Body"}}}},"responses":{"200":{"description":"Paginated response","content":{"application/json":{"schema":{"type":"object","required":["items","pagination"],"properties":{"items":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"quarter":{"type":"string","format":"date","description":"Quarter start date."},"peak_monthly_active_users":{"type":"integer","description":"Highest monthly all-activity active-user count across the quarter's three months (any of payment, deposit, withdrawal, cashback)."},"peak_monthly_payment_users":{"type":"integer","description":"Highest monthly payment-active user count across the quarter's three months (distinct addresses making >=1 card payment; excludes deposit/withdrawal-only activity). This is the metric the quarterly report uses."}}}},"pagination":{"type":"object","required":["limit","offset","returned","has_more"],"properties":{"limit":{"type":"integer","minimum":1},"offset":{"type":"integer","minimum":0},"returned":{"type":"integer","minimum":0},"has_more":{"type":"boolean"}}}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/quarterly_data/gpay_cashback/quarterly":{"get":{"tags":["Quarterly Data"],"summary":"Gpay Cashback (quarterly)","description":"**Required Access:** `tier0` (no API key required)\n\nTotal Gnosis Pay cashback in USD per quarter.\n\n**Declared Filters:**\n- **quarter_from**: >= on `quarter` (Inclusive lower bound on quarter start date (e.g. 2024-01-01 for 2024-Q1))\n- **quarter_to**: <= on `quarter` (Inclusive upper bound on quarter start date)\n\n**Pagination:**\n- **limit**: default `200`, max `1000`\n- **offset**: default `0`\n\n**Sort:**\n- `quarter DESC`\n\n**Columns:**\n- **quarter** (`Date`): Quarter start date.\n- **cashback_usd** (`Float64`): Sum of cashback paid in USD during the quarter.","operationId":"api_quarterly_data_gpay_cashback_get_v1_quarterly_data_gpay_cashback_quarterly_get","security":[{"APIKeyHeader":[]}],"responses":{"200":{"description":"Paginated response","content":{"application/json":{"schema":{"type":"object","required":["items","pagination"],"properties":{"items":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"quarter":{"type":"string","format":"date","description":"Quarter start date."},"cashback_usd":{"type":"number","description":"Sum of cashback paid in USD during the quarter."}}}},"pagination":{"type":"object","required":["limit","offset","returned","has_more"],"properties":{"limit":{"type":"integer","minimum":1},"offset":{"type":"integer","minimum":0},"returned":{"type":"integer","minimum":0},"has_more":{"type":"boolean"}}}}}}}}},"parameters":[{"name":"quarter_from","in":"query","required":false,"description":"Inclusive lower bound on quarter start date (e.g. 2024-01-01 for 2024-Q1)","schema":{"type":"string","format":"date"}},{"name":"quarter_to","in":"query","required":false,"description":"Inclusive upper bound on quarter start date","schema":{"type":"string","format":"date"}},{"name":"limit","in":"query","required":false,"description":"Row limit","schema":{"type":"integer","minimum":1,"maximum":1000,"default":200}},{"name":"offset","in":"query","required":false,"description":"Row offset","schema":{"type":"integer","minimum":0,"default":0}}]},"post":{"tags":["Quarterly Data"],"summary":"Gpay Cashback (quarterly) (POST)","description":"**Required Access:** `tier0` (no API key required)\n\nTotal Gnosis Pay cashback in USD per quarter.\n\n**Declared Filters:**\n- **quarter_from**: >= on `quarter` (Inclusive lower bound on quarter start date (e.g. 2024-01-01 for 2024-Q1))\n- **quarter_to**: <= on `quarter` (Inclusive upper bound on quarter start date)\n\n**Pagination:**\n- **limit**: default `200`, max `1000`\n- **offset**: default `0`\n\n**Sort:**\n- `quarter DESC`\n\n**Columns:**\n- **quarter** (`Date`): Quarter start date.\n- **cashback_usd** (`Float64`): Sum of cashback paid in USD during the quarter.","operationId":"api_quarterly_data_gpay_cashback_post_v1_quarterly_data_gpay_cashback_quarterly_post","security":[{"APIKeyHeader":[]}],"requestBody":{"content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/api_quarterly_data_gpay_cashback_PostBody"},{"type":"null"}],"title":" Body"}}}},"responses":{"200":{"description":"Paginated response","content":{"application/json":{"schema":{"type":"object","required":["items","pagination"],"properties":{"items":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"quarter":{"type":"string","format":"date","description":"Quarter start date."},"cashback_usd":{"type":"number","description":"Sum of cashback paid in USD during the quarter."}}}},"pagination":{"type":"object","required":["limit","offset","returned","has_more"],"properties":{"limit":{"type":"integer","minimum":1},"offset":{"type":"integer","minimum":0},"returned":{"type":"integer","minimum":0},"has_more":{"type":"boolean"}}}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/quarterly_data/gpay_payments/quarterly":{"get":{"tags":["Quarterly Data"],"summary":"Gpay Payments (quarterly)","description":"**Required Access:** `tier0` (no API key required)\n\nTotal Gnosis Pay payment transactions per quarter.\n\n**Declared Filters:**\n- **quarter_from**: >= on `quarter` (Inclusive lower bound on quarter start date (e.g. 2024-01-01 for 2024-Q1))\n- **quarter_to**: <= on `quarter` (Inclusive upper bound on quarter start date)\n\n**Pagination:**\n- **limit**: default `200`, max `1000`\n- **offset**: default `0`\n\n**Sort:**\n- `quarter DESC`\n\n**Columns:**\n- **quarter** (`Date`): Quarter start date.\n- **payments** (`UInt64`): Total number of payment transactions in the quarter.","operationId":"api_quarterly_data_gpay_payments_get_v1_quarterly_data_gpay_payments_quarterly_get","security":[{"APIKeyHeader":[]}],"responses":{"200":{"description":"Paginated response","content":{"application/json":{"schema":{"type":"object","required":["items","pagination"],"properties":{"items":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"quarter":{"type":"string","format":"date","description":"Quarter start date."},"payments":{"type":"integer","description":"Total number of payment transactions in the quarter."}}}},"pagination":{"type":"object","required":["limit","offset","returned","has_more"],"properties":{"limit":{"type":"integer","minimum":1},"offset":{"type":"integer","minimum":0},"returned":{"type":"integer","minimum":0},"has_more":{"type":"boolean"}}}}}}}}},"parameters":[{"name":"quarter_from","in":"query","required":false,"description":"Inclusive lower bound on quarter start date (e.g. 2024-01-01 for 2024-Q1)","schema":{"type":"string","format":"date"}},{"name":"quarter_to","in":"query","required":false,"description":"Inclusive upper bound on quarter start date","schema":{"type":"string","format":"date"}},{"name":"limit","in":"query","required":false,"description":"Row limit","schema":{"type":"integer","minimum":1,"maximum":1000,"default":200}},{"name":"offset","in":"query","required":false,"description":"Row offset","schema":{"type":"integer","minimum":0,"default":0}}]},"post":{"tags":["Quarterly Data"],"summary":"Gpay Payments (quarterly) (POST)","description":"**Required Access:** `tier0` (no API key required)\n\nTotal Gnosis Pay payment transactions per quarter.\n\n**Declared Filters:**\n- **quarter_from**: >= on `quarter` (Inclusive lower bound on quarter start date (e.g. 2024-01-01 for 2024-Q1))\n- **quarter_to**: <= on `quarter` (Inclusive upper bound on quarter start date)\n\n**Pagination:**\n- **limit**: default `200`, max `1000`\n- **offset**: default `0`\n\n**Sort:**\n- `quarter DESC`\n\n**Columns:**\n- **quarter** (`Date`): Quarter start date.\n- **payments** (`UInt64`): Total number of payment transactions in the quarter.","operationId":"api_quarterly_data_gpay_payments_post_v1_quarterly_data_gpay_payments_quarterly_post","security":[{"APIKeyHeader":[]}],"requestBody":{"content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/api_quarterly_data_gpay_payments_PostBody"},{"type":"null"}],"title":" Body"}}}},"responses":{"200":{"description":"Paginated response","content":{"application/json":{"schema":{"type":"object","required":["items","pagination"],"properties":{"items":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"quarter":{"type":"string","format":"date","description":"Quarter start date."},"payments":{"type":"integer","description":"Total number of payment transactions in the quarter."}}}},"pagination":{"type":"object","required":["limit","offset","returned","has_more"],"properties":{"limit":{"type":"integer","minimum":1},"offset":{"type":"integer","minimum":0},"returned":{"type":"integer","minimum":0},"has_more":{"type":"boolean"}}}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/quarterly_data/gpay_volume/quarterly":{"get":{"tags":["Quarterly Data"],"summary":"Gpay Volume (quarterly)","description":"**Required Access:** `tier0` (no API key required)\n\nTotal Gnosis Pay payment volume in USD per quarter.\n\n**Declared Filters:**\n- **quarter_from**: >= on `quarter` (Inclusive lower bound on quarter start date (e.g. 2024-01-01 for 2024-Q1))\n- **quarter_to**: <= on `quarter` (Inclusive upper bound on quarter start date)\n\n**Pagination:**\n- **limit**: default `200`, max `1000`\n- **offset**: default `0`\n\n**Sort:**\n- `quarter DESC`\n\n**Columns:**\n- **quarter** (`Date`): Quarter start date.\n- **volume_usd** (`Float64`): Sum of payment volume in USD during the quarter.","operationId":"api_quarterly_data_gpay_volume_get_v1_quarterly_data_gpay_volume_quarterly_get","security":[{"APIKeyHeader":[]}],"responses":{"200":{"description":"Paginated response","content":{"application/json":{"schema":{"type":"object","required":["items","pagination"],"properties":{"items":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"quarter":{"type":"string","format":"date","description":"Quarter start date."},"volume_usd":{"type":"number","description":"Sum of payment volume in USD during the quarter."}}}},"pagination":{"type":"object","required":["limit","offset","returned","has_more"],"properties":{"limit":{"type":"integer","minimum":1},"offset":{"type":"integer","minimum":0},"returned":{"type":"integer","minimum":0},"has_more":{"type":"boolean"}}}}}}}}},"parameters":[{"name":"quarter_from","in":"query","required":false,"description":"Inclusive lower bound on quarter start date (e.g. 2024-01-01 for 2024-Q1)","schema":{"type":"string","format":"date"}},{"name":"quarter_to","in":"query","required":false,"description":"Inclusive upper bound on quarter start date","schema":{"type":"string","format":"date"}},{"name":"limit","in":"query","required":false,"description":"Row limit","schema":{"type":"integer","minimum":1,"maximum":1000,"default":200}},{"name":"offset","in":"query","required":false,"description":"Row offset","schema":{"type":"integer","minimum":0,"default":0}}]},"post":{"tags":["Quarterly Data"],"summary":"Gpay Volume (quarterly) (POST)","description":"**Required Access:** `tier0` (no API key required)\n\nTotal Gnosis Pay payment volume in USD per quarter.\n\n**Declared Filters:**\n- **quarter_from**: >= on `quarter` (Inclusive lower bound on quarter start date (e.g. 2024-01-01 for 2024-Q1))\n- **quarter_to**: <= on `quarter` (Inclusive upper bound on quarter start date)\n\n**Pagination:**\n- **limit**: default `200`, max `1000`\n- **offset**: default `0`\n\n**Sort:**\n- `quarter DESC`\n\n**Columns:**\n- **quarter** (`Date`): Quarter start date.\n- **volume_usd** (`Float64`): Sum of payment volume in USD during the quarter.","operationId":"api_quarterly_data_gpay_volume_post_v1_quarterly_data_gpay_volume_quarterly_post","security":[{"APIKeyHeader":[]}],"requestBody":{"content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/api_quarterly_data_gpay_volume_PostBody"},{"type":"null"}],"title":" Body"}}}},"responses":{"200":{"description":"Paginated response","content":{"application/json":{"schema":{"type":"object","required":["items","pagination"],"properties":{"items":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"quarter":{"type":"string","format":"date","description":"Quarter start date."},"volume_usd":{"type":"number","description":"Sum of payment volume in USD during the quarter."}}}},"pagination":{"type":"object","required":["limit","offset","returned","has_more"],"properties":{"limit":{"type":"integer","minimum":1},"offset":{"type":"integer","minimum":0},"returned":{"type":"integer","minimum":0},"has_more":{"type":"boolean"}}}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/quarterly_data/nodes_estimated/quarterly":{"get":{"tags":["Quarterly Data"],"summary":"Nodes Estimated (quarterly)","description":"**Required Access:** `tier0` (no API key required)\n\nQuarterly end-of-quarter estimated total node count (observed + unobserved) with 95% confidence interval, sourced from the node classification model.\n\n**Declared Filters:**\n- **quarter_from**: >= on `quarter` (Inclusive lower bound on quarter start date (e.g. 2024-01-01 for 2024-Q1))\n- **quarter_to**: <= on `quarter` (Inclusive upper bound on quarter start date)\n\n**Pagination:**\n- **limit**: default `200`, max `1000`\n- **offset**: default `0`\n\n**Sort:**\n- `quarter DESC`\n\n**Columns:**\n- **quarter** (`Date`): Quarter start date.\n- **nodes_estimated** (`UInt64`): Total estimated nodes at end of quarter (sum across all categories).\n- **nodes_lower_95** (`UInt64`): Lower bound of 95% confidence interval for total nodes.\n- **nodes_upper_95** (`UInt64`): Upper bound of 95% confidence interval for total nodes.","operationId":"api_quarterly_data_nodes_estimated_get_v1_quarterly_data_nodes_estimated_quarterly_get","security":[{"APIKeyHeader":[]}],"responses":{"200":{"description":"Paginated response","content":{"application/json":{"schema":{"type":"object","required":["items","pagination"],"properties":{"items":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"quarter":{"type":"string","format":"date","description":"Quarter start date."},"nodes_estimated":{"type":"integer","description":"Total estimated nodes at end of quarter (sum across all categories)."},"nodes_lower_95":{"type":"integer","description":"Lower bound of 95% confidence interval for total nodes."},"nodes_upper_95":{"type":"integer","description":"Upper bound of 95% confidence interval for total nodes."}}}},"pagination":{"type":"object","required":["limit","offset","returned","has_more"],"properties":{"limit":{"type":"integer","minimum":1},"offset":{"type":"integer","minimum":0},"returned":{"type":"integer","minimum":0},"has_more":{"type":"boolean"}}}}}}}}},"parameters":[{"name":"quarter_from","in":"query","required":false,"description":"Inclusive lower bound on quarter start date (e.g. 2024-01-01 for 2024-Q1)","schema":{"type":"string","format":"date"}},{"name":"quarter_to","in":"query","required":false,"description":"Inclusive upper bound on quarter start date","schema":{"type":"string","format":"date"}},{"name":"limit","in":"query","required":false,"description":"Row limit","schema":{"type":"integer","minimum":1,"maximum":1000,"default":200}},{"name":"offset","in":"query","required":false,"description":"Row offset","schema":{"type":"integer","minimum":0,"default":0}}]},"post":{"tags":["Quarterly Data"],"summary":"Nodes Estimated (quarterly) (POST)","description":"**Required Access:** `tier0` (no API key required)\n\nQuarterly end-of-quarter estimated total node count (observed + unobserved) with 95% confidence interval, sourced from the node classification model.\n\n**Declared Filters:**\n- **quarter_from**: >= on `quarter` (Inclusive lower bound on quarter start date (e.g. 2024-01-01 for 2024-Q1))\n- **quarter_to**: <= on `quarter` (Inclusive upper bound on quarter start date)\n\n**Pagination:**\n- **limit**: default `200`, max `1000`\n- **offset**: default `0`\n\n**Sort:**\n- `quarter DESC`\n\n**Columns:**\n- **quarter** (`Date`): Quarter start date.\n- **nodes_estimated** (`UInt64`): Total estimated nodes at end of quarter (sum across all categories).\n- **nodes_lower_95** (`UInt64`): Lower bound of 95% confidence interval for total nodes.\n- **nodes_upper_95** (`UInt64`): Upper bound of 95% confidence interval for total nodes.","operationId":"api_quarterly_data_nodes_estimated_post_v1_quarterly_data_nodes_estimated_quarterly_post","security":[{"APIKeyHeader":[]}],"requestBody":{"content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/api_quarterly_data_nodes_estimated_PostBody"},{"type":"null"}],"title":" Body"}}}},"responses":{"200":{"description":"Paginated response","content":{"application/json":{"schema":{"type":"object","required":["items","pagination"],"properties":{"items":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"quarter":{"type":"string","format":"date","description":"Quarter start date."},"nodes_estimated":{"type":"integer","description":"Total estimated nodes at end of quarter (sum across all categories)."},"nodes_lower_95":{"type":"integer","description":"Lower bound of 95% confidence interval for total nodes."},"nodes_upper_95":{"type":"integer","description":"Upper bound of 95% confidence interval for total nodes."}}}},"pagination":{"type":"object","required":["limit","offset","returned","has_more"],"properties":{"limit":{"type":"integer","minimum":1},"offset":{"type":"integer","minimum":0},"returned":{"type":"integer","minimum":0},"has_more":{"type":"boolean"}}}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/quarterly_data/nodes_observed/quarterly":{"get":{"tags":["Quarterly Data"],"summary":"Nodes Observed (quarterly)","description":"**Required Access:** `tier0` (no API key required)\n\nQuarterly end-of-quarter observed (directly reachable) node count from the node classification model.\n\n**Declared Filters:**\n- **quarter_from**: >= on `quarter` (Inclusive lower bound on quarter start date (e.g. 2024-01-01 for 2024-Q1))\n- **quarter_to**: <= on `quarter` (Inclusive upper bound on quarter start date)\n\n**Pagination:**\n- **limit**: default `200`, max `1000`\n- **offset**: default `0`\n\n**Sort:**\n- `quarter DESC`\n\n**Columns:**\n- **quarter** (`Date`): Quarter start date.\n- **nodes_observed** (`UInt64`): Total observed nodes at end of quarter.","operationId":"api_quarterly_data_nodes_observed_get_v1_quarterly_data_nodes_observed_quarterly_get","security":[{"APIKeyHeader":[]}],"responses":{"200":{"description":"Paginated response","content":{"application/json":{"schema":{"type":"object","required":["items","pagination"],"properties":{"items":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"quarter":{"type":"string","format":"date","description":"Quarter start date."},"nodes_observed":{"type":"integer","description":"Total observed nodes at end of quarter."}}}},"pagination":{"type":"object","required":["limit","offset","returned","has_more"],"properties":{"limit":{"type":"integer","minimum":1},"offset":{"type":"integer","minimum":0},"returned":{"type":"integer","minimum":0},"has_more":{"type":"boolean"}}}}}}}}},"parameters":[{"name":"quarter_from","in":"query","required":false,"description":"Inclusive lower bound on quarter start date (e.g. 2024-01-01 for 2024-Q1)","schema":{"type":"string","format":"date"}},{"name":"quarter_to","in":"query","required":false,"description":"Inclusive upper bound on quarter start date","schema":{"type":"string","format":"date"}},{"name":"limit","in":"query","required":false,"description":"Row limit","schema":{"type":"integer","minimum":1,"maximum":1000,"default":200}},{"name":"offset","in":"query","required":false,"description":"Row offset","schema":{"type":"integer","minimum":0,"default":0}}]},"post":{"tags":["Quarterly Data"],"summary":"Nodes Observed (quarterly) (POST)","description":"**Required Access:** `tier0` (no API key required)\n\nQuarterly end-of-quarter observed (directly reachable) node count from the node classification model.\n\n**Declared Filters:**\n- **quarter_from**: >= on `quarter` (Inclusive lower bound on quarter start date (e.g. 2024-01-01 for 2024-Q1))\n- **quarter_to**: <= on `quarter` (Inclusive upper bound on quarter start date)\n\n**Pagination:**\n- **limit**: default `200`, max `1000`\n- **offset**: default `0`\n\n**Sort:**\n- `quarter DESC`\n\n**Columns:**\n- **quarter** (`Date`): Quarter start date.\n- **nodes_observed** (`UInt64`): Total observed nodes at end of quarter.","operationId":"api_quarterly_data_nodes_observed_post_v1_quarterly_data_nodes_observed_quarterly_post","security":[{"APIKeyHeader":[]}],"requestBody":{"content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/api_quarterly_data_nodes_observed_PostBody"},{"type":"null"}],"title":" Body"}}}},"responses":{"200":{"description":"Paginated response","content":{"application/json":{"schema":{"type":"object","required":["items","pagination"],"properties":{"items":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"quarter":{"type":"string","format":"date","description":"Quarter start date."},"nodes_observed":{"type":"integer","description":"Total observed nodes at end of quarter."}}}},"pagination":{"type":"object","required":["limit","offset","returned","has_more"],"properties":{"limit":{"type":"integer","minimum":1},"offset":{"type":"integer","minimum":0},"returned":{"type":"integer","minimum":0},"has_more":{"type":"boolean"}}}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/quarterly_data/stablecoin_holder_cohorts/quarterly":{"get":{"tags":["Quarterly Data"],"summary":"Stablecoin Holder Cohorts (quarterly)","description":"**Required Access:** `tier0` (no API key required)\n\nEnd-of-quarter stablecoin holder distribution by USD balance bucket, split into USD-pegged (WxDAI, sDAI, USDC, USDC.e, USDT) and non-USD (EURe, GBPe, BRLA, ZCHF, etc.). Excludes BRZ. Shows min/max/avg/median statistics for both holders and value across all days in the quarter. Reads from pre-materialized intermediate table.\n\n\n**Declared Filters:**\n- **quarter_from**: >= on `quarter` (Inclusive lower bound on quarter start date (e.g. 2024-01-01 for 2024-Q1))\n- **quarter_to**: <= on `quarter` (Inclusive upper bound on quarter start date)\n- **peg_class**: = on `peg_class` (Filter by peg class: USD-pegged or non-USD)\n\n**Pagination:**\n- **limit**: default `200`, max `1000`\n- **offset**: default `0`\n\n**Sort:**\n- `quarter DESC`\n\n**Columns:**\n- **quarter** (`Date`): Quarter start date.\n- **peg_class** (`String`): Stablecoin peg classification: 'USD-pegged' or 'non-USD'.\n- **balance_bucket** (`String`): USD balance range bucket (e.g. '0-0.01', '1-10', '100-1k', '1M+').\n- **holders_min** (`UInt64`): Minimum daily holder count in this bucket across the quarter.\n- **holders_max** (`UInt64`): Maximum daily holder count in this bucket across the quarter.\n- **holders_avg** (`Float64`): Average daily holder count in this bucket across the quarter.\n- **holders_median** (`Float64`): Median daily holder count in this bucket across the quarter.\n- **value_min** (`Float64`): Minimum daily total USD value in this bucket across the quarter.\n- **value_max** (`Float64`): Maximum daily total USD value in this bucket across the quarter.\n- **value_avg** (`Float64`): Average daily total USD value in this bucket across the quarter.\n- **value_median** (`Float64`): Median daily total USD value in this bucket across the quarter.\n- **avg_balance_usd** (`Float64`): Average USD balance per holder (value_median / holders_median).","operationId":"api_quarterly_data_stablecoin_holder_cohorts_get_v1_quarterly_data_stablecoin_holder_cohorts_quarterly_get","security":[{"APIKeyHeader":[]}],"responses":{"200":{"description":"Paginated response","content":{"application/json":{"schema":{"type":"object","required":["items","pagination"],"properties":{"items":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"quarter":{"type":"string","format":"date","description":"Quarter start date."},"peg_class":{"type":"string","description":"Stablecoin peg classification: 'USD-pegged' or 'non-USD'."},"balance_bucket":{"type":"string","description":"USD balance range bucket (e.g. '0-0.01', '1-10', '100-1k', '1M+')."},"holders_min":{"type":"integer","description":"Minimum daily holder count in this bucket across the quarter."},"holders_max":{"type":"integer","description":"Maximum daily holder count in this bucket across the quarter."},"holders_avg":{"type":"number","description":"Average daily holder count in this bucket across the quarter."},"holders_median":{"type":"number","description":"Median daily holder count in this bucket across the quarter."},"value_min":{"type":"number","description":"Minimum daily total USD value in this bucket across the quarter."},"value_max":{"type":"number","description":"Maximum daily total USD value in this bucket across the quarter."},"value_avg":{"type":"number","description":"Average daily total USD value in this bucket across the quarter."},"value_median":{"type":"number","description":"Median daily total USD value in this bucket across the quarter."},"avg_balance_usd":{"type":"number","description":"Average USD balance per holder (value_median / holders_median)."}}}},"pagination":{"type":"object","required":["limit","offset","returned","has_more"],"properties":{"limit":{"type":"integer","minimum":1},"offset":{"type":"integer","minimum":0},"returned":{"type":"integer","minimum":0},"has_more":{"type":"boolean"}}}}}}}}},"parameters":[{"name":"quarter_from","in":"query","required":false,"description":"Inclusive lower bound on quarter start date (e.g. 2024-01-01 for 2024-Q1)","schema":{"type":"string","format":"date"}},{"name":"quarter_to","in":"query","required":false,"description":"Inclusive upper bound on quarter start date","schema":{"type":"string","format":"date"}},{"name":"peg_class","in":"query","required":false,"description":"Filter by peg class: USD-pegged or non-USD","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"Row limit","schema":{"type":"integer","minimum":1,"maximum":1000,"default":200}},{"name":"offset","in":"query","required":false,"description":"Row offset","schema":{"type":"integer","minimum":0,"default":0}}]},"post":{"tags":["Quarterly Data"],"summary":"Stablecoin Holder Cohorts (quarterly) (POST)","description":"**Required Access:** `tier0` (no API key required)\n\nEnd-of-quarter stablecoin holder distribution by USD balance bucket, split into USD-pegged (WxDAI, sDAI, USDC, USDC.e, USDT) and non-USD (EURe, GBPe, BRLA, ZCHF, etc.). Excludes BRZ. Shows min/max/avg/median statistics for both holders and value across all days in the quarter. Reads from pre-materialized intermediate table.\n\n\n**Declared Filters:**\n- **quarter_from**: >= on `quarter` (Inclusive lower bound on quarter start date (e.g. 2024-01-01 for 2024-Q1))\n- **quarter_to**: <= on `quarter` (Inclusive upper bound on quarter start date)\n- **peg_class**: = on `peg_class` (Filter by peg class: USD-pegged or non-USD)\n\n**Pagination:**\n- **limit**: default `200`, max `1000`\n- **offset**: default `0`\n\n**Sort:**\n- `quarter DESC`\n\n**Columns:**\n- **quarter** (`Date`): Quarter start date.\n- **peg_class** (`String`): Stablecoin peg classification: 'USD-pegged' or 'non-USD'.\n- **balance_bucket** (`String`): USD balance range bucket (e.g. '0-0.01', '1-10', '100-1k', '1M+').\n- **holders_min** (`UInt64`): Minimum daily holder count in this bucket across the quarter.\n- **holders_max** (`UInt64`): Maximum daily holder count in this bucket across the quarter.\n- **holders_avg** (`Float64`): Average daily holder count in this bucket across the quarter.\n- **holders_median** (`Float64`): Median daily holder count in this bucket across the quarter.\n- **value_min** (`Float64`): Minimum daily total USD value in this bucket across the quarter.\n- **value_max** (`Float64`): Maximum daily total USD value in this bucket across the quarter.\n- **value_avg** (`Float64`): Average daily total USD value in this bucket across the quarter.\n- **value_median** (`Float64`): Median daily total USD value in this bucket across the quarter.\n- **avg_balance_usd** (`Float64`): Average USD balance per holder (value_median / holders_median).","operationId":"api_quarterly_data_stablecoin_holder_cohorts_post_v1_quarterly_data_stablecoin_holder_cohorts_quarterly_post","security":[{"APIKeyHeader":[]}],"requestBody":{"content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/api_quarterly_data_stablecoin_holder_cohorts_PostBody"},{"type":"null"}],"title":" Body"}}}},"responses":{"200":{"description":"Paginated response","content":{"application/json":{"schema":{"type":"object","required":["items","pagination"],"properties":{"items":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"quarter":{"type":"string","format":"date","description":"Quarter start date."},"peg_class":{"type":"string","description":"Stablecoin peg classification: 'USD-pegged' or 'non-USD'."},"balance_bucket":{"type":"string","description":"USD balance range bucket (e.g. '0-0.01', '1-10', '100-1k', '1M+')."},"holders_min":{"type":"integer","description":"Minimum daily holder count in this bucket across the quarter."},"holders_max":{"type":"integer","description":"Maximum daily holder count in this bucket across the quarter."},"holders_avg":{"type":"number","description":"Average daily holder count in this bucket across the quarter."},"holders_median":{"type":"number","description":"Median daily holder count in this bucket across the quarter."},"value_min":{"type":"number","description":"Minimum daily total USD value in this bucket across the quarter."},"value_max":{"type":"number","description":"Maximum daily total USD value in this bucket across the quarter."},"value_avg":{"type":"number","description":"Average daily total USD value in this bucket across the quarter."},"value_median":{"type":"number","description":"Median daily total USD value in this bucket across the quarter."},"avg_balance_usd":{"type":"number","description":"Average USD balance per holder (value_median / holders_median)."}}}},"pagination":{"type":"object","required":["limit","offset","returned","has_more"],"properties":{"limit":{"type":"integer","minimum":1},"offset":{"type":"integer","minimum":0},"returned":{"type":"integer","minimum":0},"has_more":{"type":"boolean"}}}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/quarterly_data/stablecoin_holders/quarterly":{"get":{"tags":["Quarterly Data"],"summary":"Stablecoin Holders (quarterly)","description":"**Required Access:** `tier0` (no API key required)\n\nQuarterly stablecoin holder statistics on Gnosis Chain, split by peg class plus a 'total' row (column-wise sum of the two classes; total holders_median is the sum of per-class medians). Shows median, max, and average of daily holder count across all days in the quarter. Note: holders are summed across tokens so an address holding multiple stablecoins is counted once per token. Excludes BRZ.\n\n\n**Declared Filters:**\n- **quarter_from**: >= on `quarter` (Inclusive lower bound on quarter start date (e.g. 2024-01-01 for 2024-Q1))\n- **quarter_to**: <= on `quarter` (Inclusive upper bound on quarter start date)\n- **peg_class**: = on `peg_class` (Filter by peg class: USD-pegged or non-USD)\n\n**Pagination:**\n- **limit**: default `200`, max `1000`\n- **offset**: default `0`\n\n**Sort:**\n- `quarter DESC`\n\n**Columns:**\n- **quarter** (`Date`): Quarter start date.\n- **peg_class** (`String`): Stablecoin peg classification: 'USD-pegged', 'non-USD', or 'total' (column-wise sum of the two classes).\n- **holders_min** (`UInt64`): Minimum daily holder count observed in the quarter.\n- **holders_max** (`UInt64`): Maximum daily holder count observed in the quarter.\n- **holders_avg** (`Float64`): Average daily holder count across all days in the quarter.\n- **holders_median** (`Float64`): Median daily holder count across all days in the quarter.\n- **tokens_included** (`String`): Comma-separated list of tokens in this peg class.","operationId":"api_quarterly_data_stablecoin_holders_get_v1_quarterly_data_stablecoin_holders_quarterly_get","security":[{"APIKeyHeader":[]}],"responses":{"200":{"description":"Paginated response","content":{"application/json":{"schema":{"type":"object","required":["items","pagination"],"properties":{"items":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"quarter":{"type":"string","format":"date","description":"Quarter start date."},"peg_class":{"type":"string","description":"Stablecoin peg classification: 'USD-pegged', 'non-USD', or 'total' (column-wise sum of the two classes)."},"holders_min":{"type":"integer","description":"Minimum daily holder count observed in the quarter."},"holders_max":{"type":"integer","description":"Maximum daily holder count observed in the quarter."},"holders_avg":{"type":"number","description":"Average daily holder count across all days in the quarter."},"holders_median":{"type":"number","description":"Median daily holder count across all days in the quarter."},"tokens_included":{"type":"string","description":"Comma-separated list of tokens in this peg class."}}}},"pagination":{"type":"object","required":["limit","offset","returned","has_more"],"properties":{"limit":{"type":"integer","minimum":1},"offset":{"type":"integer","minimum":0},"returned":{"type":"integer","minimum":0},"has_more":{"type":"boolean"}}}}}}}}},"parameters":[{"name":"quarter_from","in":"query","required":false,"description":"Inclusive lower bound on quarter start date (e.g. 2024-01-01 for 2024-Q1)","schema":{"type":"string","format":"date"}},{"name":"quarter_to","in":"query","required":false,"description":"Inclusive upper bound on quarter start date","schema":{"type":"string","format":"date"}},{"name":"peg_class","in":"query","required":false,"description":"Filter by peg class: USD-pegged or non-USD","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"Row limit","schema":{"type":"integer","minimum":1,"maximum":1000,"default":200}},{"name":"offset","in":"query","required":false,"description":"Row offset","schema":{"type":"integer","minimum":0,"default":0}}]},"post":{"tags":["Quarterly Data"],"summary":"Stablecoin Holders (quarterly) (POST)","description":"**Required Access:** `tier0` (no API key required)\n\nQuarterly stablecoin holder statistics on Gnosis Chain, split by peg class plus a 'total' row (column-wise sum of the two classes; total holders_median is the sum of per-class medians). Shows median, max, and average of daily holder count across all days in the quarter. Note: holders are summed across tokens so an address holding multiple stablecoins is counted once per token. Excludes BRZ.\n\n\n**Declared Filters:**\n- **quarter_from**: >= on `quarter` (Inclusive lower bound on quarter start date (e.g. 2024-01-01 for 2024-Q1))\n- **quarter_to**: <= on `quarter` (Inclusive upper bound on quarter start date)\n- **peg_class**: = on `peg_class` (Filter by peg class: USD-pegged or non-USD)\n\n**Pagination:**\n- **limit**: default `200`, max `1000`\n- **offset**: default `0`\n\n**Sort:**\n- `quarter DESC`\n\n**Columns:**\n- **quarter** (`Date`): Quarter start date.\n- **peg_class** (`String`): Stablecoin peg classification: 'USD-pegged', 'non-USD', or 'total' (column-wise sum of the two classes).\n- **holders_min** (`UInt64`): Minimum daily holder count observed in the quarter.\n- **holders_max** (`UInt64`): Maximum daily holder count observed in the quarter.\n- **holders_avg** (`Float64`): Average daily holder count across all days in the quarter.\n- **holders_median** (`Float64`): Median daily holder count across all days in the quarter.\n- **tokens_included** (`String`): Comma-separated list of tokens in this peg class.","operationId":"api_quarterly_data_stablecoin_holders_post_v1_quarterly_data_stablecoin_holders_quarterly_post","security":[{"APIKeyHeader":[]}],"requestBody":{"content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/api_quarterly_data_stablecoin_holders_PostBody"},{"type":"null"}],"title":" Body"}}}},"responses":{"200":{"description":"Paginated response","content":{"application/json":{"schema":{"type":"object","required":["items","pagination"],"properties":{"items":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"quarter":{"type":"string","format":"date","description":"Quarter start date."},"peg_class":{"type":"string","description":"Stablecoin peg classification: 'USD-pegged', 'non-USD', or 'total' (column-wise sum of the two classes)."},"holders_min":{"type":"integer","description":"Minimum daily holder count observed in the quarter."},"holders_max":{"type":"integer","description":"Maximum daily holder count observed in the quarter."},"holders_avg":{"type":"number","description":"Average daily holder count across all days in the quarter."},"holders_median":{"type":"number","description":"Median daily holder count across all days in the quarter."},"tokens_included":{"type":"string","description":"Comma-separated list of tokens in this peg class."}}}},"pagination":{"type":"object","required":["limit","offset","returned","has_more"],"properties":{"limit":{"type":"integer","minimum":1},"offset":{"type":"integer","minimum":0},"returned":{"type":"integer","minimum":0},"has_more":{"type":"boolean"}}}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/quarterly_data/stablecoin_supply/quarterly":{"get":{"tags":["Quarterly Data"],"summary":"Stablecoin Supply (quarterly)","description":"**Required Access:** `tier0` (no API key required)\n\nQuarterly stablecoin supply statistics on Gnosis Chain, split by peg class (USD-pegged vs non-USD) plus a 'total' row. Shows median, max, and average of daily supply across all days in the quarter. The 'total' row is the column-wise sum of the two per-class rows, so its supply_median is the sum of the per-class medians (matching the report's Total), not the median of the daily grand-total series. Excludes BRZ.\n\n\n**Declared Filters:**\n- **quarter_from**: >= on `quarter` (Inclusive lower bound on quarter start date (e.g. 2024-01-01 for 2024-Q1))\n- **quarter_to**: <= on `quarter` (Inclusive upper bound on quarter start date)\n- **peg_class**: = on `peg_class` (Filter by peg class: USD-pegged or non-USD)\n\n**Pagination:**\n- **limit**: default `200`, max `1000`\n- **offset**: default `0`\n\n**Sort:**\n- `quarter DESC`\n\n**Columns:**\n- **quarter** (`Date`): Quarter start date.\n- **peg_class** (`String`): Stablecoin peg classification: 'USD-pegged', 'non-USD', or 'total' (column-wise sum of the two classes).\n- **supply_min** (`Float64`): Minimum daily total supply (USD) observed in the quarter.\n- **supply_max** (`Float64`): Maximum daily total supply (USD) observed in the quarter.\n- **supply_avg** (`Float64`): Average daily total supply (USD) across all days in the quarter.\n- **supply_median** (`Float64`): Median daily total supply (USD) across all days in the quarter.\n- **tokens_included** (`String`): Comma-separated list of tokens in this peg class.","operationId":"api_quarterly_data_stablecoin_supply_get_v1_quarterly_data_stablecoin_supply_quarterly_get","security":[{"APIKeyHeader":[]}],"responses":{"200":{"description":"Paginated response","content":{"application/json":{"schema":{"type":"object","required":["items","pagination"],"properties":{"items":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"quarter":{"type":"string","format":"date","description":"Quarter start date."},"peg_class":{"type":"string","description":"Stablecoin peg classification: 'USD-pegged', 'non-USD', or 'total' (column-wise sum of the two classes)."},"supply_min":{"type":"number","description":"Minimum daily total supply (USD) observed in the quarter."},"supply_max":{"type":"number","description":"Maximum daily total supply (USD) observed in the quarter."},"supply_avg":{"type":"number","description":"Average daily total supply (USD) across all days in the quarter."},"supply_median":{"type":"number","description":"Median daily total supply (USD) across all days in the quarter."},"tokens_included":{"type":"string","description":"Comma-separated list of tokens in this peg class."}}}},"pagination":{"type":"object","required":["limit","offset","returned","has_more"],"properties":{"limit":{"type":"integer","minimum":1},"offset":{"type":"integer","minimum":0},"returned":{"type":"integer","minimum":0},"has_more":{"type":"boolean"}}}}}}}}},"parameters":[{"name":"quarter_from","in":"query","required":false,"description":"Inclusive lower bound on quarter start date (e.g. 2024-01-01 for 2024-Q1)","schema":{"type":"string","format":"date"}},{"name":"quarter_to","in":"query","required":false,"description":"Inclusive upper bound on quarter start date","schema":{"type":"string","format":"date"}},{"name":"peg_class","in":"query","required":false,"description":"Filter by peg class: USD-pegged or non-USD","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"Row limit","schema":{"type":"integer","minimum":1,"maximum":1000,"default":200}},{"name":"offset","in":"query","required":false,"description":"Row offset","schema":{"type":"integer","minimum":0,"default":0}}]},"post":{"tags":["Quarterly Data"],"summary":"Stablecoin Supply (quarterly) (POST)","description":"**Required Access:** `tier0` (no API key required)\n\nQuarterly stablecoin supply statistics on Gnosis Chain, split by peg class (USD-pegged vs non-USD) plus a 'total' row. Shows median, max, and average of daily supply across all days in the quarter. The 'total' row is the column-wise sum of the two per-class rows, so its supply_median is the sum of the per-class medians (matching the report's Total), not the median of the daily grand-total series. Excludes BRZ.\n\n\n**Declared Filters:**\n- **quarter_from**: >= on `quarter` (Inclusive lower bound on quarter start date (e.g. 2024-01-01 for 2024-Q1))\n- **quarter_to**: <= on `quarter` (Inclusive upper bound on quarter start date)\n- **peg_class**: = on `peg_class` (Filter by peg class: USD-pegged or non-USD)\n\n**Pagination:**\n- **limit**: default `200`, max `1000`\n- **offset**: default `0`\n\n**Sort:**\n- `quarter DESC`\n\n**Columns:**\n- **quarter** (`Date`): Quarter start date.\n- **peg_class** (`String`): Stablecoin peg classification: 'USD-pegged', 'non-USD', or 'total' (column-wise sum of the two classes).\n- **supply_min** (`Float64`): Minimum daily total supply (USD) observed in the quarter.\n- **supply_max** (`Float64`): Maximum daily total supply (USD) observed in the quarter.\n- **supply_avg** (`Float64`): Average daily total supply (USD) across all days in the quarter.\n- **supply_median** (`Float64`): Median daily total supply (USD) across all days in the quarter.\n- **tokens_included** (`String`): Comma-separated list of tokens in this peg class.","operationId":"api_quarterly_data_stablecoin_supply_post_v1_quarterly_data_stablecoin_supply_quarterly_post","security":[{"APIKeyHeader":[]}],"requestBody":{"content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/api_quarterly_data_stablecoin_supply_PostBody"},{"type":"null"}],"title":" Body"}}}},"responses":{"200":{"description":"Paginated response","content":{"application/json":{"schema":{"type":"object","required":["items","pagination"],"properties":{"items":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"quarter":{"type":"string","format":"date","description":"Quarter start date."},"peg_class":{"type":"string","description":"Stablecoin peg classification: 'USD-pegged', 'non-USD', or 'total' (column-wise sum of the two classes)."},"supply_min":{"type":"number","description":"Minimum daily total supply (USD) observed in the quarter."},"supply_max":{"type":"number","description":"Maximum daily total supply (USD) observed in the quarter."},"supply_avg":{"type":"number","description":"Average daily total supply (USD) across all days in the quarter."},"supply_median":{"type":"number","description":"Median daily total supply (USD) across all days in the quarter."},"tokens_included":{"type":"string","description":"Comma-separated list of tokens in this peg class."}}}},"pagination":{"type":"object","required":["limit","offset","returned","has_more"],"properties":{"limit":{"type":"integer","minimum":1},"offset":{"type":"integer","minimum":0},"returned":{"type":"integer","minimum":0},"has_more":{"type":"boolean"}}}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/quarterly_data/stablecoin_transfers/quarterly":{"get":{"tags":["Quarterly Data"],"summary":"Stablecoin Transfers (quarterly)","description":"**Required Access:** `tier0` (no API key required)\n\nQuarterly stablecoin transfer count and volume on Gnosis Chain, split by peg class (USD-pegged vs non-USD) plus a 'total' row (plain sum across classes = exact grand-total transfer count and volume). Excludes BRZ.\n\n\n**Declared Filters:**\n- **quarter_from**: >= on `quarter` (Inclusive lower bound on quarter start date (e.g. 2024-01-01 for 2024-Q1))\n- **quarter_to**: <= on `quarter` (Inclusive upper bound on quarter start date)\n- **peg_class**: = on `peg_class` (Filter by peg class: USD-pegged or non-USD)\n\n**Pagination:**\n- **limit**: default `200`, max `1000`\n- **offset**: default `0`\n\n**Sort:**\n- `quarter DESC`\n\n**Columns:**\n- **quarter** (`Date`): Quarter start date.\n- **peg_class** (`String`): Stablecoin peg classification: 'USD-pegged', 'non-USD', or 'total' (sum across both classes).\n- **transfers** (`UInt64`): Total number of stablecoin transfers in the quarter.\n- **volume_usd** (`Float64`): Total stablecoin transfer volume in USD for the quarter.\n- **tokens_included** (`String`): Comma-separated list of tokens in this peg class.","operationId":"api_quarterly_data_stablecoin_transfers_get_v1_quarterly_data_stablecoin_transfers_quarterly_get","security":[{"APIKeyHeader":[]}],"responses":{"200":{"description":"Paginated response","content":{"application/json":{"schema":{"type":"object","required":["items","pagination"],"properties":{"items":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"quarter":{"type":"string","format":"date","description":"Quarter start date."},"peg_class":{"type":"string","description":"Stablecoin peg classification: 'USD-pegged', 'non-USD', or 'total' (sum across both classes)."},"transfers":{"type":"integer","description":"Total number of stablecoin transfers in the quarter."},"volume_usd":{"type":"number","description":"Total stablecoin transfer volume in USD for the quarter."},"tokens_included":{"type":"string","description":"Comma-separated list of tokens in this peg class."}}}},"pagination":{"type":"object","required":["limit","offset","returned","has_more"],"properties":{"limit":{"type":"integer","minimum":1},"offset":{"type":"integer","minimum":0},"returned":{"type":"integer","minimum":0},"has_more":{"type":"boolean"}}}}}}}}},"parameters":[{"name":"quarter_from","in":"query","required":false,"description":"Inclusive lower bound on quarter start date (e.g. 2024-01-01 for 2024-Q1)","schema":{"type":"string","format":"date"}},{"name":"quarter_to","in":"query","required":false,"description":"Inclusive upper bound on quarter start date","schema":{"type":"string","format":"date"}},{"name":"peg_class","in":"query","required":false,"description":"Filter by peg class: USD-pegged or non-USD","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"Row limit","schema":{"type":"integer","minimum":1,"maximum":1000,"default":200}},{"name":"offset","in":"query","required":false,"description":"Row offset","schema":{"type":"integer","minimum":0,"default":0}}]},"post":{"tags":["Quarterly Data"],"summary":"Stablecoin Transfers (quarterly) (POST)","description":"**Required Access:** `tier0` (no API key required)\n\nQuarterly stablecoin transfer count and volume on Gnosis Chain, split by peg class (USD-pegged vs non-USD) plus a 'total' row (plain sum across classes = exact grand-total transfer count and volume). Excludes BRZ.\n\n\n**Declared Filters:**\n- **quarter_from**: >= on `quarter` (Inclusive lower bound on quarter start date (e.g. 2024-01-01 for 2024-Q1))\n- **quarter_to**: <= on `quarter` (Inclusive upper bound on quarter start date)\n- **peg_class**: = on `peg_class` (Filter by peg class: USD-pegged or non-USD)\n\n**Pagination:**\n- **limit**: default `200`, max `1000`\n- **offset**: default `0`\n\n**Sort:**\n- `quarter DESC`\n\n**Columns:**\n- **quarter** (`Date`): Quarter start date.\n- **peg_class** (`String`): Stablecoin peg classification: 'USD-pegged', 'non-USD', or 'total' (sum across both classes).\n- **transfers** (`UInt64`): Total number of stablecoin transfers in the quarter.\n- **volume_usd** (`Float64`): Total stablecoin transfer volume in USD for the quarter.\n- **tokens_included** (`String`): Comma-separated list of tokens in this peg class.","operationId":"api_quarterly_data_stablecoin_transfers_post_v1_quarterly_data_stablecoin_transfers_quarterly_post","security":[{"APIKeyHeader":[]}],"requestBody":{"content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/api_quarterly_data_stablecoin_transfers_PostBody"},{"type":"null"}],"title":" Body"}}}},"responses":{"200":{"description":"Paginated response","content":{"application/json":{"schema":{"type":"object","required":["items","pagination"],"properties":{"items":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"quarter":{"type":"string","format":"date","description":"Quarter start date."},"peg_class":{"type":"string","description":"Stablecoin peg classification: 'USD-pegged', 'non-USD', or 'total' (sum across both classes)."},"transfers":{"type":"integer","description":"Total number of stablecoin transfers in the quarter."},"volume_usd":{"type":"number","description":"Total stablecoin transfer volume in USD for the quarter."},"tokens_included":{"type":"string","description":"Comma-separated list of tokens in this peg class."}}}},"pagination":{"type":"object","required":["limit","offset","returned","has_more"],"properties":{"limit":{"type":"integer","minimum":1},"offset":{"type":"integer","minimum":0},"returned":{"type":"integer","minimum":0},"has_more":{"type":"boolean"}}}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/quarterly_data/staked_gno/quarterly":{"get":{"tags":["Quarterly Data"],"summary":"Staked Gno (quarterly)","description":"**Required Access:** `tier0` (no API key required)\n\nEnd-of-quarter GNO staked on Gnosis Chain (effective balance in real GNO; mGNO->GNO conversion happens upstream in int_consensus_validators_balances_daily).\n\n**Declared Filters:**\n- **quarter_from**: >= on `quarter` (Inclusive lower bound on quarter start date (e.g. 2024-01-01 for 2024-Q1))\n- **quarter_to**: <= on `quarter` (Inclusive upper bound on quarter start date)\n\n**Pagination:**\n- **limit**: default `200`, max `1000`\n- **offset**: default `0`\n\n**Sort:**\n- `quarter DESC`\n\n**Columns:**\n- **quarter** (`Date`): Quarter start date.\n- **staked_gno** (`Float64`): Total GNO staked at end of quarter.","operationId":"api_quarterly_data_staked_gno_get_v1_quarterly_data_staked_gno_quarterly_get","security":[{"APIKeyHeader":[]}],"responses":{"200":{"description":"Paginated response","content":{"application/json":{"schema":{"type":"object","required":["items","pagination"],"properties":{"items":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"quarter":{"type":"string","format":"date","description":"Quarter start date."},"staked_gno":{"type":"number","description":"Total GNO staked at end of quarter."}}}},"pagination":{"type":"object","required":["limit","offset","returned","has_more"],"properties":{"limit":{"type":"integer","minimum":1},"offset":{"type":"integer","minimum":0},"returned":{"type":"integer","minimum":0},"has_more":{"type":"boolean"}}}}}}}}},"parameters":[{"name":"quarter_from","in":"query","required":false,"description":"Inclusive lower bound on quarter start date (e.g. 2024-01-01 for 2024-Q1)","schema":{"type":"string","format":"date"}},{"name":"quarter_to","in":"query","required":false,"description":"Inclusive upper bound on quarter start date","schema":{"type":"string","format":"date"}},{"name":"limit","in":"query","required":false,"description":"Row limit","schema":{"type":"integer","minimum":1,"maximum":1000,"default":200}},{"name":"offset","in":"query","required":false,"description":"Row offset","schema":{"type":"integer","minimum":0,"default":0}}]},"post":{"tags":["Quarterly Data"],"summary":"Staked Gno (quarterly) (POST)","description":"**Required Access:** `tier0` (no API key required)\n\nEnd-of-quarter GNO staked on Gnosis Chain (effective balance in real GNO; mGNO->GNO conversion happens upstream in int_consensus_validators_balances_daily).\n\n**Declared Filters:**\n- **quarter_from**: >= on `quarter` (Inclusive lower bound on quarter start date (e.g. 2024-01-01 for 2024-Q1))\n- **quarter_to**: <= on `quarter` (Inclusive upper bound on quarter start date)\n\n**Pagination:**\n- **limit**: default `200`, max `1000`\n- **offset**: default `0`\n\n**Sort:**\n- `quarter DESC`\n\n**Columns:**\n- **quarter** (`Date`): Quarter start date.\n- **staked_gno** (`Float64`): Total GNO staked at end of quarter.","operationId":"api_quarterly_data_staked_gno_post_v1_quarterly_data_staked_gno_quarterly_post","security":[{"APIKeyHeader":[]}],"requestBody":{"content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/api_quarterly_data_staked_gno_PostBody"},{"type":"null"}],"title":" Body"}}}},"responses":{"200":{"description":"Paginated response","content":{"application/json":{"schema":{"type":"object","required":["items","pagination"],"properties":{"items":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"quarter":{"type":"string","format":"date","description":"Quarter start date."},"staked_gno":{"type":"number","description":"Total GNO staked at end of quarter."}}}},"pagination":{"type":"object","required":["limit","offset","returned","has_more"],"properties":{"limit":{"type":"integer","minimum":1},"offset":{"type":"integer","minimum":0},"returned":{"type":"integer","minimum":0},"has_more":{"type":"boolean"}}}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/quarterly_data/transactions_count/quarterly":{"get":{"tags":["Quarterly Data"],"summary":"Transactions Count (quarterly)","description":"**Required Access:** `tier0` (no API key required)\n\nTotal successful transactions per quarter on Gnosis Chain.\n\n**Declared Filters:**\n- **quarter_from**: >= on `quarter` (Inclusive lower bound on quarter start date (e.g. 2024-01-01 for 2024-Q1))\n- **quarter_to**: <= on `quarter` (Inclusive upper bound on quarter start date)\n\n**Pagination:**\n- **limit**: default `200`, max `1000`\n- **offset**: default `0`\n\n**Sort:**\n- `quarter DESC`\n\n**Columns:**\n- **quarter** (`Date`): Quarter start date.\n- **transactions** (`UInt64`): Total number of successful transactions in the quarter.","operationId":"api_quarterly_data_transactions_count_get_v1_quarterly_data_transactions_count_quarterly_get","security":[{"APIKeyHeader":[]}],"responses":{"200":{"description":"Paginated response","content":{"application/json":{"schema":{"type":"object","required":["items","pagination"],"properties":{"items":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"quarter":{"type":"string","format":"date","description":"Quarter start date."},"transactions":{"type":"integer","description":"Total number of successful transactions in the quarter."}}}},"pagination":{"type":"object","required":["limit","offset","returned","has_more"],"properties":{"limit":{"type":"integer","minimum":1},"offset":{"type":"integer","minimum":0},"returned":{"type":"integer","minimum":0},"has_more":{"type":"boolean"}}}}}}}}},"parameters":[{"name":"quarter_from","in":"query","required":false,"description":"Inclusive lower bound on quarter start date (e.g. 2024-01-01 for 2024-Q1)","schema":{"type":"string","format":"date"}},{"name":"quarter_to","in":"query","required":false,"description":"Inclusive upper bound on quarter start date","schema":{"type":"string","format":"date"}},{"name":"limit","in":"query","required":false,"description":"Row limit","schema":{"type":"integer","minimum":1,"maximum":1000,"default":200}},{"name":"offset","in":"query","required":false,"description":"Row offset","schema":{"type":"integer","minimum":0,"default":0}}]},"post":{"tags":["Quarterly Data"],"summary":"Transactions Count (quarterly) (POST)","description":"**Required Access:** `tier0` (no API key required)\n\nTotal successful transactions per quarter on Gnosis Chain.\n\n**Declared Filters:**\n- **quarter_from**: >= on `quarter` (Inclusive lower bound on quarter start date (e.g. 2024-01-01 for 2024-Q1))\n- **quarter_to**: <= on `quarter` (Inclusive upper bound on quarter start date)\n\n**Pagination:**\n- **limit**: default `200`, max `1000`\n- **offset**: default `0`\n\n**Sort:**\n- `quarter DESC`\n\n**Columns:**\n- **quarter** (`Date`): Quarter start date.\n- **transactions** (`UInt64`): Total number of successful transactions in the quarter.","operationId":"api_quarterly_data_transactions_count_post_v1_quarterly_data_transactions_count_quarterly_post","security":[{"APIKeyHeader":[]}],"requestBody":{"content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/api_quarterly_data_transactions_count_PostBody"},{"type":"null"}],"title":" Body"}}}},"responses":{"200":{"description":"Paginated response","content":{"application/json":{"schema":{"type":"object","required":["items","pagination"],"properties":{"items":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"quarter":{"type":"string","format":"date","description":"Quarter start date."},"transactions":{"type":"integer","description":"Total number of successful transactions in the quarter."}}}},"pagination":{"type":"object","required":["limit","offset","returned","has_more"],"properties":{"limit":{"type":"integer","minimum":1},"offset":{"type":"integer","minimum":0},"returned":{"type":"integer","minimum":0},"has_more":{"type":"boolean"}}}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/quarterly_data/validators_active/quarterly":{"get":{"tags":["Quarterly Data"],"summary":"Validators Active (quarterly)","description":"**Required Access:** `tier0` (no API key required)\n\nEnd-of-quarter count of active validators on Gnosis Chain (the full active set = active_ongoing + active_exiting), matching public beacon explorers.\n\n**Declared Filters:**\n- **quarter_from**: >= on `quarter` (Inclusive lower bound on quarter start date (e.g. 2024-01-01 for 2024-Q1))\n- **quarter_to**: <= on `quarter` (Inclusive upper bound on quarter start date)\n\n**Pagination:**\n- **limit**: default `200`, max `1000`\n- **offset**: default `0`\n\n**Sort:**\n- `quarter DESC`\n\n**Columns:**\n- **quarter** (`Date`): Quarter start date.\n- **validators_active** (`UInt64`): Number of active validators at end of quarter — active_ongoing plus active_exiting (both attest and remain staked until exit completes).","operationId":"api_quarterly_data_validators_active_get_v1_quarterly_data_validators_active_quarterly_get","security":[{"APIKeyHeader":[]}],"responses":{"200":{"description":"Paginated response","content":{"application/json":{"schema":{"type":"object","required":["items","pagination"],"properties":{"items":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"quarter":{"type":"string","format":"date","description":"Quarter start date."},"validators_active":{"type":"integer","description":"Number of active validators at end of quarter — active_ongoing plus active_exiting (both attest and remain staked until exit completes)."}}}},"pagination":{"type":"object","required":["limit","offset","returned","has_more"],"properties":{"limit":{"type":"integer","minimum":1},"offset":{"type":"integer","minimum":0},"returned":{"type":"integer","minimum":0},"has_more":{"type":"boolean"}}}}}}}}},"parameters":[{"name":"quarter_from","in":"query","required":false,"description":"Inclusive lower bound on quarter start date (e.g. 2024-01-01 for 2024-Q1)","schema":{"type":"string","format":"date"}},{"name":"quarter_to","in":"query","required":false,"description":"Inclusive upper bound on quarter start date","schema":{"type":"string","format":"date"}},{"name":"limit","in":"query","required":false,"description":"Row limit","schema":{"type":"integer","minimum":1,"maximum":1000,"default":200}},{"name":"offset","in":"query","required":false,"description":"Row offset","schema":{"type":"integer","minimum":0,"default":0}}]},"post":{"tags":["Quarterly Data"],"summary":"Validators Active (quarterly) (POST)","description":"**Required Access:** `tier0` (no API key required)\n\nEnd-of-quarter count of active validators on Gnosis Chain (the full active set = active_ongoing + active_exiting), matching public beacon explorers.\n\n**Declared Filters:**\n- **quarter_from**: >= on `quarter` (Inclusive lower bound on quarter start date (e.g. 2024-01-01 for 2024-Q1))\n- **quarter_to**: <= on `quarter` (Inclusive upper bound on quarter start date)\n\n**Pagination:**\n- **limit**: default `200`, max `1000`\n- **offset**: default `0`\n\n**Sort:**\n- `quarter DESC`\n\n**Columns:**\n- **quarter** (`Date`): Quarter start date.\n- **validators_active** (`UInt64`): Number of active validators at end of quarter — active_ongoing plus active_exiting (both attest and remain staked until exit completes).","operationId":"api_quarterly_data_validators_active_post_v1_quarterly_data_validators_active_quarterly_post","security":[{"APIKeyHeader":[]}],"requestBody":{"content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/api_quarterly_data_validators_active_PostBody"},{"type":"null"}],"title":" Body"}}}},"responses":{"200":{"description":"Paginated response","content":{"application/json":{"schema":{"type":"object","required":["items","pagination"],"properties":{"items":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"quarter":{"type":"string","format":"date","description":"Quarter start date."},"validators_active":{"type":"integer","description":"Number of active validators at end of quarter — active_ongoing plus active_exiting (both attest and remain staked until exit completes)."}}}},"pagination":{"type":"object","required":["limit","offset","returned","has_more"],"properties":{"limit":{"type":"integer","minimum":1},"offset":{"type":"integer","minimum":0},"returned":{"type":"integer","minimum":0},"has_more":{"type":"boolean"}}}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/revenue/revenue_active_users_cohorts/weekly":{"get":{"tags":["Revenue"],"summary":"Revenue Active Users Cohorts (weekly)","description":"**Required Access:** `tier1`\n\nAPI view over fct_revenue_active_users_cohorts_weekly.\n\n**Declared Filters:**\n- **cohort**: = on `cohort` (Cohort bucket)\n- **start_date**: >= on `week` (Inclusive start week)\n- **end_date**: <= on `week` (Inclusive end week)\n\n**Sort:**\n- `week DESC`\n\n**Columns:**\n- **week** (`Date`): Week start.\n- **cohort** (`String`): Annualised $-bucket (includes `<1`).\n- **annual_rolling_fees_total** (`Float64`): Sum of rolling-52w fees across all streams for users in this cohort.\n- **users_cnt** (`UInt64`): Unique users in this cohort.","operationId":"api_revenue_active_users_cohorts_weekly_get_v1_revenue_revenue_active_users_cohorts_weekly_get","security":[{"APIKeyHeader":[]}],"responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"week":{"type":"string","format":"date","description":"Week start."},"cohort":{"type":"string","description":"Annualised $-bucket (includes `<1`)."},"annual_rolling_fees_total":{"type":"number","description":"Sum of rolling-52w fees across all streams for users in this cohort."},"users_cnt":{"type":"integer","description":"Unique users in this cohort."}}}}}}}},"parameters":[{"name":"cohort","in":"query","required":false,"description":"Cohort bucket","schema":{"type":"string"}},{"name":"start_date","in":"query","required":false,"description":"Inclusive start week","schema":{"type":"string","format":"date"}},{"name":"end_date","in":"query","required":false,"description":"Inclusive end week","schema":{"type":"string","format":"date"}}]}},"/v1/revenue/revenue_active_users_cohorts/monthly":{"get":{"tags":["Revenue"],"summary":"Revenue Active Users Cohorts (monthly)","description":"**Required Access:** `tier1`\n\nAPI view over fct_revenue_active_users_cohorts_monthly.\n\n**Declared Filters:**\n- **cohort**: = on `cohort` (Cohort bucket)\n- **start_date**: >= on `month` (Inclusive start month)\n- **end_date**: <= on `month` (Inclusive end month)\n\n**Sort:**\n- `month DESC`\n\n**Columns:**\n- **month** (`Date`): First day of the month.\n- **cohort** (`String`): Monthly $-bucket.\n- **fees_total** (`Float64`): Sum of monthly fees across all streams.\n- **users_cnt** (`UInt64`): Unique users in this cohort.","operationId":"api_revenue_active_users_cohorts_monthly_get_v1_revenue_revenue_active_users_cohorts_monthly_get","security":[{"APIKeyHeader":[]}],"responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"month":{"type":"string","format":"date","description":"First day of the month."},"cohort":{"type":"string","description":"Monthly $-bucket."},"fees_total":{"type":"number","description":"Sum of monthly fees across all streams."},"users_cnt":{"type":"integer","description":"Unique users in this cohort."}}}}}}}},"parameters":[{"name":"cohort","in":"query","required":false,"description":"Cohort bucket","schema":{"type":"string"}},{"name":"start_date","in":"query","required":false,"description":"Inclusive start month","schema":{"type":"string","format":"date"}},{"name":"end_date","in":"query","required":false,"description":"Inclusive end month","schema":{"type":"string","format":"date"}}]}},"/v1/revenue/revenue_active_users_totals/weekly":{"get":{"tags":["Revenue"],"summary":"Revenue Active Users Totals (weekly)","description":"**Required Access:** `tier1`\n\nAPI view over int_revenue_active_users_totals_weekly.\n\n**Declared Filters:**\n- **start_date**: >= on `week` (Inclusive start week)\n- **end_date**: <= on `week` (Inclusive end week)\n\n**Sort:**\n- `week DESC`\n\n**Columns:**\n- **week** (`Date`): Week start.\n- **users_cnt** (`UInt64`): Unique users above the $6/year threshold.\n- **annual_rolling_fees_total** (`Float64`): Sum of rolling-52w fees from qualifying users.","operationId":"api_revenue_active_users_totals_weekly_get_v1_revenue_revenue_active_users_totals_weekly_get","security":[{"APIKeyHeader":[]}],"responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"week":{"type":"string","format":"date","description":"Week start."},"users_cnt":{"type":"integer","description":"Unique users above the $6/year threshold."},"annual_rolling_fees_total":{"type":"number","description":"Sum of rolling-52w fees from qualifying users."}}}}}}}},"parameters":[{"name":"start_date","in":"query","required":false,"description":"Inclusive start week","schema":{"type":"string","format":"date"}},{"name":"end_date","in":"query","required":false,"description":"Inclusive end week","schema":{"type":"string","format":"date"}}]}},"/v1/revenue/revenue_active_users_totals/monthly":{"get":{"tags":["Revenue"],"summary":"Revenue Active Users Totals (monthly)","description":"**Required Access:** `tier1`\n\nAPI view over int_revenue_active_users_totals_monthly.\n\n**Declared Filters:**\n- **start_date**: >= on `month` (Inclusive start month)\n- **end_date**: <= on `month` (Inclusive end month)\n\n**Sort:**\n- `month DESC`\n\n**Columns:**\n- **month** (`Date`): First day of the month.\n- **users_cnt** (`UInt64`): Unique users above the $0.50/month threshold.\n- **fees_total** (`Float64`): Sum of monthly fees from qualifying users.","operationId":"api_revenue_active_users_totals_monthly_get_v1_revenue_revenue_active_users_totals_monthly_get","security":[{"APIKeyHeader":[]}],"responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"month":{"type":"string","format":"date","description":"First day of the month."},"users_cnt":{"type":"integer","description":"Unique users above the $0.50/month threshold."},"fees_total":{"type":"number","description":"Sum of monthly fees from qualifying users."}}}}}}}},"parameters":[{"name":"start_date","in":"query","required":false,"description":"Inclusive start month","schema":{"type":"string","format":"date"}},{"name":"end_date","in":"query","required":false,"description":"Inclusive end month","schema":{"type":"string","format":"date"}}]}},"/v1/revenue/revenue_gnosis_app_cohorts/weekly":{"get":{"tags":["Revenue"],"summary":"Revenue Gnosis App Cohorts (weekly)","description":"**Required Access:** `tier1`\n\nAPI view over fct_revenue_gnosis_app_cohorts_weekly.\n\n**Declared Filters:**\n- **cohort**: = on `cohort` (Cohort bucket)\n- **start_date**: >= on `week` (Inclusive start week)\n- **end_date**: <= on `week` (Inclusive end week)\n\n**Sort:**\n- `week DESC`\n\n**Columns:**\n- **week** (`Date`): Week start.\n- **cohort** (`String`): Annualised $-bucket.\n- **annual_rolling_fees_total** (`Float64`): Sum of rolling-52w fees for users in this cohort.\n- **users_cnt** (`UInt64`): Users with >$0 rolling fees.","operationId":"api_revenue_gnosis_app_cohorts_weekly_get_v1_revenue_revenue_gnosis_app_cohorts_weekly_get","security":[{"APIKeyHeader":[]}],"responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"week":{"type":"string","format":"date","description":"Week start."},"cohort":{"type":"string","description":"Annualised $-bucket."},"annual_rolling_fees_total":{"type":"number","description":"Sum of rolling-52w fees for users in this cohort."},"users_cnt":{"type":"integer","description":"Users with >$0 rolling fees."}}}}}}}},"parameters":[{"name":"cohort","in":"query","required":false,"description":"Cohort bucket","schema":{"type":"string"}},{"name":"start_date","in":"query","required":false,"description":"Inclusive start week","schema":{"type":"string","format":"date"}},{"name":"end_date","in":"query","required":false,"description":"Inclusive end week","schema":{"type":"string","format":"date"}}]}},"/v1/revenue/revenue_gnosis_app_cohorts/monthly":{"get":{"tags":["Revenue"],"summary":"Revenue Gnosis App Cohorts (monthly)","description":"**Required Access:** `tier1`\n\nAPI view over fct_revenue_gnosis_app_cohorts_monthly.\n\n**Declared Filters:**\n- **cohort**: = on `cohort` (Cohort bucket)\n- **start_date**: >= on `month` (Inclusive start month)\n- **end_date**: <= on `month` (Inclusive end month)\n\n**Sort:**\n- `month DESC`\n\n**Columns:**\n- **month** (`Date`): First day of the month.\n- **cohort** (`String`): Monthly $-bucket.\n- **fees_total** (`Float64`): Sum of monthly fees.\n- **users_cnt** (`UInt64`): Users with >$0 monthly fees.","operationId":"api_revenue_gnosis_app_cohorts_monthly_get_v1_revenue_revenue_gnosis_app_cohorts_monthly_get","security":[{"APIKeyHeader":[]}],"responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"month":{"type":"string","format":"date","description":"First day of the month."},"cohort":{"type":"string","description":"Monthly $-bucket."},"fees_total":{"type":"number","description":"Sum of monthly fees."},"users_cnt":{"type":"integer","description":"Users with >$0 monthly fees."}}}}}}}},"parameters":[{"name":"cohort","in":"query","required":false,"description":"Cohort bucket","schema":{"type":"string"}},{"name":"start_date","in":"query","required":false,"description":"Inclusive start month","schema":{"type":"string","format":"date"}},{"name":"end_date","in":"query","required":false,"description":"Inclusive end month","schema":{"type":"string","format":"date"}}]}},"/v1/revenue/revenue_gpay_cohorts/weekly":{"get":{"tags":["Revenue"],"summary":"Revenue Gpay Cohorts (weekly)","description":"**Required Access:** `tier1`\n\nAPI view over fct_revenue_gpay_cohorts_weekly.\n\n**Declared Filters:**\n- **symbol**: = on `symbol` (Token symbol (EURe, GBPe, USDC.e))\n- **cohort**: = on `cohort` (Cohort bucket)\n- **start_date**: >= on `week` (Inclusive start week)\n- **end_date**: <= on `week` (Inclusive end week)\n\n**Sort:**\n- `week DESC`\n\n**Columns:**\n- **week** (`Date`): Week start.\n- **symbol** (`String`): Payment token (EURe, GBPe, USDC.e).\n- **cohort** (`String`): Annualised $-bucket.\n- **annual_rolling_fees_total** (`Float64`): Sum of rolling-52w fees for users in this cohort.\n- **users_cnt** (`UInt64`): Users with >$0 rolling fees.","operationId":"api_revenue_gpay_cohorts_weekly_get_v1_revenue_revenue_gpay_cohorts_weekly_get","security":[{"APIKeyHeader":[]}],"responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"week":{"type":"string","format":"date","description":"Week start."},"symbol":{"type":"string","description":"Payment token (EURe, GBPe, USDC.e)."},"cohort":{"type":"string","description":"Annualised $-bucket."},"annual_rolling_fees_total":{"type":"number","description":"Sum of rolling-52w fees for users in this cohort."},"users_cnt":{"type":"integer","description":"Users with >$0 rolling fees."}}}}}}}},"parameters":[{"name":"symbol","in":"query","required":false,"description":"Token symbol (EURe, GBPe, USDC.e)","schema":{"type":"string"}},{"name":"cohort","in":"query","required":false,"description":"Cohort bucket","schema":{"type":"string"}},{"name":"start_date","in":"query","required":false,"description":"Inclusive start week","schema":{"type":"string","format":"date"}},{"name":"end_date","in":"query","required":false,"description":"Inclusive end week","schema":{"type":"string","format":"date"}}]}},"/v1/revenue/revenue_gpay_cohorts/monthly":{"get":{"tags":["Revenue"],"summary":"Revenue Gpay Cohorts (monthly)","description":"**Required Access:** `tier1`\n\nAPI view over fct_revenue_gpay_cohorts_monthly.\n\n**Declared Filters:**\n- **symbol**: = on `symbol` (Token symbol (EURe, GBPe, USDC.e))\n- **cohort**: = on `cohort` (Cohort bucket)\n- **start_date**: >= on `month` (Inclusive start month)\n- **end_date**: <= on `month` (Inclusive end month)\n\n**Sort:**\n- `month DESC`\n\n**Columns:**\n- **month** (`Date`): First day of the month.\n- **symbol** (`String`): Payment token.\n- **cohort** (`String`): Monthly $-bucket.\n- **fees_total** (`Float64`): Sum of monthly fees.\n- **users_cnt** (`UInt64`): Users with >$0 monthly fees.","operationId":"api_revenue_gpay_cohorts_monthly_get_v1_revenue_revenue_gpay_cohorts_monthly_get","security":[{"APIKeyHeader":[]}],"responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"month":{"type":"string","format":"date","description":"First day of the month."},"symbol":{"type":"string","description":"Payment token."},"cohort":{"type":"string","description":"Monthly $-bucket."},"fees_total":{"type":"number","description":"Sum of monthly fees."},"users_cnt":{"type":"integer","description":"Users with >$0 monthly fees."}}}}}}}},"parameters":[{"name":"symbol","in":"query","required":false,"description":"Token symbol (EURe, GBPe, USDC.e)","schema":{"type":"string"}},{"name":"cohort","in":"query","required":false,"description":"Cohort bucket","schema":{"type":"string"}},{"name":"start_date","in":"query","required":false,"description":"Inclusive start month","schema":{"type":"string","format":"date"}},{"name":"end_date","in":"query","required":false,"description":"Inclusive end month","schema":{"type":"string","format":"date"}}]}},"/v1/revenue/revenue_gpay_eure_cohorts/weekly":{"get":{"tags":["Revenue"],"summary":"Revenue Gpay Eure Cohorts (weekly)","description":"**Required Access:** `tier1`\n\nEURe Gnosis Pay rolling-52w cohort API view.\n\n**Declared Filters:**\n- **cohort**: = on `cohort` (Cohort bucket)\n- **start_date**: >= on `week` (Inclusive start week)\n- **end_date**: <= on `week` (Inclusive end week)\n\n**Sort:**\n- `week DESC`\n\n**Columns:**\n- **week** (`Date`): Week start.\n- **cohort** (`String`): Annualised $-bucket.\n- **annual_rolling_fees_total** (`Float64`): Sum of rolling-52w fees for users in this cohort.\n- **users_cnt** (`UInt64`): Users with >$0 rolling fees.","operationId":"api_revenue_gpay_eure_cohorts_weekly_get_v1_revenue_revenue_gpay_eure_cohorts_weekly_get","security":[{"APIKeyHeader":[]}],"responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"week":{"type":"string","format":"date","description":"Week start."},"cohort":{"type":"string","description":"Annualised $-bucket."},"annual_rolling_fees_total":{"type":"number","description":"Sum of rolling-52w fees for users in this cohort."},"users_cnt":{"type":"integer","description":"Users with >$0 rolling fees."}}}}}}}},"parameters":[{"name":"cohort","in":"query","required":false,"description":"Cohort bucket","schema":{"type":"string"}},{"name":"start_date","in":"query","required":false,"description":"Inclusive start week","schema":{"type":"string","format":"date"}},{"name":"end_date","in":"query","required":false,"description":"Inclusive end week","schema":{"type":"string","format":"date"}}]}},"/v1/revenue/revenue_gpay_eure_cohorts/monthly":{"get":{"tags":["Revenue"],"summary":"Revenue Gpay Eure Cohorts (monthly)","description":"**Required Access:** `tier1`\n\nEURe Gnosis Pay monthly cohort API view.\n\n**Declared Filters:**\n- **cohort**: = on `cohort` (Cohort bucket)\n- **start_date**: >= on `month` (Inclusive start month)\n- **end_date**: <= on `month` (Inclusive end month)\n\n**Sort:**\n- `month DESC`\n\n**Columns:**\n- **month** (`Date`): First day of the month.\n- **cohort** (`String`): Monthly $-bucket.\n- **fees_total** (`Float64`): Sum of monthly fees.\n- **users_cnt** (`UInt64`): Users with >$0 monthly fees.","operationId":"api_revenue_gpay_eure_cohorts_monthly_get_v1_revenue_revenue_gpay_eure_cohorts_monthly_get","security":[{"APIKeyHeader":[]}],"responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"month":{"type":"string","format":"date","description":"First day of the month."},"cohort":{"type":"string","description":"Monthly $-bucket."},"fees_total":{"type":"number","description":"Sum of monthly fees."},"users_cnt":{"type":"integer","description":"Users with >$0 monthly fees."}}}}}}}},"parameters":[{"name":"cohort","in":"query","required":false,"description":"Cohort bucket","schema":{"type":"string"}},{"name":"start_date","in":"query","required":false,"description":"Inclusive start month","schema":{"type":"string","format":"date"}},{"name":"end_date","in":"query","required":false,"description":"Inclusive end month","schema":{"type":"string","format":"date"}}]}},"/v1/revenue/revenue_gpay_gbpe_cohorts/weekly":{"get":{"tags":["Revenue"],"summary":"Revenue Gpay Gbpe Cohorts (weekly)","description":"**Required Access:** `tier1`\n\nGBPe Gnosis Pay rolling-52w cohort API view.\n\n**Declared Filters:**\n- **cohort**: = on `cohort` (Cohort bucket)\n- **start_date**: >= on `week` (Inclusive start week)\n- **end_date**: <= on `week` (Inclusive end week)\n\n**Sort:**\n- `week DESC`\n\n**Columns:**\n- **week** (`Date`): Week start.\n- **cohort** (`String`): Annualised $-bucket.\n- **annual_rolling_fees_total** (`Float64`): Sum of rolling-52w fees for users in this cohort.\n- **users_cnt** (`UInt64`): Users with >$0 rolling fees.","operationId":"api_revenue_gpay_gbpe_cohorts_weekly_get_v1_revenue_revenue_gpay_gbpe_cohorts_weekly_get","security":[{"APIKeyHeader":[]}],"responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"week":{"type":"string","format":"date","description":"Week start."},"cohort":{"type":"string","description":"Annualised $-bucket."},"annual_rolling_fees_total":{"type":"number","description":"Sum of rolling-52w fees for users in this cohort."},"users_cnt":{"type":"integer","description":"Users with >$0 rolling fees."}}}}}}}},"parameters":[{"name":"cohort","in":"query","required":false,"description":"Cohort bucket","schema":{"type":"string"}},{"name":"start_date","in":"query","required":false,"description":"Inclusive start week","schema":{"type":"string","format":"date"}},{"name":"end_date","in":"query","required":false,"description":"Inclusive end week","schema":{"type":"string","format":"date"}}]}},"/v1/revenue/revenue_gpay_gbpe_cohorts/monthly":{"get":{"tags":["Revenue"],"summary":"Revenue Gpay Gbpe Cohorts (monthly)","description":"**Required Access:** `tier1`\n\nGBPe Gnosis Pay monthly cohort API view.\n\n**Declared Filters:**\n- **cohort**: = on `cohort` (Cohort bucket)\n- **start_date**: >= on `month` (Inclusive start month)\n- **end_date**: <= on `month` (Inclusive end month)\n\n**Sort:**\n- `month DESC`\n\n**Columns:**\n- **month** (`Date`): First day of the month.\n- **cohort** (`String`): Monthly $-bucket.\n- **fees_total** (`Float64`): Sum of monthly fees.\n- **users_cnt** (`UInt64`): Users with >$0 monthly fees.","operationId":"api_revenue_gpay_gbpe_cohorts_monthly_get_v1_revenue_revenue_gpay_gbpe_cohorts_monthly_get","security":[{"APIKeyHeader":[]}],"responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"month":{"type":"string","format":"date","description":"First day of the month."},"cohort":{"type":"string","description":"Monthly $-bucket."},"fees_total":{"type":"number","description":"Sum of monthly fees."},"users_cnt":{"type":"integer","description":"Users with >$0 monthly fees."}}}}}}}},"parameters":[{"name":"cohort","in":"query","required":false,"description":"Cohort bucket","schema":{"type":"string"}},{"name":"start_date","in":"query","required":false,"description":"Inclusive start month","schema":{"type":"string","format":"date"}},{"name":"end_date","in":"query","required":false,"description":"Inclusive end month","schema":{"type":"string","format":"date"}}]}},"/v1/revenue/revenue_gpay_usdce_cohorts/weekly":{"get":{"tags":["Revenue"],"summary":"Revenue Gpay Usdce Cohorts (weekly)","description":"**Required Access:** `tier1`\n\nUSDC.e Gnosis Pay rolling-52w cohort API view.\n\n**Declared Filters:**\n- **cohort**: = on `cohort` (Cohort bucket)\n- **start_date**: >= on `week` (Inclusive start week)\n- **end_date**: <= on `week` (Inclusive end week)\n\n**Sort:**\n- `week DESC`\n\n**Columns:**\n- **week** (`Date`): Week start.\n- **cohort** (`String`): Annualised $-bucket.\n- **annual_rolling_fees_total** (`Float64`): Sum of rolling-52w fees for users in this cohort.\n- **users_cnt** (`UInt64`): Users with >$0 rolling fees.","operationId":"api_revenue_gpay_usdce_cohorts_weekly_get_v1_revenue_revenue_gpay_usdce_cohorts_weekly_get","security":[{"APIKeyHeader":[]}],"responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"week":{"type":"string","format":"date","description":"Week start."},"cohort":{"type":"string","description":"Annualised $-bucket."},"annual_rolling_fees_total":{"type":"number","description":"Sum of rolling-52w fees for users in this cohort."},"users_cnt":{"type":"integer","description":"Users with >$0 rolling fees."}}}}}}}},"parameters":[{"name":"cohort","in":"query","required":false,"description":"Cohort bucket","schema":{"type":"string"}},{"name":"start_date","in":"query","required":false,"description":"Inclusive start week","schema":{"type":"string","format":"date"}},{"name":"end_date","in":"query","required":false,"description":"Inclusive end week","schema":{"type":"string","format":"date"}}]}},"/v1/revenue/revenue_gpay_usdce_cohorts/monthly":{"get":{"tags":["Revenue"],"summary":"Revenue Gpay Usdce Cohorts (monthly)","description":"**Required Access:** `tier1`\n\nUSDC.e Gnosis Pay monthly cohort API view.\n\n**Declared Filters:**\n- **cohort**: = on `cohort` (Cohort bucket)\n- **start_date**: >= on `month` (Inclusive start month)\n- **end_date**: <= on `month` (Inclusive end month)\n\n**Sort:**\n- `month DESC`\n\n**Columns:**\n- **month** (`Date`): First day of the month.\n- **cohort** (`String`): Monthly $-bucket.\n- **fees_total** (`Float64`): Sum of monthly fees.\n- **users_cnt** (`UInt64`): Users with >$0 monthly fees.","operationId":"api_revenue_gpay_usdce_cohorts_monthly_get_v1_revenue_revenue_gpay_usdce_cohorts_monthly_get","security":[{"APIKeyHeader":[]}],"responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"month":{"type":"string","format":"date","description":"First day of the month."},"cohort":{"type":"string","description":"Monthly $-bucket."},"fees_total":{"type":"number","description":"Sum of monthly fees."},"users_cnt":{"type":"integer","description":"Users with >$0 monthly fees."}}}}}}}},"parameters":[{"name":"cohort","in":"query","required":false,"description":"Cohort bucket","schema":{"type":"string"}},{"name":"start_date","in":"query","required":false,"description":"Inclusive start month","schema":{"type":"string","format":"date"}},{"name":"end_date","in":"query","required":false,"description":"Inclusive end month","schema":{"type":"string","format":"date"}}]}},"/v1/revenue/revenue_holdings_brla_cohorts/weekly":{"get":{"tags":["Revenue"],"summary":"Revenue Holdings Brla Cohorts (weekly)","description":"**Required Access:** `tier1`\n\nBRLA holdings rolling-52w cohort API view.\n\n**Declared Filters:**\n- **cohort**: = on `cohort` (Cohort bucket)\n- **start_date**: >= on `week` (Inclusive start week)\n- **end_date**: <= on `week` (Inclusive end week)\n\n**Sort:**\n- `week DESC`\n\n**Columns:**\n- **week** (`Date`): Week start.\n- **cohort** (`String`): Annualised $-bucket for user's rolling fees.\n- **annual_rolling_fees_total** (`Float64`): Sum of rolling-52w fees for users in this cohort.\n- **users_cnt** (`UInt64`): Number of users with >$0 rolling fees in cohort.","operationId":"api_revenue_holdings_brla_cohorts_weekly_get_v1_revenue_revenue_holdings_brla_cohorts_weekly_get","security":[{"APIKeyHeader":[]}],"responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"week":{"type":"string","format":"date","description":"Week start."},"cohort":{"type":"string","description":"Annualised $-bucket for user's rolling fees."},"annual_rolling_fees_total":{"type":"number","description":"Sum of rolling-52w fees for users in this cohort."},"users_cnt":{"type":"integer","description":"Number of users with >$0 rolling fees in cohort."}}}}}}}},"parameters":[{"name":"cohort","in":"query","required":false,"description":"Cohort bucket","schema":{"type":"string"}},{"name":"start_date","in":"query","required":false,"description":"Inclusive start week","schema":{"type":"string","format":"date"}},{"name":"end_date","in":"query","required":false,"description":"Inclusive end week","schema":{"type":"string","format":"date"}}]}},"/v1/revenue/revenue_holdings_brla_cohorts/monthly":{"get":{"tags":["Revenue"],"summary":"Revenue Holdings Brla Cohorts (monthly)","description":"**Required Access:** `tier1`\n\nBRLA holdings monthly cohort API view.\n\n**Declared Filters:**\n- **cohort**: = on `cohort` (Cohort bucket)\n- **start_date**: >= on `month` (Inclusive start month)\n- **end_date**: <= on `month` (Inclusive end month)\n\n**Sort:**\n- `month DESC`\n\n**Columns:**\n- **month** (`Date`): First day of the month.\n- **cohort** (`String`): Monthly $-bucket for user's monthly fees.\n- **fees_total** (`Float64`): Sum of monthly fees for users in this cohort.\n- **users_cnt** (`UInt64`): Number of users with >$0 monthly fees in cohort.","operationId":"api_revenue_holdings_brla_cohorts_monthly_get_v1_revenue_revenue_holdings_brla_cohorts_monthly_get","security":[{"APIKeyHeader":[]}],"responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"month":{"type":"string","format":"date","description":"First day of the month."},"cohort":{"type":"string","description":"Monthly $-bucket for user's monthly fees."},"fees_total":{"type":"number","description":"Sum of monthly fees for users in this cohort."},"users_cnt":{"type":"integer","description":"Number of users with >$0 monthly fees in cohort."}}}}}}}},"parameters":[{"name":"cohort","in":"query","required":false,"description":"Cohort bucket","schema":{"type":"string"}},{"name":"start_date","in":"query","required":false,"description":"Inclusive start month","schema":{"type":"string","format":"date"}},{"name":"end_date","in":"query","required":false,"description":"Inclusive end month","schema":{"type":"string","format":"date"}}]}},"/v1/revenue/revenue_holdings_cohorts/weekly":{"get":{"tags":["Revenue"],"summary":"Revenue Holdings Cohorts (weekly)","description":"**Required Access:** `tier1`\n\nAPI view over fct_revenue_holdings_cohorts_weekly.\n\n**Declared Filters:**\n- **symbol**: = on `symbol` (Token symbol (EURe, USDC.e, BRLA, ZCHF))\n- **cohort**: = on `cohort` (Cohort bucket)\n- **start_date**: >= on `week` (Inclusive start week)\n- **end_date**: <= on `week` (Inclusive end week)\n\n**Sort:**\n- `week DESC`\n\n**Columns:**\n- **week** (`Date`): Week start.\n- **symbol** (`String`): Canonical token symbol.\n- **cohort** (`String`): Annualised $-bucket for user's rolling fees.\n- **annual_rolling_fees_total** (`Float64`): Sum of rolling-52w fees for users in this cohort.\n- **users_cnt** (`UInt64`): Number of users with >$0 rolling fees in cohort.","operationId":"api_revenue_holdings_cohorts_weekly_get_v1_revenue_revenue_holdings_cohorts_weekly_get","security":[{"APIKeyHeader":[]}],"responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"week":{"type":"string","format":"date","description":"Week start."},"symbol":{"type":"string","description":"Canonical token symbol."},"cohort":{"type":"string","description":"Annualised $-bucket for user's rolling fees."},"annual_rolling_fees_total":{"type":"number","description":"Sum of rolling-52w fees for users in this cohort."},"users_cnt":{"type":"integer","description":"Number of users with >$0 rolling fees in cohort."}}}}}}}},"parameters":[{"name":"symbol","in":"query","required":false,"description":"Token symbol (EURe, USDC.e, BRLA, ZCHF)","schema":{"type":"string"}},{"name":"cohort","in":"query","required":false,"description":"Cohort bucket","schema":{"type":"string"}},{"name":"start_date","in":"query","required":false,"description":"Inclusive start week","schema":{"type":"string","format":"date"}},{"name":"end_date","in":"query","required":false,"description":"Inclusive end week","schema":{"type":"string","format":"date"}}]}},"/v1/revenue/revenue_holdings_cohorts/monthly":{"get":{"tags":["Revenue"],"summary":"Revenue Holdings Cohorts (monthly)","description":"**Required Access:** `tier1`\n\nAPI view over fct_revenue_holdings_cohorts_monthly.\n\n**Declared Filters:**\n- **symbol**: = on `symbol` (Token symbol (EURe, USDC.e, BRLA, ZCHF))\n- **cohort**: = on `cohort` (Cohort bucket)\n- **start_date**: >= on `month` (Inclusive start month)\n- **end_date**: <= on `month` (Inclusive end month)\n\n**Sort:**\n- `month DESC`\n\n**Columns:**\n- **month** (`Date`): First day of the month.\n- **symbol** (`String`): Canonical token symbol.\n- **cohort** (`String`): Monthly $-bucket for user's monthly fees.\n- **fees_total** (`Float64`): Sum of monthly fees for users in this cohort.\n- **users_cnt** (`UInt64`): Number of users with >$0 monthly fees in cohort.","operationId":"api_revenue_holdings_cohorts_monthly_get_v1_revenue_revenue_holdings_cohorts_monthly_get","security":[{"APIKeyHeader":[]}],"responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"month":{"type":"string","format":"date","description":"First day of the month."},"symbol":{"type":"string","description":"Canonical token symbol."},"cohort":{"type":"string","description":"Monthly $-bucket for user's monthly fees."},"fees_total":{"type":"number","description":"Sum of monthly fees for users in this cohort."},"users_cnt":{"type":"integer","description":"Number of users with >$0 monthly fees in cohort."}}}}}}}},"parameters":[{"name":"symbol","in":"query","required":false,"description":"Token symbol (EURe, USDC.e, BRLA, ZCHF)","schema":{"type":"string"}},{"name":"cohort","in":"query","required":false,"description":"Cohort bucket","schema":{"type":"string"}},{"name":"start_date","in":"query","required":false,"description":"Inclusive start month","schema":{"type":"string","format":"date"}},{"name":"end_date","in":"query","required":false,"description":"Inclusive end month","schema":{"type":"string","format":"date"}}]}},"/v1/revenue/revenue_holdings_eure_cohorts/weekly":{"get":{"tags":["Revenue"],"summary":"Revenue Holdings Eure Cohorts (weekly)","description":"**Required Access:** `tier1`\n\nEURe holdings rolling-52w cohort API view.\n\n**Declared Filters:**\n- **cohort**: = on `cohort` (Cohort bucket)\n- **start_date**: >= on `week` (Inclusive start week)\n- **end_date**: <= on `week` (Inclusive end week)\n\n**Sort:**\n- `week DESC`\n\n**Columns:**\n- **week** (`Date`): Week start.\n- **cohort** (`String`): Annualised $-bucket for user's rolling fees.\n- **annual_rolling_fees_total** (`Float64`): Sum of rolling-52w fees for users in this cohort.\n- **users_cnt** (`UInt64`): Number of users with >$0 rolling fees in cohort.","operationId":"api_revenue_holdings_eure_cohorts_weekly_get_v1_revenue_revenue_holdings_eure_cohorts_weekly_get","security":[{"APIKeyHeader":[]}],"responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"week":{"type":"string","format":"date","description":"Week start."},"cohort":{"type":"string","description":"Annualised $-bucket for user's rolling fees."},"annual_rolling_fees_total":{"type":"number","description":"Sum of rolling-52w fees for users in this cohort."},"users_cnt":{"type":"integer","description":"Number of users with >$0 rolling fees in cohort."}}}}}}}},"parameters":[{"name":"cohort","in":"query","required":false,"description":"Cohort bucket","schema":{"type":"string"}},{"name":"start_date","in":"query","required":false,"description":"Inclusive start week","schema":{"type":"string","format":"date"}},{"name":"end_date","in":"query","required":false,"description":"Inclusive end week","schema":{"type":"string","format":"date"}}]}},"/v1/revenue/revenue_holdings_eure_cohorts/monthly":{"get":{"tags":["Revenue"],"summary":"Revenue Holdings Eure Cohorts (monthly)","description":"**Required Access:** `tier1`\n\nEURe holdings monthly cohort API view.\n\n**Declared Filters:**\n- **cohort**: = on `cohort` (Cohort bucket)\n- **start_date**: >= on `month` (Inclusive start month)\n- **end_date**: <= on `month` (Inclusive end month)\n\n**Sort:**\n- `month DESC`\n\n**Columns:**\n- **month** (`Date`): First day of the month.\n- **cohort** (`String`): Monthly $-bucket for user's monthly fees.\n- **fees_total** (`Float64`): Sum of monthly fees for users in this cohort.\n- **users_cnt** (`UInt64`): Number of users with >$0 monthly fees in cohort.","operationId":"api_revenue_holdings_eure_cohorts_monthly_get_v1_revenue_revenue_holdings_eure_cohorts_monthly_get","security":[{"APIKeyHeader":[]}],"responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"month":{"type":"string","format":"date","description":"First day of the month."},"cohort":{"type":"string","description":"Monthly $-bucket for user's monthly fees."},"fees_total":{"type":"number","description":"Sum of monthly fees for users in this cohort."},"users_cnt":{"type":"integer","description":"Number of users with >$0 monthly fees in cohort."}}}}}}}},"parameters":[{"name":"cohort","in":"query","required":false,"description":"Cohort bucket","schema":{"type":"string"}},{"name":"start_date","in":"query","required":false,"description":"Inclusive start month","schema":{"type":"string","format":"date"}},{"name":"end_date","in":"query","required":false,"description":"Inclusive end month","schema":{"type":"string","format":"date"}}]}},"/v1/revenue/revenue_holdings_usdce_cohorts/weekly":{"get":{"tags":["Revenue"],"summary":"Revenue Holdings Usdce Cohorts (weekly)","description":"**Required Access:** `tier1`\n\nUSDC.e holdings rolling-52w cohort API view.\n\n**Declared Filters:**\n- **cohort**: = on `cohort` (Cohort bucket)\n- **start_date**: >= on `week` (Inclusive start week)\n- **end_date**: <= on `week` (Inclusive end week)\n\n**Sort:**\n- `week DESC`\n\n**Columns:**\n- **week** (`Date`): Week start.\n- **cohort** (`String`): Annualised $-bucket for user's rolling fees.\n- **annual_rolling_fees_total** (`Float64`): Sum of rolling-52w fees for users in this cohort.\n- **users_cnt** (`UInt64`): Number of users with >$0 rolling fees in cohort.","operationId":"api_revenue_holdings_usdce_cohorts_weekly_get_v1_revenue_revenue_holdings_usdce_cohorts_weekly_get","security":[{"APIKeyHeader":[]}],"responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"week":{"type":"string","format":"date","description":"Week start."},"cohort":{"type":"string","description":"Annualised $-bucket for user's rolling fees."},"annual_rolling_fees_total":{"type":"number","description":"Sum of rolling-52w fees for users in this cohort."},"users_cnt":{"type":"integer","description":"Number of users with >$0 rolling fees in cohort."}}}}}}}},"parameters":[{"name":"cohort","in":"query","required":false,"description":"Cohort bucket","schema":{"type":"string"}},{"name":"start_date","in":"query","required":false,"description":"Inclusive start week","schema":{"type":"string","format":"date"}},{"name":"end_date","in":"query","required":false,"description":"Inclusive end week","schema":{"type":"string","format":"date"}}]}},"/v1/revenue/revenue_holdings_usdce_cohorts/monthly":{"get":{"tags":["Revenue"],"summary":"Revenue Holdings Usdce Cohorts (monthly)","description":"**Required Access:** `tier1`\n\nUSDC.e holdings monthly cohort API view.\n\n**Declared Filters:**\n- **cohort**: = on `cohort` (Cohort bucket)\n- **start_date**: >= on `month` (Inclusive start month)\n- **end_date**: <= on `month` (Inclusive end month)\n\n**Sort:**\n- `month DESC`\n\n**Columns:**\n- **month** (`Date`): First day of the month.\n- **cohort** (`String`): Monthly $-bucket for user's monthly fees.\n- **fees_total** (`Float64`): Sum of monthly fees for users in this cohort.\n- **users_cnt** (`UInt64`): Number of users with >$0 monthly fees in cohort.","operationId":"api_revenue_holdings_usdce_cohorts_monthly_get_v1_revenue_revenue_holdings_usdce_cohorts_monthly_get","security":[{"APIKeyHeader":[]}],"responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"month":{"type":"string","format":"date","description":"First day of the month."},"cohort":{"type":"string","description":"Monthly $-bucket for user's monthly fees."},"fees_total":{"type":"number","description":"Sum of monthly fees for users in this cohort."},"users_cnt":{"type":"integer","description":"Number of users with >$0 monthly fees in cohort."}}}}}}}},"parameters":[{"name":"cohort","in":"query","required":false,"description":"Cohort bucket","schema":{"type":"string"}},{"name":"start_date","in":"query","required":false,"description":"Inclusive start month","schema":{"type":"string","format":"date"}},{"name":"end_date","in":"query","required":false,"description":"Inclusive end month","schema":{"type":"string","format":"date"}}]}},"/v1/revenue/revenue_holdings_zchf_cohorts/weekly":{"get":{"tags":["Revenue"],"summary":"Revenue Holdings Zchf Cohorts (weekly)","description":"**Required Access:** `tier1`\n\nZCHF holdings rolling-52w cohort API view.\n\n**Declared Filters:**\n- **cohort**: = on `cohort` (Cohort bucket)\n- **start_date**: >= on `week` (Inclusive start week)\n- **end_date**: <= on `week` (Inclusive end week)\n\n**Sort:**\n- `week DESC`\n\n**Columns:**\n- **week** (`Date`): Week start.\n- **cohort** (`String`): Annualised $-bucket for user's rolling fees.\n- **annual_rolling_fees_total** (`Float64`): Sum of rolling-52w fees for users in this cohort.\n- **users_cnt** (`UInt64`): Number of users with >$0 rolling fees in cohort.","operationId":"api_revenue_holdings_zchf_cohorts_weekly_get_v1_revenue_revenue_holdings_zchf_cohorts_weekly_get","security":[{"APIKeyHeader":[]}],"responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"week":{"type":"string","format":"date","description":"Week start."},"cohort":{"type":"string","description":"Annualised $-bucket for user's rolling fees."},"annual_rolling_fees_total":{"type":"number","description":"Sum of rolling-52w fees for users in this cohort."},"users_cnt":{"type":"integer","description":"Number of users with >$0 rolling fees in cohort."}}}}}}}},"parameters":[{"name":"cohort","in":"query","required":false,"description":"Cohort bucket","schema":{"type":"string"}},{"name":"start_date","in":"query","required":false,"description":"Inclusive start week","schema":{"type":"string","format":"date"}},{"name":"end_date","in":"query","required":false,"description":"Inclusive end week","schema":{"type":"string","format":"date"}}]}},"/v1/revenue/revenue_holdings_zchf_cohorts/monthly":{"get":{"tags":["Revenue"],"summary":"Revenue Holdings Zchf Cohorts (monthly)","description":"**Required Access:** `tier1`\n\nZCHF holdings monthly cohort API view.\n\n**Declared Filters:**\n- **cohort**: = on `cohort` (Cohort bucket)\n- **start_date**: >= on `month` (Inclusive start month)\n- **end_date**: <= on `month` (Inclusive end month)\n\n**Sort:**\n- `month DESC`\n\n**Columns:**\n- **month** (`Date`): First day of the month.\n- **cohort** (`String`): Monthly $-bucket for user's monthly fees.\n- **fees_total** (`Float64`): Sum of monthly fees for users in this cohort.\n- **users_cnt** (`UInt64`): Number of users with >$0 monthly fees in cohort.","operationId":"api_revenue_holdings_zchf_cohorts_monthly_get_v1_revenue_revenue_holdings_zchf_cohorts_monthly_get","security":[{"APIKeyHeader":[]}],"responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"month":{"type":"string","format":"date","description":"First day of the month."},"cohort":{"type":"string","description":"Monthly $-bucket for user's monthly fees."},"fees_total":{"type":"number","description":"Sum of monthly fees for users in this cohort."},"users_cnt":{"type":"integer","description":"Number of users with >$0 monthly fees in cohort."}}}}}}}},"parameters":[{"name":"cohort","in":"query","required":false,"description":"Cohort bucket","schema":{"type":"string"}},{"name":"start_date","in":"query","required":false,"description":"Inclusive start month","schema":{"type":"string","format":"date"}},{"name":"end_date","in":"query","required":false,"description":"Inclusive end month","schema":{"type":"string","format":"date"}}]}},"/v1/revenue/revenue_per_user/weekly":{"get":{"tags":["Revenue"],"summary":"Revenue Per User (weekly)","description":"**Required Access:** `tier3`\n\nAPI view over fct_revenue_per_user_weekly. Per-user weekly revenue\nkeyed on `user_pseudonym` — the canonical join key for cross-sector\nuser-overlap queries. Filterable by week range and `is_revenue_active`.\n\n\n**Declared Filters:**\n- **start_week**: >= on `week` (Inclusive start week)\n- **end_week**: <= on `week` (Inclusive end week)\n- **is_revenue_active**: = on `is_revenue_active` (Filter to users above the $6 / 52w threshold (1 or 0))\n\n**Sort:**\n- `week DESC`\n\n**Columns:**\n- **week** (`Date`): ISO week start (Monday).\n- **user_pseudonym** (`UInt64`): Cross-sector pseudonym (sipHash64 of lowercased address).\n- **rolling_fees_total** (`Float64`): Sum of 52w-rolling potential revenue across all streams (USD).\n- **has_holdings** (`UInt8`): 1 if user has any rolling fees from the holdings stream.\n- **has_sdai** (`UInt8`): 1 if user has any rolling fees from the sDAI stream.\n- **has_gpay** (`UInt8`): 1 if user has any rolling fees from the Gnosis Pay stream.\n- **has_gnosis_app** (`UInt8`): 1 if user has any rolling fees from the Gnosis App stream.\n- **n_streams** (`UInt8`): Number of distinct streams the user accrued fees in.\n- **is_revenue_active** (`UInt8`): 1 iff rolling_fees_total >= $6 (Dune active-user threshold).","operationId":"api_revenue_per_user_weekly_get_v1_revenue_revenue_per_user_weekly_get","security":[{"APIKeyHeader":[]}],"responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"week":{"type":"string","format":"date","description":"ISO week start (Monday)."},"user_pseudonym":{"type":"integer","description":"Cross-sector pseudonym (sipHash64 of lowercased address)."},"rolling_fees_total":{"type":"number","description":"Sum of 52w-rolling potential revenue across all streams (USD)."},"has_holdings":{"type":"integer","description":"1 if user has any rolling fees from the holdings stream."},"has_sdai":{"type":"integer","description":"1 if user has any rolling fees from the sDAI stream."},"has_gpay":{"type":"integer","description":"1 if user has any rolling fees from the Gnosis Pay stream."},"has_gnosis_app":{"type":"integer","description":"1 if user has any rolling fees from the Gnosis App stream."},"n_streams":{"type":"integer","description":"Number of distinct streams the user accrued fees in."},"is_revenue_active":{"type":"integer","description":"1 iff rolling_fees_total >= $6 (Dune active-user threshold)."}}}}}}}},"parameters":[{"name":"start_week","in":"query","required":false,"description":"Inclusive start week","schema":{"type":"string","format":"date"}},{"name":"end_week","in":"query","required":false,"description":"Inclusive end week","schema":{"type":"string","format":"date"}},{"name":"is_revenue_active","in":"query","required":false,"description":"Filter to users above the $6 / 52w threshold (1 or 0)","schema":{"type":"string"}}]}},"/v1/revenue/revenue_per_user/monthly":{"get":{"tags":["Revenue"],"summary":"Revenue Per User (monthly)","description":"**Required Access:** `tier3`\n\nAPI view over fct_revenue_per_user_monthly. Per-user monthly revenue\nkeyed on `user_pseudonym`. Filterable by month range and\n`is_revenue_active`.\n\n\n**Declared Filters:**\n- **start_month**: >= on `month` (Inclusive start month)\n- **end_month**: <= on `month` (Inclusive end month)\n- **is_revenue_active**: = on `is_revenue_active` (Filter to users above the $0.50 / month threshold (1 or 0))\n\n**Sort:**\n- `month DESC`\n\n**Columns:**\n- **month** (`Date`): First day of the calendar month.\n- **user_pseudonym** (`UInt64`): Cross-sector pseudonym (sipHash64).\n- **month_fees_total** (`Float64`): Sum of monthly potential revenue across all streams (USD).\n- **has_holdings** (`UInt8`): 1 if user had holdings-stream fees this month.\n- **has_sdai** (`UInt8`): 1 if user had sDAI-stream fees this month.\n- **has_gpay** (`UInt8`): 1 if user had Gnosis Pay-stream fees this month.\n- **has_gnosis_app** (`UInt8`): 1 if user had Gnosis App-stream fees this month.\n- **n_streams** (`UInt8`): Number of distinct streams contributing in the month.\n- **is_revenue_active** (`UInt8`): 1 iff month_fees_total >= $0.50 (month-scaled $6 threshold).","operationId":"api_revenue_per_user_monthly_get_v1_revenue_revenue_per_user_monthly_get","security":[{"APIKeyHeader":[]}],"responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"month":{"type":"string","format":"date","description":"First day of the calendar month."},"user_pseudonym":{"type":"integer","description":"Cross-sector pseudonym (sipHash64)."},"month_fees_total":{"type":"number","description":"Sum of monthly potential revenue across all streams (USD)."},"has_holdings":{"type":"integer","description":"1 if user had holdings-stream fees this month."},"has_sdai":{"type":"integer","description":"1 if user had sDAI-stream fees this month."},"has_gpay":{"type":"integer","description":"1 if user had Gnosis Pay-stream fees this month."},"has_gnosis_app":{"type":"integer","description":"1 if user had Gnosis App-stream fees this month."},"n_streams":{"type":"integer","description":"Number of distinct streams contributing in the month."},"is_revenue_active":{"type":"integer","description":"1 iff month_fees_total >= $0.50 (month-scaled $6 threshold)."}}}}}}}},"parameters":[{"name":"start_month","in":"query","required":false,"description":"Inclusive start month","schema":{"type":"string","format":"date"}},{"name":"end_month","in":"query","required":false,"description":"Inclusive end month","schema":{"type":"string","format":"date"}},{"name":"is_revenue_active","in":"query","required":false,"description":"Filter to users above the $0.50 / month threshold (1 or 0)","schema":{"type":"string"}}]}},"/v1/revenue/revenue_sdai_cohorts/weekly":{"get":{"tags":["Revenue"],"summary":"Revenue Sdai Cohorts (weekly)","description":"**Required Access:** `tier1`\n\nAPI view over fct_revenue_sdai_cohorts_weekly.\n\n**Declared Filters:**\n- **cohort**: = on `cohort` (Cohort bucket)\n- **start_date**: >= on `week` (Inclusive start week)\n- **end_date**: <= on `week` (Inclusive end week)\n\n**Sort:**\n- `week DESC`\n\n**Columns:**\n- **week** (`Date`): Week start.\n- **cohort** (`String`): Annualised $-bucket.\n- **annual_rolling_fees_total** (`Float64`): Sum of rolling-52w fees for users in this cohort.\n- **users_cnt** (`UInt64`): Users with >$0 rolling fees.","operationId":"api_revenue_sdai_cohorts_weekly_get_v1_revenue_revenue_sdai_cohorts_weekly_get","security":[{"APIKeyHeader":[]}],"responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"week":{"type":"string","format":"date","description":"Week start."},"cohort":{"type":"string","description":"Annualised $-bucket."},"annual_rolling_fees_total":{"type":"number","description":"Sum of rolling-52w fees for users in this cohort."},"users_cnt":{"type":"integer","description":"Users with >$0 rolling fees."}}}}}}}},"parameters":[{"name":"cohort","in":"query","required":false,"description":"Cohort bucket","schema":{"type":"string"}},{"name":"start_date","in":"query","required":false,"description":"Inclusive start week","schema":{"type":"string","format":"date"}},{"name":"end_date","in":"query","required":false,"description":"Inclusive end week","schema":{"type":"string","format":"date"}}]}},"/v1/revenue/revenue_sdai_cohorts/monthly":{"get":{"tags":["Revenue"],"summary":"Revenue Sdai Cohorts (monthly)","description":"**Required Access:** `tier1`\n\nAPI view over fct_revenue_sdai_cohorts_monthly.\n\n**Declared Filters:**\n- **cohort**: = on `cohort` (Cohort bucket)\n- **start_date**: >= on `month` (Inclusive start month)\n- **end_date**: <= on `month` (Inclusive end month)\n\n**Sort:**\n- `month DESC`\n\n**Columns:**\n- **month** (`Date`): First day of the month.\n- **cohort** (`String`): Monthly $-bucket.\n- **fees_total** (`Float64`): Sum of monthly fees for users in this cohort.\n- **users_cnt** (`UInt64`): Users with >$0 monthly fees.","operationId":"api_revenue_sdai_cohorts_monthly_get_v1_revenue_revenue_sdai_cohorts_monthly_get","security":[{"APIKeyHeader":[]}],"responses":{"200":{"description":"List response","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"month":{"type":"string","format":"date","description":"First day of the month."},"cohort":{"type":"string","description":"Monthly $-bucket."},"fees_total":{"type":"number","description":"Sum of monthly fees for users in this cohort."},"users_cnt":{"type":"integer","description":"Users with >$0 monthly fees."}}}}}}}},"parameters":[{"name":"cohort","in":"query","required":false,"description":"Cohort bucket","schema":{"type":"string"}},{"name":"start_date","in":"query","required":false,"description":"Inclusive start month","schema":{"type":"string","format":"date"}},{"name":"end_date","in":"query","required":false,"description":"Inclusive end month","schema":{"type":"string","format":"date"}}]}}},"components":{"schemas":{"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"},"api_consensus_attestations_performance_daily_PostBody":{"properties":{"date_from":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Date From","description":"Inclusive lower bound on date"},"date_to":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Date To","description":"Inclusive upper bound on date"},"limit":{"anyOf":[{"type":"integer","maximum":5000.0,"minimum":1.0},{"type":"null"}],"title":"Limit","description":"Row limit","default":100},"offset":{"anyOf":[{"type":"integer","minimum":0.0},{"type":"null"}],"title":"Offset","description":"Row offset","default":0},"sort_by":{"anyOf":[{"type":"string"},{"type":"null"}],"enum":["date","attestations_total","avg_inclusion_delay","p50_inclusion_delay"],"title":"Sort By","description":"Sort column"},"sort_direction":{"anyOf":[{"type":"string"},{"type":"null"}],"enum":["ASC","DESC"],"title":"Sort Direction","description":"Sort direction. Defaults to ASC when sort_by is provided."}},"additionalProperties":true,"type":"object","title":"api_consensus_attestations_performance_daily_PostBody"},"api_consensus_consolidations_daily_PostBody":{"properties":{"date_from":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Date From","description":"Inclusive lower bound on date"},"date_to":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Date To","description":"Inclusive upper bound on date"},"role":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Role","description":"One of self / source / target"},"limit":{"anyOf":[{"type":"integer","maximum":10000.0,"minimum":1.0},{"type":"null"}],"title":"Limit","description":"Row limit","default":5000},"offset":{"anyOf":[{"type":"integer","minimum":0.0},{"type":"null"}],"title":"Offset","description":"Row offset","default":0}},"additionalProperties":true,"type":"object","title":"api_consensus_consolidations_daily_PostBody"},"api_consensus_validators_apy_dist_income_daily_PostBody":{"properties":{"date_from":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Date From","description":"Inclusive lower bound on date"},"date_to":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Date To","description":"Inclusive upper bound on date"},"limit":{"anyOf":[{"type":"integer","maximum":10000.0,"minimum":1.0},{"type":"null"}],"title":"Limit","description":"Row limit","default":2000},"offset":{"anyOf":[{"type":"integer","minimum":0.0},{"type":"null"}],"title":"Offset","description":"Row offset","default":0}},"additionalProperties":true,"type":"object","title":"api_consensus_validators_apy_dist_income_daily_PostBody"},"api_consensus_validators_apy_mean_daily_PostBody":{"properties":{"date_from":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Date From","description":"Inclusive lower bound on date"},"date_to":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Date To","description":"Inclusive upper bound on date"},"limit":{"anyOf":[{"type":"integer","maximum":10000.0,"minimum":1.0},{"type":"null"}],"title":"Limit","description":"Row limit","default":2000},"offset":{"anyOf":[{"type":"integer","minimum":0.0},{"type":"null"}],"title":"Offset","description":"Row offset","default":0}},"additionalProperties":true,"type":"object","title":"api_consensus_validators_apy_mean_daily_PostBody"},"api_consensus_validators_explorer_apy_dist_daily_PostBody":{"properties":{"withdrawal_credentials":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Withdrawal Credentials","description":"Withdrawal credential (32-byte hex) — per-day cross-sectional APY quantiles across the validators under this credential, plus trailing 7d/30d medians of the credential's balance-weighted daily APY."},"date_from":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Date From","description":"Inclusive lower bound on date"},"date_to":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Date To","description":"Inclusive upper bound on date"},"limit":{"anyOf":[{"type":"integer","maximum":10000.0,"minimum":1.0},{"type":"null"}],"title":"Limit","description":"Row limit","default":1000},"offset":{"anyOf":[{"type":"integer","minimum":0.0},{"type":"null"}],"title":"Offset","description":"Row offset","default":0}},"additionalProperties":true,"type":"object","title":"api_consensus_validators_explorer_apy_dist_daily_PostBody"},"api_consensus_validators_explorer_balance_dist_PostBody":{"properties":{"withdrawal_credentials":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Withdrawal Credentials","description":"Withdrawal credential (32-byte hex) — returns balance histogram across co-validators"},"limit":{"anyOf":[{"type":"integer","maximum":64.0,"minimum":1.0},{"type":"null"}],"title":"Limit","description":"Row limit","default":16},"offset":{"anyOf":[{"type":"integer","minimum":0.0},{"type":"null"}],"title":"Offset","description":"Row offset","default":0}},"additionalProperties":true,"type":"object","title":"api_consensus_validators_explorer_balance_dist_PostBody"},"api_consensus_validators_explorer_daily_PostBody":{"properties":{"withdrawal_credentials":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Withdrawal Credentials","description":"Withdrawal credential (32-byte hex) — aggregates daily metrics across every validator sharing this credential"},"date_from":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Date From","description":"Inclusive lower bound on date"},"date_to":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Date To","description":"Inclusive upper bound on date"},"limit":{"anyOf":[{"type":"integer","maximum":10000.0,"minimum":1.0},{"type":"null"}],"title":"Limit","description":"Row limit","default":1000},"offset":{"anyOf":[{"type":"integer","minimum":0.0},{"type":"null"}],"title":"Offset","description":"Row offset","default":0}},"additionalProperties":true,"type":"object","title":"api_consensus_validators_explorer_daily_PostBody"},"api_consensus_validators_explorer_latest_PostBody":{"properties":{"withdrawal_credentials":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Withdrawal Credentials","description":"Withdrawal credential (32-byte hex) — aggregates KPIs across every validator sharing this credential"},"limit":{"anyOf":[{"type":"integer","maximum":1000.0,"minimum":1.0},{"type":"null"}],"title":"Limit","description":"Row limit","default":100},"offset":{"anyOf":[{"type":"integer","minimum":0.0},{"type":"null"}],"title":"Offset","description":"Row offset","default":0}},"additionalProperties":true,"type":"object","title":"api_consensus_validators_explorer_latest_PostBody"},"api_consensus_validators_explorer_members_table_PostBody":{"properties":{"withdrawal_credentials":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Withdrawal Credentials","description":"Withdrawal credential (32-byte hex) — returns every validator sharing this credential"},"limit":{"anyOf":[{"type":"integer","maximum":5000.0,"minimum":1.0},{"type":"null"}],"title":"Limit","description":"Row limit","default":100},"offset":{"anyOf":[{"type":"integer","minimum":0.0},{"type":"null"}],"title":"Offset","description":"Row offset","default":0},"sort_by":{"anyOf":[{"type":"string"},{"type":"null"}],"enum":["validator_index","balance_gno","consensus_income_amount_30d_gno","proposed_blocks_count_lifetime","total_income_estimated_gno"],"title":"Sort By","description":"Sort column"},"sort_direction":{"anyOf":[{"type":"string"},{"type":"null"}],"enum":["ASC","DESC"],"title":"Sort Direction","description":"Sort direction. Defaults to ASC when sort_by is provided."}},"additionalProperties":true,"type":"object","title":"api_consensus_validators_explorer_members_table_PostBody"},"api_consensus_validators_income_total_daily_PostBody":{"properties":{"date_from":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Date From","description":"Inclusive lower bound on date"},"date_to":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Date To","description":"Inclusive upper bound on date"},"limit":{"anyOf":[{"type":"integer","maximum":10000.0,"minimum":1.0},{"type":"null"}],"title":"Limit","description":"Row limit","default":2000},"offset":{"anyOf":[{"type":"integer","minimum":0.0},{"type":"null"}],"title":"Offset","description":"Row offset","default":0}},"additionalProperties":true,"type":"object","title":"api_consensus_validators_income_total_daily_PostBody"},"api_consensus_validators_performance_daily_PostBody":{"properties":{"validator_index":{"anyOf":[{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"string"}],"maxLength":200},{"type":"null"}],"title":"Validator Index","description":"Validator index / indices"},"pubkey":{"anyOf":[{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"string"}],"maxLength":200},{"type":"null"}],"title":"Pubkey","description":"Validator public key(s)"},"withdrawal_credentials":{"anyOf":[{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"string"}],"maxLength":200},{"type":"null"}],"title":"Withdrawal Credentials","description":"Withdrawal credential value(s)"},"withdrawal_address":{"anyOf":[{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"string"}],"maxLength":200},{"type":"null"}],"title":"Withdrawal Address","description":"20-byte withdrawal address(es) (derived from 0x01/0x02 credentials)"},"date_from":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Date From","description":"Inclusive lower bound on date"},"date_to":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Date To","description":"Inclusive upper bound on date"},"limit":{"anyOf":[{"type":"integer","maximum":5000.0,"minimum":1.0},{"type":"null"}],"title":"Limit","description":"Row limit","default":100},"offset":{"anyOf":[{"type":"integer","minimum":0.0},{"type":"null"}],"title":"Offset","description":"Row offset","default":0},"sort_by":{"anyOf":[{"type":"string"},{"type":"null"}],"enum":["date","validator_index","balance_gno","consensus_income_amount_gno","apy","proposer_reward_total_gno","proposed_blocks_count"],"title":"Sort By","description":"Sort column"},"sort_direction":{"anyOf":[{"type":"string"},{"type":"null"}],"enum":["ASC","DESC"],"title":"Sort Direction","description":"Sort direction. Defaults to ASC when sort_by is provided."}},"additionalProperties":true,"type":"object","title":"api_consensus_validators_performance_daily_PostBody"},"api_consensus_validators_performance_latest_PostBody":{"properties":{"validator_index":{"anyOf":[{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"string"}],"maxLength":200},{"type":"null"}],"title":"Validator Index","description":"Validator index / indices"},"pubkey":{"anyOf":[{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"string"}],"maxLength":200},{"type":"null"}],"title":"Pubkey","description":"Validator public key(s)"},"withdrawal_credentials":{"anyOf":[{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"string"}],"maxLength":200},{"type":"null"}],"title":"Withdrawal Credentials","description":"Withdrawal credential value(s)"},"withdrawal_address":{"anyOf":[{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"string"}],"maxLength":200},{"type":"null"}],"title":"Withdrawal Address","description":"20-byte withdrawal address(es)"},"limit":{"anyOf":[{"type":"integer","maximum":5000.0,"minimum":1.0},{"type":"null"}],"title":"Limit","description":"Row limit","default":100},"offset":{"anyOf":[{"type":"integer","minimum":0.0},{"type":"null"}],"title":"Offset","description":"Row offset","default":0},"sort_by":{"anyOf":[{"type":"string"},{"type":"null"}],"enum":["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"],"title":"Sort By","description":"Sort column"},"sort_direction":{"anyOf":[{"type":"string"},{"type":"null"}],"enum":["ASC","DESC"],"title":"Sort Direction","description":"Sort direction. Defaults to ASC when sort_by is provided."}},"additionalProperties":true,"type":"object","title":"api_consensus_validators_performance_latest_PostBody"},"api_consensus_validators_search_PostBody":{"properties":{"limit":{"anyOf":[{"type":"integer","maximum":10000.0,"minimum":1.0},{"type":"null"}],"title":"Limit","description":"Row limit","default":5000},"offset":{"anyOf":[{"type":"integer","minimum":0.0},{"type":"null"}],"title":"Offset","description":"Row offset","default":0},"sort_by":{"anyOf":[{"type":"string"},{"type":"null"}],"enum":["validator_count","withdrawal_credentials","display_name"],"title":"Sort By","description":"Sort column"},"sort_direction":{"anyOf":[{"type":"string"},{"type":"null"}],"enum":["ASC","DESC"],"title":"Sort Direction","description":"Sort direction. Defaults to ASC when sort_by is provided."}},"additionalProperties":true,"type":"object","title":"api_consensus_validators_search_PostBody"},"api_consensus_validators_status_latest_PostBody":{"properties":{"withdrawal_credentials":{"anyOf":[{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"string"}],"maxLength":200},{"type":"null"}],"title":"Withdrawal Credentials","description":"Withdrawal credential value(s)"},"pubkey":{"anyOf":[{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"string"}],"maxLength":200},{"type":"null"}],"title":"Pubkey","description":"Validator public key(s)"},"validator_index":{"anyOf":[{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"string"}],"maxLength":200},{"type":"null"}],"title":"Validator Index","description":"Validator index / indices"},"withdrawal_address":{"anyOf":[{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"string"}],"maxLength":200},{"type":"null"}],"title":"Withdrawal Address","description":"20-byte withdrawal address(es) (derived from 0x01/0x02 credentials)"},"limit":{"anyOf":[{"type":"integer","maximum":5000.0,"minimum":1.0},{"type":"null"}],"title":"Limit","description":"Row limit","default":100},"offset":{"anyOf":[{"type":"integer","minimum":0.0},{"type":"null"}],"title":"Offset","description":"Row offset","default":0},"sort_by":{"anyOf":[{"type":"string"},{"type":"null"}],"enum":["validator_index","balance","effective_balance","status","activation_epoch","exit_epoch","withdrawable_epoch"],"title":"Sort By","description":"Sort column"},"sort_direction":{"anyOf":[{"type":"string"},{"type":"null"}],"enum":["ASC","DESC"],"title":"Sort Direction","description":"Sort direction. Defaults to ASC when sort_by is provided."}},"additionalProperties":true,"type":"object","title":"api_consensus_validators_status_latest_PostBody"},"api_execution_account_balance_history_daily_PostBody":{"properties":{"address":{"anyOf":[{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"string"}],"maxLength":20},{"type":"null"}],"title":"Address"},"start_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Start Date"},"end_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"End Date"},"limit":{"anyOf":[{"type":"integer","maximum":5000.0,"minimum":1.0},{"type":"null"}],"title":"Limit","description":"Row limit","default":1000},"offset":{"anyOf":[{"type":"integer","minimum":0.0},{"type":"null"}],"title":"Offset","description":"Row offset","default":0}},"additionalProperties":true,"type":"object","title":"api_execution_account_balance_history_daily_PostBody"},"api_execution_account_counterparty_graph_PostBody":{"properties":{"source":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source"},"edge_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Edge Type"},"limit":{"anyOf":[{"type":"integer","maximum":250.0,"minimum":1.0},{"type":"null"}],"title":"Limit","description":"Row limit","default":60},"offset":{"anyOf":[{"type":"integer","minimum":0.0},{"type":"null"}],"title":"Offset","description":"Row offset","default":0}},"additionalProperties":true,"type":"object","title":"api_execution_account_counterparty_graph_PostBody"},"api_execution_account_linked_entities_latest_PostBody":{"properties":{"root_address":{"anyOf":[{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"string"}],"maxLength":20},{"type":"null"}],"title":"Root Address"},"relation":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Relation"},"entity_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Entity Type"},"limit":{"anyOf":[{"type":"integer","maximum":5000.0,"minimum":1.0},{"type":"null"}],"title":"Limit","description":"Row limit","default":100},"offset":{"anyOf":[{"type":"integer","minimum":0.0},{"type":"null"}],"title":"Offset","description":"Row offset","default":0}},"additionalProperties":true,"type":"object","title":"api_execution_account_linked_entities_latest_PostBody"},"api_execution_account_profile_latest_PostBody":{"properties":{"address":{"anyOf":[{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"string"}],"maxLength":20},{"type":"null"}],"title":"Address"},"limit":{"anyOf":[{"type":"integer","maximum":200.0,"minimum":1.0},{"type":"null"}],"title":"Limit","description":"Row limit","default":20},"offset":{"anyOf":[{"type":"integer","minimum":0.0},{"type":"null"}],"title":"Offset","description":"Row offset","default":0}},"additionalProperties":true,"type":"object","title":"api_execution_account_profile_latest_PostBody"},"api_execution_account_recent_transactions_PostBody":{"properties":{"address":{"anyOf":[{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"string"}],"maxLength":20},{"type":"null"}],"title":"Address"},"counterparty":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Counterparty"},"limit":{"anyOf":[{"type":"integer","maximum":1000.0,"minimum":1.0},{"type":"null"}],"title":"Limit","description":"Row limit","default":100},"offset":{"anyOf":[{"type":"integer","minimum":0.0},{"type":"null"}],"title":"Offset","description":"Row offset","default":0}},"additionalProperties":true,"type":"object","title":"api_execution_account_recent_transactions_PostBody"},"api_execution_account_safes_latest_PostBody":{"properties":{"owner_address":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Owner Address","description":"Address whose owned Safes we want to list"},"limit":{"anyOf":[{"type":"integer","maximum":5000.0,"minimum":1.0},{"type":"null"}],"title":"Limit","description":"Row limit","default":500},"offset":{"anyOf":[{"type":"integer","minimum":0.0},{"type":"null"}],"title":"Offset","description":"Row offset","default":0},"sort_by":{"anyOf":[{"type":"string"},{"type":"null"}],"enum":["owner_address","safe_address","became_owner_at","current_threshold","current_owner_count","deployment_date"],"title":"Sort By","description":"Sort column"},"sort_direction":{"anyOf":[{"type":"string"},{"type":"null"}],"enum":["ASC","DESC"],"title":"Sort Direction","description":"Sort direction. Defaults to ASC when sort_by is provided."}},"additionalProperties":true,"type":"object","title":"api_execution_account_safes_latest_PostBody"},"api_execution_account_search_index_PostBody":{"properties":{"search_key":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Search Key"},"address":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Address"},"result_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Result Type"},"limit":{"anyOf":[{"type":"integer","maximum":100.0,"minimum":1.0},{"type":"null"}],"title":"Limit","description":"Row limit","default":20},"offset":{"anyOf":[{"type":"integer","minimum":0.0},{"type":"null"}],"title":"Offset","description":"Row offset","default":0}},"additionalProperties":true,"type":"object","title":"api_execution_account_search_index_PostBody"},"api_execution_account_token_balances_latest_PostBody":{"properties":{"address":{"anyOf":[{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"string"}],"maxLength":20},{"type":"null"}],"title":"Address"},"symbol":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Symbol"},"limit":{"anyOf":[{"type":"integer","maximum":5000.0,"minimum":1.0},{"type":"null"}],"title":"Limit","description":"Row limit","default":100},"offset":{"anyOf":[{"type":"integer","minimum":0.0},{"type":"null"}],"title":"Offset","description":"Row offset","default":0}},"additionalProperties":true,"type":"object","title":"api_execution_account_token_balances_latest_PostBody"},"api_execution_account_token_movements_daily_PostBody":{"properties":{"address":{"anyOf":[{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"string"}],"maxLength":20},{"type":"null"}],"title":"Address"},"counterparty":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Counterparty"},"symbol":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Symbol"},"direction":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Direction"},"start_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Start Date"},"end_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"End Date"},"limit":{"anyOf":[{"type":"integer","maximum":5000.0,"minimum":1.0},{"type":"null"}],"title":"Limit","description":"Row limit","default":250},"offset":{"anyOf":[{"type":"integer","minimum":0.0},{"type":"null"}],"title":"Offset","description":"Row offset","default":0}},"additionalProperties":true,"type":"object","title":"api_execution_account_token_movements_daily_PostBody"},"api_execution_account_transaction_summary_latest_PostBody":{"properties":{"address":{"anyOf":[{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"string"}],"maxLength":20},{"type":"null"}],"title":"Address"},"limit":{"anyOf":[{"type":"integer","maximum":500.0,"minimum":1.0},{"type":"null"}],"title":"Limit","description":"Row limit","default":50},"offset":{"anyOf":[{"type":"integer","minimum":0.0},{"type":"null"}],"title":"Offset","description":"Row offset","default":0}},"additionalProperties":true,"type":"object","title":"api_execution_account_transaction_summary_latest_PostBody"},"api_execution_account_validators_latest_PostBody":{"properties":{"withdrawal_address":{"anyOf":[{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"string"}],"maxLength":20},{"type":"null"}],"title":"Withdrawal Address"},"withdrawal_credentials":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Withdrawal Credentials"},"limit":{"anyOf":[{"type":"integer","maximum":5000.0,"minimum":1.0},{"type":"null"}],"title":"Limit","description":"Row limit","default":100},"offset":{"anyOf":[{"type":"integer","minimum":0.0},{"type":"null"}],"title":"Offset","description":"Row offset","default":0}},"additionalProperties":true,"type":"object","title":"api_execution_account_validators_latest_PostBody"},"api_execution_address_resolver_PostBody":{"properties":{"address":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Address","description":"Gnosis Chain address (0x…). Returns one row with boolean flags + counts for each account-portfolio domain."},"limit":{"anyOf":[{"type":"integer","maximum":100.0,"minimum":1.0},{"type":"null"}],"title":"Limit","description":"Row limit","default":10},"offset":{"anyOf":[{"type":"integer","minimum":0.0},{"type":"null"}],"title":"Offset","description":"Row offset","default":0}},"additionalProperties":true,"type":"object","title":"api_execution_address_resolver_PostBody"},"api_execution_address_search_PostBody":{"properties":{"limit":{"anyOf":[{"type":"integer","maximum":50000.0,"minimum":1.0},{"type":"null"}],"title":"Limit","description":"Row limit","default":10000},"offset":{"anyOf":[{"type":"integer","minimum":0.0},{"type":"null"}],"title":"Offset","description":"Row offset","default":0},"sort_by":{"anyOf":[{"type":"string"},{"type":"null"}],"enum":["address","display_name","connected_validator_count","connected_safe_count"],"title":"Sort By","description":"Sort column"},"sort_direction":{"anyOf":[{"type":"string"},{"type":"null"}],"enum":["ASC","DESC"],"title":"Sort Direction","description":"Sort direction. Defaults to ASC when sort_by is provided."}},"additionalProperties":true,"type":"object","title":"api_execution_address_search_PostBody"},"api_execution_gnosis_app_user_activity_daily_PostBody":{"properties":{"address":{"anyOf":[{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"string"}],"maxLength":20},{"type":"null"}],"title":"Address"},"activity_kind":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Activity Kind"},"start_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Start Date"},"end_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"End Date"},"limit":{"anyOf":[{"type":"integer","maximum":5000.0,"minimum":1.0},{"type":"null"}],"title":"Limit","description":"Row limit","default":200},"offset":{"anyOf":[{"type":"integer","minimum":0.0},{"type":"null"}],"title":"Offset","description":"Row offset","default":0}},"additionalProperties":true,"type":"object","title":"api_execution_gnosis_app_user_activity_daily_PostBody"},"api_execution_gnosis_app_user_profile_latest_PostBody":{"properties":{"address":{"anyOf":[{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"string"}],"maxLength":20},{"type":"null"}],"title":"Address"},"limit":{"anyOf":[{"type":"integer","maximum":200.0,"minimum":1.0},{"type":"null"}],"title":"Limit","description":"Row limit","default":20},"offset":{"anyOf":[{"type":"integer","minimum":0.0},{"type":"null"}],"title":"Offset","description":"Row offset","default":0}},"additionalProperties":true,"type":"object","title":"api_execution_gnosis_app_user_profile_latest_PostBody"},"api_execution_gpay_user_activity_PostBody":{"properties":{"wallet_address":{"anyOf":[{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"string"}],"maxLength":20},{"type":"null"}],"title":"Wallet Address","description":"Wallet address(es)"},"action":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Action","description":"Action type (Payment, Cashback, Fiat Top Up, etc.)"},"symbol":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Symbol","description":"Token symbol"},"start_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Start Date","description":"Inclusive start date"},"end_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"End Date","description":"Inclusive end date"},"limit":{"anyOf":[{"type":"integer","maximum":5000.0,"minimum":1.0},{"type":"null"}],"title":"Limit","description":"Row limit","default":100},"offset":{"anyOf":[{"type":"integer","minimum":0.0},{"type":"null"}],"title":"Offset","description":"Row offset","default":0}},"additionalProperties":true,"type":"object","title":"api_execution_gpay_user_activity_PostBody"},"api_execution_gpay_user_balances_daily_PostBody":{"properties":{"wallet_address":{"anyOf":[{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"string"}],"maxLength":20},{"type":"null"}],"title":"Wallet Address","description":"Wallet address(es)"},"token":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Token","description":"Token symbol"},"start_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Start Date","description":"Inclusive start date"},"end_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"End Date","description":"Inclusive end date"},"limit":{"anyOf":[{"type":"integer","maximum":5000.0,"minimum":1.0},{"type":"null"}],"title":"Limit","description":"Row limit","default":100},"offset":{"anyOf":[{"type":"integer","minimum":0.0},{"type":"null"}],"title":"Offset","description":"Row offset","default":0}},"additionalProperties":true,"type":"object","title":"api_execution_gpay_user_balances_daily_PostBody"},"api_execution_gpay_user_balances_latest_PostBody":{"properties":{"wallet_address":{"anyOf":[{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"string"}],"maxLength":20},{"type":"null"}],"title":"Wallet Address"},"token":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Token"},"limit":{"anyOf":[{"type":"integer","maximum":5000.0,"minimum":1.0},{"type":"null"}],"title":"Limit","description":"Row limit","default":100},"offset":{"anyOf":[{"type":"integer","minimum":0.0},{"type":"null"}],"title":"Offset","description":"Row offset","default":0}},"additionalProperties":true,"type":"object","title":"api_execution_gpay_user_balances_latest_PostBody"},"api_execution_gpay_user_cashback_daily_PostBody":{"properties":{"wallet_address":{"anyOf":[{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"string"}],"maxLength":20},{"type":"null"}],"title":"Wallet Address","description":"Wallet address(es)"},"start_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Start Date","description":"Inclusive start date"},"end_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"End Date","description":"Inclusive end date"},"limit":{"anyOf":[{"type":"integer","maximum":5000.0,"minimum":1.0},{"type":"null"}],"title":"Limit","description":"Row limit","default":100},"offset":{"anyOf":[{"type":"integer","minimum":0.0},{"type":"null"}],"title":"Offset","description":"Row offset","default":0}},"additionalProperties":true,"type":"object","title":"api_execution_gpay_user_cashback_daily_PostBody"},"api_execution_gpay_user_lifetime_metrics_PostBody":{"properties":{"wallet_address":{"anyOf":[{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"string"}],"maxLength":50},{"type":"null"}],"title":"Wallet Address","description":"Wallet address(es)"}},"additionalProperties":true,"type":"object","title":"api_execution_gpay_user_lifetime_metrics_PostBody"},"api_execution_gpay_user_payments_daily_PostBody":{"properties":{"wallet_address":{"anyOf":[{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"string"}],"maxLength":20},{"type":"null"}],"title":"Wallet Address","description":"Wallet address(es)"},"token":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Token","description":"Token symbol"},"start_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Start Date","description":"Inclusive start date"},"end_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"End Date","description":"Inclusive end date"},"limit":{"anyOf":[{"type":"integer","maximum":5000.0,"minimum":1.0},{"type":"null"}],"title":"Limit","description":"Row limit","default":100},"offset":{"anyOf":[{"type":"integer","minimum":0.0},{"type":"null"}],"title":"Offset","description":"Row offset","default":0}},"additionalProperties":true,"type":"object","title":"api_execution_gpay_user_payments_daily_PostBody"},"api_execution_gpay_user_total_cashback_PostBody":{"properties":{"wallet_address":{"anyOf":[{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"string"}],"maxLength":50},{"type":"null"}],"title":"Wallet Address","description":"Wallet address(es)"}},"additionalProperties":true,"type":"object","title":"api_execution_gpay_user_total_cashback_PostBody"},"api_execution_gpay_user_total_payments_PostBody":{"properties":{"wallet_address":{"anyOf":[{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"string"}],"maxLength":50},{"type":"null"}],"title":"Wallet Address","description":"Wallet address(es)"}},"additionalProperties":true,"type":"object","title":"api_execution_gpay_user_total_payments_PostBody"},"api_execution_gpay_user_total_volume_PostBody":{"properties":{"wallet_address":{"anyOf":[{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"string"}],"maxLength":50},{"type":"null"}],"title":"Wallet Address","description":"Wallet address(es)"}},"additionalProperties":true,"type":"object","title":"api_execution_gpay_user_total_volume_PostBody"},"api_execution_safe_details_latest_PostBody":{"properties":{"safe_address":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Safe Address","description":"Safe contract address"},"limit":{"anyOf":[{"type":"integer","maximum":1000.0,"minimum":1.0},{"type":"null"}],"title":"Limit","description":"Row limit","default":100},"offset":{"anyOf":[{"type":"integer","minimum":0.0},{"type":"null"}],"title":"Offset","description":"Row offset","default":0}},"additionalProperties":true,"type":"object","title":"api_execution_safe_details_latest_PostBody"},"api_execution_safes_current_owners_PostBody":{"properties":{"safe_address":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Safe Address","description":"Safe contract address — returns every current owner of this Safe"},"owner_address":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Owner Address","description":"Owner (EOA or contract) address — returns every Safe this address currently owns"},"limit":{"anyOf":[{"type":"integer","maximum":5000.0,"minimum":1.0},{"type":"null"}],"title":"Limit","description":"Row limit","default":500},"offset":{"anyOf":[{"type":"integer","minimum":0.0},{"type":"null"}],"title":"Offset","description":"Row offset","default":0},"sort_by":{"anyOf":[{"type":"string"},{"type":"null"}],"enum":["safe_address","owner_address","became_owner_at"],"title":"Sort By","description":"Sort column"},"sort_direction":{"anyOf":[{"type":"string"},{"type":"null"}],"enum":["ASC","DESC"],"title":"Sort Direction","description":"Sort direction. Defaults to ASC when sort_by is provided."}},"additionalProperties":true,"type":"object","title":"api_execution_safes_current_owners_PostBody"},"api_execution_tokens_balances_daily_PostBody":{"properties":{"symbol":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Symbol","description":"Token symbol"},"address":{"anyOf":[{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"string"}],"maxLength":200},{"type":"null"}],"title":"Address","description":"Wallet address list"},"start_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Start Date","description":"Inclusive start date"},"end_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"End Date","description":"Inclusive end date"},"limit":{"anyOf":[{"type":"integer","maximum":5000.0,"minimum":1.0},{"type":"null"}],"title":"Limit","description":"Row limit","default":100},"offset":{"anyOf":[{"type":"integer","minimum":0.0},{"type":"null"}],"title":"Offset","description":"Row offset","default":0}},"additionalProperties":true,"type":"object","title":"api_execution_tokens_balances_daily_PostBody"},"api_quarterly_data_carbon_emissions_PostBody":{"properties":{"quarter_from":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Quarter From","description":"Inclusive lower bound on quarter start date (e.g. 2024-01-01 for 2024-Q1)"},"quarter_to":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Quarter To","description":"Inclusive upper bound on quarter start date"},"limit":{"anyOf":[{"type":"integer","maximum":1000.0,"minimum":1.0},{"type":"null"}],"title":"Limit","description":"Row limit","default":200},"offset":{"anyOf":[{"type":"integer","minimum":0.0},{"type":"null"}],"title":"Offset","description":"Row offset","default":0}},"additionalProperties":true,"type":"object","title":"api_quarterly_data_carbon_emissions_PostBody"},"api_quarterly_data_circles_active_minters_PostBody":{"properties":{"quarter_from":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Quarter From","description":"Inclusive lower bound on quarter start date (e.g. 2024-01-01 for 2024-Q1)"},"quarter_to":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Quarter To","description":"Inclusive upper bound on quarter start date"},"limit":{"anyOf":[{"type":"integer","maximum":1000.0,"minimum":1.0},{"type":"null"}],"title":"Limit","description":"Row limit","default":200},"offset":{"anyOf":[{"type":"integer","minimum":0.0},{"type":"null"}],"title":"Offset","description":"Row offset","default":0}},"additionalProperties":true,"type":"object","title":"api_quarterly_data_circles_active_minters_PostBody"},"api_quarterly_data_circles_active_trusts_PostBody":{"properties":{"quarter_from":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Quarter From","description":"Inclusive lower bound on quarter start date (e.g. 2024-01-01 for 2024-Q1)"},"quarter_to":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Quarter To","description":"Inclusive upper bound on quarter start date"},"limit":{"anyOf":[{"type":"integer","maximum":1000.0,"minimum":1.0},{"type":"null"}],"title":"Limit","description":"Row limit","default":200},"offset":{"anyOf":[{"type":"integer","minimum":0.0},{"type":"null"}],"title":"Offset","description":"Row offset","default":0}},"additionalProperties":true,"type":"object","title":"api_quarterly_data_circles_active_trusts_PostBody"},"api_quarterly_data_circles_backers_PostBody":{"properties":{"quarter_from":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Quarter From","description":"Inclusive lower bound on quarter start date (e.g. 2024-01-01 for 2024-Q1)"},"quarter_to":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Quarter To","description":"Inclusive upper bound on quarter start date"},"limit":{"anyOf":[{"type":"integer","maximum":1000.0,"minimum":1.0},{"type":"null"}],"title":"Limit","description":"Row limit","default":200},"offset":{"anyOf":[{"type":"integer","minimum":0.0},{"type":"null"}],"title":"Offset","description":"Row offset","default":0}},"additionalProperties":true,"type":"object","title":"api_quarterly_data_circles_backers_PostBody"},"api_quarterly_data_circles_humans_PostBody":{"properties":{"quarter_from":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Quarter From","description":"Inclusive lower bound on quarter start date (e.g. 2024-01-01 for 2024-Q1)"},"quarter_to":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Quarter To","description":"Inclusive upper bound on quarter start date"},"limit":{"anyOf":[{"type":"integer","maximum":1000.0,"minimum":1.0},{"type":"null"}],"title":"Limit","description":"Row limit","default":200},"offset":{"anyOf":[{"type":"integer","minimum":0.0},{"type":"null"}],"title":"Offset","description":"Row offset","default":0}},"additionalProperties":true,"type":"object","title":"api_quarterly_data_circles_humans_PostBody"},"api_quarterly_data_circles_total_supply_PostBody":{"properties":{"quarter_from":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Quarter From","description":"Inclusive lower bound on quarter start date (e.g. 2024-01-01 for 2024-Q1)"},"quarter_to":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Quarter To","description":"Inclusive upper bound on quarter start date"},"limit":{"anyOf":[{"type":"integer","maximum":1000.0,"minimum":1.0},{"type":"null"}],"title":"Limit","description":"Row limit","default":200},"offset":{"anyOf":[{"type":"integer","minimum":0.0},{"type":"null"}],"title":"Offset","description":"Row offset","default":0}},"additionalProperties":true,"type":"object","title":"api_quarterly_data_circles_total_supply_PostBody"},"api_quarterly_data_energy_consumption_PostBody":{"properties":{"quarter_from":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Quarter From","description":"Inclusive lower bound on quarter start date (e.g. 2024-01-01 for 2024-Q1)"},"quarter_to":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Quarter To","description":"Inclusive upper bound on quarter start date"},"limit":{"anyOf":[{"type":"integer","maximum":1000.0,"minimum":1.0},{"type":"null"}],"title":"Limit","description":"Row limit","default":200},"offset":{"anyOf":[{"type":"integer","minimum":0.0},{"type":"null"}],"title":"Offset","description":"Row offset","default":0}},"additionalProperties":true,"type":"object","title":"api_quarterly_data_energy_consumption_PostBody"},"api_quarterly_data_gnosis_app_peak_swappers_PostBody":{"properties":{"quarter_from":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Quarter From","description":"Inclusive lower bound on quarter start date (e.g. 2024-01-01 for 2024-Q1)"},"quarter_to":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Quarter To","description":"Inclusive upper bound on quarter start date"},"limit":{"anyOf":[{"type":"integer","maximum":1000.0,"minimum":1.0},{"type":"null"}],"title":"Limit","description":"Row limit","default":200},"offset":{"anyOf":[{"type":"integer","minimum":0.0},{"type":"null"}],"title":"Offset","description":"Row offset","default":0}},"additionalProperties":true,"type":"object","title":"api_quarterly_data_gnosis_app_peak_swappers_PostBody"},"api_quarterly_data_gnosis_app_swap_volume_PostBody":{"properties":{"quarter_from":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Quarter From","description":"Inclusive lower bound on quarter start date (e.g. 2024-01-01 for 2024-Q1)"},"quarter_to":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Quarter To","description":"Inclusive upper bound on quarter start date"},"limit":{"anyOf":[{"type":"integer","maximum":1000.0,"minimum":1.0},{"type":"null"}],"title":"Limit","description":"Row limit","default":200},"offset":{"anyOf":[{"type":"integer","minimum":0.0},{"type":"null"}],"title":"Offset","description":"Row offset","default":0}},"additionalProperties":true,"type":"object","title":"api_quarterly_data_gnosis_app_swap_volume_PostBody"},"api_quarterly_data_gnosis_app_swaps_PostBody":{"properties":{"quarter_from":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Quarter From","description":"Inclusive lower bound on quarter start date (e.g. 2024-01-01 for 2024-Q1)"},"quarter_to":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Quarter To","description":"Inclusive upper bound on quarter start date"},"limit":{"anyOf":[{"type":"integer","maximum":1000.0,"minimum":1.0},{"type":"null"}],"title":"Limit","description":"Row limit","default":200},"offset":{"anyOf":[{"type":"integer","minimum":0.0},{"type":"null"}],"title":"Offset","description":"Row offset","default":0}},"additionalProperties":true,"type":"object","title":"api_quarterly_data_gnosis_app_swaps_PostBody"},"api_quarterly_data_gnosis_app_swaps_filled_PostBody":{"properties":{"quarter_from":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Quarter From","description":"Inclusive lower bound on quarter start date (e.g. 2024-01-01 for 2024-Q1)"},"quarter_to":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Quarter To","description":"Inclusive upper bound on quarter start date"},"limit":{"anyOf":[{"type":"integer","maximum":1000.0,"minimum":1.0},{"type":"null"}],"title":"Limit","description":"Row limit","default":200},"offset":{"anyOf":[{"type":"integer","minimum":0.0},{"type":"null"}],"title":"Offset","description":"Row offset","default":0}},"additionalProperties":true,"type":"object","title":"api_quarterly_data_gnosis_app_swaps_filled_PostBody"},"api_quarterly_data_gpay_active_users_PostBody":{"properties":{"quarter_from":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Quarter From","description":"Inclusive lower bound on quarter start date (e.g. 2024-01-01 for 2024-Q1)"},"quarter_to":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Quarter To","description":"Inclusive upper bound on quarter start date"},"limit":{"anyOf":[{"type":"integer","maximum":1000.0,"minimum":1.0},{"type":"null"}],"title":"Limit","description":"Row limit","default":200},"offset":{"anyOf":[{"type":"integer","minimum":0.0},{"type":"null"}],"title":"Offset","description":"Row offset","default":0}},"additionalProperties":true,"type":"object","title":"api_quarterly_data_gpay_active_users_PostBody"},"api_quarterly_data_gpay_cashback_PostBody":{"properties":{"quarter_from":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Quarter From","description":"Inclusive lower bound on quarter start date (e.g. 2024-01-01 for 2024-Q1)"},"quarter_to":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Quarter To","description":"Inclusive upper bound on quarter start date"},"limit":{"anyOf":[{"type":"integer","maximum":1000.0,"minimum":1.0},{"type":"null"}],"title":"Limit","description":"Row limit","default":200},"offset":{"anyOf":[{"type":"integer","minimum":0.0},{"type":"null"}],"title":"Offset","description":"Row offset","default":0}},"additionalProperties":true,"type":"object","title":"api_quarterly_data_gpay_cashback_PostBody"},"api_quarterly_data_gpay_payments_PostBody":{"properties":{"quarter_from":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Quarter From","description":"Inclusive lower bound on quarter start date (e.g. 2024-01-01 for 2024-Q1)"},"quarter_to":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Quarter To","description":"Inclusive upper bound on quarter start date"},"limit":{"anyOf":[{"type":"integer","maximum":1000.0,"minimum":1.0},{"type":"null"}],"title":"Limit","description":"Row limit","default":200},"offset":{"anyOf":[{"type":"integer","minimum":0.0},{"type":"null"}],"title":"Offset","description":"Row offset","default":0}},"additionalProperties":true,"type":"object","title":"api_quarterly_data_gpay_payments_PostBody"},"api_quarterly_data_gpay_volume_PostBody":{"properties":{"quarter_from":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Quarter From","description":"Inclusive lower bound on quarter start date (e.g. 2024-01-01 for 2024-Q1)"},"quarter_to":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Quarter To","description":"Inclusive upper bound on quarter start date"},"limit":{"anyOf":[{"type":"integer","maximum":1000.0,"minimum":1.0},{"type":"null"}],"title":"Limit","description":"Row limit","default":200},"offset":{"anyOf":[{"type":"integer","minimum":0.0},{"type":"null"}],"title":"Offset","description":"Row offset","default":0}},"additionalProperties":true,"type":"object","title":"api_quarterly_data_gpay_volume_PostBody"},"api_quarterly_data_nodes_estimated_PostBody":{"properties":{"quarter_from":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Quarter From","description":"Inclusive lower bound on quarter start date (e.g. 2024-01-01 for 2024-Q1)"},"quarter_to":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Quarter To","description":"Inclusive upper bound on quarter start date"},"limit":{"anyOf":[{"type":"integer","maximum":1000.0,"minimum":1.0},{"type":"null"}],"title":"Limit","description":"Row limit","default":200},"offset":{"anyOf":[{"type":"integer","minimum":0.0},{"type":"null"}],"title":"Offset","description":"Row offset","default":0}},"additionalProperties":true,"type":"object","title":"api_quarterly_data_nodes_estimated_PostBody"},"api_quarterly_data_nodes_observed_PostBody":{"properties":{"quarter_from":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Quarter From","description":"Inclusive lower bound on quarter start date (e.g. 2024-01-01 for 2024-Q1)"},"quarter_to":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Quarter To","description":"Inclusive upper bound on quarter start date"},"limit":{"anyOf":[{"type":"integer","maximum":1000.0,"minimum":1.0},{"type":"null"}],"title":"Limit","description":"Row limit","default":200},"offset":{"anyOf":[{"type":"integer","minimum":0.0},{"type":"null"}],"title":"Offset","description":"Row offset","default":0}},"additionalProperties":true,"type":"object","title":"api_quarterly_data_nodes_observed_PostBody"},"api_quarterly_data_stablecoin_holder_cohorts_PostBody":{"properties":{"quarter_from":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Quarter From","description":"Inclusive lower bound on quarter start date (e.g. 2024-01-01 for 2024-Q1)"},"quarter_to":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Quarter To","description":"Inclusive upper bound on quarter start date"},"peg_class":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Peg Class","description":"Filter by peg class: USD-pegged or non-USD"},"limit":{"anyOf":[{"type":"integer","maximum":1000.0,"minimum":1.0},{"type":"null"}],"title":"Limit","description":"Row limit","default":200},"offset":{"anyOf":[{"type":"integer","minimum":0.0},{"type":"null"}],"title":"Offset","description":"Row offset","default":0}},"additionalProperties":true,"type":"object","title":"api_quarterly_data_stablecoin_holder_cohorts_PostBody"},"api_quarterly_data_stablecoin_holders_PostBody":{"properties":{"quarter_from":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Quarter From","description":"Inclusive lower bound on quarter start date (e.g. 2024-01-01 for 2024-Q1)"},"quarter_to":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Quarter To","description":"Inclusive upper bound on quarter start date"},"peg_class":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Peg Class","description":"Filter by peg class: USD-pegged or non-USD"},"limit":{"anyOf":[{"type":"integer","maximum":1000.0,"minimum":1.0},{"type":"null"}],"title":"Limit","description":"Row limit","default":200},"offset":{"anyOf":[{"type":"integer","minimum":0.0},{"type":"null"}],"title":"Offset","description":"Row offset","default":0}},"additionalProperties":true,"type":"object","title":"api_quarterly_data_stablecoin_holders_PostBody"},"api_quarterly_data_stablecoin_supply_PostBody":{"properties":{"quarter_from":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Quarter From","description":"Inclusive lower bound on quarter start date (e.g. 2024-01-01 for 2024-Q1)"},"quarter_to":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Quarter To","description":"Inclusive upper bound on quarter start date"},"peg_class":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Peg Class","description":"Filter by peg class: USD-pegged or non-USD"},"limit":{"anyOf":[{"type":"integer","maximum":1000.0,"minimum":1.0},{"type":"null"}],"title":"Limit","description":"Row limit","default":200},"offset":{"anyOf":[{"type":"integer","minimum":0.0},{"type":"null"}],"title":"Offset","description":"Row offset","default":0}},"additionalProperties":true,"type":"object","title":"api_quarterly_data_stablecoin_supply_PostBody"},"api_quarterly_data_stablecoin_transfers_PostBody":{"properties":{"quarter_from":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Quarter From","description":"Inclusive lower bound on quarter start date (e.g. 2024-01-01 for 2024-Q1)"},"quarter_to":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Quarter To","description":"Inclusive upper bound on quarter start date"},"peg_class":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Peg Class","description":"Filter by peg class: USD-pegged or non-USD"},"limit":{"anyOf":[{"type":"integer","maximum":1000.0,"minimum":1.0},{"type":"null"}],"title":"Limit","description":"Row limit","default":200},"offset":{"anyOf":[{"type":"integer","minimum":0.0},{"type":"null"}],"title":"Offset","description":"Row offset","default":0}},"additionalProperties":true,"type":"object","title":"api_quarterly_data_stablecoin_transfers_PostBody"},"api_quarterly_data_staked_gno_PostBody":{"properties":{"quarter_from":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Quarter From","description":"Inclusive lower bound on quarter start date (e.g. 2024-01-01 for 2024-Q1)"},"quarter_to":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Quarter To","description":"Inclusive upper bound on quarter start date"},"limit":{"anyOf":[{"type":"integer","maximum":1000.0,"minimum":1.0},{"type":"null"}],"title":"Limit","description":"Row limit","default":200},"offset":{"anyOf":[{"type":"integer","minimum":0.0},{"type":"null"}],"title":"Offset","description":"Row offset","default":0}},"additionalProperties":true,"type":"object","title":"api_quarterly_data_staked_gno_PostBody"},"api_quarterly_data_transactions_count_PostBody":{"properties":{"quarter_from":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Quarter From","description":"Inclusive lower bound on quarter start date (e.g. 2024-01-01 for 2024-Q1)"},"quarter_to":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Quarter To","description":"Inclusive upper bound on quarter start date"},"limit":{"anyOf":[{"type":"integer","maximum":1000.0,"minimum":1.0},{"type":"null"}],"title":"Limit","description":"Row limit","default":200},"offset":{"anyOf":[{"type":"integer","minimum":0.0},{"type":"null"}],"title":"Offset","description":"Row offset","default":0}},"additionalProperties":true,"type":"object","title":"api_quarterly_data_transactions_count_PostBody"},"api_quarterly_data_validators_active_PostBody":{"properties":{"quarter_from":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Quarter From","description":"Inclusive lower bound on quarter start date (e.g. 2024-01-01 for 2024-Q1)"},"quarter_to":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Quarter To","description":"Inclusive upper bound on quarter start date"},"limit":{"anyOf":[{"type":"integer","maximum":1000.0,"minimum":1.0},{"type":"null"}],"title":"Limit","description":"Row limit","default":200},"offset":{"anyOf":[{"type":"integer","minimum":0.0},{"type":"null"}],"title":"Offset","description":"Row offset","default":0}},"additionalProperties":true,"type":"object","title":"api_quarterly_data_validators_active_PostBody"}},"securitySchemes":{"APIKeyHeader":{"type":"apiKey","in":"header","name":"X-API-Key"}}}}