Docs / API: Markets
Chain TVL
Returns the top 40 chains by total value locked. Source: DefiLlama, cached for 10 minutes.
GET/api/v1/markets/chains
| Property | Value |
|---|---|
| Authentication | Optional. A key raises your limit. |
| Rate-limit cost | 1 unit |
| Status | Live |
#Request
curl -s "https://farbeamlabs.com/api/v1/markets/chains"const res = await fetch("https://farbeamlabs.com/api/v1/markets/chains");
const { data, meta, error } = await res.json();
if (error) throw new Error(`${error.code}: ${error.message}`);
console.log(data);import os, requests
res = requests.get(
"https://farbeamlabs.com/api/v1/markets/chains",
timeout=30,
)
body = res.json()
if "error" in body:
raise RuntimeError(body["error"]["code"])
print(body["data"])You can send this request now in the API playground.
#Response
This response is real. It was captured from the running API when this page was built. Arrays are cut to two items.
JSON
{
"data": [
{
"rank": 1,
"name": "Ethereum",
"tvl_usd": 45947651149,
"token": "ETH",
"covered": "ethereum"
},
{
"rank": 2,
"name": "Base",
"tvl_usd": 6158920326,
"token": null,
"covered": "base"
}
],
"meta": {
"request_id": "req_906520e87390",
"as_of": "2026-11-04T20:10:57.679Z",
"source": "defillama"
}
}#Errors
| HTTP | Code | Meaning |
|---|---|---|
| 502 | upstream_unavailable | A public data source did not answer. |
All errors share one format. See errors.