Docs / API: Chains

Get a chain

Returns coverage and current state for one chain.

GET/api/v1/chains/{chain}

Property	Value
Authentication	Optional. A key raises your limit.
Rate-limit cost	1 unit
Status	Live

#Parameters

Name	In	Type	Required	Description
`chain`	path	string	Yes	One of `ethereum`, `base`, `bnb`, `arbitrum`, `optimism`, `polygon`, `solana`.

#Request

curl -s "https://farbeamlabs.com/api/v1/chains/base"

const res = await fetch("https://farbeamlabs.com/api/v1/chains/base");
const { data, meta, error } = await res.json();
if (error) throw new Error(`${error.code}: ${error.message}`);
console.log(data);

import os, requests

res = requests.get(
    "https://farbeamlabs.com/api/v1/chains/base",
    timeout=30,
)
body = res.json()
if "error" in body:
    raise RuntimeError(body["error"]["code"])
print(body["data"])

You can send this request now in the API playground.

#Response

This response is real. It was captured from the running API when this page was built. Arrays are cut to two items.

JSON

{
  "data": {
    "id": "base",
    "name": "Base",
    "family": "evm",
    "chain_id": 8453,
    "native": "ETH",
    "large_transfer_index": true,
    "native_transfers": false,
    "sampled": false,
    "poll_seconds": 16,
    "tokens": [
      {
        "symbol": "USDC",
        "address": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
        "decimals": 6
      },
      {
        "symbol": "WETH",
        "address": "0x4200000000000000000000000000000000000006",
        "decimals": 18
      }
    ],
    "status": {
      "chain": "base",
      "name": "Base",
      "kind": "evm",
      "head": 53516847,
      "head_time": "2026-11-04T20:10:41.000Z",
      "lag_seconds": 1.5,
      "tx_count": 229,
      "gas_used_ratio": 0.10656443,
      "gas_price_gwei": 0.006,
      "base_fee_gwei": 0.005,
      "priority_fee_microlamports": null,
      "tps": null,
      "rpc_latency_ms": 350,
      "last_ok": "2026-11-04T20:10:43.622Z",
      "consecutive_failures": 0,
      "last_error": null,
      "indexed_since_start": 35,
      "scan_lag_blocks": 0,
      "status": "ok",
      "head_age_seconds": 9
    }
  },
  "meta": {
    "request_id": "req_f4098963a929",
    "as_of": "2026-11-04T20:10:50.214Z"
  }
}

#Errors

HTTP	Code	Meaning
400	`invalid_chain`	The chain is unknown.

All errors share one format. See errors.

PreviousList chains NextRecent blocks