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.
Liquity publishes 7 API contracts indexed on the APIs.io network, including V2 Protocol Stats API, V2 Website Data API, V2 Governance API, and 4 more. Tagged areas include DeFi, Decentralized Finance, Lending, Stablecoins, and Ethereum.
The Liquity catalog on APIs.io includes 1 JSON-LD context and 1 Spectral governance ruleset.
Liquity’s developer surface includes documentation, engineering blog, and 19 more developer resources.
29.7/100thin▬ flatAgent24/100agent awareFront door AI1/6
silent
Heartbeat58/100
alive
open core · MIT
Full breakdown ↓
scored 2026-11-06 · rubric v0.27.0 · Show this score on your site →
Regulatory Posture applies to this provider. Its tags matched the
Horizontal (data, software, accessibility, platform) regime, so
Regulatory Posture carries 15 points of the composite.
If this regime is wrong for your business, say so on your
provider repo — the
applicability map is public and we will correct it.
Create-or-Update Ergonomics does not apply to this provider. The published contracts declare
no write operations, and a read-only API cannot create-or-update. The facet is excluded from this provider's
denominator entirely — not scored zero. A reference or data API is not deficient for being unable to
upsert.
The six quality facets above are damped to 85 points between them,
because the conditional facet above carries the other
15. That is why each facet's contribution is shown against a damped
maximum: raising a quality facet moves the composite by 85% of its nominal
weight, not 100%. The full arithmetic is at apis.io/rating/.
Show this score on your site.
It updates itself when the score changes. Paste this where you link to your API docs:
<a href="https://apis.io/providers/liquity/"><img src="https://apis.io/badge/liquity/card.svg" alt="Liquity on APIs.io — Kin Score by API Evangelist"></a>
Other styles, a README pill and a shields.io endpoint are on the badge page.
Raise your score.
Agent readiness — checks not met, largest first (exact, from this profile):
MCP Server+12 pts — deployment.mode + probe verdict on the mcp/ manifest, not the pointer; an unprobed slug falls back to authorship
Machine-Readable Auth+10 pts — a served openid-configuration/oauth-authorization-server carrying `issuer` (served), else the securitySchemes class in the provider OpenAPIs — bound (mutualTLS, DPoP, Signature) > negotiable (oauth2 authorizationCode/clientCredentials, openIdConnect) > bearer (http bearer, apiKey)
Stable Error Semantics+8 pts — OpenAPI $refs a shared error schema across 4xx/5xx responses (verified), else common[].type includes ErrorCatalog / ErrorCodes / DeclineCodes
A2A Agent Card+8 pts — a2a/-a2a.yml manifest, graded on conformance.grade against A2A 1.0.0
Rate-Limit Signaling+7 pts — OpenAPI responses document X-RateLimit-* / RateLimit headers (verified), else a rate_limits artifact or RateLimits link (documented)
The Kin Score Market layer reads a provider inside its market:
its position, and how deep its integrations go. Depth is only comparable within a position. Provisional and unweighted:
not part of the Kin Score or agent readiness.
Registered MCP server and declares compatibility are report only — not weighted.
Undeclared means we found nothing we can read, so there is no number: we never infer integrations.
Standards this provider implements or carries. De facto ones are profiled and measured by the API Commons; formal ones come from the standards directory and are linked by the provider's own tags. The evidence column says how each claim was established — not that it was made.
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, ...
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 compa...
Provides JSON snapshots of Liquity V2 governance state including active initiatives, epoch allocation data, and the latest completed governance epoch number. Updated via The Gra...
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:
- security
generated: '2026-11-06'
method: derived
image: https://liquity.org/favicon.ico
x-docs-platform: gitbook
x-docs-platform-confidence: high
x-docs-platform-checked: 2026-10-03
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
- Leaderboards
- DeFi
tags_raw:
- 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
Liquity API — frequently asked questions
Does Liquity have an API?
Yes. APIs.io lists 7 APIs from Liquity, including Liquity V2 Protocol Stats API, Liquity V2 Website Data API and Liquity V2 Governance API, and 4 more.
Is there an OpenAPI specification for the Liquity API?
Yes. APIs.io indexes 7 OpenAPI specifications for Liquity, each linked for download from this page.
Is the Liquity API ready for AI agents?
Liquity has a Kin Score of 29.7 out of 100 (thin) and an Agent Readiness score of 23.8 (agent-aware), scored by API Evangelist on 2026-11-06.
Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
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.
Kin Score
How this is scored →
It updates itself when the score changes. Paste this where you link to your API docs: