# Vextorium Virtuals Protocol AI Agents Market Data

> Vextorium Virtuals Protocol AI Agents Market Data is a paid API for AI agents from api.vextorium.com, paid per call via x402, $0.005/call, status unknown (last checked 2026-10-19).

Returns ranked, filterable list of AI agent tokens from the Virtuals Protocol ecosystem with market cap, volume, holders, and 24h price change data.

## Facts

- Endpoint: POST https://api.vextorium.com/v1/virtuals-agents?utm_source=zero.xyz
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-19
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/vextorium-virtuals-protocol-ai-agents-market-data-20f309b0
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_LFetao54IOauN8Exrcmas

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability vextorium-virtuals-protocol-ai-agents-market-data-20f309b0 -d '<json body>'
```

Example prompt: Show me the top 10 AI agent tokens on Virtuals Protocol ranked by market cap, including only active ones.

## When to prefer this

Use this endpoint when you need ranked, real-time market data specifically for AI agent tokens on the Virtuals Protocol ecosystem — including market cap, volume, holder counts, and price movements. Prefer this over generic DeFi price APIs when the user is specifically interested in the Virtuals/AI-agent token narrative or needs category/status filtering unique to the Virtuals Protocol directory.

## Known failure modes

- Invalid order enum value returns validation error
- limit out of range (outside 1-50) returns error
- No agents match search filter returns empty agents array with found:0
- Upstream Virtuals Protocol API unavailability causes fetch failure
- Malformed body or missing required fields returns schema validation error

## How this service works

558 pay-per-call data APIs for AI agents: Solana and EVM on-chain data, tokenized stocks, DeFi, Hyperliquid, economy and official statistics, FX, validation, web and developer tools. Pay in USDC via x402.

## Output

A JSON object containing a ranked list of up to 50 Virtuals Protocol AI agent tokens, each with name, symbol, contract address, network, category, holder count, 24h price change percentage, 24h volume in USD, market cap in VIRTUAL tokens, verification status, and trading status. Also includes total count found, the applied ranking order, a data source attribution, and a volatility disclaimer note.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "limit": {
   "type": "integer",
   "maximum": 50,
   "minimum": 1,
   "description": "Results (1-50, default 20)"
  },
  "order": {
   "enum": [
    "mcap",
    "volume",
    "gainers",
    "losers",
    "new",
    "holders"
   ],
   "type": "string",
   "description": "Ranking"
  },
  "search": {
   "type": "string",
   "description": "Filter by name, symbol or category"
  },
  "only_active": {
   "type": "boolean",
   "description": "Only launched/tradeable agents (default true)"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "note": "Market cap and volume in Virtuals units ($VIRTUAL). Very volatile narrative; not investment advice.",
  "found": 100,
  "order": "mcap",
  "agents": [
   {
    "name": "Ribbita",
    "status": "AVAILABLE",
    "symbol": "TIBBIR",
    "holders": 80925,
    "network": "BASE",
    "category": "IP MIRROR",
    "contract": "0xA4A2E2ca3fBfE21aed83471D28b6f65A233C6e00",
    "verified": null,
    "change_24h_pct": -7.57,
    "volume_24h_usd": 12154769,
    "mcap_in_virtual": 376634530
   },
   {
    "name": "Toshi",
    "status": "AVAILABLE",
    "symbol": "TOSHI",
    "holders": 1088432,
    "network": "BASE",
    "category": "IP MIRROR",
    "contract": "0xAC1Bd2486aAf3B5C0fc3Fd868558b082a531B2B4",
    "verified": null,
    "change_24h_pct": 5.13,
    "volume_24h_usd": 300072,
    "mcap_in_virtual": 67883232
   }
  ],
  "source": "Virtuals Protocol (api.virtuals.io)"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/vextorium-virtuals-protocol-ai-agents-market-data-20f309b0/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.vextorium.com](https://www.zero.xyz/host/api.vextorium.com/llms.txt)