API Documentation

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 NFTs

Get list of NFTs

GET /nfts

Query parameters

NameTypeDescription
limit (optional)Number

Limit. Used for pagination

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

Offset. Used for pagination

Default value: 0
Size range: 1-300
dappSlug (optional)String
orderBy (optional)StringDefault value: priceInDollar
Allowed values:
priceInDollar price auctionCreatedAt createdAt
orderDirection (optional)StringDefault value: desc
Allowed values:
desc asc

Examples

Parameters examples

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"
       }
     ]
   }
 }

Response fields

NameTypeDescription
statusString

Status of the request

Allowed values:
success
dataObject
data.statsObject

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.totalNumber

Total number of nfts within the query

data.stats.firstSeenNumber

The timestamp of the oldest NFT within the query parameters

data.nftsObject[]

List of non-fungible tokens

data.nfts.idString

Unique identifier of the NFT

data.nfts.createdAtNumber

Timestamp of when the NFT is listed on Coinranking

data.nfts.registryIdString

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

data.nfts.dappSlugString

The URL friendly name of the Dapp

data.nfts.dappNameString

Full name of the Dapp

data.nfts.tokenIdString

Unique identifier of this NFT

data.nfts.nameString/Null

Name of the NFT

data.nfts.imageString/Null

URL to the image of this NFT

data.nfts.videoString/Null

URL to the video of this NFT

data.nfts.priceString/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.priceInDollarString/Null

Latest price this NFT is sold for in US Dollar

data.nfts.auctionCreatedAtNumber/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.externalUrlString/Null

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

data.nfts.backgroundColorString/Null

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

data.nfts.coinrankingUrlString/Null

URL about where to find this NFT on Coinranking

Error response

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

Error responses

Get NFT

Get a specific NFT

GET /nft/:id

Path parameters

NameTypeDescription
idString

The identifier of the NFT you want to retrieve. Note: the id for NFTs we use on the nft pages on coinranking.com are shortened ids. To fetch an NFT using this API you will need the full id. These full ids are provided in the nfts endpoint. In the future we will provide API endpoints to search for NFTs to make this process easier

Examples

Parameters examples

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"
     }
   }
 }

Response fields

NameTypeDescription
statusString

Status of the request

Allowed values:
success
dataObject
data.nftObject

A non-fungible token

data.nft.idString

The unique identifier of the NFt

data.nft.createdAtNumber

Date the NFT is listed on Coinranking

data.nft.registryIdString

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

data.nft.dappSlugString

The URL friendly name of the Dapp

data.nft.dappNameString

Full name of the Dapp

data.nft.dappExternalUrlString

URL to the website of the Dapp

data.nft.dappDescriptionString

Description of the Dapp

data.nft.dappImageString

URL to the logo of the Dapp

data.nft.registryBlockchainString

The blockchain the Dapp is release on

data.nft.registryContractAddressString

Smart contract address of the Dapp

data.nft.tokenIdString

Unique identifier of this NFT

data.nft.nameString/Null

Name of the NFT

data.nft.descriptionString

Description of the NFT

data.nft.imageString/Null

URL to the image of this NFT

data.nft.videoString/Null

URL to the video of this NFT

data.nft.priceString/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.priceInDollarString/Null

Latest price this NFT is sold for in US Dollar

data.nft.auctionCreatedAtNumber/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.externalUrlString/Null

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

data.nft.backgroundColorString/Null

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

data.nft.metadataObject/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.dappCoinrankingUrlString

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

data.nft.coinrankingUrlString/Null

URL about where to find this NFT on Coinranking

Error response

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

Error responses

Get Dapps

Get list of Dapps

GET /dapps

Query parameters

NameTypeDescription
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

Parameters examples

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"
       }
     ]
   }
 }

Response fields

NameTypeDescription
statusString

Status of the request

Allowed values:
success
dataObject
data.statsObject

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.totalNumber

Total number of dapps within the query

data.dappsObject[]

List of Dapps

data.dapps.slugString

URL friendly name of the Dapp

data.dapps.nameString

Full name of the Dapp

data.dapps.descriptionString

Short description of the Dapp, used as a summary

data.dapps.websiteUrlString

URL to the website of the Dapp

data.dapps.imageString

URL to logo of the Dapp

data.dapps.numberOfRegistriesNumber

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

data.dapps.numberOfNftsNumber

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

data.dapp.coinrankingUrlString

Where to find the Dapp on coinranking.com

Error response

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

Error responses

Get Dapp

Get a specific Dapp

GET /dapp/:slug

Path parameters

NameTypeDescription
slugString

Examples

Parameters examples

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"
       }
     ]
   }
 }

Response fields

NameTypeDescription
statusString

Status of the request

Allowed values:
success
dataObject
data.dappObject
data.dapp.slugString

Short URL friendly name of the Dapp

data.dapp.nameString

Full name of the Dapp

data.dapp.descriptionString

Short description of the Dapp, used as a summary

data.dapp.fullDescriptionString

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

data.dapp.websiteUrlString

URL to the website of the Dapp

data.dapp.imageString

URL to logo of the Dapp

data.dapp.numberOfRegistriesNumber

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

data.dapp.numberOfNftsNumber

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

data.dapp.linksObject[]

List of links, like social media pages

data.dapp.links.urlString

Url to the specific link

data.dapp.links.nameString

Name of the link

data.dapp.links.typeString

The type of link

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

Where to find the Dapp on coinranking.com

data.registriesObject[]

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.idString

Unique ID of the registry

data.registries.nameString

Name of the registry.

data.registries.descriptionString

Description of the registry

data.registries.contractAddressString

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

data.registries.blockchainString

The blockchain this Dapp is released on

Error response

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

Error responses