GET /v1/convergence
Detect entities followed by multiple tracked accounts independently within a time window.
Cost: $0.10 per call
curl "https://frontrun.vc/v1/convergence?threshold=2&since=7d" \
-H "X-API-Key: your_api_key"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 ("48h"), days ("7d", "14d"), or ISO date. |
Threshold guide
| Threshold | Signal strength | Typical use |
|---|---|---|
| 2 | Moderate | Broad scanning |
| 3 | Strong | High-confidence signals |
| 4+ | Very strong | Filtered to highest conviction |
Response
{
"threshold": 2,
"since": "2026-02-28T00:00:00.000Z",
"total": 3,
"cost_cents": 10,
"balance_cents": 4840,
"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": "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. |
Example
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'])}")