Get coin blockchains
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
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: 50Size range: 0-100 Example:
...coin/cVaOmQWainv7g/issuance-blockchains?limit=10
|
offset (optional) Number |
Offset. Used for pagination. Default value: 0Example:
...coin/cVaOmQWainv7g/issuance-blockchains?offset=50
|
cursor (optional) String |
Cursor for pagination. Use the
...coin/cVaOmQWainv7g/issuance-blockchains?cursor=eyJ0IjoxLC...
|
Code examples
Response
jsonHTTP/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
jsonHTTP/1.1 422 Unprocessable Entity
{
"status": "fail",
"type": "VALIDATION_ERROR",
"messages": [
"Limit can only be between 1 and 100."
]
}
Previous
Next