Farbeam
Docs / API: Transfers

Live stream

Opens a Server-Sent Events stream of new transfers and blocks. This path is outside /api/v1.

GET/api/live
PropertyValue
AuthenticationNot needed.
Rate-limit cost0 units
StatusLive

#Request

curl -N "https://farbeamlabs.com/api/live"
const stream = new EventSource("https://farbeamlabs.com/api/live");
stream.addEventListener("transfer", (m) => console.log(JSON.parse(m.data)));
stream.addEventListener("block", (m) => console.log(JSON.parse(m.data)));
import json, requests

with requests.get("https://farbeamlabs.com/api/live", stream=True, timeout=60) as r:
    for line in r.iter_lines(decode_unicode=True):
        if line.startswith("data: "):
            print(json.loads(line[6:]))

#Events

Text
event: transfer
data: {"id":123,"chain":"ethereum","token":"USDT","usd":250000.5,...}

event: block
data: {"chain":"base","number":53514841,"ts":1793819159000,"txs":294}

#Notes

  • Each network can hold 6 open streams.
  • The server sends a comment line every 25 seconds to keep the connection open.
  • There is no replay. After a reconnect, fill the gap with List large transfers.