# ChainList API

> Free, open-source REST API for blockchain chain information. Access data for 2,400+ EVM networks including chain IDs, RPC endpoints, native currencies, icons, and TVL rankings. No API keys required.

ChainList API is built on Cloudflare Workers with a D1 database, updated daily from chainlist.org. All endpoints return JSON. CORS is enabled for all origins.

Base URL: https://chainlistapi.com

## Docs

- [Full API Documentation](https://chainlistapi.com/llms-full.txt): Complete API reference with all endpoints, parameters, response schemas, and code examples in a single file
- [OpenAPI Specification](https://chainlistapi.com/openapi.json): Machine-readable OpenAPI 3.1 spec for all endpoints
- [Getting Started Guide](https://chainlistapi.com/docs/getting-started): Quick start guide with examples in JavaScript, Python, and curl
- [API Reference](https://chainlistapi.com/docs/api-reference): Endpoint documentation with parameter tables

## API Endpoints

- [GET /chains/{chainId}](https://chainlistapi.com/chains/1): Get a specific chain by ID - returns name, RPC URLs, native currency, explorers, icon, TVL
- [GET /chains/search?q={query}](https://chainlistapi.com/chains/search?q=ethereum): Search chains by name, symbol, or chain ID
- [GET /chains/all](https://chainlistapi.com/chains/all): List all chains with pagination, sorted by TVL. Filters: testnet, isDead
- [GET /icons/{name}](https://chainlistapi.com/icons/ethereum.svg): Get chain icon in SVG or PNG format (1,800+ icons available)
- [GET /stats](https://chainlistapi.com/stats): API statistics - total chains, mainnet/testnet counts, top chains by TVL

## Webhooks

- [Webhook Subscriptions](https://chainlistapi.com/webhooks): Subscribe to real-time notifications for new_chain and chain_change events (requires B3 wallet authentication)

## Optional

- [Source Code](https://github.com/b3-fun/chain-api): Open-source on GitHub
- [Changelog](https://chainlistapi.com/changelog): Recent chain additions and changes
- [Chain Launches](https://chainlistapi.com/launches): Featured chain launch announcements