Skip to main content
GET
/
v3
/
currencies
/
{id}
/
tokenomics
Currency tokenomics summary
curl --request GET \
  --url https://api.cryptorank.io/v3/currencies/{id}/tokenomics \
  --header 'X-Api-Key: <api-key>'
{
  "totalSupply": "21000000",
  "maxSupply": "21000000",
  "circulatingSupply": "19700000",
  "circulatingPercent": 93.81,
  "fullyDilutedValuation": "1300000000000",
  "totalUnlockedAmount": "12500000",
  "totalUnlockedPercent": 59.52,
  "totalLockedAmount": "8500000",
  "totalLockedPercent": 40.48,
  "nextUnlockDate": 1715000000000,
  "nextUnlockTokenAmount": "125000",
  "nextUnlockUsdAmount": "8125000",
  "nextUnlockPercentOfMcap": 0.62,
  "nextUnlockPercentOfSupply": 0.59
}

Documentation Index

Fetch the complete documentation index at: https://docs.cryptorank.io/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
X-Api-Key
string
header
required

Path Parameters

​
id
integer
required

Numeric coin id.

Example:

1

Response

​
totalSupply
object
required
Example:

"21000000"

​
maxSupply
object
required
Example:

"21000000"

​
circulatingSupply
object
required
Example:

"19700000"

​
circulatingPercent
object
required

circulatingSupply / totalSupply × 100. Null when either value is missing.

Example:

93.81

​
fullyDilutedValuation
object
required
Example:

"1300000000000"

​
totalUnlockedAmount
object
required

Sum of tokens already unlocked across all allocations. Null when no vesting data.

Example:

"12500000"

​
totalUnlockedPercent
object
required

totalUnlockedAmount / totalSupply × 100.

Example:

59.52

​
totalLockedAmount
object
required

Sum of tokens still locked. Null when no vesting data.

Example:

"8500000"

​
totalLockedPercent
object
required

totalLockedAmount / totalSupply × 100.

Example:

40.48

​
nextUnlockDate
object
required

Closest upcoming unlock date (excluding TGE batches), Unix milliseconds.

Example:

1715000000000

​
nextUnlockTokenAmount
object
required
Example:

"125000"

​
nextUnlockUsdAmount
object
required
Example:

"8125000"

​
nextUnlockPercentOfMcap
object
required

nextUnlockUsdAmount / marketCap × 100.

Example:

0.62

​
nextUnlockPercentOfSupply
object
required

nextUnlockTokenAmount / totalSupply × 100.

Example:

0.59