Real-time Virtuals protocol project search with sorting by TVL, volume, holders, and FDV via x402 payment.
What it does
Virtuals Agent is an AI-powered project search assistant hosted on Questflow that provides real-time data queries for projects built on the Virtuals protocol. It accepts natural-language queries via a simple POST endpoint and returns text responses covering project search results, Genesis project tracking, and multi-dimensional sorting by metrics such as TVL, 24-hour trading volume, holder count, and fully diluted valuation (FDV).
The endpoint is gated by the x402 payment protocol on the Base network. Each request costs up to 100,000 units of USDC (0x8335…2913 on Base), paid via the X-PAYMENT header. The agent accepts a single required field — `input` (a string message) — and returns a `response` string. The maximum timeout per request is 1,200 seconds, reflecting that the agent may perform live data lookups before responding.
No OpenAPI spec, dedicated docs page, or usage examples are published by the provider. The output schema is minimal (free-text string in, free-text string out), so callers should expect unstructured natural-language answers rather than machine-parseable JSON data. Questflow is the hosting platform; the agent itself is identified by the QRN `qrn:agent:687e2a4457b6ecbe004244af`.
Capabilities
Use cases
- —Query real-time TVL, volume, and holder data for Virtuals protocol projects
- —Track Genesis project launches and sort by key financial metrics
- —Ask natural-language questions about AI Agent token prices and trading activity
- —Compare Virtuals ecosystem projects by FDV or 24h volume
- —Screen for high-potential AI Agent investment opportunities on Virtuals
Fit
Best for
- —Crypto researchers tracking the Virtuals protocol ecosystem
- —AI agents that need on-demand Virtuals project data via x402
- —Traders screening AI Agent tokens by TVL, volume, or holder count
Not for
- —Users needing structured JSON data responses (output is free-text only)
- —Querying non-Virtuals protocol projects or general crypto market data
- —Low-latency applications (timeout up to 1200 seconds)
Quick start
curl -X POST https://api.questflow.ai/x402/agent/qrn:agent:687e2a4457b6ecbe004244af \
-H "Content-Type: application/json" \
-H "X-PAYMENT: <x402_payment_token>" \
-d '{"input": "Show me the top 5 Virtuals projects by TVL"}'Example
Request
{
"input": "Show me the top 5 Virtuals projects sorted by 24h volume"
}Response
{
"response": "Here are the top 5 Virtuals protocol projects by 24h trading volume:\n1. ProjectA — $12.4M volume, TVL $8.2M, 3,200 holders\n2. ProjectB — $9.1M volume, TVL $5.7M, 2,800 holders\n3. ProjectC — $7.6M volume, TVL $4.1M, 1,950 holders\n4. ProjectD — $5.3M volume, TVL $3.8M, 1,400 holders\n5. ProjectE — $3.9M volume, TVL $2.5M, 980 holders"
}Endpoint
Quality
No OpenAPI spec, no dedicated documentation, no usage examples, and no pricing page exist. The only schema information comes from the x402 challenge payload, which describes a minimal text-in/text-out interface. Response format and actual data coverage are entirely inferred from the description string.
Warnings
- —No OpenAPI or formal API documentation available — schema inferred solely from x402 challenge
- —Output is unstructured natural-language text; no guaranteed machine-parseable format
- —maxAmountRequired is 100000 USDC units — verify decimal precision (likely 0.10 USDC given 6-decimal USDC on Base, but unconfirmed)
- —Maximum timeout of 1200 seconds suggests potentially slow responses
- —Example response is fabricated for illustration; actual output format is unknown
- —Covers only Virtuals protocol projects — not a general crypto data API
Citations
- —Endpoint is x402-gated on Base network, paying to 0x849Dbd04451FB43B5caf40777E64025A3ff1eF85 in USDC (0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913) with maxAmountRequired 100000https://api.questflow.ai/x402/agent/qrn:agent:687e2a4457b6ecbe004244af
- —Input schema requires a single 'input' string field; output returns a 'response' string fieldhttps://api.questflow.ai/x402/agent/qrn:agent:687e2a4457b6ecbe004244af
- —Agent supports project search and Genesis project tracking with multi-dimensional sorting by TVL, 24h volume, holder count, FDVhttps://api.questflow.ai/x402/agent/qrn:agent:687e2a4457b6ecbe004244af
- —maxTimeoutSeconds is 1200https://api.questflow.ai/x402/agent/qrn:agent:687e2a4457b6ecbe004244af
- —Questflow is the hosting platform for this agenthttps://api.questflow.ai