Virtuals.io Scraper

Overview

The Virtuals.io Scraper is a powerful tool designed to collect detailed data about agents and their associated tokens from Virtuals.io. Whether you’re a crypto enthusiast, researcher, or developer, this scraper simplifies data extraction, offering flexibility and precision.

Virtuals.io is a platform focused on virtual tokenomics and ecosystem analytics, enabling users to gain insights into agent performance, token values, and more. With this scraper, you can access data on sentient agents or prototype agents, tailoring your research or analysis to your specific needs.

Features

• Flexible Agent Selection:
  • Choose between Sentient Agents and Prototype Agents to target the specific data you need.
• Extract Comprehensive Data:
  • Gather information on agents, tokenomics, market capitalization, and ascension progress.
• Detailed Analytics:
  • Access market cap calculations, token reserve details, and formatted progress data.
• Configurable Settings:
  • Adjust scraping parameters like concurrency, retries, and delays to suit your requirements.
• Proxy Support:
  • Ensure reliable and anonymous scraping with built-in proxy configurations.
• Persistent Data Storage:
  • Use custom storage names to preserve data indefinitely, ensuring deduplication and flexibility.
  • Duplicate datasets easily by assigning unique names to storage, enabling long-term analysis or simultaneous projects.

How to Use

1. Set Up: Ensure you have an Apify account and access to the Apify platform.
2. Select Agent Type: Choose between Sentient Agents or Prototype Agents for targeted scraping.
3. Provide Input Data: Input specific scraping parameters, such as the maximum number of items or custom storage names.
4. Adjust Scraper Settings: Configure settings like maxConcurrency, minConcurrency, and maxRequestRetries as per your requirements.
5. Run the Scraper: Execute the scraper on the Apify platform.
6. Download Results: Export the scraped data in your preferred format (JSON, CSV, Excel).

Input Configuration

Here is an example of how to set up the input for the Virtuals.io Scraper:

{
    "agents": "sentient",
    "maxItems": 10000,
    "maxConcurrency": 10,
    "minConcurrency": 1,
    "maxRequestRetries": 100,
    "storeName": "VirtualsDataStorage",
    "proxy": {
        "useApifyProxy": true,
        "apifyProxyGroups": [
            "RESIDENTIAL"
        ]
    }
}

Input Fields Explanation

• Agents (agents): Specify the type of agents to scrape:
  • sentient: Scrape data for Sentient Agents.
  • prototype: Scrape data for Prototype Agents.
• Max Items (maxItems): Maximum number of items to process during a single run.
• Max Concurrency (maxConcurrency): Maximum number of pages processed simultaneously.
• Min Concurrency (minConcurrency): Minimum number of pages processed simultaneously.
• Max Request Retries (maxRequestRetries): Number of retries for failed requests before stopping.
• Store Name (storeName): Custom name for the storage to enable data deduplication and retention.
• Proxy Configuration (proxy): Proxy settings for anonymity and reliability during scraping.

Output Structure

The scraper produces a structured list of agent data with detailed information. Below is an example of the output:

{
    "name": "Bark Ruffalo",
    "role": "CREATIVE",
    "preToken": "0x2D656C595dF8db8526E2F075322ADFcE37F4367d",
    "createdAt": "2024-11-23T14:32:59.403Z",
    "holders": null,
    "marketCap": {
        "rawValue": "592549233513375",
        "formatted": "$2,180,581.2k",
        "isUndergrad": false,
        "preTokenPair": "0x17Ed86287A52987AAD3fB7466699cc73ebE06416",
        "calculationSteps": {
            "originalValue": "592549233513375",
            "baseValue": 592549233513375,
            "supply": 592549.233513375,
            "tokenUsdPrice": 3.68,
            "fdvValue": 2180581.17932922,
            "calculation": "592549233513375 / 1000000000 * 3.68"
        }
    },
    "ascensionProgress": {
        "tokenReserves": 124504236.88581388,
        "virtualReserves": 48191.13108177,
        "progress": 100,
        "formattedProgress": "100.00%",
        "priceInVirtual": 0.0003870641858233898
    },
    "description": "Why $PAWSY?\n✨ We are creating an ecosystem and a community focused on making money...",
    "link": "https://virtuals.io/agent/BarkRuffalo"
}

Output Fields Explanation

• name: Name of the agent.
• role: Role or designation of the agent.
• preToken: Identifier for the token associated with the agent.
• createdAt: Timestamp indicating when the agent was created.
• holders: Number of token holders (if available).
• marketCap: Details of the market capitalization, including calculations and raw values.
• ascensionProgress: Progress metrics related to the agent's ascension.
• description: Detailed description of the agent and its purpose.
• link: Direct URL to the agent's profile on Virtuals.io.

Explore More Scrapers

If you found the Virtuals.io Scraper useful, check out other powerful scrapers and actors at memo23's Apify profile. We offer a wide range of tools to enhance your web scraping and automation needs.

Support

• For issues or feature requests, please use the Issues section of this actor.
• For further assistance, contact the author:
  • Author's website: https://muhamed-didovic.github.io/
  • Email: muhamed.didovic@gmail.com

Additional Services

• Request customization or a full dataset: muhamed.didovic@gmail.com
• Need other platforms scraped? Contact muhamed.didovic@gmail.com
• For API services of this scraper, reach out to muhamed.didovic@gmail.com

🤖 For AI Agents & LLM Apps

Compact reference for AI agents calling this actor via the Apify MCP server or the Apify API (actor: memo23/virtuals-cheerio).

Purpose: Scrape agent and token data from Virtuals.io — name, role, token address, market cap, ascension progress, and description for either Sentient or Prototype agents.

Minimal input:

{ "agents": "sentient", "maxItems": 50 }

Output: one dataset row per agent — name, role, preToken, createdAt, holders, marketCap {rawValue, formatted, isUndergrad, preTokenPair, calculationSteps}, ascensionProgress {tokenReserves, virtualReserves, progress, formattedProgress, priceInVirtual}, description, link.

Behaviors an agent should know:

• agents is required and selects the universe scraped: sentient or prototype — the two are separate agent sets, run once per type.
• Always set maxItems to cap output; it defaults to 10000.
• storeName names a Key-Value Store for deduplication and long-term retention across runs (lowercase letters, digits, and internal hyphens only); leave blank for default storage.
• maxConcurrency, minConcurrency, and maxRequestRetries tune throughput and retry behavior.
• proxy defaults to Apify Residential proxy.
• Pay-per-event billing — see the Pricing tab on the actor page.

⚠️ Disclaimer

This Actor is an independent tool and is not affiliated with, endorsed by, or sponsored by Virtuals Protocol (the operator of virtuals.io) or any of its affiliates. All trademarks mentioned are the property of their respective owners.

The scraper accesses only publicly available agent and token pages on virtuals.io — no authenticated endpoints, paid features, or content behind a login wall. Users are responsible for ensuring their use complies with virtuals.io's Terms of Service, applicable data-protection law (GDPR, CCPA, etc.), and any contractual obligations of their own organization.

SEO Keywords

Virtuals scraper, scrape Virtuals.io, Virtuals.io scraper, Virtuals API, Apify Virtuals, crypto agent scraper, AI agent token scraper, tokenomics scraper, agent market cap data, token holder data, crypto analytics export, web3 data scraper, defi analytics, AI agent economy data, sentient agents data, prototype agents scraper, virtual token intelligence, crypto research data