Nfts

NFTs (Non Fungible Tokens) - are unique assets, of which we list a lot on Coinranking. Read more about what they are on our blog.

Each NFT belongs to a Dapp (Decentralized Application), which technically is one or more smart contracts on the blockchain. Such smart contract addresses mostly follow a well defined standard, such as ERC-721 or ERC-1155. More practically; an example of a Dapp would be cryptokitties - the ecosystem - while a particular cryptokitty such as Susi Scrummyswoggle is an NFT.

Each NFT can change ownership, by making transactions on the blockchain. We follow these transactions and calculate the exchange rate in US Dollars for the amount of tokens used in these transactions, and list the latest rate as the current value of the NFT.

Get Dapp

Get a specific Dapp

GET /dapp/:slug

Path parameters

Name Type Description
slug String

Examples

Example: cURL

curl https://api.coinranking.com/v2/dapp/cryptokitties

Parameters examples

bash - slug

curl https://api.coinranking.com/v2/dapp/cryptokitties

Success response

Name Type Description
status String

Status of the request

Allowed values:
success
data Object
data.dapp Object
data.dapp.slug String

Short URL friendly name of the Dapp

data.dapp.name String

Full name of the Dapp

data.dapp.description String

Short description of the Dapp, used as a summary

data.dapp.fullDescription String

Long description of the Dapp, might be a couple of paragraphs long

data.dapp.websiteUrl String

URL to the website of the Dapp

data.dapp.image String

URL to logo of the Dapp

data.dapp.numberOfRegistries Number

The amount of registries used for this Dapp, see 'registries' below

data.dapp.numberOfNfts Number

The amount of Non-Fungible tokens available within this Dapp. E.g. the amount of cryptokitties

data.dapp.links Object[]

List of links, like social media pages

data.dapp.links.url String

Url to the specific link

data.dapp.links.name String

Name of the link

data.dapp.links.type String

The type of link

Allowed values:
twitter telegram reddit discord medium bitcointalk youtube facebook instagram github website etc.
data.dapp.coinrankingUrl String

Where to find the Dapp on coinranking.com

data.registries Object[]

A list of smart contract addresses used to interact with the NFTs within a Dapp. These contracts mint and hold NFTs, fire transfer events and describe how to retrieve metadata such as a token identifier, image urls, names, descriptions and more. Currently, ERC721 and ERC1155 are popular standards to define such a contract; they enable a consistent way to interact with different Dapp

data.registries.id String

Unique ID of the registry

data.registries.name String

Name of the registry.

data.registries.description String

Description of the registry

data.registries.contractAddress String

Smart contract address, this address can be used to find and check out the definition of a Dapp on its respective blockchain

data.registries.blockchain String

The blockchain this Dapp is released on

Success response example - Response:

HTTP/1.1 200 OK
 {
   "status": "success",
   "data": {
     "dapp": {
       "slug": "cryptokitties",
       "name": "CryptoKitties",
       "description": "Cryptokitties is a blockchain-based virtual...",
       "fullDescription": "<p>CryptoKitties is the world’s first...",
       "websiteUrl": "https://www.cryptokitties.co",
       "image": "https://cdn.coinranking.com/dapp/cryptokitties.svg",
       "numberOfRegistries": 1,
       "numberOfNfts": 36129,
       "links": [
         {
           "url": "https://cryptokitties.co",
           "name": "cryptokitties.co",
           "type": "website"
         },
         {
           "url": "https://twitter.com/CryptoKitties",
           "name": "@CryptoKitties",
           "type": "twitter"
         }
       ],
       "coinrankingUrl": "https://coinranking.com/dapp/rarible"
     },
     "registries": [
       {
         "id": "40ee8f0cb50df2067b0a16870df963e899d6714815338aa6b9b2f5ad0a37ec62",
         "name": "CryptoKitties",
         "description": "Cryptokitties is a blockchain-based virtual...",
         "contractAddress": "0x06012c8cf97BEaD5deAe237070F9587f8E7A266d",
         "blockchain": "Ethereum"
       }
     ]
   }
 }

