Get UUID by contract address

Find a specific coin by the contract address on its blockchain. We use the term contract address, but the name differs per ecosystem. For example, in Ethereum, it's called a smart contract address, others call it a token address, assetID, or something else.

GET /blockchain/:blockchain/:address

https://api.coinranking.com/v2/blockchain/:blockchain/:address

Path parameters

Parameter	Description
blockchain `String`	Name of the blockchain you want to request. You can find a list of all possible values by making a request to our blockchains endpoint.
address `String`	Address of the token you want to request. This is the same address as is used on the blockchain the token is minted on. For example, the Tether (USDT) contract address on Ethereum is 0xdac17f958d2ee523a2206206994597c13d831ec7. In our case, the address is case-insensitive.

Code examples

Response

HTTP/1.1 200 OK
{
  "status": "success",
  "data": {
    "coin": {
      "uuid": "razxDUgYGNAdQ",
      "name": "Ethereum",
      "symbol": "ETH",
      "contractAddresses": [
        "ethereum/0xNative",
        "bitcoin/0xBtc"
      ],
      "coinrankingUrl": "https://coinranking.com/coin/razxDUgYGNAdQ+ethereum-eth"
    }
  }
}

Response fields

Parameter	Description
status `String`	Status of the request Allowed values: success
data `Object`
data.coin `Object`
data.coin.UUID `String`	Uuid of the coin
data.coin.name `String`	Name of the coin
data.coin.symbol `String`	Symbol of the coin (e.g. BTC, ETH, XRP)
data.coin.contractAddresses `Object[]`	List of contract addresses for this coin. The format is `blockchain/contractAddress`. A single coin can be minted on multiple blockchains. For example, Tether (USDT) is available on Ethereum (ethereum/0xda...) Bitcoin Cash (bitcoin-cash/9fc...) and seven other blockchains.
data.coin.coinrankingUrl `String`	Where to find the coin on coinranking.com

Error response

HTTP/1.1 404 Not Found
{
  "status": "fail",
  "type": "COIN_NOT_FOUND",
  "message": "Coin not found"
}