> ## Documentation Index
> Fetch the complete documentation index at: https://docs.codex.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Virtuals API

> Track Virtuals token launches in real-time with the Codex API. Get launch data, trading activity, and live WebSocket updates.

AI agent token platform on Base, enabling the creation and trading of tokens representing AI agents. Codex provides full coverage of Virtuals token launches and market data.

## Network Information

| Property              | Value        |
| --------------------- | ------------ |
| Network               | Base         |
| Chain ID              | `8453`       |
| Protocol Filter       | `Virtuals`   |
| Launchpad Name Filter | `"Virtuals"` |

<Tip>
  Filter queries to Virtuals tokens using `launchpadName: "Virtuals"` in [`filterTokens`](/api-reference/queries/filtertokens) or `protocol: Virtuals` in subscriptions.
</Tip>

## Token Lifecycle

Virtuals tokens are created as standard DEX pairs without bonding curve mechanics. Tokens are tradeable immediately upon launch.

<Note>
  Virtuals does not use bonding curves. Fields like `graduationPercent`, `completed`, and `migrated` will not be populated for these tokens.
</Note>

## Supported APIs

### Launchpad API

* [Get Newly Created Virtuals Tokens](/api-reference/queries/filtertokens) — Find the latest token launches on Virtuals

### Real-time API

* [Subscribe to All Virtuals Token Events](/api-reference/subscriptions/onlaunchpadtokeneventbatch) — Stream real-time launch events and trades
* [Subscribe to Individual Virtuals Token Events](/api-reference/subscriptions/onlaunchpadtokenevent) — Track events for a specific token

<Warning>
  Launchpad events are extremely high-frequency and will send a large number of requests. We offer a monthly flat-rate option with unlimited requests for this subscription. [Contact us](mailto:hello@codex.io?subject=Launchpad%20Events%20Subscription) for more information.
</Warning>

### Trading & Market Data API

* [Get Trading Events for Virtuals Tokens](/api-reference/queries/gettokenevents) — Query swap events and trading history
* [Get Detailed Statistics for Virtuals Tokens](/api-reference/queries/filtertokens) — Retrieve volume, buys/sells, and market metrics
* [Get Token Holders for Virtuals Tokens](/api-reference/queries/holders) — Query token holder data and balances

## Try It in the Explorer

Test any Virtuals query directly in the [Codex GraphQL Explorer](/explore).

## Related Resources

* [Launchpads Recipe](/recipes/launchpads) — Build a launchpad dashboard
* [Supported Networks Overview](/networks) — All supported networks