Error response

Error response - 404

Name Type Description
DAPP_NOT_FOUND Object

Error response example - Response:

HTTP/1.1 404 Not found
 {
   "status": "fail",
   "type": "DAPP_NOT_FOUND",
   "message": "Dapp not found"
 }

Get Dapps

Get list of Dapps

GET /dapps

Query parameters

Name Type Description
limit (optional) Number

Limit. Used for pagination

Default value: 50
Size range: 0-100
offset (optional) Number

Offset. Used for pagination

Default value: 0

Examples

Example: cURL

curl https://api.coinranking.com/v2/dapps

Parameters examples

bash - limit

curl https://api.coinranking.com/v2/dapps?limit=10

bash - offset

curl https://api.coinranking.com/v2/dapps?offset=50

Success response

Name Type Description
status String

Status of the request

Allowed values:
success
data Object
data.stats Object

A series of statistics regarding the requested list. Note that the stats its scope includes dapps outside the limit. E.g. the response of a query with a limit of 50 dapps returns 50 dapps (obviously), while the stats depicts the amount of dapps available without this limit, which may be a much higher number

data.stats.total Number

Total number of dapps within the query

data.dapps Object[]

List of Dapps

data.dapps.slug String

URL friendly name of the Dapp

data.dapps.name String

Full name of the Dapp

data.dapps.description String

Short description of the Dapp, used as a summary

data.dapps.websiteUrl String

URL to the website of the Dapp

data.dapps.image String

URL to logo of the Dapp

data.dapps.numberOfRegistries Number

The amount of registries used for this Dapp, see registries in the Dapp endpoint

data.dapps.numberOfNfts Number

The amount of Non-Fungible tokens available within this Dapp. E.g. the amount of cryptokitties

data.dapp.coinrankingUrl String

Where to find the Dapp on coinranking.com

Success response example - Response:

HTTP/1.1 200 OK
 {
   "status": "success",
   "data": {
     "stats": {
       "total": 10
     },
     "dapps": [
       {
         "slug": "cryptokitties",
         "name": "CryptoKitties",
         "description": "Cryptokitties is a blockchain-based virtual game...",
         "websiteUrl": "https://www.cryptokitties.co",
         "image": "https://cdn.coinranking.com/dapp/cryptokitties.svg",
         "numberOfRegistries": 1,
         "numberOfNfts": 36129,
         "coinrankingUrl": "https://coinranking.com/dapp/cryptokitties"
       },
       {
         "slug": "rarible",
         "name": "Rarible",
         "description": "Rarible is a NFT marketplace and gives a platform...",
         "websiteUrl": "https://rarible.com/",
         "image": "https://cdn.coinranking.com/dapp/rarible.png",
         "numberOfRegistries": 3,
         "numberOfNfts": 39239,
         "coinrankingUrl": "https://coinranking.com/dapp/rarible"
       }
     ]
   }
 }

Error response

Error response - 422

Name Type Description
VALIDATION_ERROR Object

The request could not be validated. The response should provide more details.

Error response example - Response:

HTTP/1.1 422 Unprocessable Entity
 {
   "status": "fail",
   "type": "VALIDATION_ERROR",
   "messages": [
     "Limit can only be between 1 and 100."
   ]
 }

Get NFT

Get a specific NFT

GET /nft/:id

Path parameters

Name Type Description
id String

Examples

Example: cURL

curl https://api.coinranking.com/v2/nft/16443c43d6a1ba33c85a49c7c6c36f7ac7150e478a405d05c4bedcc200b9610a

Parameters examples

bash - id

curl https://api.coinranking.com/v2/nft/16443c43d6a1ba33c85a49c7c6c36f7ac7150e478a405d05c4bedcc200b9610a

Success response

Name Type Description
status String

Status of the request

Allowed values:
success
data Object
data.nft Object

A non-fungible token

data.nft.id String

The unique identifier of the NFt

data.nft.createdAt Number

Date the NFT is listed on Coinranking

