API reference · Tokens

Token thesis velocity

GEThttps://fomodata.dev/v1/tokens/{ref}/thesis-velocity

Scopes:tokens:readRate class:standardFlag:TOKENS_API_ENABLED

Theses in the last 5 minutes and last hour vs the previous hour. change_pct is null when the previous hour had none.

All counts are derived from theses FomoData ingested from its authorized upstream since first_seen_at (metrics_scope: "ingested") — not Fomo's all-time totals.

Example request

curl 'https://fomodata.dev/v1/tokens/$RUN/thesis-velocity?chain=robinhood' \
  -H "Authorization: Bearer $FOMODATA_API_KEY"

Try it in the playground

Parameters

Path parameters

refstringrequired: Token reference: tk_… id, contract/mint address, chain:address, $RUN or RUN (case-insensitive). A symbol on several chains returns 409 AMBIGUOUS_TOKEN — pass ?chain= or the address.

Query parameters

chainstring: Narrow to one chain, e.g. robinhood, solana, base. Test keys: sandbox.

Response

200 Thesis velocity

application/jsonThesisVelocity

objectenumrequired"thesis_velocity"
tokenobjectrequired+ 5 child attributes
- idstringrequired
- symbolstringrequired
- namestring | nullrequired
- chainstringrequired
- addressstringrequired
last_5mintegerrequired
last_1hintegerrequired
previous_1hintegerrequired
change_pctnumber | nullrequirednull when previous_1h is 0.
metrics_scopeenumrequired"ingested"
livemodebooleanrequired
computed_atstring (date-time)required

200 · exampleJSON

{
  "object": "thesis_velocity",
  "token": {
    "id": "tk_9bF2kLmQ0sVx7RtY3nHc1A",
    "symbol": "$RUN",
    "name": "Run",
    "chain": "robinhood",
    "address": "0x5a4d1f3c0f6e2b8d9a7c4e1f0b3d6a9c2e5f8a1b"
  },
  "last_5m": 0,
  "last_1h": 0,
  "previous_1h": 0,
  "change_pct": 186.2,
  "metrics_scope": "ingested",
  "livemode": true,
  "computed_at": "2026-10-07T10:04:12.000Z"
}

Errors

Status	When
`401`	Missing, invalid, revoked or expired API key
`403`	Insufficient scope, live access not approved, or history limit
`404`	Not found (or feature disabled)
`409`	Conflict (e.g. ambiguous token symbol)
`422`	Validation failed
`429`	Rate limit or quota exceeded

All errors use the standard envelope. See error codes for every code value.

← All endpoints openapi.json