# CEX Perp Funding Aggregator (`automation-lab/cex-perp-funding-aggregator`) Actor Track Binance perpetual futures funding rates with normalized APR, prices, next funding times, and optional open interest for crypto quant workflows. - **URL**: https://apify.com/automation-lab/cex-perp-funding-aggregator.md - **Developed by:** [Stas Persiianenko](https://apify.com/automation-lab) (community) - **Categories:** Business - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing Pay per event This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have. 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 ## CEX Perp Funding Aggregator Track perpetual futures funding rates from centralized exchanges in one normalized dataset. This actor starts with Binance USD-M Futures public APIs and produces clean rows for arbitrage dashboards, quant notebooks, market-making tools, and recurring monitoring jobs. ### What does CEX Perp Funding Aggregator do? The actor fetches current perpetual swap funding-rate snapshots and normalizes each market into a consistent schema. - 🏦 Venue name - 💱 Symbol, base asset, and quote asset - 📈 Mark price and index price - 🧮 Raw funding rate, percent value, and annualized APR estimate - ⏰ Next funding time - 📊 Optional open interest - 🔗 API endpoint and source URL - 🕒 Scrape timestamp ### Who is it for? Crypto teams use funding data for repeated monitoring rather than one-off scraping. - Arbitrage desks comparing positive and negative funding across markets - Quant researchers building funding-rate histories - Market makers watching carry costs - Bot builders feeding signal pipelines - Analysts preparing exchange risk dashboards - Data engineers loading crypto market data into warehouses ### Why use this actor? Public exchange APIs use exchange-specific field names. This actor turns those responses into stable export-friendly rows. - No browser is required - No login is required - No proxy is required for the supported Binance endpoint - Results are ready for CSV, JSON, Excel, API, and webhook workflows - The schema is designed so more venues can be added later ### Supported exchanges Version 0.1 supports Binance USD-M Futures via the public `premiumIndex` API. Additional adapters such as OKX, Bybit, Bitget, and Hyperliquid can be added incrementally while keeping the same normalized output fields. ### How much does it cost to monitor CEX perp funding rates? The actor uses pay-per-event pricing. - A small start fee is charged once per run - A per-item event is charged for each funding row saved - Use `symbols` or `maxItems` to keep tiny monitoring jobs inexpensive - Leave `includeOpenInterest` disabled when you only need funding rates Current pricing: | Event | Price | | --- | --- | | Run started | $0.005 per run | | Funding row (FREE) | $0.000034588 | | Funding row (BRONZE) | $0.000030077 | | Funding row (SILVER) | $0.00002346 | | Funding row (GOLD) | $0.000018046 | | Funding row (PLATINUM) | $0.000012031 | | Funding row (DIAMOND) | $0.00001 | ### Input You can run the actor with broad or narrow filters. ```json { "venues": ["binance"], "quoteAssets": ["USDT"], "maxItems": 250, "sortBy": "annualizedAprAbs", "includeOpenInterest": false } ```` ### Input fields | Field | Type | Description | | --- | --- | --- | | `venues` | array | Exchange adapters to query. Currently `binance`. | | `symbols` | array | Optional exact symbols such as `BTCUSDT`. Empty means all symbols. | | `quoteAssets` | array | Optional quote filters such as `USDT` or `USDC`. | | `maxItems` | integer | Maximum funding rows saved after sorting. | | `sortBy` | string | Sort by symbol, absolute funding rate, absolute APR, or next funding time. | | `includeOpenInterest` | boolean | Adds one extra public request per symbol for Binance open interest. | ### Output Each dataset item is one normalized funding snapshot. ```json { "venue": "binance", "symbol": "BTCUSDT", "base": "BTC", "quote": "USDT", "markPrice": 60209.12, "indexPrice": 60248.77, "fundingRate": 0.00005194, "fundingRatePct": 0.005194, "annualizedApr": 0.0568743, "nextFundingTime": "2026-06-27T08:00:00.000Z", "openInterest": null, "timestamp": "2026-06-27T02:33:25.000Z", "apiEndpoint": "https://fapi.binance.com/fapi/v1/premiumIndex", "sourceUrl": "https://www.binance.com/en/futures/BTCUSDT", "scrapedAt": "2026-06-27T02:33:25.437Z" } ``` ### Data table | Column | Meaning | | --- | --- | | `venue` | Exchange source. | | `symbol` | Exchange market symbol. | | `base` | Base asset parsed from the symbol. | | `quote` | Quote asset parsed from the symbol. | | `markPrice` | Mark price from the venue. | | `indexPrice` | Index price from the venue. | | `fundingRate` | Decimal funding rate for the next/last interval. | | `fundingRatePct` | Funding rate converted to percent. | | `annualizedApr` | Simple annualized estimate using 3 intervals per day. | | `nextFundingTime` | Next funding time in ISO format. | | `nextFundingTimeMs` | Raw next funding time in milliseconds. | | `openInterest` | Optional open interest enrichment. | | `timestamp` | Exchange response timestamp in ISO format. | | `timestampMs` | Raw exchange timestamp in milliseconds. | | `apiEndpoint` | API endpoint used for the row. | | `sourceUrl` | Human-readable market URL. | | `scrapedAt` | Actor collection timestamp. | ### How to run 1. Open the actor on Apify. 2. Keep `venues` set to `binance`. 3. Leave `symbols` empty for a full snapshot or add symbols such as `BTCUSDT`. 4. Set `quoteAssets` to `USDT` for the main Binance USD-M universe. 5. Choose `maxItems`. 6. Click **Start**. 7. Export the dataset or consume it via API. ### Example workflows - Run every 5 minutes and alert when absolute annualized APR crosses a threshold. - Store full snapshots in a data warehouse for historical funding analysis. - Compare funding rates with spot borrow rates. - Feed the highest absolute funding markets into a trading research notebook. - Monitor open interest only for a short symbol list to avoid extra requests. ### Tips for best results - Use `sortBy: annualizedAprAbs` to surface extreme funding markets first. - Use `symbols` for low-cost production monitors. - Use `quoteAssets: ["USDT"]` for clean Binance USD-M snapshots. - Disable open interest unless your strategy needs it. - Schedule recurring runs on Apify for time-series collection. ### API usage with Node.js ```js import { ApifyClient } from 'apify-client'; const client = new ApifyClient({ token: process.env.APIFY_TOKEN }); const run = await client.actor('automation-lab/cex-perp-funding-aggregator').call({ venues: ['binance'], quoteAssets: ['USDT'], maxItems: 250, sortBy: 'annualizedAprAbs' }); console.log(run.defaultDatasetId); ``` ### API usage with Python ```python from apify_client import ApifyClient client = ApifyClient('MY-APIFY-TOKEN') run = client.actor('automation-lab/cex-perp-funding-aggregator').call(run_input={ 'venues': ['binance'], 'quoteAssets': ['USDT'], 'maxItems': 250, 'sortBy': 'annualizedAprAbs', }) print(run['defaultDatasetId']) ``` ### API usage with cURL ```bash curl "https://api.apify.com/v2/acts/automation-lab~cex-perp-funding-aggregator/runs?token=$APIFY_TOKEN" \ -H 'Content-Type: application/json' \ -d '{"venues":["binance"],"quoteAssets":["USDT"],"maxItems":250}' ``` ### MCP integration Use the Apify MCP server to call this actor from Claude Desktop, Claude Code, or compatible MCP clients. MCP URL: ```text https://mcp.apify.com/?tools=automation-lab/cex-perp-funding-aggregator ``` Claude Code setup: ```bash claude mcp add apify-cex-funding https://mcp.apify.com/?tools=automation-lab/cex-perp-funding-aggregator ``` Claude Desktop JSON config: ```json { "mcpServers": { "apify-cex-funding": { "url": "https://mcp.apify.com/?tools=automation-lab/cex-perp-funding-aggregator" } } } ``` Example prompts: - "Run the CEX perp funding monitor for Binance USDT markets and show the top 20 absolute APR values." - "Fetch BTCUSDT, ETHUSDT, and SOLUSDT funding rates and summarize next funding times." - "Create a CSV-ready funding-rate snapshot for my quant notebook." ### Integrations Connect the dataset to: - Google Sheets for desk dashboards - BigQuery or Snowflake for historical snapshots - Slack alerts through Apify integrations - Trading research notebooks - Webhooks that trigger downstream bots - BI dashboards that track market carry ### Scheduling Funding changes throughout the day. A recurring schedule is the best way to build a useful time series. Common schedules: - Every 5 minutes for active trading monitors - Every 15 minutes for dashboards - Hourly for research archives - Around funding boundaries for exchange settlement checks ### Limitations - Version 0.1 supports Binance USD-M Futures. - Annualized APR is a simple estimate, not a forecast. - Public API availability can change. - Open interest enrichment adds one request per emitted symbol. - The actor does not place trades or provide financial advice. ### Legality This actor uses public market-data API endpoints. You should still review exchange terms, respect rate limits, and use the data responsibly. The actor is intended for analytics, monitoring, and research workflows. ### FAQ #### Is it legal to scrape funding rates? This actor uses public exchange market-data APIs and does not access private account data. Review the target exchange's terms before using the data in production. #### Does this actor place trades? No. It only extracts public funding-rate data and does not connect to trading accounts or submit orders. ### Troubleshooting #### Why did I get zero rows? Check your `symbols` and `quoteAssets` filters. Exact symbols should look like `BTCUSDT`. If you filter for a quote asset the venue does not return, the dataset can be empty. #### Why is open interest empty? Open interest is optional. Enable `includeOpenInterest` to request it. If the venue rejects an individual open-interest request, the actor keeps the funding row and leaves `openInterest` as `null`. ### Related scrapers Explore related Automation Lab actors on Apify: - https://apify.com/automation-lab - https://apify.com/automation-lab/crypto-news-scraper - https://apify.com/automation-lab/stock-market-news-scraper ### Changelog #### 0.1 Initial Binance USD-M Futures funding-rate aggregator with normalized funding rows, APR estimates, source links, and optional open-interest enrichment. ### Support If you need another exchange adapter or an extra normalized field, open an issue on the Apify actor page with example symbols and the workflow you want to support. # Actor input Schema ## `venues` (type: `array`): Centralized perpetual futures venues to query. Binance is supported now; more adapters can be added without changing the output schema. ## `symbols` (type: `array`): Optional exact perpetual symbols such as BTCUSDT or ETHUSDT. Leave empty to fetch all available Binance premium-index rows. ## `quoteAssets` (type: `array`): Optional quote-asset filters. Use USDT for the main Binance USD-M universe, or leave empty for all quotes returned by the API. ## `maxItems` (type: `integer`): Maximum normalized funding records to save to the dataset. ## `sortBy` (type: `string`): Sort rows before applying the maximum limit. ## `includeOpenInterest` (type: `boolean`): Make one additional public Binance API request per emitted symbol to include openInterest. Keep disabled for fastest recurring monitoring runs. ## `useApifyProxy` (type: `boolean`): Use Apify residential proxy for exchange API requests when running from restricted cloud locations. ## `proxyCountryCode` (type: `string`): Country code for Apify Proxy fallback. Germany (DE) works well for Binance public futures endpoints. ## Actor input object example ```json { "venues": [ "binance" ], "symbols": [], "quoteAssets": [ "USDT" ], "maxItems": 20, "sortBy": "annualizedAprAbs", "includeOpenInterest": false, "useApifyProxy": true, "proxyCountryCode": "DE" } ``` # Actor output Schema ## `overview` (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 = { "venues": [ "binance" ], "symbols": [], "quoteAssets": [ "USDT" ], "maxItems": 20, "sortBy": "annualizedAprAbs", "includeOpenInterest": false, "useApifyProxy": true, "proxyCountryCode": "DE" }; // Run the Actor and wait for it to finish const run = await client.actor("automation-lab/cex-perp-funding-aggregator").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 = { "venues": ["binance"], "symbols": [], "quoteAssets": ["USDT"], "maxItems": 20, "sortBy": "annualizedAprAbs", "includeOpenInterest": False, "useApifyProxy": True, "proxyCountryCode": "DE", } # Run the Actor and wait for it to finish run = client.actor("automation-lab/cex-perp-funding-aggregator").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 '{ "venues": [ "binance" ], "symbols": [], "quoteAssets": [ "USDT" ], "maxItems": 20, "sortBy": "annualizedAprAbs", "includeOpenInterest": false, "useApifyProxy": true, "proxyCountryCode": "DE" }' | apify call automation-lab/cex-perp-funding-aggregator --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=automation-lab/cex-perp-funding-aggregator", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "CEX Perp Funding Aggregator", "description": "Track Binance perpetual futures funding rates with normalized APR, prices, next funding times, and optional open interest for crypto quant workflows.", "version": "0.1", "x-build-id": "ZLCNdXqj1ZQ4ueKnx" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/automation-lab~cex-perp-funding-aggregator/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-automation-lab-cex-perp-funding-aggregator", "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/automation-lab~cex-perp-funding-aggregator/runs": { "post": { "operationId": "runs-sync-automation-lab-cex-perp-funding-aggregator", "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/automation-lab~cex-perp-funding-aggregator/run-sync": { "post": { "operationId": "run-sync-automation-lab-cex-perp-funding-aggregator", "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": { "venues": { "title": "Venues", "uniqueItems": true, "type": "array", "description": "Centralized perpetual futures venues to query. Binance is supported now; more adapters can be added without changing the output schema.", "items": { "type": "string", "enum": [ "binance" ], "enumTitles": [ "Binance USD-M Futures" ] }, "default": [ "binance" ] }, "symbols": { "title": "Symbols", "type": "array", "description": "Optional exact perpetual symbols such as BTCUSDT or ETHUSDT. Leave empty to fetch all available Binance premium-index rows.", "items": { "type": "string" } }, "quoteAssets": { "title": "Quote assets", "type": "array", "description": "Optional quote-asset filters. Use USDT for the main Binance USD-M universe, or leave empty for all quotes returned by the API.", "items": { "type": "string" } }, "maxItems": { "title": "Maximum funding rows", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Maximum normalized funding records to save to the dataset.", "default": 20 }, "sortBy": { "title": "Sort by", "enum": [ "symbol", "fundingRateAbs", "annualizedAprAbs", "nextFundingTime" ], "type": "string", "description": "Sort rows before applying the maximum limit.", "default": "symbol" }, "includeOpenInterest": { "title": "Include open interest", "type": "boolean", "description": "Make one additional public Binance API request per emitted symbol to include openInterest. Keep disabled for fastest recurring monitoring runs.", "default": false }, "useApifyProxy": { "title": "Use Apify Proxy fallback", "type": "boolean", "description": "Use Apify residential proxy for exchange API requests when running from restricted cloud locations.", "default": true }, "proxyCountryCode": { "title": "Proxy country code", "type": "string", "description": "Country code for Apify Proxy fallback. Germany (DE) works well for Binance public futures endpoints.", "default": "DE" } } }, "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 } } } } } } } } } } ```