> ## 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.

# Arc API

> Access real-time Arc token prices, trading pairs, wallet analytics, and live WebSocket subscriptions through the Codex API.

Arc is a stablecoin-native, EVM-compatible Layer 1 built by Circle for real-world financial applications, with fees paid in USDC and deterministic settlement in under a second. Codex provides full DeFi data coverage for Arc, letting you track tokens, pairs, and wallet activity in real time.

## Supported Networks

| Network     | Chain ID | Status |
| ----------- | -------- | ------ |
| Arc Mainnet | `5042`   | Live   |

<Tip>
  Filter queries to Arc by passing `network: 5042`.
</Tip>

## Supported APIs

### Token API

* [Get Token Prices on Arc](/api-reference/queries/gettokenprices) — Retrieve current USD prices for any token
* [Search and Filter Tokens on Arc](/api-reference/queries/filtertokens) — Discover trending tokens, filter by liquidity, volume, and market cap
* [Get OHLCV Chart Data on Arc](/api-reference/queries/gettokenbars) — Fetch candlestick price data for any token
* [Get Token Sparklines on Arc](/api-reference/queries/tokensparklines) — Retrieve sparkline chart data for tokens
* [Get Top Traders for a Token on Arc](/api-reference/queries/tokentoptraders) — Find the most active traders for any token

### Pair & Trading API

* [Filter Trading Pairs on Arc](/api-reference/queries/filterpairs) — Search pairs by liquidity, volume, or token
* [Get Detailed Pair Stats on Arc](/api-reference/queries/getdetailedpairstats) — Fetch comprehensive trading metrics for any pair
* [Get Token Events on Arc](/api-reference/queries/gettokenevents) — Track buys and sells in real-time
* [List Pairs for a Token on Arc](/api-reference/queries/listpairsfortoken) — Find all trading pairs for a specific token
* [Get Pair Metadata on Arc](/api-reference/queries/pairmetadata) — Retrieve metadata for any trading pair

### Wallet API

* [Get Token Holders on Arc](/api-reference/queries/holders) — Query token holders with balances
* [Get Top 10 Holder Concentration on Arc](/api-reference/queries/top10holderspercent) — Check how concentrated a token's supply is among top holders
* [Filter Wallets on Arc](/api-reference/queries/filterwallets) — Discover active traders and smart money wallets
* [Get Wallet Balances on Arc](/api-reference/queries/balances) — Retrieve token balances for any wallet

### Real-time WebSocket API

* [Subscribe to Price Updates on Arc](/api-reference/subscriptions/onpriceupdated) — Get real-time token price changes
* [Subscribe to Trade Events on Arc](/api-reference/subscriptions/oneventscreated) — Stream live swap events for any token
* [Subscribe to Chart Updates on Arc](/api-reference/subscriptions/onbarsupdated) — Get live candlestick chart data
* [Subscribe to Pair Metadata Updates on Arc](/api-reference/subscriptions/onpairmetadataupdated) — Track pair metadata changes in real-time

## Try It in the Explorer

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