# DeFiLlama Protocols Lookup

> DeFiLlama Protocols Lookup is a paid API for AI agents from x402-v2-mint-defillama-protocols.vercel.app, paid per call via x402, $0.020165/call, status unknown (last checked 2026-11-18).

Fetches and filters DeFiLlama protocol data by name, slug, category, or limit via a paid x402 API

## Facts

- Endpoint: POST https://x402-v2-mint-defillama-protocols.vercel.app/v1/defillama-protocols?utm_source=zero.xyz
- Price: $0.020165/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-18
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/defillama-protocols-lookup-74fc0718
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_dwbjYaMNJiUU02eTOfMEM

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 defillama-protocols-lookup-74fc0718 -d '<json body>'
```

Example prompt: Can you pull up to 10 DeFi protocols from DeFiLlama in the 'Lending' category and show me their details?

## When to prefer this

Use this endpoint when you need structured DeFiLlama protocol data programmatically and are willing to pay per call via x402 micropayments. Prefer this over scraping DeFiLlama directly when you need reliable, API-structured responses with filtering by name, slug, or category in an agent workflow.

## Known failure modes

- Payment not processed — charged field returns false, no data returned
- Invalid category string returns empty or error response
- Limit exceeds maximum of 50 — request rejected with validation error
- Unknown slug or name returns empty result set
- Request timeout if DeFiLlama upstream is unavailable

## How this service works

DefiLlama protocols TVL list (keyless). POST {} or {name?, slug?, limit?, category?}. Unpaid empty → 402; after settle empty/invalid → 400 charged:false. DeFi TVL lane (≠ mempool/btc-fee / coinpaprika ticker).

## Output

Returns a JSON object with ok status, the skill name ('defillama-protocols'), a charged flag indicating payment was processed, and a summary field, along with protocol data matching the requested filters (name, slug, category, limit).

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "name": {
   "type": "string",
   "maxLength": 128
  },
  "slug": {
   "type": "string",
   "maxLength": 128
  },
  "limit": {
   "type": "integer",
   "maximum": 50,
   "minimum": 1
  },
  "category": {
   "type": "string",
   "maxLength": 64
  },
  "request_id": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "ok": true,
  "skill": "defillama-protocols",
  "charged": true,
  "summary": "ok"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/defillama-protocols-lookup-74fc0718/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402-v2-mint-defillama-protocols.vercel.app](https://www.zero.xyz/host/x402-v2-mint-defillama-protocols.vercel.app/llms.txt)
