Signal

Activity feed

Changed on

Chronological event stream across all tracked accounts, newest first: new_follow and convergence events with classification on the target, filterable by event type, sector, and time window. Costs 16 credits. Good for polling-based monitoring; for push delivery of the same events register a webhook via POST /webhooks instead.

get/feed

Request

  • Base URL: https://frontrun.vc/v1
  • URL: https://frontrun.vc/v1/feed
  • Auth: API key in header X-API-Key

Query parameters

event_type'new_follow' | 'convergence'

Filter to a single event type.

sincestring
Example:24h

Time window: relative ("24h", "7d") or absolute date ("YYYY-MM-DD"). Default "24h".

hoursinteger

Alternative to since - window size in hours (e.g. hours=48 equals since=48h).

sectorstring

Filter events by classified sector (substring match).

limitinteger

Maximum results to return (default 50, max 200).

offsetinteger

Pagination offset over the sorted event list (default 0).

cursorstring
Example:frc1_eyJ2IjoxLCJzIjoiOWY0YyIsImQiOiIyMDI2LTA4LTA3In0.Xq9

Opaque watermark from a previous response's next_cursor. Resumes exactly where that run stopped, so a scheduled job that retries neither double counts nor drops records. Overrides since when present. Cursors are signed and scoped to the endpoint, API key and filters; a modified or cross-scope cursor returns 400 with error_code invalid_cursor. Persist next_cursor only AFTER you have processed the response.

scopestring
Example:tracked

Whose follows to read: tracked (default, your tracked accounts), network (the whole Frontrun network; paid Pro and Enterprise) or list:<id> (one of your lists, with its sectors). See /docs/reference/scopes.

Response

Feed events, newest first.

sincestring date-time
totalinteger
returnedinteger
cost_creditsinteger

Credits charged for this call.

balance_creditsinteger

Remaining credit balance after this call.

offsetinteger
has_moreboolean
next_cursorstring nullable

Opaque cursor for the next run. Null while has_more is true, by design, not an error: the cursor marks the end of the whole matched window, so it is issued on the final page only. Call again with offset set to next_offset until has_more is false, then take next_cursor from that final page.

next_offsetinteger

Present while has_more is true: the offset value for the next page of this window (offset + returned).

next_cursor_notestring
cursor_notestring

Changes