{ "openapi": "3.0.1", "info": { "title": "DeFi Protocols TVL & Yield Scraper", "description": "Scrape DeFi protocols with current TVL, category, chains, 1d/7d change, market cap and mcap/TVL ratio. Switch modes to get total value locked per blockchain or liquidity pools with APY. Filter by category, chain or minimum TVL and sort by TVL or momentum. Export to JSON, CSV or Excel.", "version": "0.1", "x-build-id": "ePOT8ke7amPyFtKOe" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrapers_lat~defillama-protocols-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrapers_lat-defillama-protocols-scraper", "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/scrapers_lat~defillama-protocols-scraper/runs": { "post": { "operationId": "runs-sync-scrapers_lat-defillama-protocols-scraper", "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/scrapers_lat~defillama-protocols-scraper/run-sync": { "post": { "operationId": "run-sync-scrapers_lat-defillama-protocols-scraper", "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": { "maxProtocols": { "title": "Max protocols", "minimum": 1, "maximum": 1000000, "type": "integer", "description": "Maximum number of protocols to collect. Optional." }, "mode": { "title": "Data mode", "enum": [ "protocols", "chains", "yields" ], "type": "string", "description": "What to collect: DeFi protocols with TVL and fundamentals, total value locked per blockchain, or liquidity pools with APY.", "default": "protocols" }, "category": { "title": "Category / project filter", "type": "string", "description": "Optional. In protocols mode keep only one category (for example 'Dexes', 'Lending', 'Liquid Staking', 'CDP'). In yields mode keep only one project (for example 'aave-v3', 'lido')." }, "chain": { "title": "Chain filter", "type": "string", "description": "Optional. Keep only protocols, pools or the chain matching this blockchain (for example 'Ethereum', 'Solana', 'Base', 'Arbitrum')." }, "minTvl": { "title": "Minimum TVL (USD)", "minimum": 0, "type": "integer", "description": "Optional. Keep only records whose total value locked is at least this many US dollars." }, "sort": { "title": "Sort by", "enum": [ "tvl", "change" ], "type": "string", "description": "Order the results by total value locked (largest first) or by momentum (biggest 1-day change / APY move first).", "default": "tvl" }, "withSummary": { "title": "AI protocol summary (paid add-on)", "type": "boolean", "description": "Optional AI add-on, off by default (protocols mode only). Generate a plain-English overview of each protocol from its description and metrics. Billed per successful summary. Disabled on free plans.", "default": false }, "withRisk": { "title": "AI risk red-flags (paid add-on)", "type": "boolean", "description": "Optional AI add-on, off by default (protocols mode only). Surface DeFi due-diligence red flags (rugged, deprecated, unaudited, forked, sharp TVL drop) and an overall risk level. Billed per successful analysis. Disabled on free plans.", "default": false } } }, "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 } } } } } } } } } }