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


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

Usage-based. Load credits, pay per operation. No subscriptions required for API access.

OperationCost
Track account$0.10
New follows$0.05
Follow list$0.02
Convergence$0.10
Trending$0.05
Account activity$0.05
Search$0.03
Classification+$0.03/entity

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) and load credits.

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
        }
      ]
    }
  ]
}