# GET /v1/convergence

> Source: https://www.frontrun.vc/docs/endpoints/convergence
> Raw markdown: https://www.frontrun.vc/raw/docs/endpoints/convergence.md
> Full docs (single file): https://www.frontrun.vc/llms-full.txt

Detect entities followed by multiple tracked accounts independently within a time window.

**Cost:** Draws on your monthly usage.

```bash
curl "https://frontrun.vc/v1/convergence?threshold=2&since=7d" \
  -H "X-API-Key: your_api_key"
```

## Startups only

Convergence returns **startups only**: accounts followed by 2 or more of your tracked accounts in the window (`threshold`, default 2) that our curated companies table marks as a company, with an entity type of company, project, protocol or product, and 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. Anything not yet classified is left out, so a startup can take a little time to appear.

For the full catalog of your companies, call [`GET /v1/companies`](/docs/endpoints/companies).

## Parameters

| Parameter | Type | Default | Description |
|-----------|------|---------|-------------|
| `threshold` | integer (query) | `2` | Minimum tracked accounts that must have followed the same entity. |
| `since` | string (query) | `"7d"` | Time window. Accepts hours (`"24h"`, `"168h"`), days (`"7d"`, `"14d"`), or ISO date. Defaults to `7d` when omitted. |

### Threshold guide

| Threshold | Signal strength | Typical use |
|-----------|----------------|-------------|
| 2 | Moderate | Broad scanning |
| 3 | Strong | High-confidence signals |
| 4+ | Very strong | Filtered to highest conviction |

## Response

```json
{
  "threshold": 2,
  "since": "2026-02-28T00:00:00.000Z",
  "total": 3,
  "usage_pct": 12,
  "usage_resets_at": "2026-11-01T00:00:00Z",
  "convergences": [
    {
      "twitter_user_id": "1111111111",
      "username": "stealth_ai_co",
      "name": "StealthAI",
      "description": "Automating enterprise workflows with LLMs",
      "followed_by": ["pmarca", "naval", "paulg"]
    },
    {
      "twitter_user_id": "3333333333",
      "username": "ledgerloop_hq",
      "name": "LedgerLoop",
      "description": "Real-time reconciliation for finance teams",
      "followed_by": ["pmarca", "naval", "paulg"]
    },
    {
      "twitter_user_id": "2222222222",
      "username": "dev_infra_xyz",
      "name": "DevInfra",
      "description": "Next-gen developer infrastructure",
      "followed_by": ["pmarca", "naval"]
    }
  ]
}
```

Results are sorted by convergence strength (most followers first).

| Field | Type | Description |
|-------|------|-------------|
| `convergences[].followed_by` | array | Tracked account usernames that recently followed this entity. Array length = convergence score. |

Every result is a startup, so there is nothing to filter out afterwards. For the full list of your companies, start from [`GET /v1/companies`](/docs/endpoints/companies).

## Example

```python
import requests

response = requests.get(
    "https://frontrun.vc/v1/convergence",
    headers={"X-API-Key": "your_api_key"},
    params={"threshold": 3, "since": "7d"}
)

for signal in response.json()["convergences"]:
    print(f"{signal['name']} - followed by {', '.join(signal['followed_by'])}")
```