{
  "api": "mainnet-reference-api",
  "version": "v1",
  "schema_version": "1.0.0",
  "status": "stable-static",
  "dataset": "index",
  "updated": "April 30, 2026",
  "mode": "static-source-cited",
  "notes": [
    "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."
  ],
  "endpoints": [
    {
      "path": "/api/v1/chains.json",
      "dataset": "chains",
      "count": 26,
      "description": "Source-cited chain metadata, RPC URLs, explorers, review dates, and safety notes."
    },
    {
      "path": "/api/v1/launches.json",
      "dataset": "launches",
      "count": 4,
      "description": "Source-cited launch records with primary source links."
    },
    {
      "path": "/api/v1/categories.json",
      "dataset": "network-categories",
      "count": 5,
      "description": "Network category records and the chain IDs grouped under each category."
    },
    {
      "path": "/api/v1/glossary.json",
      "dataset": "glossary",
      "count": 9,
      "description": "Short mainnet, RPC endpoint, and chain ID definitions with related guide URLs."
    },
    {
      "path": "/api/v1/gas-tokens.json",
      "dataset": "gas-tokens",
      "count": 13,
      "description": "Gas token groups derived from reviewed chain metadata."
    },
    {
      "path": "/api/v1/explorers.json",
      "dataset": "explorers",
      "count": 26,
      "description": "Block explorer hostnames and chain contexts from reviewed chain metadata."
    },
    {
      "path": "/api/v1/search-index.json",
      "dataset": "search-index",
      "count": 174,
      "description": "Static discovery index for chain, RPC, guide, launch, glossary, explorer, and gas-token pages."
    },
    {
      "path": "/api/v1/review-queue.json",
      "dataset": "review-queue",
      "count": 26,
      "description": "Operator-facing freshness queue for monthly chain metadata reviews."
    },
    {
      "path": "/api/v1/sources.json",
      "dataset": "sources",
      "count": 52,
      "description": "Deduplicated public source registry with chain and launch page contexts."
    },
    {
      "path": "/api/v1/source-hashes.json",
      "dataset": "source-hashes",
      "count": 52,
      "description": "Operator-generated source URL hash snapshot for deterministic change detection."
    },
    {
      "path": "/api/v1/source-changes.json",
      "dataset": "source-changes",
      "count": 52,
      "description": "Operator-generated source URL changes compared with the previous hash artifact."
    },
    {
      "path": "/api/v1/rpc-probes.json",
      "dataset": "rpc-probes",
      "count": 25,
      "description": "Operator-generated eth_chainId probe snapshot for EVM-style public RPC endpoints."
    },
    {
      "path": "/api/v1/openapi.json",
      "dataset": "openapi",
      "count": 1,
      "description": "OpenAPI 3.1 description for the stable static API surface."
    }
  ],
  "future": {
    "mcpServer": "Planned read-only wrapper over this versioned API.",
    "rpcIdentityProbe": "Operator-only today; not published as API status data."
  }
}