API

Main.net API

The Main.net API is a static, source-cited contract for chain settings, RPC references, launch source records, category pages, glossary terms, source links, review freshness data, and CSV snapshots.

Version v1

Schema 1.0.0

Endpoints 17

Updated June 10, 2026

Endpoints

/api/v1/chains.json Source-cited chain metadata, decimal and hex chain IDs, copy-ready config JSON, canonical status URLs, legacy helper redirects, RPC URLs, explorers, review dates, safety notes, and chain ID probe evidence. chains 58

/api/v1/chains.csv CSV snapshot of source-cited chain metadata for spreadsheets and lightweight scripts. chains-csv 58

/api/v1/launches.json Source-cited launch source records with primary source links and no stage labels. launches 2

/api/v1/categories.json Network category records and the chain IDs grouped under each category. network-categories 5

/api/v1/glossary.json Short mainnet, RPC endpoint, and chain ID definitions with related guide URLs. glossary 9

/api/v1/gas-tokens.json Gas token groups derived from reviewed chain metadata. gas-tokens 39

/api/v1/explorers.json Block explorer hostnames and chain contexts from reviewed chain metadata. explorers 58

/api/v1/search-index.json Static discovery index for chain, RPC, guide, launch, glossary, explorer, and gas-token pages. search-index 369

/api/v1/review-queue.json Operator-facing freshness queue for monthly chain metadata reviews. review-queue 58

/api/v1/sources.json Deduplicated public source registry with chain and launch page contexts. sources 108

/api/v1/source-hashes.json Operator-generated source URL hash snapshot for deterministic change detection. source-hashes 108

/api/v1/source-changes.json Operator-generated source URL changes compared with the previous hash artifact. source-changes 58

/api/v1/rpc-probes.json Operator-generated eth_chainId probe snapshot for EVM-style public RPC endpoints. rpc-probes 57

/api/v1/ai-source-extractions.json Report-only AI source extraction artifact for changed source URLs. It does not edit reviewed chain metadata. ai-source-extractions 8

/api/v1/ai-candidate-drafts.json Report-only AI candidate draft artifact for operator review. It does not publish candidate chains. ai-candidate-drafts 5

/api/v1/upstream-reconciliation.json Operator-only upstream registry comparison artifact. Differences are factual observations, not judgments about source quality. upstream-reconciliation 58

/api/v1/openapi.json OpenAPI 3.1 description for the stable static API surface. openapi 1

Usage boundary

Main.net API v1 is a static, source-cited reference API generated at build time.
The API does not publish live uptime, latency, block lag, price, TVL, or investment advice.
Public RPC endpoints are convenience references and should be verified against linked sources before production use.
Use chain urls.canonical, urls.rpcSection, and urls.chainIdSection for crawlable pages; urls.legacyRedirects preserves old helper URLs as redirects.
This API is read-only and does not connect wallets, submit transactions, bridge funds, rank tokens, or recommend investments.

For AI agents and scripts

Start with /api/v1/index.json for endpoint discovery, /api/v1/openapi.json for the OpenAPI description, and /llms.txt for crawler context. Use /api/v1/chains.csv when a spreadsheet-friendly chain snapshot is enough.

Minimal JavaScript lookup

Chain records include decimal and hex chain IDs, source links, copy-ready config, and EIP-3085-shaped JSON for EVM rows. Treat public RPC values as references, not uptime guarantees.

const response = await fetch('https://main.net/api/v1/chains.json')
const payload = await response.json()
const base = payload.chains.find((chain) => chain.id === 'base')

console.log(base.chainId)          // "8453"
console.log(base.chainIdHex)       // "0x2105"
console.log(base.eip3085Config)    // wallet_addEthereumChain-shaped JSON