Skip to content
GET /v1/meta

Service metadata & live sample

Try it live

10 free calls per day — no sign-up, no API key. Goes through the oanor gateway.

Custom headers (optional)
api.oanor.com/liquity-api

It works. Grab an API key and use it in your project.

Get an API key

Code snippets

curl "https://api.oanor.com/liquity-api/v1/meta" \
  -H "x-oanor-key: oanor_test_..."
await fetch("https://api.oanor.com/liquity-api/v1/meta", {
  headers: { "x-oanor-key": "oanor_test_..." }
});
$ch = curl_init("https://api.oanor.com/liquity-api/v1/meta");
curl_setopt($ch, CURLOPT_HTTPHEADER, ["x-oanor-key: oanor_test_..."]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$out = curl_exec($ch);
import requests
requests.get(
    "https://api.oanor.com/liquity-api/v1/meta",
    headers={"x-oanor-key": "oanor_test_..."}
)

Example response

A real response from this endpoint, captured by the latest health check.

{
    "data": {
        "note": "collateral takes optional limit (1-100) and min_usd. pools takes optional version (v1, v2), earning (true/false) and sort (tvl or apy). All money values are USD; APYs are percentages. Other endpoints take no parameters.",
        "sample": {
            "top_collateral": "WETH",
            "total_collateral_usd": 197759953.66
        },
        "source": "DeFiLlama open API (api.llama.fi + yields.llama.fi), live",
        "service": "liquity-api",
        "endpoints": {
            "GET /v1/tvl": "Total collateral locked in Liquity (total + per-chain).",
            "GET /v1/meta": "This document.",
            "GET /v1/pools": "Liquity pools (stability pools / deposits) with APY (version, earning, sort).",
            "GET /v1/overview": "Combined Liquity snapshot (collateral + assets + best pool).",
            "GET /v1/collateral": "Assets backing LUSD/BOLD — ETH and LSTs, by USD and share."
        },
        "description": "Live protocol metrics for Liquity, the original immutable decentralized borrowing protocol issuing the LUSD and BOLD stablecoins against ETH and LST collateral, keyless. Total collateral locked, the breakdown of which assets back the stablecoins (ETH, wstETH, rETH across v1 + v2), per-chain TVL, and the Liquity pools (stability pools) with APY. One combined overview snapshots it all. Live, nothing stored beyond a short protective cache. The CDP / decentralized-stablecoin metrics layer for DeFi dashboards, stablecoin, risk and yield apps. Distinct from DEX, lending, restaking and yield protocols — Liquity's collateralized-debt model specifically.",
        "upstream_status": "ok"
    },
    "meta": {
        "timestamp": "2026-06-14T08:04:29.242Z",
        "request_id": "72710370-2a61-4638-9d3b-1ccc77df942b"
    },
    "status": "ok",
    "message": "Meta",
    "success": true
}