Python
Use the Frontrun API from Python with requests or any HTTP client.
Installation
pip install requestsBasic usage
import requests
BASE_URL = "https://frontrun.vc/v1"
HEADERS = {"X-API-Key": "your_api_key"}
def frontrun_get(path, params=None):
response = requests.get(f"{BASE_URL}{path}", headers=HEADERS, params=params)
response.raise_for_status()
return response.json()
def frontrun_post(path, data):
response = requests.post(f"{BASE_URL}{path}", headers=HEADERS, json=data)
response.raise_for_status()
return response.json()Examples
Track an account
result = frontrun_post("/track", {"username": "pmarca"})
print(result)Get new follows
new_follows = frontrun_get("/follows/new", {"since": "48h", "classify": "true"})
for account in new_follows["results"]:
print(f"\n{account['tracked_account']}:")
for follow in account["new_follows"]:
sector = follow.get("classification", {}).get("sector", "Unknown")
print(f" @{follow['username']} ({sector})")Check convergence
convergence = frontrun_get("/convergence", {"threshold": 3, "since": "7d"})
for signal in convergence["convergences"]:
followers = ", ".join(signal["followed_by"])
print(f"{signal['name']} — followed by {followers}")Get trending
trending = frontrun_get("/trending", {"since": "7d", "classify": "true", "limit": 10})
for company in trending["trending"]:
print(f"#{company['follower_count']} {company['name']} @{company['username']}")Account activity
activity = frontrun_get("/vc/pmarca/activity", {"since": "30d"})
print(f"Follows/week: {activity['follows_per_week']}")
print(f"Sectors: {activity['sector_breakdown']}")Search
results = frontrun_get("/search", {"sector": "AI/ML", "entity_type": "startup"})
for company in results["results"]:
print(f"@{company['username']} — {company['description']}")