> For the complete documentation index, see [llms.txt](https://docs.satoshiterminal.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.satoshiterminal.io/resources/copy-of-defi-analytics/adoption-and-ecosystem-health/on-chain-governance-metrics.md).

# On-Chain Governance Metrics

**Implementation Details**

**Class Names**

| Model Name        | Parameters Class      | Data Class     |
| ----------------- | --------------------- | -------------- |
| GovernanceMetrics | GovernanceQueryParams | GovernanceData |

**Import Statement**

```python
pythonCopyEditfrom satoshi_terminal.models.on_chain_governance_metrics import (
    GovernanceMetrics,
    GovernanceQueryParams,
    GovernanceData,
)
```

***

**Parameters**

| Name             | Type | Description                                                 | Default | Optional |
| ---------------- | ---- | ----------------------------------------------------------- | ------- | -------- |
| protocol\_name   | str  | Name of the protocol being analyzed (e.g., MakerDAO, Aave). | None    | False    |
| voting\_activity | bool | Whether to include detailed voting activity data.           | False   | True     |
| voter\_class     | str  | Class of voters to track (e.g., "Whales," "DAOs").          | None    | True     |

***

**Data**

| Name                    | Type     | Description                                                 |
| ----------------------- | -------- | ----------------------------------------------------------- |
| protocol\_name          | str      | Name of the protocol being analyzed.                        |
| active\_proposals       | int      | Number of governance proposals currently open.              |
| voter\_distribution     | dict     | Breakdown of voting power across voter classes.             |
| proposal\_success\_rate | float    | Percentage of successful governance proposals historically. |
| timestamp               | datetime | Timestamp of the governance analysis.                       |

***

**Key Features**

* **Voter Influence Mapping:** Visualize how voting power is distributed among whales, DAOs, and other participants.
* **Proposal Success Analytics:** Track success rates and common traits of passed proposals.
* **Governance Centralization Detection:** Highlight protocols with governance dominated by a few entities.