---
title: "DefiLlama: Current total value locked (USD) for a single protocol."
method: GET
path: "/api/v1/x/defillama/tvl"
tags: ["Crypto API (aggregator)"]
---

# DefiLlama: Current total value locked (USD) for a single protocol.

`GET /api/v1/x/defillama/tvl`

## Request

- Base URL: `https://three.ws`
- URL: `https://three.ws/api/v1/x/defillama/tvl`
- Auth: none required

Current total value locked (USD) for a single protocol. Billing lanes, in order: free tier (30/min, 2000/day per IP, no credentials) → x402 pay-per-call ($0.001 USDC via HTTP 402, no credentials) — or send your own upstream key via BYOK, or authenticate with a three.ws API key / OAuth session / browser session for the plan lane.

## Query parameters

- `protocol` string, required

## Response `200`

Normalized upstream response, wrapped as { data, _meta }

## Other responses

- `400`: Missing or invalid parameter
- `402`: Payment Required (x402) — no credentials and free quota (if any) exhausted
- `404`: Unknown provider/endpoint pair
- `429`: Rate limited

---

[API](https://skmtc.dev/three/apis/three-ws-api.md) · [All operations](https://skmtc.dev/three/apis/three-ws-api/llms.txt) · [OpenAPI document](https://skmtc.dev/three/apis/three-ws-api/revisions/dbc5e3a81b79?raw)