data.nft.registryId String

Unique identifier of the registry. Every NFT belongs to a registry, or smart-contract address

data.nft.dappSlug String

The URL friendly name of the Dapp

data.nft.dappName String

Full name of the Dapp

data.nft.dappExternalUrl String

URL to the website of the Dapp

data.nft.dappDescription String

Description of the Dapp

data.nft.dappImage String

URL to the logo of the Dapp

data.nft.registryBlockchain String

The blockchain the Dapp is release on

data.nft.registryContractAddress String

Smart contract address of the Dapp

data.nft.tokenId String

Unique identifier of this NFT

data.nft.name String/Null

Name of the NFT

data.nft.description String

Description of the NFT

data.nft.image String/Null

URL to the image of this NFT

data.nft.video String/Null

URL to the video of this NFT

data.nft.price String/Null

Latest amount of tokens this NFT is sold for. The token used for transactions differs per Dapp, most Dapps have their own token

data.nft.priceInDollar String/Null

Latest price this NFT is sold for in US Dollar

data.nft.auctionCreatedAt Number/Null

A timestamp of the last auction. The price and priceInUsd are based on an auction that has taken place at this moment

data.nft.externalUrl String/Null

URL to the website of the NFT, which in most cases is a page on the website of the Dapp

data.nft.backgroundColor String/Null

A hexidecimal color code, which is suggested in the metadata as background color to show the NFT on

data.nft.metadata Object/Null

The raw metadata for this NFT. What is available as metadata differs per Dapp and is defined in it's smart contract, see the registries of the Dapp

data.nft.dappCoinrankingUrl String

URL about where to find the Dapp for this NFT on Coinranking

data.nft.coinrankingUrl String/Null

URL about where to find this NFT on Coinranking

Success response example - Response:

HTTP/1.1 200 OK
 {
   "status": "success",
   "data": {
     "nft": {
       "id": "16443c43d6a1ba33c85a49c7c6c36f7ac7150e478a405d05c4bedcc200b9610a",
       "createdAt": 1602904185,
       "registryId": "d7926fa0a6ccb4adf34f87a1f73683853f3e3128de0a839a1d3a95c3488dcb37",
       "dappSlug": "makersplace",
       "dappName": "MakersPlace",
       "dappExternalUrl": "https://makersplace.com/",
       "dappDescription": "MakersPlace is a platform to discover...",
       "dappImage": "https://cdn.coinranking.com/dapp/makersplace.png",
       "registryBlockchain": "Ethereum",
       "registryContractAddress": "0x2A46f2fFD99e19a89476E2f62270e0a35bBf0756",
       "tokenId": "31438",
       "name": "Genesis",
       "description": "José Delbo sent me his striking pencil...",
       "image": null,
       "video": "https://cdn.coinranking.com/nft/0x2A46f2fFD99e19a89476E2f62270e0a35bBf0756/31438.mp4",
       "price": "302.5",
       "priceInDollar": "111289.749999999993122058",
       "auctionCreatedAt": 1602904186,
       "externalUrl": "https://makersplace.com/product/token/0x2A46f2fFD99e19a89476E2f62270e0a35bBf0756/31438",
       "backgroundColor": null,
       "metadata": {},
       "dappCoinrankingUrl": "https://coinranking.com/dapp/makersplace",
       "coinrankingUrl": "https://coinranking.com/nft/16443c43d6-makersplace-genesis"
     }
   }
 }

Error response

Error response - 404

Name Type Description
NFT_NOT_FOUND Object

Error response example - Response:

HTTP/1.1 404 Not found
 {
   "status": "fail",
   "type": "NFT_NOT_FOUND",
   "message": "NFT not found"
 }

Get NFTs

Get list of NFTs

GET /nfts

Query parameters

Name Type Description
limit (optional) Number

Limit. Used for pagination

Default value: 50
Size range: 0-100
offset (optional) Number

Offset. Used for pagination

Default value: 0
dappSlug (optional) String
orderBy (optional) String Default value: priceInDollar
Allowed values:
priceInDollar price auctionCreatedAt createdAt
orderDirection (optional) String Default value: desc
Allowed values:
desc asc

