{"openapi":"3.1.0","info":{"title":"Chain TVL API","version":"1.0.0","description":"Live DeFi total-value-locked per blockchain as an API, streamed from the DefiLlama chains feed. For every chain DefiLlama tracks: the dollar value of assets locked in its DeFi protocols, its native token symbol, and its share of all DeFi value (dominance), plus 7-day and 30-day change for a chain. Rank the blockchains by how much capital they hold, drill into one chain, read the total DeFi market and its leader, or search. The blockchain-level view of where DeFi capital lives. Live, no key. Distinct from protocol-level TVL, fees, DEX-volume and yield APIs — here the entity is the chain, not the protocol.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/chaintvl-api","description":"oanor gateway"}],"tags":[{"name":"Chains"},{"name":"Meta"}],"components":{"securitySchemes":{"oanorKey":{"type":"apiKey","in":"header","name":"x-oanor-key","description":"Get your key at https://www.oanor.com/developer/keys"}}},"security":[{"oanorKey":[]}],"paths":{"/v1/chain":{"get":{"operationId":"get_v1_chain","tags":["Chains"],"summary":"One chain TVL + change","description":"","parameters":[{"name":"name","in":"query","required":true,"description":"Chain name","schema":{"type":"string"},"example":"Ethereum"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"chain":{"name":"Ethereum","rank":1,"tvl_usd":37525912986,"chain_id":1,"gecko_id":"ethereum","token_symbol":"ETH","change_7d_pct":-10.09,"dominance_pct":52,"change_30d_pct":-17.64}},"meta":{"timestamp":"2026-06-09T03:03:07.223Z","request_id":"ac62a327-6510-494e-8091-bf6b86da830f"},"status":"ok","message":"Chain retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/search":{"get":{"operationId":"get_v1_search","tags":["Chains"],"summary":"Search chains","description":"","parameters":[{"name":"q","in":"query","required":true,"description":"Search term","schema":{"type":"string"},"example":"arbi"},{"name":"limit","in":"query","required":false,"description":"Max 1-100","schema":{"type":"string"},"example":"25"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":2,"query":"arbi","total":2,"chains":[{"name":"Arbitrum","rank":9,"tvl_usd":1260234521,"chain_id":42161,"gecko_id":"arbitrum","token_symbol":"ARB","dominance_pct":1.75},{"name":"Arbitrum Nova","rank":194,"tvl_usd":340157,"chain_id":42170,"dominance_pct":0}]},"meta":{"timestamp":"2026-06-09T03:03:07.348Z","request_id":"4a059ac5-2f59-4031-9fff-6e32e029ff23"},"status":"ok","message":"Search results retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/top":{"get":{"operationId":"get_v1_top","tags":["Chains"],"summary":"Chains ranked by DeFi TVL","description":"","parameters":[{"name":"limit","in":"query","required":false,"description":"Max 1-300","schema":{"type":"string"},"example":"25"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":25,"chains":[{"name":"Ethereum","rank":1,"tvl_usd":37525912986,"chain_id":1,"gecko_id":"ethereum","token_symbol":"ETH","dominance_pct":52},{"name":"BSC","rank":2,"tvl_usd":5172717234,"chain_id":56,"gecko_id":"binancecoin","token_symbol":"BNB","dominance_pct":7.17},{"name":"Solana","rank":3,"tvl_usd":4899513420,"gecko_id":"solana","token_symbol":"SOL","dominance_pct":6.79},{"name":"Tron","rank":4,"tvl_usd":4504779204,"gecko_id":"tron","token_symbol":"TRON","dominance_pct":6.24},{"name":"Bitcoin","rank":5,"tvl_usd":4128402238,"gecko_id":"bitcoin","token_symbol":"BTC","dominance_pct":5.72},{"name":"Base","rank":6,"tvl_usd":3943897828,"chain_id":8453,"dominance_pct":5.46},{"name":"Provenance","rank":7,"tvl_usd":1598412643,"gecko_id":"hash-2","token_symbol":"HASH","dominance_pct":2.21},{"name":"Hyperliquid L1","rank":8,"tvl_usd":1565147733,"gecko_id":"hyperliquid","token_symbol":"HYPE","dominance_pct":2.17},{"name":"Arbitrum","rank":9,"tvl_usd":1260234521,"chain_id":42161,"gecko_id":"arbitrum","token_symbol":"ARB","dominance_pct":1.75},{"name":"Polygon","rank":10,"tvl_usd":1048795984,"chain_id":137,"gecko_id":"polygon-ecosystem-token","token_symbol":"POL","dominance_pct":1.45},{"name":"Plasma","rank":11,"tvl_usd":774675119,"chain_id":9745,"gecko_id":"plasma","token_symbol":"XPL","dominance_pct":1.07},{"name":"Avalanche","rank":12,"tvl_usd":472974317,"chain_id":43114,"gecko_id":"avalanche-2","token_symbol":"AVAX","dominance_pct":0.66},{"name":"Sui","rank":13,"tvl_usd":433418245,"gecko_id":"sui","token_symbol":"SUI","dominance_pct":0.6},{"name":"Monad","rank":14,"tvl_usd":358417330,"chain_id":143,"gecko_id":"monad","token_symbol":"MON","dominance_pct":0.5},{"name":"ENI","rank":15,"tvl_usd":299777578,"chain_id":173,"token_symbol":"ENI","dominance_pct":0.42},{"name":"OP Mainnet","rank":16,"tvl_usd":297971103,"chain_id":10,"gecko_id":"optimism","token_symbol":"OP","dominance_pct":0.41},{"name":"Cronos","rank":17,"tvl_usd":270992460,"chain_id":25,"gecko_id":"crypto-com-chain","token_symbol":"CRO","dominance_pct":0.38},{"name":"Stellar","rank":18,"tvl_usd":204136907,"gecko_id":"stellar","token_symbol":"XLM","dominance_pct":0.28},{"name":"Ink","rank":19,"tvl_usd":201123530,"chain_id":57073,"dominance_pct":0.28},{"name":"Aptos","rank":20,"tvl_usd":190730769,"gecko_id":"aptos","token_symbol":"APT","dominance_pct":0.26},{"name":"Starknet","rank":21,"tvl_usd":186233994,"gecko_id":"starknet","token_symbol":"STRK","dominance_pct":0.26},{"name":"Mantle","rank":22,"tvl_usd":157020781,"chain_id":5000,"gecko_id":"mantle","token_symbol":"MNT","dominance_pct":0.22},{"name":"Near","rank":23,"tvl_usd":153860027,"gecko_id":"near","token_symbol":"NEAR","dominance_pct":0.21},{"name":"Movement","rank":24,"tvl_usd":127229802,"chain_id":3073,"gecko_id":"movement","token_symbol":"MOVE","dominance_pct":0.18},{"name":"Flare","rank":25,"tvl_usd":124423609,"gecko_id":"flare-networks","token_symbol":"FLR","dominance_pct":0.17}],"total_chains":451,"total_defi_tvl_usd":72170722892},"meta":{"timestamp":"2026-06-09T03:03:07.451Z","request_id":"d6114451-8f70-476b-b03f-571ba0311976"},"status":"ok","message":"Top chains retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/total":{"get":{"operationId":"get_v1_total","tags":["Chains"],"summary":"Total DeFi TVL and leader","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"top_chain":"Ethereum","chains_tracked":451,"total_defi_tvl_usd":72170722892,"top_chain_dominance_pct":52},"meta":{"timestamp":"2026-06-09T03:03:07.575Z","request_id":"d49ef1d8-c0f4-4088-b612-646a9e81488b"},"status":"ok","message":"Total TVL retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/meta":{"get":{"operationId":"get_v1_meta","tags":["Meta"],"summary":"Service metadata","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"source":"DefiLlama chains (live)","service":"chaintvl-api","endpoints":{"GET /v1/top":"Chains ranked by DeFi TVL with dominance (limit).","GET /v1/meta":"This document.","GET /v1/chain":"One chain's TVL, rank, dominance and 7d/30d change (name=Ethereum).","GET /v1/total":"Total DeFi TVL across all chains and the leader.","GET /v1/search":"Search chains by name or token (q=)."},"description":"Live DeFi total-value-locked per blockchain from DefiLlama (v2/chains): each chain's TVL, native token symbol, and share of all DeFi value, plus 7d/30d change per chain. Rank chains by capital held, drill into one, read the market total, or search. Live, no key. Distinct from protocol-level TVL, fees, DEX-volume and yield APIs — the entity is the chain.","chains_tracked":451,"total_defi_tvl_usd":72170722892},"meta":{"timestamp":"2026-06-09T03:03:07.689Z","request_id":"bf0aa168-23ca-4598-8351-1bc0654cf477"},"status":"ok","message":"Meta","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}}},"x-oanor-pricing":[{"slug":"free","name":"Free","price_cents_month":0,"monthly_call_quota":240,"rps_limit":3,"hard_limit":true},{"slug":"analyst","name":"Analyst","price_cents_month":1300,"monthly_call_quota":8400,"rps_limit":10,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":3500,"monthly_call_quota":43000,"rps_limit":25,"hard_limit":true},{"slug":"fund","name":"Fund","price_cents_month":8200,"monthly_call_quota":215000,"rps_limit":45,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/chaintvl-api"}