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
/docs/llms.txtllmstxt.org (opens in a new tab) index — every page with a one-line summary and a link to its raw markdown
/docs/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

Hybrid model. Subscribe for monthly credits at standard rates, or pay-as-you-go at 2.5x rates on the free tier.

PlanMonthly costCredits includedRateMCP
Free$0$02.5x standardNo
Starter$49/mo$25/moStandardNo
Pro$99/mo$75/moStandardYes
EnterpriseCustomUnlimitedCustomYes

Standard rates: $0.01 basic, $0.02 signal, $0.05 intelligence, $0.10 founder.

Every response includes cost_cents and balance_cents 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). Subscribers get monthly credits automatically; pay-as-you-go users load credits via the developer page.

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_cents": 10,
  "balance_cents": 4990,
  "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_cents": 5,
  "balance_cents": 4985,
  "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
        }
      ]
    }
  ]
}