Skip to main content
GET
/
v3
/
currencies
/
{id}
/
tokenomics
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": "2026-07-01T00:00:00.000Z",
  "nextUnlockTokenAmount": "125000",
  "nextUnlockUsdAmount": "8125000",
  "nextUnlockPercentOfMcap": 0.62,
  "nextUnlockPercentOfSupply": 0.59,
  "vestingInfo": [
    "https://docs.project.io/tokenomics"
  ]
}
nextUnlockUsdAmount = tokens × current price.
Per-group breakdown: /currencies/:id/vesting/allocations. Emission chart: /currencies/:id/vesting/chart.

Authorizations

​
X-Api-Key
string
header
required

Path Parameters

​
id
integer
required

Numeric coin id.

Example:

1

Response

​
totalSupply
string | null
required

Total supply: issued minus burned, excluding not-yet-emitted tokens.

Example:

"21000000"

​
maxSupply
string | null
required

Max supply ever to exist. Null if uncapped.

Example:

"21000000"

​
circulatingSupply
string | null
required

Circulating supply: tokens currently in circulation. Null when the coin is not actively traded.

Example:

"19700000"

​
circulatingPercent
number | null
required

Circulating supply as % of total supply. Null when the coin is not actively traded.

Example:

93.81

​
fullyDilutedValuation
string | null
required

Fully diluted valuation (FDV), USD. Null when the coin is not actively traded.

Example:

"1300000000000"

​
totalUnlockedAmount
string | null
required

Total unlocked tokens to date.

Example:

"12500000"

​
totalUnlockedPercent
number | null
required

Unlocked tokens as % of total supply.

Example:

59.52

​
totalLockedAmount
string | null
required

Total tokens still locked.

Example:

"8500000"

​
totalLockedPercent
number | null
required

Locked tokens as % of total supply.

Example:

40.48

​
nextUnlockDate
string | null
required

Next unlock date, ISO 8601 UTC.

Example:

"2026-07-01T00:00:00.000Z"

​
nextUnlockTokenAmount
string | null
required

Tokens in the next unlock.

Example:

"125000"

​
nextUnlockUsdAmount
string | null
required

Next unlock value (tokens × current price), USD. Null when the coin is not actively traded.

Example:

"8125000"

​
nextUnlockPercentOfMcap
number | null
required

Next unlock as % of market cap. Null when the coin is not actively traded.

Example:

0.62

​
nextUnlockPercentOfSupply
number | null
required

Next unlock as % of total supply.

Example:

0.59

​
vestingInfo
string[]
required

Vesting source documentation links. Empty when no vesting data.

Example:
["https://docs.project.io/tokenomics"]