Docs / API: Service
Status
Returns the live state of each chain poller and each outbound data source, measured by this service.
GET/api/v1/status
| Property | Value |
|---|---|
| Authentication | Optional. A key raises your limit. |
| Rate-limit cost | 0 units |
| Status | Live |
#Request
curl -s "https://farbeamlabs.com/api/v1/status"const res = await fetch("https://farbeamlabs.com/api/v1/status");
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/status",
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": {
"watch_list": {
"wallets": [
{
"name": "Binance",
"address": "5tzFkiKscXHK5ZXCGbXZxdw7gTjjD1mBwuoFbhUvuAi9"
},
{
"name": "Binance 2",
"address": "9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM"
}
],
"last_run": "2026-11-04T20:10:25.170Z",
"last_ok": "2026-11-04T20:10:31.948Z",
"transactions_read": 29,
"failures": 0
},
"keyed_rpc_daily_limit_reached": false,
"latest_event": {
"arbitrum": "2026-11-04T20:09:39.250Z",
"base": "2026-11-04T20:10:41.000Z",
"bnb": "2026-11-04T20:10:27.750Z",
"ethereum": "2026-11-04T20:10:35.000Z",
"solana": "2026-11-04T20:00:26.000Z"
},
"chains": [
{
"chain": "ethereum",
"name": "Ethereum",
"kind": "evm",
"head": 26343752,
"head_time": "2026-11-04T20:10:35.000Z",
"lag_seconds": 12.5,
"tx_count": 425,
"gas_used_ratio": 0.45533158333333335,
"gas_price_gwei": 0.151869504,
"base_fee_gwei": 0.151861469,
"priority_fee_microlamports": null,
"tps": null,
"rpc_latency_ms": 797,
"last_ok": "2026-11-04T20:10:48.263Z",
"consecutive_failures": 0,
"last_error": null,
"indexed_since_start": 7,
"scan_lag_blocks": 0,
"status": "ok",
"head_age_seconds": 15
},
{
"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
}
],
"sources": [
{
"name": "coingecko",
"ok": true,
"calls": 1,
"failures": 0,
"latency_ms": 940,
"last_ok": "2026-11-04T20:10:06.098Z",
"last_error_at": null,
"error": null
},
{
"name": "rpc:arbitrum:primary",
"ok": true,
"calls": 6,
"failures": 0,
"latency_ms": 828,
"last_ok": "2026-11-04T20:10:42.208Z",
"last_error_at": null,
"error": null
}
],
"measuring_since": "2026-11-04T19:03:49.590Z",
"uptime_seconds": 45
},
"meta": {
"request_id": "req_8dd2cd3cc8ba",
"as_of": "2026-11-04T20:10:50.212Z"
}
}#Fields
| Field | Type | Description |
|---|---|---|
data.chains[].status | string | ok, degraded, down or starting. See chain states. |
data.chains[].head | integer | Latest block or slot this service read. |
data.chains[].rpc_latency_ms | integer | Time of the last head read. |
data.sources[].name | string | Name of an outbound source. |
data.sources[].failures | integer | Failures since the last restart. |
data.measuring_since | string | UTC time the first sample was stored. |