# 🦙 DeFi TVL & Protocol Tracker — by Category & Chain (`nexgendata/defi-tvl-protocol-tracker`) Actor Track DeFi Total Value Locked (TVL) across protocols by category and chain, with 1d/7d TVL changes and market cap. For crypto funds, analysts, and dashboard builders. - **URL**: https://apify.com/nexgendata/defi-tvl-protocol-tracker.md - **Developed by:** [NexGenData](https://apify.com/nexgendata) (community) - **Categories:** Business - **Stats:** 3 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $20.00 / 1,000 13f holdings This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## 🦙 DeFi TVL & Protocol Tracker — by Category & Chain **Pay-per-result DeFi Total Value Locked (TVL) data — every tracked protocol with TVL, 1d/7d change, market cap, category, and chain, as structured JSON. $0.10 per record. No Nansen subscription, no Messari Enterprise seat, no DefiLlama Pro contract.** Total Value Locked is the headline health metric of decentralized finance: how much capital is actually deposited in a protocol's smart contracts right now, and which direction it is moving. It is the number crypto funds size positions against, the number analysts put in every market report, and the number dashboard builders surface to users. This actor reads the DefiLlama protocol universe and returns each protocol as a discrete JSON record carrying its name, category, chain, current TVL, 1-day and 7-day TVL change, market cap, and a direct link to its DefiLlama page. Filter by category, chain, name, and minimum TVL, sort by whichever momentum metric matters, and feed the result straight into a fund dashboard, a screening pipeline, or a research model. ### Why use this The TVL data is public — DefiLlama is the open standard for DeFi metrics — but turning it into a filterable, repeatable, schema-stable feed is work you would otherwise own. You would build a client against the API, normalize categories and chains, compute or extract the change metrics, page through thousands of protocols, and keep it all running as the source evolves. And if you want a managed, enriched version of this data with no maintenance burden, the commercial alternatives — Nansen, Messari Enterprise, DefiLlama Pro — are priced for funds, not for a single dashboard or a research script. This actor is the managed feed without the enterprise price tag. You pass filters and a sort; you get back ranked protocol records. Pay-per-result means a tightly filtered query that returns ten protocols costs you for ten records — no subscription, no seat, no minimum. Sort by `change_1d` or `change_7d` to surface momentum, set `minTvl` to drop dust protocols, and constrain to a single `chain` or `category` to answer a specific question cheaply. ### What you get Each record is one protocol, structured JSON populated from the DefiLlama universe: - `name` — the protocol name (Aave, Lido, Uniswap, etc.) - `category` — the protocol category (Lending, Dexes, Liquid Staking, CEX, Yield, etc.) - `chain` — the chain (or primary chain) the protocol is deployed on - `tvl` — current Total Value Locked, in USD - `change_1d` — 1-day change in TVL (percent) - `change_7d` — 7-day change in TVL (percent) - `mcap` — protocol token market capitalization, in USD (where available) - `defillamaUrl` — direct deep link to the protocol's DefiLlama page for verification The schema is additive-only and stable, so records load straight into a dashboard, a warehouse (Snowflake, BigQuery, Postgres), or a screening notebook without re-mapping on each refresh. ### Use cases - **Fund TVL screening and sizing** — Set `category=Lending`, `chain=Ethereum`, `minTvl=100000000`, sort by `tvl` descending to get every major Ethereum lending protocol ranked by capital, the canonical input to a sector-allocation decision. - **Momentum and flow detection** — Sort by `change_7d` descending to surface the protocols pulling capital fastest this week, or ascending to flag outflows and potential stress — a leading signal for both opportunity and risk desks. - **Category and chain rotation analysis** — Pull every protocol in a category across chains, or every protocol on an emerging chain (Base, Solana), to quantify where TVL is rotating and which ecosystems are gaining share. - **Dashboard and product backends** — Power a retail-facing DeFi explorer or an internal monitoring board with a scheduled pull, without standing up and maintaining your own DefiLlama client. - **Risk monitoring on concentration** — Track the `tvl` and `change_1d` of the protocols your fund or treasury is exposed to and alert on sharp single-day drops that may signal an exploit, a depeg, or a bank-run dynamic. - **Research and reporting** — Generate the ranked TVL tables that anchor a weekly DeFi market report, filtered to the categories and chains your audience cares about. - **Comparative protocol due diligence** — Pull a peer set within a category, line up `tvl`, `mcap`, and the change metrics, and compute mcap/TVL ratios for relative-value work. ### Sample output ```json { "name": "Aave", "category": "Lending", "chain": "Ethereum", "tvl": 18342000000, "change_1d": -1.42, "change_7d": 4.87, "mcap": 4120000000, "defillamaUrl": "https://defillama.com/protocol/aave" } ```` ### Input parameters | Parameter | Label | Description | |---|---|---| | `category` | Category | Filter by protocol category (e.g. `Lending`, `Dexes`, `Liquid Staking`, `CEX`, `Yield`). | | `chain` | Chain | Only protocols deployed on this chain (e.g. `Ethereum`, `Solana`, `Base`). | | `nameContains` | Name contains | Filter by protocol name substring. | | `minTvl` | Min TVL (USD) | Only protocols with TVL at least this much. | | `sortBy` | Sort by | `tvl`, `change_1d`, `change_7d`, `change_1h`, or `mcap`. | | `descending` | Descending | Sort high to low. | | `maxResults` | Max results | Maximum number of protocols to return. | ### How to use #### Python (apify-client) ```python from apify_client import ApifyClient client = ApifyClient("YOUR_TOKEN") run = client.actor("nexgendata/defi-tvl-protocol-tracker").call(run_input={ "category": "Lending", "chain": "Ethereum", "minTvl": 100000000, "sortBy": "tvl", "descending": True, "maxResults": 50, }) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item["name"], item["tvl"], item["change_7d"], item["mcap"]) ``` #### cURL ```bash curl -X POST "https://api.apify.com/v2/acts/nexgendata~defi-tvl-protocol-tracker/run-sync-get-dataset-items?token=YOUR_TOKEN" \ -H "Content-Type: application/json" \ -d '{ "category": "Lending", "chain": "Ethereum", "minTvl": 100000000, "sortBy": "tvl", "descending": true, "maxResults": 50 }' ``` Results stream into the Apify dataset, exportable as JSON, JSONL, CSV, or Excel. Schedule via Apify's built-in scheduler — an hourly or daily pull keeps a dashboard or a flow-monitor current — and wire a webhook to fire a Slack / Zapier / Make alert on sharp TVL moves. ### Pricing This actor runs on Apify's **pay-per-event (PPE)** model — you pay for results, not run-time: - **$0.10 per protocol record** — the primary event, charged once per protocol pushed to the dataset - **Actor start** — a negligible one-time per-run event No subscriptions, no seat licences, no minimums. #### Cost worked example - Top 50 lending protocols on Ethereum → ~$5 - A 200-protocol cross-category screen → ~$20 - A daily top-25 momentum watch → ~$2.50/day A filter that matches nothing costs nothing beyond the actor-start event. Apify's free tier covers most experiments. Browse 200+ buyer-intent actors at https://apify.com/nexgendata?fpr=2ayu9b ### How this compares to Nansen and Messari | Source | Cost | What you get | |---|---|---| | Nansen | ~$100-$1,800+/month per plan | On-chain analytics, wallet labels, and dashboards; TVL is one feature inside a broad suite | | Messari Enterprise | Custom, typically $10K+/year | Research, screeners, and an API behind an enterprise contract | | DefiLlama Pro | Subscription (per-key API tiers) | Managed DefiLlama API access; you still build the client and pipeline | | DefiLlama (free, DIY) | Free | Raw API; you own the client, normalization, change-metric extraction, and maintenance | | **DeFi TVL & Protocol Tracker (this actor)** | **$0.10/protocol, no subscription** | **Filtered, sorted, structured JSON — name, category, chain, TVL, 1d/7d change, mcap, source URL** | If you need wallet-level on-chain analytics, smart-money labels, and a full research workspace, Nansen and Messari earn their price. But if your workflow is TVL screening, momentum/flow detection, or powering a dashboard — and you want ranked protocol records as JSON for cents apiece — this actor is the right cost model. ### FAQ **Q: Where does the data come from?** A: DefiLlama, the open standard for DeFi TVL metrics. Each record carries a `defillamaUrl` linking to the protocol's DefiLlama page for verification. **Q: How current is the TVL?** A: Each run pulls the current values from the source. For live-monitoring use cases, schedule the actor hourly; for research and reporting, a daily run is typically sufficient. **Q: What does the `chain` field mean for multi-chain protocols?** A: It reflects the chain (or primary chain) the protocol is associated with in the source. Use the `chain` filter to scope to a single ecosystem when comparing chain-level TVL. **Q: Is `mcap` always populated?** A: Where the source provides a token market cap it is included; protocols without a liquid governance token, or where the source lacks the figure, return null for `mcap`. **Q: Can I sort by a metric and also cap results?** A: Yes — set `sortBy` and `descending`, then `maxResults` to keep only the top-N. This is the cheap way to get, say, the 25 fastest-growing protocols this week. ### Schema stability & versioning This actor follows NexGenData's **additive-only schema** contract. New fields may be added as new keys, defaulting to null for older runs. Existing fields are never renamed or removed without a major-version bump and advance changelog notice. Field semantics — units (USD), change-percent conventions — are never silently changed; a required change adds a new field and keeps the old for at least 90 days. Build a production dashboard or screen on this output without a change breaking your pipeline. ### Compliance & legal - The actor reads **public** DeFi metrics published by DefiLlama. No authentication, no paywalled content, no credentials are involved. - Requests are paced politely against the source. - TVL and market-cap figures are informational market data, not investment advice. Verify any figure against the source `defillamaUrl` before relying on it for a trade. - You are responsible for ensuring downstream use complies with the source's terms and your jurisdiction's laws. ### Related NexGenData actors Part of NexGenData's **Crypto & Markets intelligence** cluster — pair this actor with: - [Stablecoin Supply & Peg Monitor](https://apify.com/nexgendata/stablecoin-supply-peg-monitor?fpr=2ayu9b) — stablecoin supply and peg-deviation tracking - [Crypto Perp Funding Rates Tracker](https://apify.com/nexgendata/crypto-perp-funding-rates-tracker?fpr=2ayu9b) — perpetual-swap funding rates across venues - [Crypto Top-100 Screener](https://apify.com/nexgendata/crypto-top100-screener?fpr=2ayu9b) — the top-100 coin universe by market cap - [Polymarket Prediction Markets Tracker](https://apify.com/nexgendata/polymarket-prediction-markets-tracker?fpr=2ayu9b) — on-chain prediction-market prices - [Kalshi Prediction Markets Tracker](https://apify.com/nexgendata/kalshi-prediction-markets-tracker?fpr=2ayu9b) — regulated event-contract prices - [Crypto DeFi MCP](https://apify.com/nexgendata/crypto-defi-mcp?fpr=2ayu9b) — model-context-protocol bridge to pull DeFi data from Claude, GPT, and Cursor Browse the full 200+ actor catalog at **https://apify.com/nexgendata?fpr=2ayu9b**. # Actor input Schema ## `category` (type: `string`): Filter by protocol category (e.g. 'Lending', 'Dexes', 'Liquid Staking', 'CEX', 'Yield'). ## `chain` (type: `string`): Only protocols deployed on this chain (e.g. 'Ethereum', 'Solana', 'Base'). ## `nameContains` (type: `string`): Filter by protocol name. ## `minTvl` (type: `integer`): Only protocols with TVL at least this much. ## `sortBy` (type: `string`): tvl, change\_1d, change\_7d, change\_1h, or mcap. ## `descending` (type: `boolean`): Sort high to low. ## `maxResults` (type: `integer`): Max protocols to return. ## Actor input object example ```json { "sortBy": "tvl", "descending": true, "maxResults": 1000 } ``` # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = {}; // Run the Actor and wait for it to finish const run = await client.actor("nexgendata/defi-tvl-protocol-tracker").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = {} # Run the Actor and wait for it to finish run = client.actor("nexgendata/defi-tvl-protocol-tracker").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{}' | apify call nexgendata/defi-tvl-protocol-tracker --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=nexgendata/defi-tvl-protocol-tracker", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "🦙 DeFi TVL & Protocol Tracker — by Category & Chain", "description": "Track DeFi Total Value Locked (TVL) across protocols by category and chain, with 1d/7d TVL changes and market cap. For crypto funds, analysts, and dashboard builders.", "version": "0.0", "x-build-id": "KswGYHLeLyKO4VCv6" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/nexgendata~defi-tvl-protocol-tracker/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-nexgendata-defi-tvl-protocol-tracker", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/nexgendata~defi-tvl-protocol-tracker/runs": { "post": { "operationId": "runs-sync-nexgendata-defi-tvl-protocol-tracker", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/nexgendata~defi-tvl-protocol-tracker/run-sync": { "post": { "operationId": "run-sync-nexgendata-defi-tvl-protocol-tracker", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "category": { "title": "Category", "type": "string", "description": "Filter by protocol category (e.g. 'Lending', 'Dexes', 'Liquid Staking', 'CEX', 'Yield')." }, "chain": { "title": "Chain", "type": "string", "description": "Only protocols deployed on this chain (e.g. 'Ethereum', 'Solana', 'Base')." }, "nameContains": { "title": "Name contains", "type": "string", "description": "Filter by protocol name." }, "minTvl": { "title": "Min TVL (USD)", "type": "integer", "description": "Only protocols with TVL at least this much." }, "sortBy": { "title": "Sort by", "enum": [ "tvl", "change_1d", "change_7d", "change_1h", "mcap" ], "type": "string", "description": "tvl, change_1d, change_7d, change_1h, or mcap.", "default": "tvl" }, "descending": { "title": "Descending", "type": "boolean", "description": "Sort high to low.", "default": true }, "maxResults": { "title": "Max results", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Max protocols to return.", "default": 1000 } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```