Docs
Introduction

Frontrun API

Programmatic access to VC follow graph intelligence on X. Track accounts, detect new follows, surface convergence signals, and classify entities - all through a REST API designed for agents and automation.

Base URL: https://frontrun.vc/v1


For LLMs and agents

Every page on this site is also available as raw markdown - use the Copy page button at the top of any page, or pull the whole spec at once:

FileWhat it is
/llms.txtllmstxt.org (opens in a new tab) index - every page with a one-line summary and a link to its raw markdown
/llms-full.txtEntire docs concatenated into a single file. Drop into any LLM context for instant working knowledge of the API
/docs/raw/<path>.mdPer-page raw markdown for any doc URL (e.g. /docs/raw/endpoints/follows-new.md)

These files regenerate on every deploy. Point an agent at llms-full.txt and it has the full API reference, integration guides, and use-case examples in one shot.


What you get

Frontrun monitors X accounts and surfaces follow activity changes as structured, enriched data:

  • New follows - who accounts started following and when
  • Convergence - entities followed by multiple tracked accounts independently
  • Trending - entities ranked by attention across your tracked set
  • Activity profiles - per-account follow velocity and sector focus
  • AI classification - every entity tagged by sector, type, and confidence
  • Custom rules - build your own classification layer on top

Core concepts

Tracked accounts

A tracked account is an X account that Frontrun monitors for follow activity. Add them via POST /v1/track or through the dashboard.

Classification

Passing ?classify=true on supported endpoints enriches returned entities with AI classification:

  • is_company - whether the account represents a company or project
  • sector - e.g., "AI/ML", "Fintech", "Crypto/Web3", "Enterprise SaaS"
  • entity_type - e.g., "startup", "growth_company", "vc_fund", "individual"
  • confidence - "high", "medium", or "low"

Pricing

API + MCP access is included with Pro. Starter covers the web app only.

PlanMonthly costCredits includedAPI + MCP
Starter$49/mo-No
Pro$99/mo10,000/moYes
EnterpriseCustomUnlimitedYes

Standard rates: 4 credits basic, 16 signal, 24 trending, 40 thesis search, 60 company deep-dive, 100 founder intelligence. Pro has no trial - API access unlocks immediately on payment.

Every response includes cost_credits and balance_credits so you always know your spend.

Full pricing details →


Quickstart

Get your API key

Generate an API key from your Frontrun dashboard (opens in a new tab). Pro subscribers get 10,000 monthly credits automatically; top-up packs are available via the developer page.

Machine-readable spec: the full API is described in an OpenAPI 3.1 spec at /openapi.json (opens in a new tab) - point a generator, a Postman import, or your agent at it.

Remote MCP endpoint (beta)

No local install needed - the Frontrun MCP server is also hosted at https://www.frontrun.vc/mcp (streamable HTTP).

claude.ai / Claude Desktop: Settings → Connectors → Add custom connector → paste https://mcp.frontrun.vc. Claude opens a Frontrun login and handles auth via OAuth - no key to copy.

Any other MCP client: authenticate with your API key:

URL:    https://www.frontrun.vc/mcp
Header: Authorization: Bearer <your API key>

For Claude Code: claude mcp add --transport http frontrun https://www.frontrun.vc/mcp --header "Authorization: Bearer <your API key>". Same 36 tools, same credit metering as the frontrun-mcp-server (opens in a new tab) npm package.

Track an account

curl -X POST https://frontrun.vc/v1/track \
  -H "X-API-Key: your_api_key" \
  -H "Content-Type: application/json" \
  -d '{"username": "pmarca"}'
{
  "username": "pmarca",
  "tracking": true,
  "follow_count": 70,
  "cost_credits": 4,
  "balance_credits": 9996,
  "message": "Tracking active. New follows will appear once activity is detected."
}

Query new follows

curl https://frontrun.vc/v1/follows/new?since=48h \
  -H "X-API-Key: your_api_key"
{
  "since": "2026-03-05T04:00:00.000Z",
  "accounts_checked": 1,
  "total_new_follows": 3,
  "cost_credits": 16,
  "balance_credits": 9980,
  "results": [
    {
      "tracked_account": "pmarca",
      "new_follows_count": 3,
      "new_follows": [
        {
          "twitter_user_id": "1234567890",
          "username": "newai_startup",
          "name": "NewAI",
          "description": "Building the future of AI infrastructure",
          "verified": true
        }
      ]
    }
  ]
}