find_apisBrowse and filter every API in the catalog.
get_api_artifactsOne API's artifacts, grouped by type.
get_openapiThe primary OpenAPI for this API.
find_similar_apisAPIs that look like this one.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This API

curl "https://apis.io/api/v1/apis/liquity-v2-governance-api"

All apis

curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

openapi: 3.2.0
info:
  title: Liquity Protocol V1 Supply V2 Governance API
  description: 'The Liquity static JSON API at api.liquity.org covers circulating supplies, protocol stats, stability pool data, prices, governance epochs, yield opportunities, borrow rates, and a points leaderboard. Data is generated on-chain and published as flat files to GitHub Pages. Liquity V1 issues LUSD stablecoin backed by ETH. Liquity V2 (BOLD) supports multi-collateral borrowing with WETH, wstETH, and rETH.

    '
  version: 1.0.0
  contact:
    name: Liquity Team
    url: https://www.liquity.org/
  license:
    name: MIT
    url: https://opensource.org/licenses/MIT
  termsOfService: https://www.liquity.org/terms
servers:
- url: https://api.liquity.org
  description: Liquity API (GitHub Pages)
tags:
- name: V2 Governance
  description: Liquity V2 governance state including initiatives and epoch data.
paths:
  /v2/governance/initiatives.json:
    get:
      operationId: getGovernanceInitiatives
      summary: Governance Initiatives
      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).

        '
      tags:
      - V2 Governance
      responses:
        '200':
          description: Map of governance initiative addresses to metadata.
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  $ref: '#/components/schemas/GovernanceInitiative'
              example:
                '0xD533a949740bb3306d119CC777fa900bA034cd52':
                  isBribeInitiative: true
                  bribeToken: '0xD533a949740bb3306d119CC777fa900bA034cd52'
                '0x1234567890abcdef1234567890abcdef12345678':
                  isBribeInitiative: false
                  bribeToken: null
  /v2/governance/latest_completed_epoch.json:
    get:
      operationId: getLatestCompletedEpoch
      summary: Latest Completed Epoch
      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.

        '
      tags:
      - V2 Governance
      responses:
        '200':
          description: Latest completed governance epoch index.
          content:
            application/json:
              schema:
                type: integer
                description: The index of the most recently completed governance epoch.
                example: 57
components:
  schemas:
    GovernanceInitiative:
      type: object
      description: Metadata for a Liquity V2 governance initiative.
      properties:
        isBribeInitiative:
          type: boolean
          description: Whether this initiative uses bribe mechanisms.
          example: true
        bribeToken:
          type:
          - string
          - 'null'
          description: Ethereum token address used for bribes, or null if not a bribe initiative.
          example: '0xD533a949740bb3306d119CC777fa900bA034cd52'
      required:
      - isBribeInitiative
      - bribeToken
externalDocs:
  description: Liquity API GitHub Repository
  url: https://github.com/liquity/api.liquity.org