Skip to main content
GET
Token versions
Returns every project version of a token, oldest first by historyOrder. Use the ids from this endpoint as versionId on the other Point-in-Time History endpoints.
  • Each version carries validFrom, validFromBasis, validUntil, disclosedAt and previousVersionId.
  • Tokenomist’s own corrections are not listed separately. Each one is folded into the project version it follows, which then serves the corrected data.
  • start and end filter on the UTC day of validFrom, both days included.
  • change.category is baseline on the first version and project_decision on later ones.
  • metadata holds the query date, credit and pagination only. This endpoint takes no asOf or versionId.
list_versions.py
Example version:

Authorizations

x-api-key
string
header
required

Your Tokenomist API key

Path Parameters

tokenId
string
required

Token identifier (slug), as in Token List v5. A token not in that list answers 404 TOKEN_NOT_FOUND.

Query Parameters

start
string<date>

Return versions whose validFrom falls on or after this UTC day (YYYY-MM-DD).

end
string<date>

Return versions whose validFrom falls on or before this UTC day (YYYY-MM-DD).

page
integer

Page number (1-indexed). 0 or omitted means 1.

Required range: x >= 0
pageSize
integer

Number of items per page. 0 or omitted means 20.

Required range: x >= 0

Response

Successful response

metadata
object
status
boolean
data
object[]