Liquity

name: Liquity
description: 'Liquity is a decentralized borrowing protocol that allows users to draw interest-free loans against Ether and
  liquid staking tokens as collateral. The protocol (V1) issues LUSD stablecoin backed by ETH, while V2 (BOLD) supports multi-collateral
  borrowing with WETH, wstETH, and rETH. Liquity exposes a static JSON API at api.liquity.org covering circulating supplies,
  protocol stats, stability pool data, prices, governance epochs, yield opportunities, borrow rates, and a points leaderboard
  — all generated on-chain and published as flat files to GitHub Pages.

  '
deliveryModel:
  model: open-core
  license: MIT
  open_source: true
  commercial: true
  callable_host: true
  label: Open core · an OSS project plus a commercial hosted product
  confidence: high
  source:
  - license
  - openapi
  - pricing
  generated: '2026-08-28'
  method: derived
accessModel:
  pricing: unknown
  onboarding: unknown
  trial: false
  try_now: false
  public: false
  label: Unknown
  confidence: low
  source: []
  generated: '2026-07-22'
  method: derived
image: https://liquity.org/favicon.ico
tags:
- DeFi
- Decentralized Finance
- Lending
- Stablecoins
- Ethereum
- LUSD
- BOLD
- Liquidity Protocol
tags_raw:
- DeFi
- Decentralized Finance
- Lending
- Stablecoin
- Ethereum
- LUSD
- BOLD
- Liquidity Protocol
url: https://www.liquity.org/
specificationVersion: '0.23'
created: '2026-06-14'
modified: '2026-06-14'
apis:
- name: Liquity V2 Protocol Stats API
  description: 'Provides JSON snapshots of Liquity V2 (BOLD) protocol state including total BOLD supply, collateral values,
    stability pool deposits, TVL, per-branch (WETH/wstETH/rETH) metrics, token prices, and yield opportunities. Data is refreshed
    on-chain and published as flat files to GitHub Pages on a scheduled basis.

    '
  humanURL: https://github.com/liquity/api.liquity.org
  baseURL: https://api.liquity.org/v2
  tags:
  - BOLD
  - Protocol Stats
  - TVL
  - Stability Pool
  - Collateral
  properties:
  - type: Documentation
    url: https://github.com/liquity/api.liquity.org
  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
  endpoints:
  - name: Ethereum Protocol Stats
    method: GET
    path: /ethereum.json
    description: 'Returns comprehensive V2 protocol stats for Ethereum mainnet including total_bold_supply, total_debt_pending,
      total_coll_value, total_sp_deposits, total_value_locked, max_sp_apy, per-collateral branch data (WETH, wstETH, rETH),
      sBOLD and yBOLD vault metrics, boldYield opportunities, and current token prices.

      '
  - name: Mainnet Legacy Protocol Stats
    method: GET
    path: /mainnet.json
    description: 'Returns V2 legacy deployment stats for Ethereum mainnet with the same schema as ethereum.json but scoped
      to the original V2 contract deployment.

      '
  - name: Sepolia Testnet Stats
    method: GET
    path: /testnet/sepolia.json
    description: Returns V2 protocol stats for the Sepolia testnet deployment.
- name: Liquity V2 Website Data API
  description: 'Provides JSON data feeds used by the Liquity website including yield venue listings for BOLD, protocol fork
    venues, points leaderboard rankings, and collateral borrow rate comparisons versus DeFi averages.

    '
  humanURL: https://github.com/liquity/api.liquity.org
  baseURL: https://api.liquity.org/v2/website
  tags:
  - BOLD
  - Yield
  - Borrow Rates
  - Leaderboard
  - DeFi
  properties:
  - type: Documentation
    url: https://github.com/liquity/api.liquity.org
  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/website
  endpoints:
  - name: BOLD Yield Venues
    method: GET
    path: /bold-venues.json
    description: 'Returns an array of yield opportunities for BOLD across DeFi protocols (e.g., Euler, Yearn, Asymmetry).
      Each entry includes protocol name, asset/vault name, link, weekly APR, total APR range, and TVL.

      '
  - name: Fork Venues
    method: GET
    path: /fork-venues.json
    description: Returns data on Liquity protocol fork deployments and venues.
  - name: Points Leaderboard
    method: GET
    path: /leaderboard.json
    description: 'Returns a ranked leaderboard of Ethereum addresses by accumulated Liquity points, including rank, address,
      points earned, and percentage share. Contains up to 1,900+ entries.

      '
  - name: Borrow Rates Comparison
    method: GET
    path: /borrow-rates.json
    description: 'Returns average borrow rate comparison per collateral type (WETH, wstETH, rETH) between Liquity V2 and DeFi-wide
      averages.

      '
