GET /v1/trending
Entities ranked by the number of tracked accounts that recently followed them.
Cost: 24 credits per call (+16 credits/entity with classify=true)
curl "https://frontrun.vc/v1/trending?since=7d&classify=true" \
-H "X-API-Key: your_api_key"Parameters
| Parameter | Type | Default | Description |
|---|---|---|---|
since | string (query) | "7d" | Time window. Accepts "24h", "48h", "7d", "14d", "30d", or ISO date. |
limit | integer (query) | 25 | Maximum results (max 100). |
offset | integer (query) | 0 | Pagination offset. |
classify | string (query) | -- | Set to "true" to include AI classification. |
max_credits | integer (query) | -- | Cap what this call may cost. With classify=true the cost scales with limit, so limit=100 can reach 1,624 credits. Fails closed: over the ceiling, nothing runs and nothing is charged. See Budgets & Cursors. |
/v1/trending does not take a cursor. It is a ranked aggregation over a
window, not a record listing, so narrowing the window changes the answer rather
than continuing it. Use since.
Response
{
"since": "2026-02-28T00:00:00.000Z",
"accounts_scanned": 50,
"total": 25,
"cost_credits": 24,
"max_cost_credits": 424,
"balance_credits": 9836,
"trending": [
{
"twitter_user_id": "1111111111",
"username": "stealth_ai_co",
"name": "StealthAI",
"description": "Automating enterprise workflows with LLMs",
"verified": true,
"followed_by": ["pmarca", "naval", "paulg", "sequoia"],
"follower_count": 4,
"classification": {
"is_company": true,
"confidence": "high",
"sector": "AI/ML",
"entity_type": "startup"
}
}
]
}