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. image: https://liquity.org/favicon.ico tags: - DeFi - Decentralized Finance - Lending - Stablecoin - Ethereum - LUSD - BOLD - Liquidity Protocol url: https://www.liquity.org/ specificationVersion: "0.19" created: "2026-06-14" modified: "2026-06-14" apis: - name: Liquity V1 Circulating Supply API description: > Provides plaintext files for LQTY token circulating supply and LUSD stablecoin total supply, derived directly from on-chain contract state via Ethers.js and published to GitHub Pages. humanURL: https://github.com/liquity/api.liquity.org baseURL: https://api.liquity.org/v1 tags: - LUSD - LQTY - Supply - Circulating Supply properties: - type: Documentation url: https://github.com/liquity/api.liquity.org - type: OpenAPI url: https://api.liquity.org/v1/lusd_total_supply.txt 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/v1 endpoints: - name: LUSD Total Supply method: GET path: /lusd_total_supply.txt description: Returns the current total supply of LUSD stablecoin as a plaintext decimal number. - name: LQTY Circulating Supply method: GET path: /lqty_circulating_supply.txt description: Returns the current circulating supply of LQTY governance token as a plaintext decimal number. - name: LUSD Chicken Bonds BAMM Stats method: GET path: /lusd_cb_bamm_stats.json description: > Returns JSON with BAMM (B.AMM) debt, and 7-day, 14-day, and 30-day APR figures for the LUSD Chicken Bonds stability pool integration with B.Protocol. - 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. common: - 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