# ðŸ—ģïļ DAO Governance Tracker (`taroyamada/web3-dao-governance-tracker`) Actor Monitor EVM DAO governance proposals and voting outcomes across Ethereum, Arbitrum, and Optimism using Snapshot's GraphQL API to extract scores and quorum. - **URL**: https://apify.com/taroyamada/web3-dao-governance-tracker.md - **Developed by:** [åĪŠéƒŽ åąąį”°](https://apify.com/taroyamada) (community) - **Categories:** Business, News - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing Pay per usage This Actor is paid per platform usage. The Actor is free to use, and you only pay for the Apify platform usage, which gets cheaper the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-usage ## 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 ## Web3 DAO Governance Tracker Monitor the heartbeat of decentralized organizations with this dedicated Web3 DAO Governance Tracker. Built to scrape and extract live voting data from the industry-standard Snapshot.org GraphQL API, this tool gives you instant visibility into off-chain governance signals across Ethereum, Arbitrum, Optimism, and other EVM-compatible networks. Whether you are an active delegate, a treasury analyst, or an institutional investor, staying ahead of governance changes is critical. This scraper allows you to track active, pending, or closed proposals without needing a connected wallet, API key, or paid tier. Users rely on this extraction tool to schedule weekly monitors of their favorite DAO spaces, ensuring they never miss a crucial protocol upgrade or treasury vote. By querying Snapshot's public infrastructure directly, you can reliably capture a wealth of structured data for quantitative analysis, financial modeling, or compliance reporting. Every run seamlessly delivers concrete outputs including the unique proposal ID, space details, full proposal body, author addresses, voting choices, and real-time scores per choice. It also extracts the current state (active vs closed), precise start and end timestamps, quorum thresholds, and total vote counts. Use this data to power your own dashboards, track delegate participation, or build internal alerts when controversial proposals are nearing their deadlines. ### Status Scaffolded as part of **Wave 17 Batch S — Tier 3 (strategic / emerging platforms + governance)**. Domain logic lives in `src/workflow.js`. ### Feasibility **Very high — Snapshot.org's public GraphQL API (hub.snapshot.org/graphql) is the industry-standard index for EVM DAO off-chain voting. Fully public, no API key required, stable schema in use by Tally / DeepDAO / Etherscan.** ### V1 scope Snapshot.org public GraphQL only. Per proposal: ID, space, title, body, author, choices, scores per choice, state (active/closed/pending), start/end, quorum, votes count, strategies, link. OUT OF SCOPE: on-chain executor (Gnosis Safe, Compound Governor) transaction history, Tally / Boardroom aggregation, cross-chain reorg handling, wallet-sign voting. ### Extraction surfaces - Snapshot GraphQL: https://hub.snapshot.org/graphql — proposals / spaces / votes queries - Snapshot space JSON: https://hub.snapshot.org/api/spaces/{spaceId} ### Known limitations and explicit warnings - Snapshot is an OFF-chain gasless voting platform — vote counts reflect signed messages, not on-chain transactions. - Some DAOs have migrated from Snapshot to Tally (on-chain Governor) — Snapshot coverage for those is historical-only. - Strategy configuration (how voting power is calculated) is DAO-defined; the actor surfaces the strategy spec but does not re-compute balances. - GraphQL endpoint rate-limits at ~60 req/min for anonymous clients; batched queries are preferred. - Proposal bodies are user-authored Markdown — no sanitization is performed; consumers should treat as untrusted. - Quorum calculation depends on the strategy and may require fetching the space config separately. - 'Scores' fields are computed by Snapshot using the space's strategies; they may lag during active voting windows. - Space IDs are case-sensitive and often use .eth suffix; the actor passes them through verbatim. - On-chain execution status (whether a passing proposal was actually queued / executed) is NOT tracked by Snapshot and is out of V1 scope. - DAO metadata returns the CURRENT space config, not historical snapshots at proposal-creation time. ### Input - DAO space IDs / governance proposals - Delivery mode (dataset or webhook) - Dry-run support for local validation ### Output - Normalized `proposals` array - `meta` section with implementation status, feasibility note, V1 scope, warnings, and notes ### Local run ```bash npm test npm start ```` ### ⭐ Was this helpful? If this actor saved you time, please [**leave a ★ rating**](https://apify.com/taroyamada/web3-dao-governance-tracker/reviews) on Apify Store. It takes 10 seconds, helps other developers discover it, and keeps updates free. Bug report or feature request? Open an issue on the [Issues tab](https://apify.com/taroyamada/web3-dao-governance-tracker/issues) of this actor. # Actor input Schema ## `spaceIds` (type: `array`): DAO space IDs on Snapshot (e.g. 'uniswap', 'aave.eth', 'ens.eth'). ## `states` (type: `array`): Filter proposals by state (active, closed, pending). Leave empty for all. ## `maxProposalsPerSpace` (type: `integer`): Cap on the number of proposals to return per space. ## `delivery` (type: `string`): Where to send results: dataset or webhook. ## `webhookUrl` (type: `string`): Webhook URL to POST results to when delivery=webhook. ## `dryRun` (type: `boolean`): Run without saving results to the dataset. ## Actor input object example ```json { "spaceIds": [ "uniswap" ], "states": [ "active", "closed" ], "maxProposalsPerSpace": 20, "delivery": "dataset", "dryRun": false } ``` # 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 = { "spaceIds": [ "uniswap" ], "states": [ "active", "closed" ] }; // Run the Actor and wait for it to finish const run = await client.actor("taroyamada/web3-dao-governance-tracker").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 = { "spaceIds": ["uniswap"], "states": [ "active", "closed", ], } # Run the Actor and wait for it to finish run = client.actor("taroyamada/web3-dao-governance-tracker").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 '{ "spaceIds": [ "uniswap" ], "states": [ "active", "closed" ] }' | apify call taroyamada/web3-dao-governance-tracker --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=taroyamada/web3-dao-governance-tracker", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "ðŸ—ģïļ DAO Governance Tracker", "description": "Monitor EVM DAO governance proposals and voting outcomes across Ethereum, Arbitrum, and Optimism using Snapshot's GraphQL API to extract scores and quorum.", "version": "0.1", "x-build-id": "baJ37EKmZU5FB2LDF" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/taroyamada~web3-dao-governance-tracker/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-taroyamada-web3-dao-governance-tracker", "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/taroyamada~web3-dao-governance-tracker/runs": { "post": { "operationId": "runs-sync-taroyamada-web3-dao-governance-tracker", "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/taroyamada~web3-dao-governance-tracker/run-sync": { "post": { "operationId": "run-sync-taroyamada-web3-dao-governance-tracker", "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": { "spaceIds": { "title": "Snapshot Space IDs", "type": "array", "description": "DAO space IDs on Snapshot (e.g. 'uniswap', 'aave.eth', 'ens.eth').", "items": { "type": "string" } }, "states": { "title": "Proposal States", "type": "array", "description": "Filter proposals by state (active, closed, pending). Leave empty for all.", "items": { "type": "string" } }, "maxProposalsPerSpace": { "title": "Max Proposals per Space", "minimum": 1, "maximum": 200, "type": "integer", "description": "Cap on the number of proposals to return per space.", "default": 20 }, "delivery": { "title": "Delivery", "enum": [ "dataset", "webhook" ], "type": "string", "description": "Where to send results: dataset or webhook.", "default": "dataset" }, "webhookUrl": { "title": "Webhook URL", "type": "string", "description": "Webhook URL to POST results to when delivery=webhook." }, "dryRun": { "title": "Dry Run", "type": "boolean", "description": "Run without saving results to the dataset.", "default": false } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```