# Crypto Wallet Scraper - Balances, Tokens, NFTs & Transactions (`scrapesage/crypto-wallet-scraper`) Actor Scrape crypto wallet data across Ethereum, top L2s & Bitcoin: native + ERC-20 balances with live USD value, NFT holdings, full transaction & token-transfer history, internal txns and token-contract info. Keyless, no browser. Paste addresses or ENS names; monitor wallets for new activity. - **URL**: https://apify.com/scrapesage/crypto-wallet-scraper.md - **Developed by:** [Scrape Sage](https://apify.com/scrapesage) (community) - **Categories:** Other, Automation, Developer tools - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $4.00 / 1,000 wallet overviews 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 ## Crypto Wallet Scraper — Balances, Tokens, NFTs & Transactions Track any **crypto wallet** across **Ethereum, top L2s and Bitcoin** in one run. Get the **native balance with live USD value**, the **full ERC-20 token portfolio** (every holding priced in USD, with a total portfolio value), **NFT holdings**, and the **complete transaction, token-transfer and internal-transaction history** — plus **token-contract lookups** and a **monitor mode** that emits only new wallet activity. No login, no API key, no browser — fast JSON extraction straight from public on-chain explorers. ### Why this crypto wallet scraper? Most wallet scrapers return a thin balance and a tx list. This actor ships the **richest on-chain dataset in the category** — every holding priced, every counterparty labelled, every chain in one place: | Data | Typical scrapers | This actor | |---|---|---| | Native balance + **live USD value** | partial | ✅ | | **Full token portfolio** with per-token USD value & total | ❌ | ✅ | | NFT holdings (collection, token id, image, traits) | ❌ | ✅ | | Transactions with **direction**, USD value, fees & gas | partial | ✅ | | Token transfers (ERC-20 / 721 / 1155) | partial | ✅ | | Internal transactions | ❌ | ✅ | | Counterparty **ENS names & address labels** (exchanges, contracts) | ❌ | ✅ | | Token-contract info (supply, holders, price, market cap) | ❌ | ✅ | | Bitcoin support | rare | ✅ | | **Monitor mode** — only new activity | ❌ | ✅ | | Multi-chain in one actor (Ethereum + L2s + Bitcoin) | ❌ | ✅ | | API key required | usually | ❌ keyless | ### Supported chains **Ethereum, Optimism, Arbitrum One, Polygon, Gnosis Chain, zkSync Era, Scroll, Celo, Unichain** and **Bitcoin** — out of the box, keyless. Add **any other Blockscout-powered EVM chain** (Base, BNB Chain, Avalanche, Linea, …) via the `customInstances` input. ### Use cases - **Portfolio tracking** — pull a wallet's complete token + NFT portfolio with USD values for dashboards, accounting, or tax tooling. - **Whale & smart-money watching** — schedule the actor in monitor mode and get only **new transactions** the moment a tracked wallet moves funds. - **Wallet intelligence & compliance** — map counterparties (labelled exchanges, contracts, ENS) across an address's full history for AML/KYT, due diligence, or research. - **Airdrop & treasury monitoring** — track DAO treasuries, multisigs, and vesting wallets across multiple chains in a single run. - **On-chain analytics** — feed transactions, transfers, and holdings into your own models, data warehouse, or LLM. - **Token research** — look up any token contract's supply, holders, price, and market cap. ### How to use 1. [Sign up for Apify](https://console.apify.com/sign-up) — the free plan is enough to try this actor. 2. Open the **Crypto Wallet Scraper**, choose **What to scrape** (wallet, transactions, holdings, …), paste **addresses** or ENS names, pick a **chain**, and click **Start**. 3. Watch results stream into the dataset table. 4. **Export** as JSON, CSV, Excel, XML, or RSS — or pull results programmatically via the [Apify API](https://docs.apify.com/api/v2). ### Input ```json { "outputType": "wallet", "addresses": ["vitalik.eth", "0x28C6c06298d514Db089934071355E5743bf21d60"], "chain": "ethereum", "includeTokenHoldings": true, "includeNftHoldings": false } ```` - **outputType** — `wallet` (rich overview), `transactions`, `tokenTransfers`, `internalTransactions`, `tokenHoldings`, `nftHoldings`, `token` (contract lookup), or `transaction` (lookup by hash). - **addresses** — wallet addresses (EVM `0x…` or Bitcoin) or ENS names (`vitalik.eth`). - **chain** — `ethereum`, `optimism`, `arbitrum`, `polygon`, `gnosis`, `zksync`, `scroll`, `celo`, `unichain`, or `bitcoin`. - **tokenAddresses** — token contracts for `outputType: "token"`. - **transactionHashes** — tx hashes for `outputType: "transaction"`. - **startUrls** — paste explorer URLs (Etherscan, Blockscout, mempool.space) for an address, token, or tx; the chain & type are auto-detected. - **includeTokenHoldings** *(default true)* — fetch the ERC-20 portfolio with USD prices in `wallet` mode. - **includeNftHoldings** *(default false)* — embed an NFT summary in `wallet` mode. - **direction** — `all` / `in` / `out`, for transaction / transfer / internal modes. - **maxResultsPerAddress** *(default 100)* — cap list records per address. - **maxResults** *(default 1000)* — overall dataset cap. - **customInstances** — add extra Blockscout EVM chains (see Supported chains). - **monitorMode** *(default false)* — output only new records vs. previous runs. ### Output One record per result, tagged with a `type`. Example `wallet` record: ```json { "type": "wallet", "chain": "ethereum", "chainName": "Ethereum", "nativeSymbol": "ETH", "address": "0x28C6c06298d514Db089934071355E5743bf21d60", "ensName": null, "name": "Binance 14", "labels": ["Binance"], "isContract": false, "nativeBalance": 1883.45, "nativePriceUsd": 1754.19, "nativeBalanceUsd": 3303860.12, "portfolioUsd": 2256241425.97, "tokenHoldingsUsd": 1649938173.84, "transactionsCount": 8123456, "tokenCount": 2044, "nftCount": 10091, "topHoldingSymbol": "USDT", "tokenHoldings": [ { "symbol": "USDT", "name": "Tether", "balance": 1079898422.15, "priceUsd": 0.999239, "valueUsd": 1079076619.45, "tokenAddress": "0xdAC17F958D2ee523a2206206994597C13D831ec7" }, { "symbol": "WBTC", "name": "Wrapped BTC", "balance": 573.99, "priceUsd": 64204, "valueUsd": 36852345.04 } ], "explorerUrl": "https://etherscan.io/address/0x28C6c06298d514Db089934071355E5743bf21d60", "scrapedAt": "2026-06-18T00:00:00.000Z" } ``` Example `transaction` record: ```json { "type": "transaction", "chain": "ethereum", "hash": "0xd215ef02068b35dba8b6703ed888fff7a6de3ea5574101724f437271f493772a", "timestamp": "2026-06-17T14:30:47.000Z", "direction": "in", "from": "0xB69B37A4Fb4A18b3258f974ff6e9f529AD2647b1", "to": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045", "toLabel": "vitalik.eth", "value": 0.00179, "valueUsd": 3.14, "fee": 0.0000139, "gasUsed": 21062, "method": null, "status": "ok", "explorerUrl": "https://etherscan.io/tx/0xd215ef02068b35dba8b6703ed888fff7a6de3ea5574101724f437271f493772a" } ``` Other `type`s: `tokenTransfer`, `internalTransaction`, `tokenHolding`, `nftHolding`, `token`. ### Automate & schedule Run this actor on autopilot and pull results into your own stack: - **[Apify API](https://docs.apify.com/api/v2)** — start runs, fetch datasets, and manage schedules over REST. - **[apify-client for JavaScript](https://docs.apify.com/api/client/js/)** and **[apify-client for Python](https://docs.apify.com/api/client/python/)** — official SDKs. - **[Schedules](https://docs.apify.com/platform/schedules)** — run it every few minutes/hourly/daily to watch wallets; combine with `monitorMode` to emit only new transactions. - **[Webhooks](https://docs.apify.com/platform/integrations/webhooks)** — trigger downstream actions (Slack alert, trade bot, CRM import) the moment a run finishes. ```js import { ApifyClient } from 'apify-client'; const client = new ApifyClient({ token: 'MY_APIFY_TOKEN' }); const run = await client.actor('scrapesage/crypto-wallet-scraper').call({ outputType: 'transactions', addresses: ['vitalik.eth'], chain: 'ethereum', monitorMode: true, }); const { items } = await client.dataset(run.defaultDatasetId).listItems(); console.log(`Got ${items.length} new transactions`); ``` ### Integrate with any app Connect the dataset to 5,000+ apps — no code required: - **[Make](https://docs.apify.com/platform/integrations/make)** — multi-step automation scenarios. - **[Zapier](https://docs.apify.com/platform/integrations/zapier)** — push new wallet activity straight into your tools. - **[Slack](https://docs.apify.com/platform/integrations/slack)** — get a ping when a monitored wallet moves. - **[Google Drive / Sheets](https://docs.apify.com/platform/integrations/drive)** — auto-export every run to a spreadsheet. - **[Airbyte](https://docs.apify.com/platform/integrations/airbyte)** — pipe results into your data warehouse. - **[GitHub](https://docs.apify.com/platform/integrations/github)** — trigger runs from commits or releases. ### Use with AI assistants (MCP) The output is clean, LLM-ready JSON. Call this actor from Claude, ChatGPT, or any agent framework through the **[Apify MCP server](https://docs.apify.com/platform/integrations/mcp)** — ask your assistant to "show vitalik.eth's token portfolio and recent transactions" and let it run this scraper for you. ### More scrapers from scrapesage Build a complete **crypto & finance data stack**: - **[CoinGecko Crypto Scraper](https://apify.com/scrapesage/coingecko-crypto-scraper)** — coins, markets, exchanges, NFTs, trending & global data. - **[DEX Token Scraper](https://apify.com/scrapesage/dex-token-scraper)** — on-chain DEX pairs/pools, prices, liquidity & new launches across 190+ chains. - **[DeFiLlama Scraper](https://apify.com/scrapesage/defillama-scraper)** — protocol TVL, yields, fees, stablecoins & chains. - **[Prediction Markets Scraper](https://apify.com/scrapesage/prediction-markets-scraper)** — Polymarket + Kalshi odds, volume & arbitrage. - **[Finviz Scraper](https://apify.com/scrapesage/finviz-scraper)** — stock screener, fundamentals & insider trading. - **[Yahoo Finance Scraper](https://apify.com/scrapesage/yahoo-finance-scraper)** — stocks, ETFs, crypto & FX quotes, financials & history. - **[SEC EDGAR Scraper](https://apify.com/scrapesage/sec-edgar-scraper)** — company filings & XBRL financials. ### Tips - **Big wallets**: exchange/treasury addresses can hold thousands of tokens and have millions of transactions — use `maxResultsPerAddress` to cap, and `direction` to focus on inflows or outflows. - **Recurring monitoring**: combine [Schedules](https://docs.apify.com/platform/schedules) with `monitorMode` and a unique `monitorKey` per watch list to get only new activity each run. - **ENS**: just paste `name.eth` — the actor resolves it to the address automatically. - **More chains**: add any Blockscout instance via `customInstances`, then set `chain` to that name. - **Rate limits**: the actor rotates a fresh proxy IP per request; if you ever see throttling, lower `maxConcurrency`. ### FAQ **Which chains are supported?** Ethereum, Optimism, Arbitrum One, Polygon, Gnosis Chain, zkSync Era, Scroll, Celo, Unichain and Bitcoin out of the box. Add any other Blockscout-powered EVM chain with `customInstances`. **Do I need an API key?** No. The actor reads public block-explorer APIs (Blockscout for EVM chains, mempool.space for Bitcoin) — no key, no login, no browser. **Can I get a wallet's USD portfolio value?** Yes — `wallet` mode prices every ERC-20 holding and the native balance, and returns the total `portfolioUsd`. **How do I monitor a wallet for new transactions?** Set `outputType: "transactions"` and `monitorMode: true`, then create a [Schedule](https://docs.apify.com/platform/schedules). Each run outputs only transactions that are new since the last run. **Can I export to Google Sheets, CSV, or Excel?** Yes — one click in the dataset view, or automatically on every run via the [Google Drive integration](https://docs.apify.com/platform/integrations/drive). **Why is a field null?** Fields are `null` only when the data genuinely doesn't exist on-chain (e.g. a token without a market price, or a wallet with no ENS name) — not because the scraper skipped them. **Is on-chain data public?** Yes. Blockchain transactions and balances are public by design; this actor only reads publicly available on-chain data. You are responsible for using it in compliance with applicable laws. ### Need help? Open an issue on the actor's **Issues** tab, or visit the [Apify help center](https://help.apify.com/). Feature requests are welcome — this actor is actively maintained. # Actor input Schema ## `outputType` (type: `string`): Choose the dataset you want. wallet = a rich overview per address (balance, USD portfolio, token holdings, NFT summary, counts). The other modes return granular lists. ## `addresses` (type: `array`): Wallet addresses to scrape — EVM (0x…) or Bitcoin, or ENS names like vitalik.eth. Used by all address modes (wallet, transactions, tokenTransfers, internalTransactions, tokenHoldings, nftHoldings). ## `chain` (type: `string`): Network for the addresses above. Bitcoin supports wallet + transactions only. Add more EVM chains via Custom chains below. ## `tokenAddresses` (type: `array`): Only for outputType = "Token info". ERC-20/721/1155 contract addresses (0x…) on the selected chain. ## `transactionHashes` (type: `array`): Only for outputType = "Transaction detail". Transaction hashes on the selected chain (EVM 0x… or Bitcoin txid). ## `startUrls` (type: `array`): Paste block-explorer URLs (Etherscan, Blockscout, mempool.space, …) for an address, token or tx — the actor auto-detects the chain and type. Works alongside the fields above. ## `includeTokenHoldings` (type: `boolean`): In wallet mode, fetch the address's ERC-20 token holdings with live USD prices and compute the total portfolio value. Turn off for a faster, balance-only overview. ## `includeNftHoldings` (type: `boolean`): In wallet mode, also embed a summary of NFTs held (collection, token id, image). Adds one extra request per wallet. ## `direction` (type: `string`): For transaction / transfer / internal modes: keep only incoming, only outgoing, or all records relative to the queried address. ## `maxResultsPerAddress` (type: `integer`): Cap on list records (transactions / transfers / holdings / NFTs) collected per address. ## `maxResults` (type: `integer`): Overall cap on records pushed to the dataset across the whole run. ## `customInstances` (type: `array`): Add any other Blockscout-powered EVM chain. Each item: { "name": "base", "baseUrl": "https://base.blockscout.com", "nativeSymbol": "ETH", "displayName": "Base", "explorerUrl": "https://basescan.org" }. Then set chain to that name. ## `monitorMode` (type: `boolean`): Remember what was emitted in previous runs (in a named key-value store) and output only NEW records — new transactions/transfers, or wallets whose balance or tx count changed. Perfect for scheduled wallet/whale watching. ## `monitorKey` (type: `string`): Namespace for monitor memory. Use a distinct key per watch list so they don't share state. ## `maxConcurrency` (type: `integer`): Parallel requests. The actor rotates a fresh proxy IP per request to spread public-API rate limits; lower this if you hit throttling. ## `proxyConfiguration` (type: `object`): Proxy settings. Apify Proxy (datacenter) is recommended and enabled by default — fresh IP rotation keeps the public explorer APIs happy. ## Actor input object example ```json { "outputType": "wallet", "addresses": [ "vitalik.eth" ], "chain": "ethereum", "includeTokenHoldings": true, "includeNftHoldings": false, "direction": "all", "maxResultsPerAddress": 100, "maxResults": 1000, "monitorMode": false, "monitorKey": "default", "maxConcurrency": 4, "proxyConfiguration": { "useApifyProxy": true } } ``` # Actor output Schema ## `results` (type: `string`): All scraped wallet, transaction, holding and token records as JSON items in the default dataset. # 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 = { "addresses": [ "vitalik.eth" ] }; // Run the Actor and wait for it to finish const run = await client.actor("scrapesage/crypto-wallet-scraper").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 = { "addresses": ["vitalik.eth"] } # Run the Actor and wait for it to finish run = client.actor("scrapesage/crypto-wallet-scraper").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 '{ "addresses": [ "vitalik.eth" ] }' | apify call scrapesage/crypto-wallet-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=scrapesage/crypto-wallet-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Crypto Wallet Scraper - Balances, Tokens, NFTs & Transactions", "description": "Scrape crypto wallet data across Ethereum, top L2s & Bitcoin: native + ERC-20 balances with live USD value, NFT holdings, full transaction & token-transfer history, internal txns and token-contract info. Keyless, no browser. Paste addresses or ENS names; monitor wallets for new activity.", "version": "0.1", "x-build-id": "xmBYa9qx5MqrTj8PT" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrapesage~crypto-wallet-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrapesage-crypto-wallet-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/scrapesage~crypto-wallet-scraper/runs": { "post": { "operationId": "runs-sync-scrapesage-crypto-wallet-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/scrapesage~crypto-wallet-scraper/run-sync": { "post": { "operationId": "run-sync-scrapesage-crypto-wallet-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", "required": [ "outputType" ], "properties": { "outputType": { "title": "What to scrape", "enum": [ "wallet", "transactions", "tokenTransfers", "internalTransactions", "tokenHoldings", "nftHoldings", "token", "transaction" ], "type": "string", "description": "Choose the dataset you want. wallet = a rich overview per address (balance, USD portfolio, token holdings, NFT summary, counts). The other modes return granular lists.", "default": "wallet" }, "addresses": { "title": "Wallet addresses / ENS names", "type": "array", "description": "Wallet addresses to scrape — EVM (0x…) or Bitcoin, or ENS names like vitalik.eth. Used by all address modes (wallet, transactions, tokenTransfers, internalTransactions, tokenHoldings, nftHoldings).", "items": { "type": "string" } }, "chain": { "title": "Chain / network", "enum": [ "ethereum", "optimism", "arbitrum", "polygon", "gnosis", "zksync", "scroll", "celo", "unichain", "bitcoin" ], "type": "string", "description": "Network for the addresses above. Bitcoin supports wallet + transactions only. Add more EVM chains via Custom chains below.", "default": "ethereum" }, "tokenAddresses": { "title": "Token contract addresses", "type": "array", "description": "Only for outputType = \"Token info\". ERC-20/721/1155 contract addresses (0x…) on the selected chain.", "items": { "type": "string" } }, "transactionHashes": { "title": "Transaction hashes", "type": "array", "description": "Only for outputType = \"Transaction detail\". Transaction hashes on the selected chain (EVM 0x… or Bitcoin txid).", "items": { "type": "string" } }, "startUrls": { "title": "Explorer URLs (optional)", "type": "array", "description": "Paste block-explorer URLs (Etherscan, Blockscout, mempool.space, …) for an address, token or tx — the actor auto-detects the chain and type. Works alongside the fields above.", "items": { "type": "string" } }, "includeTokenHoldings": { "title": "Include token holdings (wallet mode)", "type": "boolean", "description": "In wallet mode, fetch the address's ERC-20 token holdings with live USD prices and compute the total portfolio value. Turn off for a faster, balance-only overview.", "default": true }, "includeNftHoldings": { "title": "Include NFT holdings (wallet mode)", "type": "boolean", "description": "In wallet mode, also embed a summary of NFTs held (collection, token id, image). Adds one extra request per wallet.", "default": false }, "direction": { "title": "Direction filter", "enum": [ "all", "in", "out" ], "type": "string", "description": "For transaction / transfer / internal modes: keep only incoming, only outgoing, or all records relative to the queried address.", "default": "all" }, "maxResultsPerAddress": { "title": "Max results per address", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Cap on list records (transactions / transfers / holdings / NFTs) collected per address.", "default": 100 }, "maxResults": { "title": "Max results (total)", "minimum": 1, "maximum": 200000, "type": "integer", "description": "Overall cap on records pushed to the dataset across the whole run.", "default": 1000 }, "customInstances": { "title": "Custom chains (advanced)", "type": "array", "description": "Add any other Blockscout-powered EVM chain. Each item: { \"name\": \"base\", \"baseUrl\": \"https://base.blockscout.com\", \"nativeSymbol\": \"ETH\", \"displayName\": \"Base\", \"explorerUrl\": \"https://basescan.org\" }. Then set chain to that name." }, "monitorMode": { "title": "Monitor mode (only new)", "type": "boolean", "description": "Remember what was emitted in previous runs (in a named key-value store) and output only NEW records — new transactions/transfers, or wallets whose balance or tx count changed. Perfect for scheduled wallet/whale watching.", "default": false }, "monitorKey": { "title": "Monitor key", "type": "string", "description": "Namespace for monitor memory. Use a distinct key per watch list so they don't share state.", "default": "default" }, "maxConcurrency": { "title": "Max concurrency", "minimum": 1, "maximum": 12, "type": "integer", "description": "Parallel requests. The actor rotates a fresh proxy IP per request to spread public-API rate limits; lower this if you hit throttling.", "default": 4 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Proxy settings. Apify Proxy (datacenter) is recommended and enabled by default — fresh IP rotation keeps the public explorer APIs happy.", "default": { "useApifyProxy": true } } } }, "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 } } } } } } } } } } ```