# DeFi Yield Monitor — APY & TVL Alerts (DeFiLlama) MCP (`mokaman/defi-yield-mcp`) Actor DeFi yield pools from DeFiLlama with APY, TVL, and risk flags — as MCP tools for AI agents plus classic dataset runs with threshold alerts. - **URL**: https://apify.com/mokaman/defi-yield-mcp.md - **Developed by:** [Michael](https://apify.com/mokaman) (community) - **Categories:** AI, Developer tools - **Stats:** 1 total users, 0 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: 5.00 out of 5 stars ## Pricing from $4.00 / 1,000 pool-results This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage. 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/docs.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python/docs.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/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 Yield Monitor — APY & TVL Alerts (DeFiLlama) MCP ### What does DeFi Yield Monitor do? **DeFi Yield Monitor** tracks **yield farming APY and TVL across 15,000+ DeFi pools** on every major chain (Ethereum, Arbitrum, Base, Solana, and 100+ more), powered by the free [DeFiLlama](https://defillama.com) yields API. It works in two ways: 1. **As an MCP server for AI agents** — connect Claude, ChatGPT, or any MCP-compatible agent and let it search pools, pull APY history, spot top movers, and check yield alerts in real time. 2. **As a classic Apify Actor** — run it with filters and get a clean dataset of pools, or run it on a schedule with alert rules to get notified when yields cross your thresholds. > **Disclaimer:** This Actor is an unofficial tool and is **not affiliated with, endorsed by, or sponsored by DeFiLlama**. It uses DeFiLlama's public API as a data source. All output — including APY, TVL, risk flags, and the APY prediction (DeFiLlama's own model output) — is provided **for informational purposes only and is not financial, investment, or trading advice**, nor an offer or recommendation. DeFi carries significant risk of loss. Always do your own research before depositing funds. Every pool comes with **risk flags included**: impermanent-loss risk, stablecoin flag, single/multi-token exposure, and DeFiLlama's APY outlook prediction. No API keys, no browser, no proxies — pure API data with near-100% run reliability. ### Why use DeFi Yield Monitor? - **Find the best stablecoin yields** — e.g. "all stablecoin pools above 8% APY with at least $10M TVL" - **Give your AI agent DeFi data** — yield questions answered live inside Claude or any MCP client - **Get yield alerts on autopilot** — schedule runs and pipe alert matches to email, Slack, or webhooks via Apify integrations - **Spot opportunities early** — `top_movers` surfaces pools whose APY jumped (or collapsed) over 1d/7d/30d - **Filter out junk** — TVL thresholds and automatic outlier exclusion keep dust pools and fake APYs out of your results ### How to use DeFi Yield Monitor #### As an MCP server (AI agents) 1. Add the Actor's MCP endpoint to your agent (via [Apify's MCP infrastructure](https://mcp.apify.com) or the Actor's standby URL). 2. Your agent can now call these tools: | Tool | What it does | |------|--------------| | `search_pools` | Search pools by chain, project, symbol, min APY, min TVL, stablecoin-only; sorted by TVL or APY | | `pool_history` | Full APY/TVL time series for one pool | | `top_movers` | Biggest APY gainers or losers over 1d / 7d / 30d | | `check_alerts` | Evaluate alert rules against live data, returns all matching pools | #### As a classic Actor (dataset output) 1. Set your filters in the Input tab (chain, project, min APY, min TVL, stablecoin-only, sort, limit). 2. Click **Start** — matching pools land in the dataset. 3. Download as JSON, CSV, Excel, or HTML, or consume via API. #### Recurring yield alerts 1. Fill in **Alert rules** in the input, for example: ```json { "alertRules": [ { "label": "stablecoin-8pct", "minApy": 8, "minTvl": 10000000, "stablecoinOnly": true } ] } ```` 2. Create an [Apify Schedule](https://docs.apify.com/platform/schedules) (e.g. hourly). 3. Attach an email, Slack, or webhook integration to the Actor — every run pushes current matches to the dataset. ### Input All fields are optional. Without filters you get the top pools by TVL. | Field | Type | Description | |-------|------|-------------| | `chain` | string | Exact chain name, e.g. `Ethereum`, `Arbitrum` | | `project` | string | DeFiLlama project slug, e.g. `aave-v3`, `lido` | | `symbol` | string | Substring match, e.g. `USDC` | | `minApy` | number | Minimum APY in % | | `minTvl` | number | Minimum TVL in USD | | `stablecoinOnly` | boolean | Only stablecoin pools | | `sort` | string | `tvl` (default) or `apy` | | `limit` | number | Max results (default 100) | | `alertRules` | array | Switches to alert mode (see above) | ### Example presets Copy any block into the **Input** tab (JSON editor) and hit **Start**. Each one is a ready-made starting point — tweak the numbers to taste. **Safe stablecoin income** — low-volatility pools with solid TVL, highest APY first: ```json { "stablecoinOnly": true, "minApy": 6, "minTvl": 20000000, "sort": "apy", "limit": 50 } ``` **High-yield hunter** — chase the top APYs, dust pools filtered out (higher risk): ```json { "minApy": 20, "minTvl": 1000000, "sort": "apy", "limit": 100 } ``` **Blue-chip single protocol** — watch one project on one chain (e.g. Aave v3 on Ethereum): ```json { "chain": "Ethereum", "project": "aave-v3", "sort": "tvl", "limit": 50 } ``` **Recurring stablecoin alert** — alert mode: attach an [Apify Schedule](https://docs.apify.com/platform/schedules) plus an email/Slack integration and get pinged whenever a pool crosses your thresholds: ```json { "alertRules": [ { "label": "stablecoin-8pct", "minApy": 8, "minTvl": 10000000, "stablecoinOnly": true }, { "label": "eth-blue-chip-5pct", "chain": "Ethereum", "project": "aave-v3", "minApy": 5 } ] } ``` ### Output One record per pool: ```json { "poolId": "747c1d2a-c668-4682-b9f9-296708a3dd90", "chain": "Ethereum", "project": "lido", "symbol": "STETH", "tvlUsd": 17177564785, "apy": 2.15, "apyBase": 2.15, "apyReward": null, "apyPct1D": -0.07, "apyPct7D": -0.03, "apyPct30D": -0.24, "stablecoin": false, "ilRisk": "no", "exposure": "single", "prediction": "Stable/Up", "predictionProbability": 70, "url": "https://defillama.com/yields/pool/747c1d2a-c668-4682-b9f9-296708a3dd90" } ``` ### How much does it cost? Pay-per-event pricing — you only pay for what you use: | Event | Price | When | |-------|-------|------| | Actor start | $0.005 | Each classic (non-MCP) run | | MCP tool call | $0.01 | Each tool call from your agent | | Pool result | $0.004 | Each pool in a classic run's dataset | | Alert match | $0.01 | Each pool matching an alert rule in alert mode | Example: a daily stablecoin-yield digest of 20 pools costs about $2.55/month. An agent asking 100 yield questions costs $1.00. An hourly alert schedule averaging 2 matches per run costs about $18/month. ### Tips - Set `minTvl` to at least `1000000` — sub-$1M pools often show unsustainable APYs. - Use `sort: "apy"` with a `minTvl` floor to find the best *credible* yields. - Watch the `prediction` field: `Down` means DeFiLlama's model expects the APY to fall. - Keep alert rules tight (high `minApy` + high `minTvl`) so you only pay for matches you care about. ### FAQ & support **Where does the data come from?** The public DeFiLlama yields API — the same data as [defillama.com/yields](https://defillama.com/yields). **Is this financial advice?** No. APY and risk flags are raw data; always do your own research before depositing funds. **Found a bug or missing a feature?** Open an issue in the Issues tab. # Actor input Schema ## `chain` (type: `string`): Exact chain name, e.g. Ethereum, Arbitrum, Base, Solana. Leave empty for all chains. ## `project` (type: `string`): Exact project slug as used by DeFiLlama, e.g. aave-v3, lido, curve-dex. Leave empty for all projects. ## `symbol` (type: `string`): Substring match on the pool symbol, e.g. USDC matches USDC-USDT. ## `minApy` (type: `integer`): Only pools with APY at or above this percentage. ## `minTvl` (type: `integer`): Only pools with total value locked at or above this amount. Filters out risky dust pools. ## `stablecoinOnly` (type: `boolean`): Only pools where all assets are stablecoins (lower volatility risk). ## `sort` (type: `string`): Sort results by TVL (safest first) or APY (highest yield first). ## `limit` (type: `integer`): Maximum number of pools to return (1-1000). Each result is charged as one pool-result event. ## `alertRules` (type: `array`): When set, the Actor runs in alert mode: each rule is an object with optional keys label, chain, project, symbol, minApy, minTvl, stablecoinOnly. Every pool matching a rule is pushed to the dataset as one alert match. Combine with an Apify Schedule and email/Slack integration for recurring alerts. ## Actor input object example ```json { "chain": "Ethereum", "minApy": 5, "minTvl": 1000000, "stablecoinOnly": false, "sort": "apy", "limit": 100, "alertRules": [ { "label": "stablecoin-8pct", "minApy": 8, "minTvl": 10000000, "stablecoinOnly": true } ] } ``` # Actor output Schema ## `dataset` (type: `string`): No description ## `keyValueStore` (type: `string`): No description # 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 = { "chain": "Ethereum", "minApy": 5, "minTvl": 1000000, "sort": "apy", "alertRules": [ { "label": "stablecoin-8pct", "minApy": 8, "minTvl": 10000000, "stablecoinOnly": true } ] }; // Run the Actor and wait for it to finish const run = await client.actor("mokaman/defi-yield-mcp").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 = { "chain": "Ethereum", "minApy": 5, "minTvl": 1000000, "sort": "apy", "alertRules": [{ "label": "stablecoin-8pct", "minApy": 8, "minTvl": 10000000, "stablecoinOnly": True, }], } # Run the Actor and wait for it to finish run = client.actor("mokaman/defi-yield-mcp").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 '{ "chain": "Ethereum", "minApy": 5, "minTvl": 1000000, "sort": "apy", "alertRules": [ { "label": "stablecoin-8pct", "minApy": 8, "minTvl": 10000000, "stablecoinOnly": true } ] }' | apify call mokaman/defi-yield-mcp --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=mokaman/defi-yield-mcp", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "DeFi Yield Monitor — APY & TVL Alerts (DeFiLlama) MCP", "description": "DeFi yield pools from DeFiLlama with APY, TVL, and risk flags — as MCP tools for AI agents plus classic dataset runs with threshold alerts.", "version": "1.0", "x-build-id": "n3ban6NTBNol5bp2H" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/mokaman~defi-yield-mcp/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-mokaman-defi-yield-mcp", "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/mokaman~defi-yield-mcp/runs": { "post": { "operationId": "runs-sync-mokaman-defi-yield-mcp", "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/mokaman~defi-yield-mcp/run-sync": { "post": { "operationId": "run-sync-mokaman-defi-yield-mcp", "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": { "chain": { "title": "Chain", "type": "string", "description": "Exact chain name, e.g. Ethereum, Arbitrum, Base, Solana. Leave empty for all chains." }, "project": { "title": "Project", "type": "string", "description": "Exact project slug as used by DeFiLlama, e.g. aave-v3, lido, curve-dex. Leave empty for all projects." }, "symbol": { "title": "Symbol contains", "type": "string", "description": "Substring match on the pool symbol, e.g. USDC matches USDC-USDT." }, "minApy": { "title": "Min APY (%)", "minimum": 0, "type": "integer", "description": "Only pools with APY at or above this percentage." }, "minTvl": { "title": "Min TVL (USD)", "minimum": 0, "type": "integer", "description": "Only pools with total value locked at or above this amount. Filters out risky dust pools." }, "stablecoinOnly": { "title": "Stablecoin pools only", "type": "boolean", "description": "Only pools where all assets are stablecoins (lower volatility risk).", "default": false }, "sort": { "title": "Sort by", "enum": [ "tvl", "apy" ], "type": "string", "description": "Sort results by TVL (safest first) or APY (highest yield first).", "default": "tvl" }, "limit": { "title": "Max results", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Maximum number of pools to return (1-1000). Each result is charged as one pool-result event.", "default": 100 }, "alertRules": { "title": "Alert rules (alert mode)", "type": "array", "description": "When set, the Actor runs in alert mode: each rule is an object with optional keys label, chain, project, symbol, minApy, minTvl, stablecoinOnly. Every pool matching a rule is pushed to the dataset as one alert match. Combine with an Apify Schedule and email/Slack integration for recurring alerts." } } }, "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 } } } } } } } } } } ```