---
title: "Convergence detection"
method: GET
path: "/convergence"
tags: ["Signal"]
---

# Convergence detection

`GET /convergence`

## Request

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

Detect startups that 2 or more of your tracked accounts (`threshold`, default 2) followed independently within a time window. Startups only: A result is kept only if our curated companies table marks it a company, its entity type is company, project, protocol or product, and it has at most 25,000 X followers (the same ceiling the daily reports use). People, investors, VC firms, media, organizations, public companies and big established brands are left out, as is anything not yet classified. Results are ranked by how many tracked accounts converged (`followed_by`). Costs 60 credits; zero convergences cost 0 credits. `threshold` (alias `min_accounts`) sets the minimum converging accounts; use 3+ for high conviction. Default window is 7d when since is omitted. Typical chain: /convergence, then /company/{handle} and /company/{handle}/founders on the hits.

## Query parameters

- `threshold` integer
- `since` string
- `hours` integer
- `limit` integer
- `scope` string

## Response `200`

Convergence results ranked by follower count.

- object
  - `threshold` integer
  - `since` string, date-time
  - `limit` integer
  - `total` integer: Total entities matching the threshold.
  - `returned` integer
  - `convergences` object[]
    - `twitter_user_id` string
    - `username` string
    - `name` string
    - `description` string
    - `followed_by` string[]: Tracked accounts that followed this entity in the window.
  - `cost_credits` integer: Credits charged for this call.
  - `balance_credits` integer: Remaining credit balance after this call.

## 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/convergence/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)