Examples

Example: cURL

curl https://api.coinranking.com/v2/nfts

Parameters examples

bash - limit

curl https://api.coinranking.com/v2/nfts?limit=10

bash - offset

curl https://api.coinranking.com/v2/nfts?offset=50

bash - dappSlug

curl https://api.coinranking.com/v2/nfts?dappSlug=cryptokitties

bash - orderBy

curl https://api.coinranking.com/v2/nfts?orderBy=auctionCreatedAt

bash - orderDirection

curl https://api.coinranking.com/v2/nfts?orderDirection=asc

Success response

Name Type Description
status String

Status of the request

Allowed values:
success
data Object
data.stats Object

A series of statistics regarding the requested list. Note that the stats its scope includes nfts outside the limit. E.g. the response of a query with a limit of 50 nfts returns 50 nfts (obviously), while the stats depicts the amount of nfts available without this limit, which may be a much higher number

data.stats.total Number

Total number of nfts within the query

data.stats.firstSeen Number

The timestamp of the oldest NFT within the query parameters

data.nfts Object[]

List of non-fungible tokens

data.nfts.id String

Unique identifier of the NFT

data.nfts.createdAt Number

Timestamp of when the NFT is listed on Coinranking

data.nfts.registryId String

Unique identifier of the registry. Every NFT belongs to a registry, or smart-contract address

data.nfts.dappSlug String

The URL friendly name of the Dapp

data.nfts.dappName String

Full name of the Dapp

data.nfts.tokenId String

Unique identifier of this NFT

data.nfts.name String/Null

Name of the NFT

data.nfts.image String/Null

URL to the image of this NFT

data.nfts.video String/Null

URL to the video of this NFT

data.nfts.price String/Null

Latest amount of tokens this NFT is sold for. The token used for transactions differs per Dapp, most Dapps have their own token

data.nfts.priceInDollar String/Null

Latest price this NFT is sold for in US Dollar

data.nfts.auctionCreatedAt Number/Null

A timestamp of the last auction. The price and priceInUsd are based on an auction that has taken place at this moment

data.nfts.externalUrl String/Null

URL to the website of the NFT, which in most cases is a page on the website of the Dapp

data.nfts.backgroundColor String/Null

A hexidecimal color code, which is suggested in the metadata as background color to show the NFT on

data.nfts.coinrankingUrl String/Null

URL about where to find this NFT on Coinranking

Success response example - Response:

HTTP/1.1 200 OK
 {
   "status": "success",
   "data": {
     "stats": {
       "total": 100062,
       "firstSeen": 1593700663
     },
     "nfts": [
       {
         "id": "88b10026c6b8d0f66570fa169c0106adaf397dba15c303942a60491be0b81879",
         "createdAt": 1604678591,
         "registryId": "007cf3ad37a57270a6ffdb91c8f222975cc12282ae57552ef860fd0368e8cd6a",
         "dappSlug": "axie-infinity",
         "dappName": "Axie Infinity",
         "tokenId": "1046",
         "name": "Angel",
         "image": "https://cdn.coinranking.com/nft/0xF5b0A3eFB8e8E4c201e2A935F110eAaF3FFEcb8d/1046.png",
         "video": null,
         "price": "300",
         "priceInDollar": "131969.9999999999931789",
         "auctionCreatedAt": 1604678591,
         "externalUrl": "https://axieinfinity.com/axie/1046",
         "backgroundColor": null,
         "coinrankingUrl": "https://coinranking.com/nft/88b10026c6-axie-infinity-angel"
       }
     ]
   }
 }

Error response

Error response - 422

Name Type Description
VALIDATION_ERROR Object

The request could not be validated. The response should provide more details.

Error response example - Response:

HTTP/1.1 422 Unprocessable Entity
 {
   "status": "fail",
   "type": "VALIDATION_ERROR",
   "messages": [
     "Limit can only be between 1 and 100."
   ]
 }