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.
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
jsonHTTP/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
|
data.coin.coinrankingUrl String |
Where to find the coin on coinranking.com |
Error response
jsonHTTP/1.1 404 Not Found
{
"status": "fail",
"type": "COIN_NOT_FOUND",
"message": "Coin not found"
}
Previous
Next