---
title: "Activity feed"
method: GET
path: "/feed"
tags: ["Signal"]
---

# Activity feed

`GET /feed`

## Request

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

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.

## Query parameters

- `event_type` 'new_follow' | 'convergence'
- `since` string
- `hours` integer
- `sector` string
- `limit` integer
- `offset` integer
- `cursor` string
- `scope` string

## Response `200`

Feed events, newest first.

- object
  - `since` string, date-time
  - `total` integer
  - `returned` integer
  - `events` object[]
    - `type` 'new_follow' | 'convergence'
    - `timestamp` string, date-time
    - `vc` object: Present on new_follow events.
      - `handle` string
    - `accounts` string[]: Present on convergence events - tracked accounts that converged.
    - `target` object
      - `handle` string
      - `name` string
      - `classification` Classification: AI classification of the entity.
        - `is_company` boolean: Whether the entity is classified as a company.
        - `confidence` string: Classification confidence.
        - `sector` string: Primary sector (e.g. "AI/ML", "DeFi").
        - `entity_type` string: Entity type (e.g. "startup", "investor").
    - `signal_strength` number: Present on convergence events - 0 to 1.
  - `filter` object
    - `event_type` string
    - `sector` string
  - `cost_credits` integer: Credits charged for this call.
  - `balance_credits` integer: Remaining credit balance after this call.
  - `offset` integer
  - `has_more` boolean
  - `next_cursor` string, 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_offset` integer: Present while has_more is true: the offset value for the next page of this window (offset + returned).
  - `next_cursor_note` string
  - `cursor_note` string

## Other responses

- `401`: Missing, invalid, inactive, or expired API key.
- `402`: Insufficient credits for this operation. Top up from the developer page or enable auto-refill.
- `429`: Rate limit or daily credit cap reached. Retry after the indicated reset time.

## Changes

- **2026-10-19** `6880b29e94c9`: 1 info
  - added the new optional `query` request parameter `scope`

[Operation history](https://skmtc.dev/frontrun/apis/frontrun-api/changes/feed/get.md)

---

[API](https://skmtc.dev/frontrun/apis/frontrun-api.md) · [All operations](https://skmtc.dev/frontrun/apis/frontrun-api/llms.txt) · [OpenAPI document](https://skmtc.dev/frontrun/apis/frontrun-api/revisions/6880b29e94c9?raw)