# BRAINIAC DeFi Intelligence — Chain TVL Lookup

> BRAINIAC DeFi Intelligence — Chain TVL Lookup is a paid API for AI agents from www.brainiac.software, paid per call via x402, $0.03/call, status unknown (last checked 2026-11-17).

Returns the Total Value Locked (TVL) for a specified blockchain chain in the DeFi ecosystem

## Facts

- Endpoint: POST https://www.brainiac.software/api/v1/defi-intelligence/chains/tvl?utm_source=zero.xyz
- Price: $0.03/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-17
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/brainiac-defi-intelligence-chain-tvl-lookup-a8b44118
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_nc17qVyjt4Pcb_QaFZB0D

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability brainiac-defi-intelligence-chain-tvl-lookup-a8b44118 -d '<json body>'
```

Example prompt: What's the current total value locked in DeFi on the Ethereum chain? Pay for the lookup using USDC on Base.

## When to prefer this

Use this endpoint when you need on-demand, pay-per-call TVL data for a specific blockchain chain without committing to a subscription or creating an account. Ideal for AI agents that only occasionally need DeFi chain metrics and want to pay micro-amounts per query using USDC on Base via x402. Prefer this over subscription DeFi APIs when usage is sporadic or cost-per-call economics are favorable.

## Known failure modes

- Unknown or unsupported chain name returns an error or empty result
- Payment of 0.03 USDC on Base via x402 not received results in 402 Payment Required response
- Malformed or missing 'chain' field in request body results in validation error
- Chain name string too long (exceeds 100 chars) or empty (less than 1 char) triggers schema validation failure
- Network or upstream data provider outage may return 5xx error

## How this service works

Retrieve Total Value Locked (TVL) across blockchains from DeFiLlama public API v2. TVL is a delayed reference value.

## Output

A JSON response containing the Total Value Locked (TVL) figure for the requested blockchain chain, likely including numeric TVL value and possibly currency denomination or timestamp context.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "chain": {
   "type": "string",
   "maxLength": 100,
   "minLength": 1
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "chains": [
   {
    "tvl": 43501437476.51646,
    "name": "Ethereum",
    "cmcId": "1027",
    "chainId": 1,
    "gecko_id": "ethereum",
    "tokenSymbol": "ETH",
    "defiLlamaUrl": "https://api.llama.fi/v2/chains"
   }
  ],
  "source": {
   "url": "https://api.llama.fi/v2/chains?chain=Ethereum",
   "status": "OK",
   "retrievedAt": "2026-11-07T12:08:58.034Z"
  },
  "limitations": [
   "Chain TVL data is retrieved from the DeFiLlama public API v2.",
   "TVL values are in USD.",
   "TVL is a delayed reference value, not a real-time market value.",
   "Source: https://defillama.com"
  ],
  "retrievedAt": "2026-11-07T12:08:58.034Z"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/brainiac-defi-intelligence-chain-tvl-lookup-a8b44118/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from www.brainiac.software](https://www.zero.xyz/host/www.brainiac.software/llms.txt)
