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

Path parameters

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


HTTP/1.1 200 OK
  "status": "success",
  "data": {
    "coin": {
      "uuid": "razxDUgYGNAdQ",
      "name": "Ethereum",
      "symbol": "ETH",
      "contractAddresses": [
      "coinrankingUrl": ""

Response fields

Parameter Description
status String

Status of the request

Allowed values:
data Object
data.coin Object
data.coin.UUID String

Uuid of the coin 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

Error response

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

Error responses