# 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. Frontrun is a REST API that exposes the live X (Twitter) follow graph as structured intelligence. Track accounts, detect new follows in time windows, surface convergence (entities followed by multiple tracked accounts), classify companies/VCs, and pull funding/founder data. Pricing is hybrid (subscription credits or pay-as-you-go); every response includes `cost_cents` and `balance_cents`. Base URL: `https://frontrun.vc/v1` — auth via `X-API-Key` header. Full spec also available as a single file at https://frontrun.vc/docs/llms-full.txt. ## Introduction - [Introduction](https://frontrun.vc/docs/raw/index.md): 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. ## Authentication - [Authentication](https://frontrun.vc/docs/raw/authentication.md): All API requests require an API key passed via the `X-API-Key` header. ## Use Cases - [Use Cases](https://frontrun.vc/docs/raw/use-cases.md): Track investor accounts and surface convergence — multiple accounts following the same entity independently. ## API Reference - [GET /v1/status](https://frontrun.vc/docs/raw/endpoints/status.md): Returns your credit balance, tracked account count, and 30-day usage breakdown. - [Track Accounts](https://frontrun.vc/docs/raw/endpoints/track.md): Manage which X accounts you're monitoring for follow activity. - [GET /v1/preview/:handle](https://frontrun.vc/docs/raw/endpoints/preview.md): Preview an account before tracking it. Returns profile summary, signal potential score, tracking recommendation, and sector hints. - [GET /v1/follows/new](https://frontrun.vc/docs/raw/endpoints/follows-new.md): Detect new follows across your tracked accounts within a time window. - [GET /v1/follows/snapshot](https://frontrun.vc/docs/raw/endpoints/follows-snapshot.md): Returns the current follow list for a tracked account. - [GET /v1/follows/enriched](https://frontrun.vc/docs/raw/endpoints/enriched.md): New follows with full enrichment: AI classification + your custom rules + your custom tags, all merged into each result. - [GET /v1/convergence](https://frontrun.vc/docs/raw/endpoints/convergence.md): Detect entities followed by multiple tracked accounts independently within a time window. - [GET /v1/trending](https://frontrun.vc/docs/raw/endpoints/trending.md): Entities ranked by the number of tracked accounts that recently followed them. - [GET /v1/search](https://frontrun.vc/docs/raw/endpoints/search.md): Search across entities followed by your tracked accounts. Filter by sector, keyword, or entity type. - [Custom Classification](https://frontrun.vc/docs/raw/endpoints/classify.md): Build your own classification layer on top of Frontrun's AI. Define rules that auto-tag entities, manually tag companies, and query with your custom data merged in. - [GET /v1/company/:handle](https://frontrun.vc/docs/raw/endpoints/company.md): Synthesized company overview from multiple sources. Returns profile data, sector classification, entity type, website summary, and recent activity. - [GET /v1/company/:handle/founders](https://frontrun.vc/docs/raw/endpoints/company-founders.md): Founder intelligence for a company. Identifies founders via social graph analysis and enriches with LinkedIn data. - [GET /v1/company/:handle/signals](https://frontrun.vc/docs/raw/endpoints/company-signals.md): Social signal analysis for a company. Returns buzz score, sentiment, mention count, notable mentions, and tracked VC followers. - [GET /v1/company/:handle/resources](https://frontrun.vc/docs/raw/endpoints/company-resources.md): Discovered links and resources for a company. Aggregates website, GitHub, documentation, community links, and bio links. - [GET /v1/company/:handle/funding](https://frontrun.vc/docs/raw/endpoints/company-funding.md): Funding and deal information for a company, cross-referenced with VC follow signals. - [GET /v1/vc/:handle/activity](https://frontrun.vc/docs/raw/endpoints/vc-activity.md): Activity profile for a tracked account — follow velocity, sector distribution, and recent follows. - [GET /v1/vc/:handle/similar](https://frontrun.vc/docs/raw/endpoints/vc-similar.md): Find VCs with similar follow patterns. Computed from temporal follow graph overlap. - [GET /v1/feed](https://frontrun.vc/docs/raw/endpoints/feed.md): Real-time activity feed across all tracked accounts. Filterable by event type, sector, and time window. - [GET /v1/sectors](https://frontrun.vc/docs/raw/endpoints/sectors.md): Sector breakdown of all discovered entities across your tracked accounts. - [GET /v1/discover](https://frontrun.vc/docs/raw/endpoints/discover.md): Personalized account recommendations based on your tracked set and custom classification rules. ## Integrations - [MCP Server](https://frontrun.vc/docs/raw/integrations/mcp-server.md): The Frontrun MCP server gives AI agents native access to the Frontrun API. 29 tools, version 2.3.2. Everything runs via `npx`. - [OpenClaw](https://frontrun.vc/docs/raw/integrations/openclaw.md): Use Frontrun as a data source in your OpenClaw agent. Surface VC follow signals, convergence events, and classified entities directly in your agent's workflow. - [Claude Code](https://frontrun.vc/docs/raw/integrations/claude-code.md): Use Frontrun natively in Claude Code via the MCP server. - [Cursor](https://frontrun.vc/docs/raw/integrations/cursor.md): Use Frontrun with Cursor's AI agent mode. - [Python](https://frontrun.vc/docs/raw/integrations/python.md): Use the Frontrun API from Python with `requests` or any HTTP client. - [JavaScript](https://frontrun.vc/docs/raw/integrations/javascript.md): Use the Frontrun API from JavaScript/TypeScript with `fetch`. ## Reference - [Pricing](https://frontrun.vc/docs/raw/reference/pricing.md): Frontrun has a **hybrid pricing model**. Subscribe for monthly API credits at standard rates, or pay-as-you-go on the free tier at 2.5x rates. - [Parameters & Limits](https://frontrun.vc/docs/raw/reference/parameters.md): Many endpoints accept time window parameters to control the lookback period. - [Errors & Status Codes](https://frontrun.vc/docs/raw/reference/errors.md): Every error response returns a JSON object with an `error` field describing what went wrong. - [Rate Limits](https://frontrun.vc/docs/raw/reference/rate-limits.md): All API endpoints are rate-limited per API key. Two independent limits apply: a **request-count** rate limit (DoS guardrail) and a **daily spend cap** (dollar ceiling). - [Security](https://frontrun.vc/docs/raw/reference/security.md): If a key is compromised: