# TokenGuard TVL Endpoint

> TokenGuard TVL Endpoint is a paid API for AI agents from eltociear-tokenguard.hf.space, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-15).

Fetches Total Value Locked (TVL) data for DeFi protocols, filterable by blockchain and category, sourced from DefiLlama

## Facts

- Endpoint: POST https://eltociear-tokenguard.hf.space/tvl
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/tokenguard-tvl-endpoint-42d91db3
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_gtYmsysyb1o4yO6F71eek

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 tokenguard-tvl-endpoint-42d91db3 -d '<json body>'
```

Example prompt: Show me the top lending protocols by TVL on Ethereum right now — I want to see their names, TVL in USD, and how much they've changed in the last day and week.

## When to prefer this

Use this endpoint when you need ranked TVL data for DeFi protocols filtered by chain or category, especially when you want DefiLlama-sourced data with recent percentage changes. Prefer this over generic crypto price APIs when the question is about protocol-level liquidity or DeFi ecosystem size.

## Known failure modes

- Invalid or unsupported chain name returns empty or error response
- Invalid category string returns zero results
- Payment failure via x402 results in 402 response blocking the call
- DefiLlama upstream data unavailable causes timeout or stale data
- Malformed JSON body returns 400 bad request

## How this service works

Protocol TVL ranking + 1d/7d momentum, filterable by category/chain (DeFi analytics).

## Output

Returns a ranked list of DeFi protocols with their TVL in USD, supported chains, category classification, and 1-day and 7-day percentage change in TVL, along with a total count of matching protocols and the data source (DefiLlama).

## Example request

```json
{
 "input": {
  "body": {
   "chain": "ethereum",
   "category": "Lending"
  },
  "type": "http",
  "method": "POST",
  "bodyType": "json"
 }
}
```

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "chain": {
   "type": "string",
   "description": "Chain filter (optional)"
  },
  "category": {
   "type": "string",
   "description": "Category filter e.g. Lending/DEX (optional)"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "count": 20,
  "protocols": [
   {
    "name": "Aave",
    "tvl_usd": 15000000000,
    "category": "Lending",
    "change_1d_pct": 1.2
   }
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/tokenguard-tvl-endpoint-42d91db3/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from eltociear-tokenguard.hf.space](https://www.zero.xyz/host/eltociear-tokenguard.hf.space/llms.txt)