Signal

Trending startups

Changed on

Startups ranked by how many of your tracked accounts followed them within the window (no minimum). Startups only: A result is kept only if our curated companies table marks it a company, its entity type is company, project, protocol or product, and it has at most 25,000 X followers (the same ceiling the daily reports use). People, investors, VC firms, media, organizations, public companies and big established brands are left out, as is anything not yet classified. Costs 24 credits. classify=true attaches the cached AI classification to each result (16 credits per classified entity returned), so keep limit small when classifying. Default window is 7d when since is omitted. Returns an empty hint response if you track no accounts; add coverage with POST /track first.

get/trending

Request

  • Base URL: https://frontrun.vc/v1
  • URL: https://frontrun.vc/v1/trending
  • Auth: API key in header X-API-Key

Query parameters

sincestring
Example:24h

Time window: relative ("24h", "168h", "7d") or absolute date ("YYYY-MM-DD"). Default "7d".

limitinteger

Maximum results to return (default 25, max 100).

offsetinteger

Pagination offset (default 0).

classify'true' | 'false'

Set to "true" to attach the cached AI classification to each result (adds 16 credits per classified entity).

max_creditsinteger

Ceiling on what this single call may cost, in credits. FAILS CLOSED: checked against the maximum the call could cost before any billable work runs, so if it would exceed the ceiling nothing is computed and nothing is charged (400, error_code max_credits_exceeded, with max_cost_credits telling you the real number). You are still billed only for what was actually computed, so a call that clears the ceiling usually lands under it. Relevant here because classify=true adds 16 credits per entity returned, so limit=100 is a call that can reach 1,624 credits.

scopestring
Example:tracked

Whose follows to read: tracked (default, your tracked accounts), network (the whole Frontrun network; paid Pro and Enterprise) or list:<id> (one of your lists, with its sectors). See /docs/reference/scopes.

Response

Trending entities.

sincestring date-time
accounts_scannedinteger
totalinteger
returnedinteger
offsetinteger
has_moreboolean
cost_creditsinteger

Credits charged for this call.

balance_creditsinteger

Remaining credit balance after this call.

max_cost_creditsinteger

The most this call could have cost with the parameters you sent. Budget the next call against it. cost_credits is what you were actually charged.

Changes