Governance API Endpoints¶

Monthly governance activity, long format (date, metric, value) for proposals_created, votes_cast, unique_voters.

Model: api_governance_activity_monthly — table dbt.api_governance_activity_monthly

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

Columns

Example

curl "https://api.analytics.gnosis.io/v1/governance/governance_activity/monthly" \
  -H "X-API-Key: YOUR_API_KEY"

Space-level concentration at canonical tiers 10/20/50, long format, one row per (population, tier). Populations: voters_by_vp (all-time voting power cast -- participation-weighted, not a balance), voters_by_votes, delegates_by_delegators (currently active delegations, both chains). Per-proposal w...

Model: api_governance_concentration_latest — table dbt.api_governance_concentration_latest

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

Columns

Example

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

Top 200 forum contributors by posts written. Keyed by contributor_key -- an irreversible salted pseudonym of the Discourse user id (no username, no raw id ships anywhere in this model). Like counts follow the canonical eligibility contract (active + mapped).

Model: api_governance_contributors_latest — table dbt.api_governance_contributors_latest

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

Columns

Example

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

Delegate leaderboard: how many distinct gnosis.eth holders currently delegate to each address across both DelegateRegistry chains (1 and 100). A holder active on both chains counts once (uniqExact). See int_governance_current_delegations for how "current" is resolved. Delegation here is a separat...

Model: api_governance_delegates_latest — table dbt.api_governance_delegates_latest

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

Columns

Example

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

Monthly DelegateRegistry activity, long format (date, metric, value). Metrics: set_events, clear_events, net_change, new_delegators (first-ever set per (chain, delegator)), repointed (later sets), active_delegators (running net through the month). Chains collapsed; churn classification is the can...

Model: api_governance_delegation_activity_monthly — table dbt.api_governance_delegation_activity_monthly

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

Columns

Example

curl "https://api.analytics.gnosis.io/v1/governance/governance_delegation_activity/monthly" \
  -H "X-API-Key: YOUR_API_KEY"

Current delegator -> delegate edges (one row per active delegation per chain), for a delegation-network visual. chain_id separates the two registries; tx_hash lets a reader verify any edge on-chain.

Model: api_governance_delegation_graph — table dbt.api_governance_delegation_graph

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

Columns

Example

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

Discussion and endorsement per proposal per lifecycle phase: before the proposal existed, after it existed but before voting opened, during the vote, and after it closed. Rows exist for any (proposal, phase) with either posts or likes, so a phase where people only clicked like is still present --...

Model: api_governance_discussion_phases — table dbt.api_governance_discussion_phases

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

Columns

Example

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

Electorate size per month measured two ways at once: how many PEOPLE voted and how much CAPITAL voted. The divergence between the two lines is the finding -- raw vote counts fell ~98.7% from 2022 to 2026, but median voting power per GIP is HIGHER now (137k vs 102k) and median voters per GIP (68) ...

Model: api_governance_electorate_monthly — table dbt.api_governance_electorate_monthly

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

Columns

Example

curl "https://api.analytics.gnosis.io/v1/governance/governance_electorate/monthly" \
  -H "X-API-Key: YOUR_API_KEY"

Weekly forum activity long format (date, metric, value).

Model: api_governance_forum_activity_weekly — table dbt.api_governance_forum_activity_weekly

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

Columns

Example

curl "https://api.analytics.gnosis.io/v1/governance/governance_forum_activity/weekly" \
  -H "X-API-Key: YOUR_API_KEY"

Forum discussion <-> Snapshot vote cross-links, topic grain. Unions two independent signals -- a pasted proposal/0x URL in a post (via_forum_post) and the proposal's own authored discussion field (via_discussion) -- so a link found by only one method still gets its own row (43 discussion-only r...

Model: api_governance_forum_topic_proposal_links — table dbt.api_governance_forum_topic_proposal_links

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

Columns

Example

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

Nested GIP conversion funnel: discussed on forum -> discussed AND reached Snapshot vote -> discussed AND reached vote AND (has_passed OR has_decided).

Model: api_governance_gip_funnel — table dbt.api_governance_gip_funnel

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

Columns

Example

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

Pending GIP pipeline: open forum topics whose GIP number never reached a Snapshot vote, with idle time. 45 idle days is the canonical dormancy threshold; every pending topic is exposed with flags (no cap, no hidden rows -- capping is presentation).

Model: api_governance_gip_pipeline_latest — table dbt.api_governance_gip_pipeline_latest

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

Columns

