Codex
Codex is a blockchain data API for real-time and historical DeFi data. Linea is fully supported. All Codex data primitives (tokens, prices, charts, holders, wallets, trades, and live subscriptions) are available for Linea, backed by indexing 80+ million tokens, 700 million wallets, and 28 billion transactions across 80+ networks.
What you can do
All of Codex's token endpoints are available for Linea, allowing applications to:
- Discover tokens: filter and search Linea tokens by liquidity, market cap, age, volume, holder count, and other metrics.
- Read prices and charts: real-time and historical prices, plus OHLCV candlestick data for any Linea token across any timeframe.
- Look up holders and balances: holder counts, top-holder distribution, and token balances for any Linea wallet.
- Query DEX trades and pairs: swap events and token pair data across Linea DEXs.
- Stream live updates: WebSocket subscriptions for price ticks, trades, and pair events on Linea tokens as they happen.
For a comprehensive list of endpoints available for Linea, see the Codex Linea reference.
Quick example
Fetch the top 10 Linea tokens by 24-hour trading volume, with price, market cap, liquidity, and holder metrics:
import { Codex } from "@codex-data/sdk";
const sdk = new Codex("YOUR_API_KEY");
const { filterTokens } = await sdk.queries.filterTokens({
filters: {
network: [59144], // Linea's network ID
liquidity: { gt: 10000 },
},
rankings: [{ attribute: "volume24", direction: "DESC" }],
limit: 10,
});
for (const result of filterTokens.results ?? []) {
console.log({
name: result.token.name,
symbol: result.token.symbol,
address: result.token.address,
priceUSD: result.priceUSD,
volume24: result.volume24,
liquidity: result.liquidity,
marketCap: result.marketCap,
holders: result.holders,
});
}
The same query as a raw GraphQL request:
curl -X POST https://graph.codex.io/graphql \
-H "Content-Type: application/json" \
-H "Authorization: YOUR_API_KEY" \
-d '{
"query": "query { filterTokens(filters: { network: [59144], liquidity: { gt: 10000 } }, rankings: [{ attribute: volume24, direction: DESC }], limit: 10) { results { token { name symbol address } priceUSD volume24 liquidity marketCap holders } } }"
}'
Integrating Codex
Codex exposes one GraphQL endpoint with several access modes. Pick the one that fits your delivery needs.
GraphQL endpoint
All queries and mutations are issued as HTTPS POST to https://graph.codex.io/graphql. 65 query operations cover every data category listed above.
TypeScript SDK
The @codex-data/sdk package is a thin wrapper around the GraphQL API with typed queries, mutations, and built-in subscription handling.
npm install @codex-data/sdk
WebSocket subscriptions
24 real-time streams are available over wss://graph.codex.io/graphql, including price updates, chart data, trade events, new and updated DEX pairs, and wallet activity.
Webhooks
For push-based delivery without a persistent WebSocket, Codex webhooks POST onchain events to your server as they occur.
Resources
- Sign up for free - 10,000 requests/month on the free plan
- Linea reference - Linea-specific endpoint coverage
- Full API documentation
- GraphQL Explorer — interactively build and test queries
- Recipes and guides
- GitHub
- Discord