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

# Ethereum API

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

Ethereum is the original smart contract platform and the most liquid, established DeFi ecosystem in crypto. Codex indexes 10M+ tokens across thousands of DEXes on Ethereum mainnet, giving you comprehensive access to token prices, trading pairs, wallet activity, and real-time event streams.

## Supported Networks

| Network          | Chain ID   | Status |
| ---------------- | ---------- | ------ |
| Ethereum Mainnet | `1`        | Live   |
| Ethereum Sepolia | `11155111` | Live   |

<Tip>
  Filter queries to Ethereum by passing `network: 1`.
</Tip>

## Supported APIs

### Token API

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

### Pair & Trading API

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

### Wallet API

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

### Real-time WebSocket API

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

## Try It in the Explorer

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