# GET /v1/discover

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

Personalized account recommendations based on your tracked set and custom classification rules.

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

```bash
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

```json
{
  "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 accounts 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 tracked accounts. Matches your climate focus rule."
    }
  ],
  "total": 3,
  "usage_pct": 12,
  "usage_resets_at": "2026-11-01T00:00:00Z"
}
```

| Field | Type | Description |
|-------|------|-------------|
| `signal_score` | number | Composite signal score (0–1) based on tracked-account follow patterns, convergence, and recency. |
| `matched_rule` | string \| null | Name of your custom classification rule that matched, if any. |
| `followed_by` | array | Tracked accounts that follow this account. |
| `reason` | string | Human-readable explanation of why this account is recommended. |