Liquity V2 Website Data API
Data feeds for the Liquity website including yield venues, leaderboard, and borrow rates.
Work with this as data
Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
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.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/liquity-v2-website-data-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.
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 Website Data 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 Website Data
description: Data feeds for the Liquity website including yield venues, leaderboard, and borrow rates.
paths:
/v2/website/bold-venues.json:
get:
operationId: getBoldYieldVenues
summary: BOLD Yield Venues
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.
'
tags:
- V2 Website Data
responses:
'200':
description: List of BOLD yield opportunities.
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/YieldVenue'
example:
- protocol: Euler
asset: BOLD Vault
link: https://app.euler.finance/vault/0xC1C51C5c9EfaF0c485Aa1097AE9690B5e102975A
weekly_apr: 0.10333863505351129
total_apr: 21.5% - 103.1%
tvl: 148921.61027224179
/v2/website/fork-venues.json:
get:
operationId: getForkVenues
summary: Fork Venues
description: Returns data on Liquity protocol fork deployments and venues.
tags:
- V2 Website Data
responses:
'200':
description: List of Liquity protocol fork venues.
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/YieldVenue'
/v2/website/leaderboard.json:
get:
operationId: getPointsLeaderboard
summary: Points Leaderboard
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.
'
tags:
- V2 Website Data
responses:
'200':
description: Points leaderboard with ranked Ethereum addresses.
content:
application/json:
schema:
$ref: '#/components/schemas/Leaderboard'
example:
total_row_count: 1907
rows:
- rank: 1
address: '0xc83aa8e0da4ffc388fdbfc1cb111d8d625b5b8e7'
points: 632014.0793235414
percent: 0.05085206108535175
- rank: 2
address: '0xceb63486c7ec2896b399e2d967c567d8c05f673a'
points: 451653.63560210326
percent: 0.036340200350666235
/v2/website/borrow-rates.json:
get:
operationId: getBorrowRatesComparison
summary: Borrow Rates Comparison
description: 'Returns average borrow rate comparison per collateral type (WETH, wstETH, rETH) between Liquity V2 and DeFi-wide averages.
'
tags:
- V2 Website Data
responses:
'200':
description: Borrow rate comparison by collateral type.
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/BorrowRateComparison'
example:
- collateral: WETH
defi_avg_borrow_rate: 0.04535838926497226
liquity_avg_borrow_rate: 0.022137661065511436
- collateral: wstETH
defi_avg_borrow_rate: 0.039
liquity_avg_borrow_rate: 0.018
- collateral: rETH
defi_avg_borrow_rate: 0.041
liquity_avg_borrow_rate: 0.019
components:
schemas:
LeaderboardEntry:
type: object
description: A single entry in the Liquity points leaderboard.
properties:
rank:
type: integer
description: Leaderboard ranking position.
example: 1
address:
type: string
description: Ethereum wallet address.
example: '0xc83aa8e0da4ffc388fdbfc1cb111d8d625b5b8e7'
points:
type: number
description: Total Liquity points accumulated.
example: 632014.0793235414
percent:
type: number
description: Percentage share of total points (0-1 range).
example: 0.05085206108535175
required:
- rank
- address
- points
- percent
BorrowRateComparison:
type: object
description: Borrow rate comparison between Liquity V2 and DeFi average for a collateral.
properties:
collateral:
type: string
description: Collateral token identifier (e.g., WETH, wstETH, rETH).
example: WETH
defi_avg_borrow_rate:
type: number
format: float
description: Average borrow rate across DeFi protocols as decimal.
example: 0.04535838926497226
liquity_avg_borrow_rate:
type: number
format: float
description: Average borrow rate on Liquity V2 as decimal.
example: 0.022137661065511436
required:
- collateral
- defi_avg_borrow_rate
- liquity_avg_borrow_rate
Leaderboard:
type: object
description: Paginated leaderboard of Ethereum addresses by Liquity points.
properties:
total_row_count:
type: integer
description: Total number of entries in the leaderboard.
example: 1907
rows:
type: array
items:
$ref: '#/components/schemas/LeaderboardEntry'
description: List of leaderboard entries.
required:
- total_row_count
- rows
YieldVenue:
type: object
description: A yield opportunity for BOLD in a DeFi protocol.
properties:
protocol:
type: string
description: Name of the DeFi protocol.
example: Euler
asset:
type: string
description: Asset or vault identifier.
example: BOLD Vault
link:
type: string
format: uri
description: URL to access the yield opportunity.
example: https://app.euler.finance/vault/0xC1C51C5c9EfaF0c485Aa1097AE9690B5e102975A
weekly_apr:
type: number
description: Weekly annualized percentage rate as decimal.
example: 0.10333863505351129
total_apr:
type: string
description: Range of total APR as formatted string.
example: 21.5% - 103.1%
tvl:
type: number
description: Total value locked in USD.
example: 148921.61027224179
required:
- protocol
- asset
- link
- weekly_apr
- total_apr
- tvl
externalDocs:
description: Liquity API GitHub Repository
url: https://github.com/liquity/api.liquity.org