- 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.

      '
- aid: liquity:liquity-v1-supply-api
  name: Liquity V1 Supply API
  description: Liquity V1 circulating supply and BAMM stats endpoints.
  humanURL: https://github.com/liquity/api.liquity.org
  baseURL: https://api.liquity.org/v1
  tags:
  - V1 Supply
  properties:
  - type: OpenAPI
    url: openapi/liquity-v1-supply-api-openapi.yml
  - type: Documentation
    url: https://github.com/liquity/api.liquity.org
- aid: liquity:liquity-v2-governance-api
  name: Liquity V2 Governance API
  description: Liquity V2 governance state including initiatives and epoch data.
  humanURL: https://github.com/liquity/api.liquity.org
  baseURL: https://api.liquity.org/v1
  tags:
  - V2 Governance
  properties:
  - type: OpenAPI
    url: openapi/liquity-v2-governance-api-openapi.yml
  - type: Documentation
    url: https://github.com/liquity/api.liquity.org
- aid: liquity:liquity-v2-protocol-stats-api
  name: Liquity V2 Protocol Stats API
  description: Liquity V2 (BOLD) protocol state snapshots for mainnet and testnet.
  humanURL: https://github.com/liquity/api.liquity.org
  baseURL: https://api.liquity.org/v1
  tags:
  - V2 Protocol Stats
  properties:
  - type: OpenAPI
    url: openapi/liquity-v2-protocol-stats-api-openapi.yml
  - type: Documentation
    url: https://github.com/liquity/api.liquity.org
- aid: liquity:liquity-v2-website-data-api
  name: Liquity V2 Website Data API
  description: Data feeds for the Liquity website including yield venues, leaderboard, and borrow rates.
  humanURL: https://github.com/liquity/api.liquity.org
  baseURL: https://api.liquity.org/v1
  tags:
  - V2 Website Data
  properties:
  - type: OpenAPI
    url: openapi/liquity-v2-website-data-api-openapi.yml
  - type: Documentation
    url: https://github.com/liquity/api.liquity.org
common:
- type: Website
  url: https://www.liquity.org/
- type: IssueTracker
  url: https://github.com/liquity/V2-gov/issues
- type: License
  name: MIT
  url: https://github.com/liquity/V2-gov/blob/main/LICENSE
- type: AgenticAccess
  url: agentic-access/liquity-agentic-access.yml
- type: DomainSecurity
  url: security/liquity-domain-security.yml
- type: TermsOfService
  url: https://www.liquity.org/terms
- type: PrivacyPolicy
  url: https://www.liquity.org/privacy
- type: GitHubOrganization
  url: https://github.com/liquity
- type: StatusPage
  url: https://api.liquity.org/
- type: Documentation
  url: https://docs.liquity.org/
- type: Blog
  url: https://www.liquity.org/blog
- type: Discord
  url: https://discord.gg/2up5U32
- type: Twitter
  url: https://twitter.com/LiquityProtocol
- type: GitHubRepository
  url: https://github.com/liquity/dev
- type: GitHubRepository
  url: https://github.com/liquity/bold
- type: GitHubRepository
  url: https://github.com/liquity/api.liquity.org
- type: NPMPackage
  url: https://www.npmjs.com/package/@liquity/lib-ethers
- type: NPMPackage
  url: https://www.npmjs.com/package/@liquity/lib-base
- type: NPMPackage
  url: https://www.npmjs.com/package/@liquity/lib-react
- type: NPMPackage
  url: https://www.npmjs.com/package/@liquity/lib-subgraph
- type: PostmanWorkspace
  url: https://www.postman.com/api-evangelist/liquity
maintainers:
- FN: API Evangelist
  url: https://apievangelist.com
  email: info@apievangelist.com