Example

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

Single-row headline governance KPIs for number tiles: proposal/GIP/vote counts, unique voters, followers, proposals passed, pass rate, and average voters per closed GIP proposal (avg_voters_per_gip_proposal).

Model: api_governance_kpis_latest — table dbt.api_governance_kpis_latest

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

Columns

Example

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

The forum's headcount verdict against the token verdict on the SAME question. The only comparison in the layer between two genuinely SEPARATE populations -- a forum temperature check (one person one vote, no token needed) and the Snapshot ballot that followed. head_minus_weight_against on api_gov...

Model: api_governance_poll_vs_vote — table dbt.api_governance_poll_vs_vote

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

Columns

Example

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

Monthly voting power by source (Staked GNO / GNO holdings / Delegated), long format (date, label, value). Empty until proposals carry strategies.

Model: api_governance_power_source_monthly — table dbt.api_governance_power_source_monthly

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

Columns

Example

curl "https://api.analytics.gnosis.io/v1/governance/governance_power_source/monthly" \
  -H "X-API-Key: YOUR_API_KEY"

Per-choice vote breakdown, long format (one row per proposal x choice), for the per-proposal For/Against/Abstain (or ranked-choice) bar with a quorum reference line. Works for any ballot shape, not just binary.

Model: api_governance_proposal_choices — table dbt.api_governance_proposal_choices

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

Columns

Example

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

Per-proposal voting direction measured twice -- once by headcount, once by voting power -- plus the gap between them. Powers the "whales versus everyone else" view. Shares are over DECISIVE votes (for + against), excluding abstain so an abstain-heavy ballot never reads as consensus; abstain is ex...

Model: api_governance_proposal_direction — table dbt.api_governance_proposal_direction

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

Columns

Example

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

Proposal browse table (one row per Snapshot proposal) with outcome, category, quorum, and vote aggregates. Filter is_gip = 1 for GIPs only.

Model: api_governance_proposals_latest — table dbt.api_governance_proposals_latest

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

Columns

Example

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

Ballots open right now (voting window contains query time). Vote counts lag up to the daily ingest; hours_left is exact. Empty when no ballot is open -- an empty result is a fact, not a failure.

Model: api_governance_proposals_live — table dbt.api_governance_proposals_live

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

Columns

Example

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

Top 50 proposal authors by count, with outcome record. enactment_rate is (passed + decided) / closed proposals — distinct from gip_pass_rate on KPIs (pass/fail only, excludes selection ballots).

Model: api_governance_top_proposers — table dbt.api_governance_top_proposers

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

Columns

Example

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

Top 200 voters by proposals voted, with cumulative and average voting power. total_vp_cast is participation-weighted, not a balance.

Model: api_governance_top_voters — table dbt.api_governance_top_voters

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

Columns

Example

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

Per-GIP turnout browse table (is_gip=1 only): total_vp cast / eligible GNO supply (circulating on both chains + staked, conditionally). See int_governance_turnout for the full methodology, the GIP-only scoping rationale, and its historical-precision caveat.

Model: api_governance_turnout_latest — table dbt.api_governance_turnout_latest

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

Columns

Example

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

Monthly turnout trend (is_gip=1 only): a simple average of per-GIP turnout ratios, NOT population-weighted by eligible supply. Directional trend only -- use api_governance_turnout_latest for exact per-proposal figures. A month with no real GIP shows no row (rather than a misleading 0%), since the...

Model: api_governance_turnout_monthly — table dbt.api_governance_turnout_monthly

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

Columns

Example

curl "https://api.analytics.gnosis.io/v1/governance/governance_turnout/monthly" \
  -H "X-API-Key: YOUR_API_KEY"

How opinion FORMED across a voting window: one row per (proposal, hour since voting opened) with cumulative against-share by headcount and by voting power. Viable because the median proposal spreads 100 votes over 50 distinct active hours in a 168h window. Intended use is to overlay forum post ti...

Model: api_governance_vote_trajectory — table dbt.api_governance_vote_trajectory

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

Columns

Example

curl "https://api.analytics.gnosis.io/v1/governance/governance_vote_trajectory/hourly" \
  -H "X-API-Key: YOUR_API_KEY"

Per-proposal voting-power concentration: share of total vp cast by the top 1 / 5 / 10 voters. Reveals whale-decided votes a raw voter count would hide. NULL shares on zero-vote proposals.

Model: api_governance_whale_concentration — table dbt.api_governance_whale_concentration

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

Columns

Example

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