# Virtuals Protocol AI Agent Token Market Data

> Virtuals Protocol AI Agent Token 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-01).

Search, filter, and rank AI agent tokens on Virtuals Protocol (Base and Solana) by market cap, volume, gainers/losers, newest launches, or holders, returning live market metrics per token.

## Facts

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

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 virtuals-protocol-ai-agent-token-market-data-a4ebbd35 -d '<json body>'
```

Example prompt: Show me the top 10 AI agent tokens on Virtuals Protocol ranked by market cap — include their 24h change, volume, holders, and which chain they're on.

## When to prefer this

Use this endpoint when you need live, ranked, or searchable market data specifically for AI agent tokens on Virtuals Protocol (Base or Solana). Prefer it over general crypto market APIs when the user is focused on the Virtuals ecosystem, wants agent-specific metadata (category, holder count, chain), or needs rankings like top gainers, losers, newest launches, or highest volume within that protocol.

## Known failure modes

- Invalid 'orden' value returns an error or empty result
- Search term matches no agents, returning empty agentes array
- Limit out of range (outside 1-50) causes validation error
- Virtuals API upstream downtime causes delayed or failed response
- Requesting inactive agents with solo_activos=false may return stale data

## How this service works

AI agent tokens on Virtuals Protocol (Base and Solana): search by name/symbol/category, or rank by market cap, 24h volume, top gainers/losers, newest launches or holders. Returns market cap, 24h change, volume, holders, category, chain and contract. Live from the Virtuals API.

## Output

Returns a list of AI agent tokens matching the query, each with name, symbol, contract address, chain (Base or Solana), category, verification status, market cap in VIRTUAL, 24h percentage change, 24h volume in USD, and holder count, plus metadata like sort order, source, and total found count.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method",
    "bodyType",
    "body"
   ],
   "properties": {
    "body": {
     "required": [],
     "properties": {
      "orden": {
       "enum": [
        "mcap",
        "volumen",
        "suben",
        "bajan",
        "nuevos",
        "holders"
       ],
       "type": "string",
       "description": "Ranking"
      },
      "buscar": {
       "type": "string",
       "description": "Filter by name, symbol or category"
      },
      "limite": {
       "type": "integer",
       "maximum": 50,
       "minimum": 1,
       "description": "Results (1-50, default 20)"
      },
      "solo_activos": {
       "type": "boolean",
       "description": "Only launched/tradeable agents (default true)"
      }
     }
    },
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "POST"
     ],
     "type": "string"
    },
    "bodyType": {
     "enum": [
      "json",
      "form-data",
      "text"
     ],
     "type": "string"
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": [
      "object",
      "null"
     ],
     "properties": {
      "nota": {
       "type": [
        "string",
        "null"
       ]
      },
      "orden": {
       "type": [
        "string",
        "null"
       ]
      },
      "fuente": {
       "type": [
        "string",
        "null"
       ]
      },
      "agentes": {
       "type": [
        "array",
        "null"
       ],
       "items": {
        "type": [
         "null",
         "object"
        ],
        "properties": {
         "red": {
          "type": [
           "null",
           "string"
          ]
         },
         "estado": {
          "type": [
           "null",
           "string"
          ]
         },
         "nombre": {
          "type": [
           "null",
           "string"
          ]
         },
         "holders": {
          "type": [
           "null",
           "number"
          ]
         },
         "simbolo": {
          "type": [
           "null",
           "string"
          ]
         },
         "contrato": {
          "type": [
           "null",
           "string"
       
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/virtuals-protocol-ai-agent-token-market-data-a4ebbd35/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)