GET
Stream rug flags (server-sent events)

Authorizations

Authorization
string
header
required

The streaming endpoints additionally accept ?token= for clients that cannot set headers, such as a browser WebSocket. Mint a separate token for that: a credential in a URL reaches access logs, proxies and browser history.

Headers

Last-Event-ID
string

Sent automatically by EventSource on reconnect. Treated identically to since.

Query Parameters

chains
string

Comma-separated chain names, or all. Omit for every chain. Unknown names are reported in the welcome event rather than silently dropped.

since
integer

Resume after this sequence number. The replay window is bounded; a range already discarded is reported as a gap in the welcome event.

token
string

Bearer token, for clients that cannot set headers. The Authorization header is checked first and always wins; prefer it.

Response

The stream is open. Body is text/event-stream and does not terminate.

One event's data: payload. Chain-scoped events also carry chain.

seq
integer

Monotonic. Pass the last one you saw back as since to resume.

type
enum<string>
Available options:
welcome,
rug_flag,
subscribed,
heartbeat,
lag,
error
ts
number
chain
string
address
string
score
number
model_version
string
first_seen
boolean

False means an existing flag was re-scored rather than a new wallet flagged.

top_evidence
object | null