# Crypto Whale Wallet Tracker (`seralifatih/whale-tracker-api`) Actor

Monitor large crypto wallet movements on Ethereum, BSC & Solana. Detect exchange deposit flows signaling sell pressure. Real-time alerts with USD values and severity scoring.

- **URL**: https://apify.com/seralifatih/whale-tracker-api.md
- **Developed by:** [Fatih İlhan](https://apify.com/seralifatih) (community)
- **Categories:** Developer tools, Lead generation, Integrations
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks
- **User rating**: No ratings yet

## Pricing

from $0.01 / 1,000 results

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

## 🐋 Whale Wallet Tracker

[![Run on Apify](https://img.shields.io/badge/Run%20on-Apify-ff9033?style=flat-square&logo=apify)](https://apify.com/)
[![Python 3.11](https://img.shields.io/badge/Python-3.11-blue?style=flat-square&logo=python)](https://www.python.org/)
[![Chains](https://img.shields.io/badge/Chains-ETH%20%7C%20BNB%20%7C%20SOL-1f8bff?style=flat-square)]()

Track high-value whale wallet movements across **Ethereum**, **BNB Chain**, and **Solana** with exchange-aware alerts built for analysts, traders, and automation workflows.

This Actor scans bundled whale registries or your own wallet list, enriches transfers with USD pricing, tags exchange flows, and ranks alerts by severity so you can focus on the movements that actually matter.

Unlike basic wallet trackers, this Actor does more than list transactions. It estimates transfer size in USD, calculates percentage of wallet holdings moved, detects exchange deposits and withdrawals, and highlights the difference between a routine transfer and a potential market-moving event.

---

### ✨ Key Features

* **🐋 Whale-first monitoring:** Track large wallets from a bundled registry or bring your own custom wallet list.
* **🌐 Multi-chain coverage:** Monitor activity across Ethereum, BNB Chain, and Solana in one run.
* **🏦 Exchange flow detection:** Match transfers against known exchange wallets and deposit clusters, including fuzzy prefix matching.
* **🚨 Severity scoring:** Rank alerts as `critical`, `high`, `medium`, or `low` using configurable USD and holdings-based thresholds.
* **💵 USD valuation:** Enrich transfers with CoinGecko pricing for native assets and supported tokens.
* **📊 Holdings context:** Calculate `pct_of_holdings` to show how meaningful a transfer is relative to the wallet's size.
* **🔁 Exchange-to-exchange awareness:** Detect flows moving between exchange-controlled wallets.
* **🧾 Clean JSON output:** Structured dataset records designed for APIs, dashboards, alerts, and downstream automation.

---

### ⛓️ Supported Chains

| Chain | Native Asset | Balance + Transfer Source |
| --- | --- | --- |
| Ethereum | ETH | Etherscan |
| BNB Chain | BNB | BscScan |
| Solana | SOL | Solscan |

The Actor supports:

* Native token balances and transfers
* ERC-20 / BEP-20 token balances and transfers for tracked contracts
* SPL token transfer tracking on Solana
* Custom wallets and bundled whale registries per chain

---

### 📊 Sample Output

Each alert is returned as a structured record in the dataset:

```json
{
  "wallet_address": "0x1111111111111111111111111111111111111111",
  "wallet_label": "Sample Whale",
  "chain": "ethereum",
  "token": "ETH",
  "amount": 1850.75,
  "usd_value": 5922400.0,
  "direction": "outflow",
  "destination": {
    "address": "0x9999999999999999999999999999999999999999",
    "label": "Binance Hot Wallet",
    "is_exchange": true,
    "exchange_name": "binance",
    "flow_type": "deposit"
  },
  "alert_severity": "critical",
  "tx_hash": "0xabc123def456",
  "block_number": 19765432,
  "timestamp": 1707004800,
  "metadata": {
    "pct_of_holdings": 12.48,
    "wallet_total_usd": 47450000.0,
    "source_is_exchange": false,
    "source_exchange_name": null,
    "exchange_to_exchange": false
  }
}
````

The Actor also emits a run-level summary record:

```json
{
  "type": "RUN_SUMMARY",
  "total_wallets": 150,
  "total_transfers_scanned": 892,
  "total_alerts": 27,
  "enabled_chains": ["ethereum", "bsc", "solana"]
}
```

***

### ⚙️ How It Works

1. **Wallet loading:** Pulls bundled whale wallets and merges any custom wallets you provide.
2. **Chain scanning:** Fetches balances and recent transfers from the relevant chain adapter.
3. **Price enrichment:** Resolves USD prices for native assets and supported tokens.
4. **Exchange matching:** Tags counterparties as exchange deposits or withdrawals when they match the exchange address database.
5. **Alert scoring:** Applies your threshold rules and sorts alerts by severity, then USD value.
6. **Output:** Pushes alert records and a run summary into the Apify dataset.

***

### 🚀 How to Use

#### Method 1: Apify Console

Best for analysts and operators who want a no-code monitoring workflow.

1. Open the Actor in Apify Store.
2. In the **Input** tab, choose your target `chains`.
3. Add custom `wallets` or leave the field empty to use the bundled whale registry.
4. Set `min_usd_value` and any optional severity thresholds.
5. Click **Start**.
6. Review alerts in the **Dataset** tab or connect the dataset to your downstream workflow.

#### Method 2: API Integration

Trigger the Actor programmatically from your own systems:

```bash
curl --request POST \
  --url https://api.apify.com/v2/acts/YOUR_USERNAME~whale-wallet-tracker/runs?token=YOUR_API_TOKEN \
  --header "Content-Type: application/json" \
  --data '{
    "chains": ["ethereum", "bsc", "solana"],
    "wallets": [
      {
        "address": "0x1111111111111111111111111111111111111111",
        "chain": "ethereum",
        "label": "Treasury Wallet"
      },
      {
        "address": "7xKXtg2CW8E4Y9rWcL6sQ9qfDq8f7nP4v1L5Tn6i7Y8Z",
        "chain": "solana",
        "label": "Solana Watchlist Wallet"
      }
    ],
    "min_usd_value": 100000,
    "critical_usd_value": 5000000,
    "critical_exchange_pct_of_holdings": 10,
    "high_exchange_usd_value": 1000000,
    "medium_usd_value": 500000,
    "include_exchange_flows_only": false,
    "top_whales_count": 50
  }'
```

After the run finishes, read the dataset items through the Apify API or export them to JSON, CSV, or your preferred integration target.

***

### 🧩 Input Schema

```json
{
  "wallets": [],
  "chains": ["ethereum", "bsc", "solana"],
  "min_usd_value": 50000,
  "include_exchange_flows_only": false,
  "critical_usd_value": 5000000,
  "critical_exchange_pct_of_holdings": 10,
  "high_exchange_usd_value": 1000000,
  "medium_usd_value": 500000,
  "top_whales_count": 50,
  "proxy_configuration": {
    "useApifyProxy": true
  }
}
```

| Parameter | Type | Default | Description |
| --- | --- | --- | --- |
| `wallets` | `Array<Object>` | `[]` | Optional custom wallets to monitor. Leave empty to use the bundled whale registry. |
| `chains` | `Array<String>` | `["ethereum", "bsc", "solana"]` | Chains to scan in the current run. |
| `min_usd_value` | `Integer` | `50000` | Minimum transfer value in USD required to report an alert. |
| `include_exchange_flows_only` | `Boolean` | `false` | If `true`, only exchange-related transfers are returned. |
| `critical_usd_value` | `Integer` | `5000000` | Transfers above this value are marked `critical`. |
| `critical_exchange_pct_of_holdings` | `Number` | `10` | Exchange deposits above this percentage of wallet holdings are marked `critical`. |
| `high_exchange_usd_value` | `Integer` | `1000000` | Exchange deposits above this value are marked `high` unless already `critical`. |
| `medium_usd_value` | `Integer` | `500000` | Transfers above this value are marked `medium` when higher rules do not apply. |
| `top_whales_count` | `Integer` | `50` | Number of bundled whale wallets to load per chain when custom wallets are not provided. |
| `proxy_configuration` | `Object` | `{"useApifyProxy": true}` | Optional Apify proxy settings passed through to chain adapters. |

#### Custom wallet example

```json
{
  "wallets": [
    {
      "address": "0x742d35Cc6634C0532925a3b844Bc454e4438f44e",
      "chain": "ethereum",
      "label": "ETH Treasury"
    },
    {
      "address": "0x8894E0a0c962CB723c1976a4421c95949bE2D4E3",
      "chain": "bsc",
      "label": "BNB Whale"
    },
    {
      "address": "7xKXtg2CW8E4Y9rWcL6sQ9qfDq8f7nP4v1L5Tn6i7Y8Z",
      "chain": "solana",
      "label": "SOL Watch Wallet"
    }
  ]
}
```

***

### 🧾 Output Schema

Each alert record includes:

| Field | Type | Description |
| --- | --- | --- |
| `wallet_address` | `String` | Source wallet being monitored. |
| `wallet_label` | `String \| null` | Human-readable wallet label when available. |
| `chain` | `String` | Blockchain name: `ethereum`, `bsc`, or `solana`. |
| `token` | `String` | Native asset or token symbol. |
| `amount` | `Number` | Transfer amount in token units. |
| `usd_value` | `Number \| null` | Estimated USD value when pricing is available. |
| `direction` | `String` | `inflow` or `outflow`. |
| `destination.address` | `String` | Counterparty wallet or token account. |
| `destination.label` | `String \| null` | Counterparty label when known. |
| `destination.is_exchange` | `Boolean` | Whether the counterparty matched the exchange database. |
| `destination.exchange_name` | `String \| null` | Exchange name if matched. |
| `destination.flow_type` | `String \| null` | `deposit` or `withdrawal` for exchange-related flows. |
| `alert_severity` | `String` | `critical`, `high`, `medium`, or `low`. |
| `tx_hash` | `String` | Transaction hash or Solana signature. |
| `block_number` | `Integer \| null` | Block number or slot when available. |
| `timestamp` | `Integer` | Unix timestamp. |
| `metadata.pct_of_holdings` | `Number \| null` | Transfer size as a percentage of wallet holdings. |
| `metadata.wallet_total_usd` | `Number \| null` | Estimated total wallet value in USD. |
| `metadata.source_is_exchange` | `Boolean \| null` | Whether the monitored wallet is itself recognized as an exchange wallet. |
| `metadata.source_exchange_name` | `String \| null` | Exchange name for the source wallet when matched. |
| `metadata.exchange_to_exchange` | `Boolean` | Whether the flow moved between exchange-controlled wallets. |

***

### ⚠️ Disclaimer

This Actor is provided for **informational and analytical purposes only**.

- Wallet labels and exchange matches are heuristic and database-driven.
- API providers may rate-limit, delay, or omit some activity.
- Token prices can be unavailable or stale for illiquid or newly created assets.
- Large transfers do **not** automatically imply buying, selling, or market intent.
- This is **not financial advice**.

Always validate important signals independently before making trading, treasury, or risk decisions.

***

### 🛠️ Tech Stack

- **Apify Actor** for scheduling, runs, datasets, and API access
- **Python 3.11** runtime
- **aiohttp** for async network requests
- **Etherscan** for Ethereum wallet and token activity
- **BscScan** for BNB Chain wallet and token activity
- **Solscan** for Solana portfolio and transfer data
- **CoinGecko** for USD token pricing
- **jsonschema / pytest** for contract-style output validation

***

**Built for crypto intelligence. Shipped for automation.**

# Actor input Schema

## `wallets` (type: `array`):

Optional custom wallets to monitor. Leave empty to use the bundled whale registry.

## `chains` (type: `array`):

Blockchains to scan.

## `etherscan_api_key` (type: `string`):

Secret API key for Ethereum balance and transfer lookups via Etherscan.

## `bscscan_api_key` (type: `string`):

Secret API key for BNB Chain balance and transfer lookups via BscScan.

## `solscan_api_key` (type: `string`):

Secret Solscan Pro API key for Solana portfolio and transfer lookups.

## `min_usd_value` (type: `integer`):

Minimum transfer value in USD to report.

## `include_exchange_flows_only` (type: `boolean`):

Only report flows that match known exchange wallets.

## `critical_usd_value` (type: `integer`):

Transfers above this USD value are marked critical regardless of destination.

## `critical_exchange_pct_of_holdings` (type: `number`):

Transfers to an exchange above this percentage of wallet holdings are marked critical.

## `high_exchange_usd_value` (type: `integer`):

Transfers to an exchange above this USD value are marked high unless they are already critical.

## `medium_usd_value` (type: `integer`):

Transfers above this USD value are marked medium when they do not meet higher severity rules.

## `top_whales_count` (type: `integer`):

How many bundled whale wallets to load per chain when custom wallets are not provided.

## `thresholds` (type: `object`):

Optional grouped override for all severity thresholds. Values here take precedence over top-level threshold fields.

## `proxy_configuration` (type: `object`):

Optional Apify proxy configuration passed through to chain adapters.

## Actor input object example

```json
{
  "wallets": [],
  "chains": [
    "ethereum",
    "bsc",
    "solana"
  ],
  "min_usd_value": 50000,
  "include_exchange_flows_only": false,
  "critical_usd_value": 5000000,
  "critical_exchange_pct_of_holdings": 10,
  "high_exchange_usd_value": 1000000,
  "medium_usd_value": 500000,
  "top_whales_count": 50,
  "proxy_configuration": {
    "useApifyProxy": true
  }
}
```

# Actor output Schema

## `alerts` (type: `string`):

Alert records generated by the actor, including transfer amounts, USD values, exchange tags, severity labels, and one RUN\_SUMMARY item in the dataset output.

## `runSummary` (type: `string`):

Key-value store record with the aggregated run summary, including total wallets scanned, transfers scanned, total alerts, enabled chains, and any runtime warnings.

# 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 '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {};

// Run the Actor and wait for it to finish
const run = await client.actor("seralifatih/whale-tracker-api").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 '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {}

# Run the Actor and wait for it to finish
run = client.actor("seralifatih/whale-tracker-api").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 seralifatih/whale-tracker-api --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=seralifatih/whale-tracker-api",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "Crypto Whale Wallet Tracker",
        "description": "Monitor large crypto wallet movements on Ethereum, BSC & Solana. Detect exchange deposit flows signaling sell pressure. Real-time alerts with USD values and severity scoring.",
        "version": "0.0",
        "x-build-id": "8EbJXnimLM5fe4etr"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/seralifatih~whale-tracker-api/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-seralifatih-whale-tracker-api",
                "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/seralifatih~whale-tracker-api/runs": {
            "post": {
                "operationId": "runs-sync-seralifatih-whale-tracker-api",
                "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/seralifatih~whale-tracker-api/run-sync": {
            "post": {
                "operationId": "run-sync-seralifatih-whale-tracker-api",
                "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": {
                    "wallets": {
                        "title": "Custom Wallets",
                        "type": "array",
                        "description": "Optional custom wallets to monitor. Leave empty to use the bundled whale registry.",
                        "items": {
                            "type": "object",
                            "properties": {
                                "address": {
                                    "title": "Address",
                                    "type": "string",
                                    "description": "Wallet address to monitor on the selected chain."
                                },
                                "chain": {
                                    "title": "Chain",
                                    "type": "string",
                                    "description": "Blockchain network where the wallet is active.",
                                    "enum": [
                                        "ethereum",
                                        "bsc",
                                        "solana"
                                    ]
                                },
                                "label": {
                                    "title": "Label",
                                    "type": "string",
                                    "description": "Optional human-readable name for the wallet."
                                }
                            }
                        },
                        "default": []
                    },
                    "chains": {
                        "title": "Chains",
                        "type": "array",
                        "description": "Blockchains to scan.",
                        "items": {
                            "type": "string",
                            "enum": [
                                "ethereum",
                                "bsc",
                                "solana"
                            ]
                        },
                        "default": [
                            "ethereum",
                            "bsc",
                            "solana"
                        ]
                    },
                    "etherscan_api_key": {
                        "title": "Etherscan API Key",
                        "type": "string",
                        "description": "Secret API key for Ethereum balance and transfer lookups via Etherscan."
                    },
                    "bscscan_api_key": {
                        "title": "BscScan API Key",
                        "type": "string",
                        "description": "Secret API key for BNB Chain balance and transfer lookups via BscScan."
                    },
                    "solscan_api_key": {
                        "title": "Solscan API Key",
                        "type": "string",
                        "description": "Secret Solscan Pro API key for Solana portfolio and transfer lookups."
                    },
                    "min_usd_value": {
                        "title": "Minimum USD Value",
                        "minimum": 0,
                        "type": "integer",
                        "description": "Minimum transfer value in USD to report.",
                        "default": 50000
                    },
                    "include_exchange_flows_only": {
                        "title": "Exchange Flows Only",
                        "type": "boolean",
                        "description": "Only report flows that match known exchange wallets.",
                        "default": false
                    },
                    "critical_usd_value": {
                        "title": "Critical USD Threshold",
                        "minimum": 0,
                        "type": "integer",
                        "description": "Transfers above this USD value are marked critical regardless of destination.",
                        "default": 5000000
                    },
                    "critical_exchange_pct_of_holdings": {
                        "title": "Critical Exchange % of Holdings",
                        "minimum": 0,
                        "type": "number",
                        "description": "Transfers to an exchange above this percentage of wallet holdings are marked critical.",
                        "default": 10
                    },
                    "high_exchange_usd_value": {
                        "title": "High Exchange USD Threshold",
                        "minimum": 0,
                        "type": "integer",
                        "description": "Transfers to an exchange above this USD value are marked high unless they are already critical.",
                        "default": 1000000
                    },
                    "medium_usd_value": {
                        "title": "Medium USD Threshold",
                        "minimum": 0,
                        "type": "integer",
                        "description": "Transfers above this USD value are marked medium when they do not meet higher severity rules.",
                        "default": 500000
                    },
                    "top_whales_count": {
                        "title": "Top Whales Per Chain",
                        "minimum": 1,
                        "maximum": 500,
                        "type": "integer",
                        "description": "How many bundled whale wallets to load per chain when custom wallets are not provided.",
                        "default": 50
                    },
                    "thresholds": {
                        "title": "Threshold Overrides (advanced)",
                        "type": "object",
                        "description": "Optional grouped override for all severity thresholds. Values here take precedence over top-level threshold fields.",
                        "properties": {
                            "min_usd_value": {
                                "title": "Min USD Value",
                                "description": "Minimum transfer value in USD to report.",
                                "type": "integer",
                                "minimum": 0
                            },
                            "critical_usd_value": {
                                "title": "Critical USD Value",
                                "description": "Transfers above this USD value are marked critical.",
                                "type": "integer",
                                "minimum": 0
                            },
                            "critical_exchange_pct_of_holdings": {
                                "title": "Critical Exchange % of Holdings",
                                "description": "Transfers to an exchange above this percentage of wallet holdings are marked critical.",
                                "type": "number",
                                "minimum": 0
                            },
                            "high_exchange_usd_value": {
                                "title": "High Exchange USD Value",
                                "description": "Transfers to an exchange above this USD value are marked high.",
                                "type": "integer",
                                "minimum": 0
                            },
                            "medium_usd_value": {
                                "title": "Medium USD Value",
                                "description": "Transfers above this USD value are marked medium.",
                                "type": "integer",
                                "minimum": 0
                            },
                            "include_exchange_flows_only": {
                                "title": "Exchange Flows Only",
                                "description": "Only report transfers involving known exchange addresses.",
                                "type": "boolean"
                            }
                        }
                    },
                    "proxy_configuration": {
                        "title": "Proxy Configuration",
                        "type": "object",
                        "description": "Optional Apify proxy configuration passed through to chain adapters.",
                        "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
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```
