Get coin blockchains

Growth This endpoint requires the growth plan or higher. Free, Basic and Startup plans can use preview access.

Get the blockchains on which the coin is issued. Most of the time this is only one blockchain, but some coins are issued on multiple blockchains. We call the relation of a coin to a blockchain the issuance blockchain.

https://api.coinranking.com/v2/coin/:uuid/issuance-blockchains

Preview access

Free, Basic and Startup plans can test this endpoint with five successful requests per account per UTC day. Use the documented endpoint URL with your existing API key. Preview access is applied automatically. The allowance resets at 00:00 UTC.

All API keys, resource IDs, query parameters and pagination requests share this endpoint's allowance for your account. Failed requests do not consume the preview allowance. Successful previews also count toward your normal API usage, and your plan's result, historical-window and rate limits still apply. See endpoint previews for limits, response headers and quota errors.

Path parameters

Parameter	Description
uuid `String`	UUID of the coin you want to request the blockchains for.

Query parameters

Parameter	Description
limit (optional) `Number`	Limit. Used for pagination. Default value: 50 Size range: 0-100 Example: `https://api.coinranking.com/v2/coin/cVaOmQWainv7g/issuance-blockchains?limit=10`
offset (optional) `Number`	Offset. Used for pagination. Default value: 0 Example: `https://api.coinranking.com/v2/coin/cVaOmQWainv7g/issuance-blockchains?offset=50`
cursor (optional) `String`	Cursor for pagination. Use the `nextCursor` value from the previous response to get the next page of results, or the `previousCursor` value to navigate back to the previous page. See Pagination for more information. Example: `https://api.coinranking.com/v2/coin/cVaOmQWainv7g/issuance-blockchains?cursor=eyJ0IjoxLC...`

Code examples

curl 'https://api.coinranking.com/v2/coin/cVaOmQWainv7g/issuance-blockchains?limit=50&offset=0' \
  -H 'x-access-token: your-api-key' \
  -G

const options = {
  headers: {
    'x-access-token': 'your-api-key',
  },
};

fetch('https://api.coinranking.com/v2/coin/cVaOmQWainv7g/issuance-blockchains?limit=50&offset=0', options)
  .then((response) => response.json())
  .then((result) => console.log(result));

<?php
  $curl = curl_init();

  curl_setopt_array($curl, array(
    CURLOPT_URL => "https://api.coinranking.com/v2/coin/cVaOmQWainv7g/issuance-blockchains?limit=50&offset=0",
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_ENCODING => "",
    CURLOPT_MAXREDIRS => 10,
    CURLOPT_TIMEOUT => 0,
    CURLOPT_FOLLOWLOCATION => true,
    CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
    CURLOPT_CUSTOMREQUEST => "GET",
    CURLOPT_HTTPHEADER => array(
      "x-access-token: your-api-key"
    ),
  ));

  $response = curl_exec($curl);

  curl_close($curl);
  echo $response;

import requests

headers = {
  'x-access-token': 'your-api-key'
}

response = requests.request("GET", "https://api.coinranking.com/v2/coin/cVaOmQWainv7g/issuance-blockchains?limit=50&offset=0", headers=headers)

print(response.text)

Response

HTTP/1.1 200 OK
 {
   "status": "success",
   "data": {
     "total": 1,
     "issuanceBlockchains": [
       {
         "name": "Ethereum",
         "referenceName": "Ethereum contract address",
         "reference": "0x1985365e9f78359a9B6AD760e32412f4a445E862",
         "blockExplorerUrl": "https://etherscan.io/token/0x1985365e9f78359a9B6AD760e32412f4a445E862",
         "migratedToReference": "0x221657776846890989a759ba2973e427dff5c9bb",
         "migrationDate": 1640757180
       }
     ]
   },
   "pagination": {
     "limit": 50,
     "hasNextPage": false,
     "hasPreviousPage": false,
     "nextCursor": null,
     "previousCursor": null
   }
 }

Response fields

Error	Description
status `String`	Status of the request Allowed values: success
data `Object`
data.total `Number`	Total number of issuance blockchains for the coin.
data.issuanceBlockchains `Object[]`
data.issuanceBlockchains.name `String`	Name of the blockchain.
data.issuanceBlockchains.referenceName `String/null`	Blockchain specific coin reference name. For instance, 'Ethereum contract address' for a coin's reference on the Ethereum blockchain.
data.issuanceBlockchains.reference `String/null`	Reference address of the coin on the blockchain. Null means it is the blockchain's native coin. For example this is the smart contract address of a coin if it is issued on the Ethereum blockchain and the asset code if the coin is issued on the Stellar blockchain.
data.issuanceBlockchains.blockExplorerUrl `String/null`	The supplies are fetched from third parties, called block explorers. The url links to the website of the block explorer, and if possible to the specific token.
data.issuanceBlockchains.migratedToReference `String/null`	The new reference address that this coin has moved to on the same blockchain. This happens when a coin's smart contract is upgraded or replaced, and the old contract address is no longer used.
data.issuanceBlockchains.migrationDate `Number/null`	Epoch timestamp of when the coin was migrated to the new reference address.
pagination `Object`	Pagination information. See Pagination for more details.
pagination.limit `Number`	The number of results per page
pagination.hasNextPage `Boolean`	Whether there are more results available after the current page
pagination.hasPreviousPage `Boolean`	Whether there are results available before the current page
pagination.nextCursor `String/null`	Cursor to use for the next page, or null if there are no more results
pagination.previousCursor `String/null`	Cursor to use for the previous page, or null if on the first page

Error response

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

Error responses

Name	Type	Description
VALIDATION_ERROR	`Object`	The request could not be validated. The response should provide more details.
INVALID_CURSOR	`Object`	The cursor string is malformed or could not be decoded. Start pagination from the beginning without a cursor.
CURSOR_MISMATCH	`Object`	The cursor was created with different orderBy or orderDirection parameters. Match the original parameters or start over.
PAGINATION_CONFLICT	`Object`	Both cursor and offset parameters were provided. Use only one pagination method per request.