CoinGlass Liquidation Heatmap Capture An Apify Actor that captures CoinGlass liquidation heatmap charts as PNG screenshots. The actor navigates to CoinGlass liquidation heatmap pages and captures high-quality screenshots of the heatmap canvas. ## Features - 📊 Capture CoinGlass liquidation heatmaps for any cryptocurrency - 🎯 Automatic canvas detection and capture - 🖼️ High-resolution PNG screenshots - 📦 Base64 encoded images in dataset output - ☁️ Fully compatible with Apify platform - 🚀 Can run locally or in the cloud - 🎨 Support for custom viewport sizes - ⏱️ Configurable wait times for page loading ## Prerequisites - Python 3.8+ (for local development) - Apify account (for cloud deployment) - Git (for version control) ## Local Development ### 1. Install Dependencies bash # Install Python dependencies pip install -r requirements.txt # Install Playwright browsers playwright install chromium ### 2. Run Locally with Apify SDK The actor uses Apify SDK which works automatically in local environment: bash # Run the actor (Apify CLI automatically reads storage/key_value_stores/default/INPUT.json) apify run # Or specify custom input file apify run --input storage/key_value_stores/default/INPUT.json ### 3. Local Storage When running locally, Apify SDK automatically creates: - storage/key_value_stores/default/ - Screenshots stored here - storage/datasets/default/ - Dataset JSON files stored here ### 4. Test Input Example Create storage/key_value_stores/default/INPUT.json file: json { "coin": "SOL", "type": "symbol", "width": 1920, "height": 1080, "waitTime": 5, "headless": false } Note: - Apify SDK works automatically in local mode - no API token required for local testing - On Apify platform, input is provided via Actor input in the console ## Input Schema | Field | Type | Default | Description | |-------|------|---------|-------------| | coin | string | "SOL" | Cryptocurrency symbol (e.g., SOL, BTC, ETH) | | type | string | "symbol" | Chart type (usually "symbol") | | width | integer | 1920 | Screenshot width in pixels (800-3840) | | height | integer | 1080 | Screenshot height in pixels (600-2160) | | waitTime | integer | 5 | Time to wait for page to fully load before screenshot (in seconds, 1-30) | | outputFileName | string | null | Custom filename (auto-generated if not provided) | | headless | boolean | false (locally) | Run browser in headless mode (hidden). Default: false locally, true on Apify platform | ## Output The actor saves: - Screenshot: PNG image in Apify Key-Value store - Metadata: JSON record in Apify Dataset with: - Coin symbol, type, URL - screenshotBase64: Base64 encoded image string (ready to use) - screenshotDataUrl: Data URL format (data:image/png;base64,...) - Screenshot URL and key (for direct access) - Timestamp Example output: json { "coin": "SOL", "type": "symbol", "url": "https://www.coinglass.com/pro/futures/LiquidationHeatMap?coin=SOL&type=symbol", "width": 1920, "height": 1080, "screenshotBase64": "iVBORw0KGgoAAAANSUhEUgAA...", "screenshotDataUrl": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAA...", "screenshotUrl": "https://api.apify.com/v2/key-value-stores/.../coinglass_SOL_2024-01-01T12-00-00.png", "screenshotKey": "coinglass_SOL_2024-01-01T12-00-00.png", "timestamp": "2024-01-01T12:00:00.000Z" } ## Supported Coins The actor supports all cryptocurrencies available on CoinGlass, including: - SOL (Solana) - BTC (Bitcoin) - ETH (Ethereum) - BNB (Binance Coin) - And many more... ## GitHub Setup & Deployment ### 1. Initialize Git Repository bash # Initialize git (if not already done) git init # Add all files git add . # Create initial commit git commit -m "Initial commit: CoinGlass heatmap capture actor" ### 2. Push to GitHub bash # Create a new repository on GitHub, then: git remote add origin https://github.com/YOUR_USERNAME/coinglass-heatmap-capture.git git branch -M main git push -u origin main ### 3. Deploy to Apify #### Option A: Deploy from GitHub (Recommended) 1. Go to Apify Console 2. Click "Create new" → "Actor" 3. Select "Deploy from GitHub" 4. Connect your GitHub account 5. Select the repository: coinglass-heatmap-capture 6. Apify will automatically build and deploy your actor #### Option B: Deploy via CLI bash # Login to Apify apify login # Build the actor apify build # Push to Apify apify push ### 4. Configure GitHub Actions (Optional) The project includes a GitHub Actions workflow (.github/workflows/deploy.yml) that automatically: - Installs dependencies - Builds the actor - Pushes to Apify on every push to main branch Setup: 1. Go to your GitHub repository 2. Navigate to Settings → Secrets and variables → Actions 3. Add a new secret named APIFY_TOKEN with your Apify API token 4. Get your token from: Apify Settings → Integrations ## Project Structure coinglass-heatmap-capture/ ├── src/ │ ├── main.py # Main actor logic │ ├── __init__.py │ └── __main__.py ├── .actor/ │ ├── actor.json # Apify actor configuration │ ├── input_schema.json # Input schema definition │ ├── dataset_schema.json # Dataset output schema │ └── output_schema.json # Output schema ├── storage/ # Local storage (gitignored) │ ├── datasets/ # Local dataset storage │ └── key_value_stores/ # Local key-value storage ├── requirements.txt # Python dependencies ├── Dockerfile # Docker image for Apify platform ├── .gitignore # Git ignore rules ├── README.md # This file └── AGENTS.md # AI agent instructions ## How It Works 1. Launch Browser: Opens Chromium via Playwright 2. Navigate: Goes to CoinGlass liquidation heatmap URL with specified coin 3. Wait for Canvas: Waits for the heatmap canvas to load and render 4. Capture: Takes PNG screenshot of the canvas element 5. Save: Stores screenshot in Key-Value store and metadata (with base64) in Dataset ## Troubleshooting ### Canvas Not Found - Increase waitTime value to allow more time for page loading - Check if CoinGlass is accessible from your network - Verify the coin symbol is correct ### Screenshot Quality - Increase width and height for higher resolution - Ensure waitTime is sufficient for chart to fully render ### Page Not Loading - Check internet connection - Verify CoinGlass website is accessible - Increase timeout values if needed ## License ISC ## Support For issues and questions: - Check Apify Documentation - Visit Apify Community - Review CoinGlass Terms of Service --- Note: This actor is for educational and personal use. Ensure compliance with CoinGlass's Terms of Service when using this tool.