Skip to main content
GET
/
v3
/
currencies
/
contract
/
{platform}
/
{address}
Currency profile by contract address
curl --request GET \
  --url https://api.cryptorank.io/v3/currencies/contract/{platform}/{address} \
  --header 'X-Api-Key: <api-key>'
{
  "id": 1,
  "slug": "bitcoin",
  "symbol": "BTC",
  "name": "Bitcoin",
  "rank": 1,
  "type": "coin",
  "lifecycle": "traded",
  "categoryId": 12,
  "images": {
    "icon": "<string>",
    "x60": "<string>",
    "x150": "<string>",
    "native": "<string>"
  },
  "description": {},
  "listingDate": "2009-01-03T00:00:00.000Z",
  "links": [
    {
      "type": "web",
      "url": "https://bitcoin.org"
    }
  ],
  "price": "65000.5",
  "marketCap": "1280000000000",
  "volume24h": "32000000000",
  "volume24hBase": "492000",
  "high24h": "65500",
  "low24h": "64000",
  "fullyDilutedValuation": "1300000000000",
  "percentChange": {
    "h24": 1.23,
    "d7": -4.56,
    "d30": 12.34,
    "m3": 8.9,
    "ytd": 50.12
  },
  "volMcapRatio": 0.025,
  "volatility": 35.42,
  "circulatingSupply": "19700000",
  "totalSupply": "21000000",
  "maxSupply": "21000000",
  "athPrice": "69000",
  "athDate": "2021-11-10T14:24:00.000Z",
  "atlPrice": "0.05",
  "atlDate": "2013-07-05T00:00:00.000Z",
  "athMarketCap": "1380000000000",
  "athFdv": "1450000000000",
  "fromAthPercent": -5.78,
  "fromAtlPercent": 130000.42,
  "vcAvgRoi": 12.5,
  "icoRoi": 8500.4,
  "isTraded": true,
  "hasFundingRounds": true,
  "hasTeams": true,
  "hasVesting": true,
  "hasNextUnlock": true,
  "hasContracts": true,
  "hasPublicSales": true,
  "hasDrophunting": false,
  "sparkline7d": {},
  "lastUpdated": "2026-05-06T12:34:56.000Z"
}

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

​
platform
string
required

Platform slug (token_platform.key). Case-sensitive exact match.

Example:

"ethereum"

​
address
string
required

Contract address. Case-insensitive match.

Example:

"0xdac17f958d2ee523a2206206994597c13d831ec7"

Response

​
id
number
required
Example:

1

​
slug
string
required
Example:

"bitcoin"

​
symbol
object
required
Example:

"BTC"

​
name
string
required
Example:

"Bitcoin"

​
rank
object
required
Example:

1

​
type
string
required

Asset type. Common values: coin, token, fiat, no-token. May also be etf, leveraged-token, derivative, undefined for less common assets.

Example:

"coin"

​
lifecycle
enum<string>
required

Lifecycle stage. Values: traded (live market), crowdsale (active ICO/IDO), funding (raising), scheduled (announced TGE), inactive (not trading), unknown.

Available options:
traded,
crowdsale,
funding,
scheduled,
inactive,
unknown
Example:

"traded"

​
categoryId
object
required
Example:

12

​
images
object
required
​
description
object
required

Long English description.

​
listingDate
object
required

Listing date — first available of: explicit listing date, TGE start, first traded date.

Example:

"2009-01-03T00:00:00.000Z"

​
links
object[]
required
​
price
string
required
Example:

"65000.5"

​
marketCap
object
required
Example:

"1280000000000"

​
volume24h
string
required
Example:

"32000000000"

​
volume24hBase
string
required

Volume in base currency (volume24h / price).

Example:

"492000"

​
high24h
object
required

USD high in last 24h (not affected by convert).

Example:

"65500"

​
low24h
object
required

USD low in last 24h (not affected by convert).

Example:

"64000"

​
fullyDilutedValuation
object
required
Example:

"1300000000000"

​
percentChange
object
required
​
volMcapRatio
object
required

Volume / MarketCap ratio. Null when market cap is unavailable or zero.

Example:

0.025

​
volatility
object
required

30-day USD price volatility (percent), updated periodically.

Example:

35.42

​
circulatingSupply
object
required
Example:

"19700000"

​
totalSupply
object
required
Example:

"21000000"

​
maxSupply
object
required
Example:

"21000000"

​
athPrice
object
required

USD price at ATH (not affected by convert).

Example:

"69000"

​
athDate
object
required
Example:

"2021-11-10T14:24:00.000Z"

​
atlPrice
object
required

USD price at ATL (not affected by convert).

Example:

"0.05"

​
atlDate
object
required
Example:

"2013-07-05T00:00:00.000Z"

​
athMarketCap
object
required

USD market cap at ATH (not affected by convert).

Example:

"1380000000000"

​
athFdv
object
required

USD fully diluted valuation at ATH (not affected by convert).

Example:

"1450000000000"

​
fromAthPercent
object
required

Current price vs ATH, percent.

Example:

-5.78

​
fromAtlPercent
object
required
Example:

130000.42

​
vcAvgRoi
object
required

Average ROI of VC investors based on disclosed funding rounds.

Example:

12.5

​
icoRoi
object
required

ROI from latest closed public sale (ICO/IDO/IEO). Null when no sale or untraded.

Example:

8500.4

​
isTraded
boolean
required
Example:

true

​
hasFundingRounds
boolean
required
Example:

true

​
hasTeams
boolean
required
Example:

true

​
hasVesting
boolean
required
Example:

true

​
hasNextUnlock
boolean
required
Example:

true

​
hasContracts
boolean
required
Example:

true

​
hasPublicSales
boolean
required
Example:

true

​
hasDrophunting
boolean
required
Example:

false

​
sparkline7d
object
required

URL of pre-rendered 7d sparkline image, null when no chart available.

​
lastUpdated
string
required
Example:

"2026-05-06T12:34:56.000Z"