Get currency information
posthttps://api.criptointercambio.com/v2/#getCurrenciesFullRetrieves currencies and their properties.
Disabled currencies have the "enabled": false property in the response.
Request
Header parameters
Requires authentication headers.
Body parameters
Consists of a JSON-RPC 2.0 protocol request object.
The params schema:
| Name | Type | Required | Description |
|---|---|---|---|
params | object | false | Request parameters. |
Sample request
{
"jsonrpc": "2.0",
"id": "exampleCustomIdValue",
"method": "getCurrenciesFull",
"params": {}
}
Response
The getCurrenciesFull response contains notification params. They may warn your customers. Also, they can make payments properly and significantly reduce the number of support inquiries.
Feel free to implement these params in your interface to improve the UX.
Successful response
Consists of a JSON-RPC 2.0 protocol response object.
The result schema:
| Name | Type | Description |
|---|---|---|
addressUrl | string | The blockchain address URL. |
blockchain | string | The currency blockchain. |
blockchainPrecision | integer | The maximum number of decimal places in a currency blockchain precision. |
coin | string | The currency token symbol. |
contractAddress | string | The contract address on the blockchain. Returns only if the currency has any contract address. |
enabled | boolean | Is enabled for exchange. |
enabledFrom | boolean | Is enabled for payin. |
enabledTo | boolean | Is enabled for payout. |
extraIdName | string | The extraId name. Returns for the enabled extraId. |
fixedTime | number | The time in milliseconds to pay for a fixed transaction. Depends on the currency. |
fixRateEnabled | boolean | Is enabled for fixed-rate transactions. |
fullname | string | The currency full name. |
image | string | The currency image URL. |
name | string | The currency name. |
network | string | The network related to a currency. |
notifications | object | Notifications about the currency. Returns only if the currency has any notification. |
»payin | string | The notification about the payin currency. Returns only if the payin currency has any notification. |
»payout | string | The notification about the payout currency. Returns only if the payout currency has any notification. |
payinConfirmations | integer | The number of payin confirmations. |
protocol | string | The currency protocol. |
ticker | string | The currency ticker. |
transactionUrl | string | The transaction URL. |
The getCurrenciesFull default response contains the protocol and blockchain params. If you want to receive information about the coin and network params, contact us at [email protected].
After that, getCurrenciesFull retrieves coin and network instead of protocol and blockchain.
Sample successful responses
Sample successful response with the blockchain and protocol params
{
"jsonrpc": "2.0",
"id": "exampleCustomIdValue",
"result": [
{
"addressUrl": "https://bithomp.com/explorer/%1$s",
"blockchain": "ripple",
"blockchainPrecision": 6,
"enabled": true,
"enabledFrom": true,
"enabledTo": true,
"extraIdName": "Destination Tag",
"fixedTime": 900000,
"fixRateEnabled": true,
"fullName": "XRP",
"image": "https://cdn.criptointercambio.com/icons/xrp.png",
"name": "XRP",
"payinConfirmations": 2,
"protocol": "XRP",
"ticker": "xrp",
"transactionUrl": "https://bithomp.com/explorer/%1$s"
}
]
}
Sample successful response with the coin and network params
{
"jsonrpc": "2.0",
"id": "exampleCustomIdValue",
"result": [
{
"addressUrl": "https://solana.fm/address/%1$s",
"blockchainPrecision": 6,
"coin": "cosmos",
"enabled": true,
"enabledFrom": true,
"enabledTo": true,
"extraIdName": "Memo",
"fixRateEnabled": true,
"fixedTime": 900000,
"fullName": "Cosmos",
"image": "https://cdn.criptointercambio.com/icons/atom.png",
"name": "ATOM",
"network": "atom",
"payinConfirmations": 10,
"ticker": "atom",
"transactionUrl": "https://atomscan.com/transactions/%1$s"
}
]
}
Error response
Consists of a JSON-RPC 2.0 protocol error response object.
Sample error response
{
"jsonrpc": "2.0",
"id": "exampleCustomIdValue",
"error": {
"code": -32603,
"message": "Internal Error"
}
}
Error codes
| Code | Message | Description |
|---|---|---|
-32600 | Error: You reached requests limit {limit} rps | RPS is out of the limit. |
-32603 |
| Mostly, this is a technical issue on our side. Requires further investigation. |