# three.ws DeFi Radar

> three.ws DeFi Radar is a paid API for AI agents from three.ws, paid per call via x402, $0.005/call, status unknown (last checked 2026-10-11).

Returns real-time DeFi leaderboards covering TVL rankings, gainers/losers, DEX trading volume, and protocol fee data across major chains

## Facts

- Endpoint: GET https://three.ws/api/x402/defi-radar?utm_source=zero.xyz
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-11
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/three-ws-defi-radar-f8d6530a
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_5aLGlhtwRKNLVdhSm3IG3

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-radar-f8d6530a
```

Example prompt: Give me a DeFi market snapshot — show me the top 10 protocols by TVL with their daily changes, biggest gainers and losers, top DEX volumes, and which protocols earned the most fees in the last 24 hours.

## When to prefer this

Choose this endpoint when you need a broad, multi-metric DeFi market snapshot in a single call — covering TVL, gainers/losers, DEX volume, and fees simultaneously — rather than querying multiple specialized APIs. Ideal for daily briefings, market monitoring, or surfacing top movers without needing to aggregate data from DeFiLlama or similar sources manually. The $0.005 USDC micropayment makes it practical for frequent polling by AI agents.

## Known failure modes

- limit parameter out of range (must be 1–25, default 10) returns validation error
- Payment of $0.005 USDC not provided or x402 payment flow fails — returns 402 Payment Required
- Upstream DeFi data source temporarily unavailable — may return stale or partial data
- GET-only endpoint; POST/PUT requests return method not allowed

## 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 snapshot containing: a timestamp, TVL leaderboard (top protocols with TVL in USD, daily/weekly % change, chain list, category), TVL gainers and losers (top movers with 1d change %), DEX volume leaderboard (top protocols with 24h and daily change), protocol fee rankings (top earners with 24h and 7d USD totals), and aggregate totals for TVL, DEX volume, and fees across all tracked protocols.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "$schema": "https://json-schema.org/draft/2020-12/schema",
     "properties": {
      "limit": {
       "type": "integer",
       "default": 10,
       "maximum": 25,
       "minimum": 1,
       "description": "Rows per leaderboard (TVL top, gainers, losers, fees, DEX volume)."
      }
     }
    }
   },
   "additionalProperties": false
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "ts": "2026-07-11T10:00:00Z",
  "dex": {
   "top": [
    {
     "name": "Example Protocol",
     "change_1d": 4.1,
     "total_24h_usd": 1200000000
    }
   ],
   "total_24h_usd": 3900000000
  },
  "tvl": {
   "top": [
    {
     "name": "Example Protocol",
     "chains": [
      "Ethereum"
     ],
     "tvl_usd": 21500000000,
     "category": "Liquid Staking",
     "change_1d": 0.8,
     "change_7d": 3.2
    }
   ],
   "losers": [
    {
     "name": "Example Protocol",
     "tvl_usd": 98000000,
     "change_1d": -11.2
    }
   ],
   "gainers": [
    {
     "name": "Example Protocol",
     "tvl_usd": 312000000,
     "change_1d": 14.6
    }
   ],
   "total_usd": 118400000000
  },
  "fees": {
   "top": [
    {
     "name": "Example Protocol",
     "category": "DEX",
     "total_7d_usd": 40200000,
     "total_24h_usd": 6100000
    }
   ],
   "total_24h_usd": 41200000
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/three-ws-defi-radar-f8d6530a/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)