Freshness

Data reaches you through three kinds of path: direct database reads, in-memory poller state, and cached calls to public sources. This page lists how old a response can be on each endpoint.

#By endpoint

#Inside a token report

A report combines calls with different cache times. The sources[] array shows each call, and a ms near 0 usually means a cache hit.

total_supply on EVM can therefore be up to 24 hours old. Do not use it for a live market cap.

#How the cache behaves

• It is in process memory. A restart empties it.
• Concurrent requests for the same key share one upstream call.
• A failed call is not cached, so the next request tries again.
• An empty GoPlus result is not cached. It counts as a failed source, and the next read tries again.
• Expired values are not served. If the source then fails, you get 502 or unknown, not old data.
• GET /prices is the exception. The poller keeps the last good prices when a refresh fails, so valuation continues with an older price.

#Poll cycle by chain

A poll cycle is the wait in indexing plus the RPC time. These figures come from the spacing of real blocks read on 2026-11-04 UTC.

These figures are a measurement and not a promise. Farbeam publishes no latency target.

#Measuring age yourself

#Stale copies

If every source fails, four endpoints answer with the last saved copy: Wallet overview, Token report, Stablecoin supply and DEX volume. Each of those answers holds data.stale and data.as_of.

Saved copies are kept for 7 days. With no copy, the answer is 502 upstream_unavailable. Read data.stale before you act on a value.

#Comparing times

For a stored transfer, compare ts with meta.as_of. For the head of a chain, read head_age_seconds from /status.

curl -s "https://farbeamlabs.com/api/v1/status" | jq '.data.chains[] | {chain, status, head_age_seconds, last_ok}'

const res = await fetch("https://farbeamlabs.com/api/v1/status");
const { data } = await res.json();
for (const c of data.chains) console.log(c.chain, c.status, c.head_age_seconds, c.last_ok);

import requests

data = requests.get("https://farbeamlabs.com/api/v1/status", timeout=30).json()["data"]
for c in data["chains"]:
    print(c["chain"], c["status"], c["head_age_seconds"], c["last_ok"])

#Polling advice

Polling faster than the cache time returns the same values and still costs units. Poll token reports no more than once per minute for market fields, and once per 5 minutes for checks. For new transfers, use the stream or a webhook.