# three.ws DeFi Market Data — Protocol TVL & Stats

> three.ws DeFi Market Data — Protocol TVL & Stats is a paid API for AI agents from three.ws, paid per call via x402, $0.001/call, status unknown (last checked 2026-10-23).

Returns real-time DeFi protocol market data including total value locked (TVL), category, chain count, and 7-day change for thousands of protocols.

## Facts

- Endpoint: GET https://three.ws/api/x402/market-defi?utm_source=zero.xyz
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-23
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/three-ws-defi-market-data-protocol-tvl-stats-368fe769
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_60tibAxBIB4xsM-bHvbcU

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 three-ws-defi-market-data-protocol-tvl-stats-368fe769
```

Example prompt: Can you pull the latest DeFi market data and tell me which protocols have the highest TVL right now, including their 7-day change and how many chains they're on?

## When to prefer this

Choose this endpoint when you need aggregated DeFi protocol TVL data with category and multi-chain breakdowns in a single call. It is particularly useful for agents needing on-demand DeFi market snapshots without managing a direct DeFiLlama integration, and it supports x402 micropayment access at $0.001 USDC per call — ideal for pay-per-use agent workflows where subscribing to a data provider is impractical.

## Known failure modes

- Upstream data source unavailable returns empty or error response
- Payment of 0.001 USDC not received results in 402 Payment Required
- Invalid properties filter parameter may return unfiltered or empty results
- Rate limiting if called too frequently without payment
- Stale data if underlying DeFiLlama feed is delayed

## How this service works

Make a 3D AI agent from a selfie in 60 seconds. Drop one HTML tag to embed it on any website. Agents think on IBM watsonx.ai (Granite); optionally charge per chat with built-in micropayments.

## Output

A JSON object containing an array of DeFi protocol objects (each with name, slug, TVL, 7-day TVL change, category, and chain count), along with aggregate stats: total TVL across all protocols and total protocol count.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "properties": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "protocols": [
   {
    "tvl": 28100000000,
    "name": "AAVE V3",
    "slug": "aave-v3",
    "category": "Lending",
    "change_7d": 3.4,
    "chain_count": 14
   }
  ],
  "total_tvl": 208000000000,
  "protocol_count": 4213
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/three-ws-defi-market-data-protocol-tvl-stats-368fe769/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from three.ws](https://www.zero.xyz/host/three.ws/llms.txt)