GET /v1/discover
Personalized account recommendations based on your tracked set and custom classification rules.
Cost: $0.10 per call
curl "https://frontrun.vc/v1/discover?sector=AI/ML&min_signal=0.5&limit=10" \
-H "X-API-Key: your_api_key"Parameters
| Parameter | Type | Default | Description |
|---|---|---|---|
sector | string (query) | -- | Filter recommendations to a specific sector. |
min_signal | number (query) | 0.3 | Minimum signal score (0–1) to include. |
limit | integer (query) | 20 | Maximum recommendations (max 50). |
Response
{
"recommendations": [
{
"handle": "stealth_ai_co",
"name": "StealthAI",
"sector": "AI/ML",
"followed_by": ["pmarca", "naval"],
"signal_score": 0.87,
"matched_rule": "ai_infrastructure",
"reason": "Followed by 2 tracked VCs in the last 7 days. Matches your AI infrastructure classification rule."
},
{
"handle": "dev_infra_xyz",
"name": "DevInfra",
"sector": "Developer Tools",
"followed_by": ["paulg"],
"signal_score": 0.64,
"matched_rule": null,
"reason": "High signal potential in Developer Tools. Recently followed by paulg."
},
{
"handle": "climate_tech_co",
"name": "ClimateTech",
"sector": "Climate",
"followed_by": ["naval", "chrisdixon"],
"signal_score": 0.52,
"matched_rule": "climate_focus",
"reason": "Convergence signal from 2 VCs. Matches your climate focus rule."
}
],
"total": 3,
"cost_cents": 15,
"balance_cents": 4800
}| Field | Type | Description |
|---|---|---|
signal_score | number | Composite signal score (0–1) based on VC follow patterns, convergence, and recency. |
matched_rule | string | null | Name of your custom classification rule that matched, if any. |
followed_by | array | Tracked VCs that follow this account. |
reason | string | Human-readable explanation of why this account is recommended. |