Liquity V2 Governance API

Provides JSON snapshots of Liquity V2 governance state including active initiatives, epoch allocation data, and the latest completed governance epoch number. Updated via The Graph subgraph queries on a weekly epoch schedule (epoch duration 604,800 seconds).

API entry from apis.yml

apis.yml Raw ↑
name: Liquity V2 Governance API
description: 'Provides JSON snapshots of Liquity V2 governance state including active initiatives, epoch
  allocation data, and the latest completed governance epoch number. Updated via The Graph subgraph queries
  on a weekly epoch schedule (epoch duration 604,800 seconds).

  '
humanURL: https://github.com/liquity/api.liquity.org
baseURL: https://api.liquity.org/v2/governance
tags:
- Governance
- LQTY
- Epoch
- Initiatives
- Voting
properties:
- type: Documentation
  url: https://github.com/liquity/api.liquity.org
- type: GitHubRepository
  url: https://github.com/liquity/V2-gov
contact:
- FN: Liquity Team
  url: https://www.liquity.org/
meta:
- type: x-api-key-required
  value: 'false'
- type: x-base-url
  value: https://api.liquity.org/v2/governance
endpoints:
- name: Governance Initiatives
  method: GET
  path: /initiatives.json
  description: 'Returns a mapping of Ethereum addresses to governance initiative metadata, including whether
    each address is a bribe initiative and the associated bribe token address (or null).

    '
- name: Latest Completed Epoch
  method: GET
  path: /latest_completed_epoch.json
  description: 'Returns the index number of the most recently completed governance epoch as a plain integer.
    Epoch cadence is weekly starting from epoch start timestamp 1746662400.

    '
- name: Epoch Allocation
  method: GET
  path: /allocation
  description: 'Directory of per-epoch LQTY allocation snapshots used to distribute governance rewards
    to initiative participants.

    '