Coin
Get list of coins
If you need to fetch multiple coins, this is the endpoint you need. It provides the most crucial data of coins in a handy filterable list.
https://insight.djuno.io/v1/coins
Query parameters
Parameter | Description |
referenceCurrencyUuid (optional) | UUID of coin (either fiat or crypto), in which all the prices are calculated. Defaults to US Dollar, but you can use any coin. You can find UUIDs for reference currencies in any coin endpoint, including a convenient dedicated reference currency endpoint Default value: yhjMzLPhuIDl |
timePeriod (optional) | By setting the timePeriod the change percentage and sparkline in the response will be calculated accordingly. Default value: 24h |
symbols (optional) | Symbols to filter the list on. Do note that symbols are not unique. Should you need a specific coin, then you should use the UUIDs filter. Example: |
contractAddresses (optional) | Contract Addresses to filter the list on. These are the addresses currencies get on their respective blockchains. Smart Contract Addresses are a common name for addresses on blockchains, but some chains might call them AssetID, Token Address or something else. We use the term Contract Address to cover all these cases. Note that tokens might be issued on several blockchains, so the same token might have several addresses Example: |
blockchains (optional) | Blockchains to filter the list on. With this filter you can for example fetch only coins that are minted on the Ethereum blockchain. You can filter on multiple blockchains at once. Example: |
uuids (optional) | UUIDs to filter the list on. If you know the UUIDs of the coins you want to fetch, you can use this filter to get the specific coins. Example: |
tiers (optional) | We separate coins into three tiers. With this parameter you can filter coins on the tiers you need. Allowed values: |
tags (optional) | Tags to filter the list on. Allowed values: |
orderBy (optional) | Index to order by. All sortings excluding listedAt still take our different tiers of coins into account. Default value: marketCapAllowed values:price marketCap 24hVolume change listedAtExample:...coins?orderBy=price |
orderDirection (optional) | Applies direction to the orderBy query, which can be in ascending or descending order. Default value: desc |
limit (optional) | Limit. Used for pagination. The maximum amount of results you can fetch in one request is 5000 for the Startup and Professional plan, and 100 for the Free plan. Default value: 50 |
offset (optional) | Offset. Used for pagination. Default value: 0 |
Code examples
curl https://insight.djuno.io/v1/coins \
-H 'x-api-key: your-api-key' \
-G
Response
HTTP/1.1 200 OK
{
"status": "success",
"data": {
"stats": {
"total": 3
},
"currencies": [
{
"uuid": "Qwsogvtv82FCd",
"type": "coin",
"symbol": "BTC",
"name": "Bitcoin",
"iconUrl": "https://cdn.coinranking.com/bOabBYkcX/bitcoin_btc.svg",
"sign": "₿"
},
{
"uuid": "razxDUgYGNAdQ",
"type": "coin",
"symbol": "ETH",
"name": "Ethereum",
"iconUrl": "https://cdn.coinranking.com/rk4RKHOuW/eth.svg",
"sign": "Ξ"
},
{
"uuid": "yhjMzLPhuIDl",
"type": "fiat",
"symbol": "USD",
"name": "US Dollar",
"iconUrl": "https://cdn.coinranking.com/kz6a7w6vF/usd.svg",
"sign": "$"
}
]
}
}
Response fields
Property | Description |
status | Status of the request Allowed values: |
data |
|
data.stats | A series of statistics regarding the requested list. Note that the stats its scope includes coins outside the limit. E.g. the response of a query with a limit of 50 coins returns 50 coins (obviously), while the stats depicts the amount of coins available, 24 hour volume, etc. without this limit, which may be a much higher number. |
data.stats.total | Total number of coins within the query |
data.stats.totalCoins | Total number of coins without the filters |
data.stats.totalMarkets | Total number of markets without the filters |
data.stats.totalExchanges | Total number of exchanges without the filters |
data.stats.totalMarketCap | The market capital of coins without the filters |
data.stats.total24hVolume | The volume over the last 24 hours of coins without the filters |
data.coins | List of coins |
data.coins.uuid | UUID of the coin |
data.coins.symbol | Currency symbol |
data.coins.name | Name of the coin |
data.coins.color | Main HEX color of the coin |
data.coins.iconUrl | Location of the icon |
data.coins.24hVolume | 24h trade volume |
data.coins.marketCap | Market capitalization. Price times circulating supply |
data.coins.price | Price of the coin |
data.coins.btcPrice | Price of the coin expressed in Bitcoin |
data.coins.listedAt | Epoch timestamp of when we started listing the coin. |
data.coins.change | Percentage of change over the given time period |
data.coins.rank | The position in the ranks |
data.coins.sparkline | Array of prices based on the time period parameter, useful for a sparkline |
data.coins.coinrankingUrl | Where to find the coin on coinranking.com |
data.coins.contractAddresses | List of contract addresses for this coin. The format is |
Error response
HTTP/1.1 422 Unprocessable Entity
{
"status": "fail",
"type": "REFERENCE_UNAVAILABLE",
"message": "Reference currency with UUID of HxDUgYGNAdQz not available"
}
Error responses
404
Error | Description |
VALIDATION_ERROR | The request could not be validated. The response should provide more details. |
REFERENCE_UNAVAILABLE | The reference currency used in the request is not available. Choose another UUID. |
Coin details
When you need data about a specific coin, you need our coin details endpoint. This provides more specific data then the list endpoint, such as links to socials and supply information.
https://insight.djuno.io/v1/coin/:uuid
Path parameters
Parameter | Description |
uuid | UUID of the coin you want to request. |
Query parameters
Parameter | Description |
referenceCurrencyUuid (optional) | UUID of coin (either fiat or crypto), in which all the prices are calculated. Defaults to US Dollar, but you can use any coin. You can find UUIDs for reference currencies in any coin endpoint, including a convenient dedicated reference currency endpoint Default value: yhjMzLPhuIDl |
timePeriod (optional) | Time period where the change and sparkline are based on Default value: 24h |
Code examples
curl https://insight.djuno.io/v1/coin/Qwsogvtv82FCd \
-H 'x-api-key: your-api-key' \
-G
Response
HTTP/1.1 200 OK
{
"status": "success",
"data": {
"coin": {
"uuid": "Qwsogvtv82FCd",
"symbol": "BTC",
"name": "Bitcoin",
"description": "Bitcoin is the first decentralized digital currency.",
"color": "#f7931A",
"iconUrl": "https://cdn.coinranking.com/Sy33Krudb/btc.svg",
"websiteUrl": "https://bitcoin.org",
"links": [
{
"name": "Bitcoin",
"url": "https://www.reddit.com/r/Bitcoin/",
"type": "reddit"
}
],
"supply": {
"confirmed": true,
"supplyAt": 1640757180,
"circulating": "17009275",
"total": "17009275",
"max": "21000000"
},
"24hVolume": "6818750000",
"marketCap": "159393904304",
"fullyDilutedMarketCap": "196790985529",
"price": "9370.9993109108",
"btcPrice": "1",
"priceAt": 1640757180,
"change": "-0.52",
"rank": 1,
"numberOfMarkets": 9800,
"numberOfExchanges": 190,
"sparkline": [
"9515.0454185372",
"9540.1812284677",
"9554.2212643043",
"9593.571539283",
"9592.8596962985",
"9562.5310295967",
"9556.7860427046",
"9388.823394515",
"9335.3004209165",
"9329.4331700521",
"9370.9993109108"
],
"allTimeHigh": {
"price": "19500.471361532",
"timestamp": 1513555200
},
"coinrankingUrl": "https://coinranking.com/coin/Qwsogvtv82FCd+bitcoin-btc",
"lowVolume": false,
"listedAt": 1483228800,
"notices": [
{
"type": "MESSAGE",
"value": "Lorem ipsum dolor sit amet"
}
],
"contractAddresses": [],
"tags": [
"staking",
"layer-1"
]
}
}
}
Response fields
Property | Description |
status | Status of the request Allowed values: |
data |
|
data.coin |
|
data.coin.uuid | UUID of the coin |
data.coin.symbol | Currency symbol |
data.coin.name | Name of the coin |
data.coin.description | Small description of the coin |
data.coin.color | Main HEX color of the coin |
data.coin.iconUrl |
|
data.coin.websiteUrl | URL of the primary website |
data.coin.links | List of links, like social media pages |
data.coin.links.name | Name of the link |
data.coin.links.url | Url to the specific link |
data.coin.links.type | The type of link Allowed values: |
data.coin.supply |
|
data.coin.supply.confirmed | Coins without a confirmed supply are ranked below coins with a confirmed supply. Read about our methodology. |
data.coin.supply.supplyAt | Epoch timestamp of when the supply was synchronized. If the supply was never synchronized or the supply is manually updated the API will return null. |
data.coin.supply.total | Number of coins that are in existence |
data.coin.supply.circulating | Number of coins that are circulating in the public market |
data.coin.supply.max | Maximum amount the coin's supply can ever be. |
data.coin.marketCap | Market capitalization. Price times circulating supply |
data.coin.fullyDilutedMarketCap | Market capitalization. Price times circulating supply Full Market capitalization. Fully diluted market cap is a coin's price multiplied by its max supply. Or total supply if the max supply is not known. It shows what the market cap could be if all coins were in circulation, with the current price. |
data.coin.price | Price of the coin |
data.coin.btcPrice | Price of the coin expressed in Bitcoin |
data.coin.priceAt | Epoch timestamp of when the price was calculated. |
data.coin.24hVolume | 24h trade volume |
data.coin.change | Percentage of change over the given time period |
data.coin.rank | The position in the ranks |
data.coin.numberOfMarkets | The number of markets that contain the this coin |
data.coin.numberOfExchanges | The number of exchanges that trade this coin |
data.coin.sparkline | Array of prices based on the time period parameter, useful for a sparkline |
data.coin.allTimeHigh |
|
data.coin.allTimeHigh.price | The highest price that the coin has reached |
data.coin.allTimeHigh.timestamp | An Epoch timestamp in seconds when the coin reached its highest price. |
data.coin.coinrankingUrl | Where to find the coin on coinranking.com |
data.coin.lowVolume | If the coin is not much traded on listed exchanges it is marked as having a low volume. The threshold is currently set at the equivalent of 500.000 US Dollar in 24 hours |
data.coin.listedAt | Epoch timestamp of when we started listing the coin. |
data.coin.notices | List of notices, which signal some important information about the coin. The notices are in JSON format, and in most cases consist of a "type" property with an important keyword such as "WARNING", and a more human readable message in a "value" property. |
data.coin.contractAddresses | List of contract addresses for this coin. The format is |
data.coin.tags | List of tags, like "Staking" or "Meme" |
Error response
HTTP/1.1 404 Not Found
{
"status": "fail",
"type": "COIN_NOT_FOUND",
"message": "Coin not found"
}
Error responses
404
Name type | Description |
COIN_NOT_FOUND | The coin could not be found. Try another UUID |
422
Name type | Description |
VALIDATION_ERROR | The request could not be validated. The response should provide more details. |
REFERENCE_UNAVAILABLE | The reference currency used in the request is not available. Choose another UUID. |
Coin price
Simple endpoint, to fetch a single price point for a coin. You can specify a timestamp to get the price for some earlier date.
https://insight.djuno.io/v1/coin/:uuid/price
Path parameters
Parameter | Description |
uuid | UUID of the coin you need the price. |
Query parameters
Parameter | Description |
referenceCurrencyUuid (optional) | UUID of coin (either fiat or crypto), in which all the prices are calculated. Defaults to US Dollar, but you can use any coin. You can find UUIDs for reference currencies in any coin endpoint, including a convenient dedicated reference currency endpoint Default value: yhjMzLPhuIDl |
timestamp (optional) | The timestamp parameter accepts an epoch timestamp in seconds. This timestamp is used to find the nearest available price point, selecting the data's granularity based on the age of the request:
If no timestamp is provided, this endpoint will default to the latest price. Example: |
Code examples
curl https://insight.djuno.io/v1/coin/Qwsogvtv82FCd/price \
-H 'x-api-key: your-api-key' \
-G
Response
HTTP/1.1 200 OK
{
"status": "success",
"data": {
"price": "7305.985182338483",
"timestamp": 1586305740
}
}
Response fields
Property | Description |
status | Status of the request Allowed values: |
data |
|
data.price | The price of the requested coin at the requested time |
data.timestamp | An Epoch timestamp in seconds when the coin had the given price. Might differ from the provided timestamp in the request, because it is stripped down to the day, hour or minute. |
Error response
HTTP/1.1 404 Not Found
{
"status": "fail",
"type": "COIN_NOT_FOUND",
"message": "Coin not found"
}
Error responses
404
Error | Description |
PRICE_NOT_FOUND | No price could be calculated for this request. Try another coin and/or another reference currency |
COIN_NOT_FOUND | The coin could not be found. Try another UUID |
422
Error | Description |
VALIDATION_ERROR | The request could not be validated. The response should provide more details. |
REFERENCE_UNAVAILABLE | The reference currency used in the request is not available. Choose another UUID. |
Coin price history
Gets you a series of pricepoints going back in time a day, a year or some other period of time.
https://insight.djuno.io/v1/coin/:uuid/history
Path parameters
Parameter | Description |
uuid | UUID of the coin you want to request |
Query parameters
Parameter | Description |
timePeriod (optional) | Timeperiod where the change and history are based on Default value: 24h |
referenceCurrencyUuid (optional) | UUID of coin (either fiat or crypto), the price of the reference currency is used to calculate the volume. Defaults to US Dollar, but you can use any coin. You can find UUIDs for reference currencies in any coin endpoint, including a convenient dedicated reference currency endpoint Default value: yhjMzLPhuIDl |
Code examples
curl https://insight.djuno.io/v1/coin/Qwsogvtv82FCd/history \
-H 'x-api-key: your-api-key' \
-G
Response
HTTP/1.1 200 OK
{
"status": "success",
"data": {
"change": "12",
"history": [
{
"price": "41905.99687434882803047615",
"timestamp": 1641897900
},
{
"price": "41937.93174219252237197408",
"timestamp": 1641897600
}
]
}
}
Response fields
Property | Description |
status | Status of the request Allowed values: |
data |
|
data.change | Percentage of change over the given time frame |
data.history | List of prices |
data.history.price | Price of the coin |
data.history.timestamp | An Epoch timestamp in seconds when the coin had the given price. |
Error response
HTTP/1.1 404 Not Found
{
"status": "fail",
"type": "COIN_NOT_FOUND",
"message": "Coin not found"
}
Error responses
404
Error | Description |
COIN_NOT_FOUND | The coin could not be found. Try another UUID |
422
Error | Description |
VALIDATION_ERROR | The request could not be validated. The response should provide more details. |
REFERENCE_UNAVAILABLE | The reference currency used in the request is not available. Choose another UUID. |
Coin OHLC
Similar to coin price history, but with OHLC (Open High Low Close) data, which is often used to make candlestick charts.
https://insight.djuno.io/v1/coin/:uuid/ohlc
Path parameters
Parameter | Description |
uuid | UUID of the coin you want to request the OHLC data for. |
Query parameters
Parameter | Description |
interval (optional) | The interval determines the time period over which each OHLC item is determined. Default value: day |
limit (optional) | Limit. Limit the amount of time periods for which the OHLC data is retrieved. For example, when interval=hour and limit is 10, data will be returned for the last 10 hours. The maximum amount of results you can fetch in one request is 5000 for the Startup and Professional plan, and 100 for the Free plan. Default value: 50 |
referenceCurrencyUuid (optional) | UUID of coin (either fiat or crypto), in which all the prices are calculated. Defaults to US Dollar, but you can use any coin. You can find UUIDs for reference currencies in any coin endpoint, including a convenient dedicated reference currency endpoint Default value: yhjMzLPhuIDl |
Code examples
curl https://insight.djuno.io/v1/coin/Qwsogvtv82FCd/ohlc \
-H 'x-api-key: your-api-key' \
-G
Response
HTTP/1.1 200 OK
{
"status": "success",
"data": {
"ohlc": [
{
"startingAt": 1641427200,
"open": "43639.170052896734",
"high": "43830.15844443845",
"low": "42679.105282492994",
"close": "43253.82606224523",
"avg": "43194.86335084649"
},
{
"startingAt": 1641340800,
"open": "45997.97595190101",
"high": "47050.58243007133",
"low": "42923.375181467185",
"close": "43639.198327313374",
"avg": "46022.85506904964"
}
]
}
}
Response fields
Property | Description |
status | Status of the request Allowed values: |
data |
|
data.ohlc | List of OHLC items |
data.ohlc.startingAt | An Epoch timestamp in seconds marking the start of the time period on which the OHLC values are based. |
data.ohlc.open | Opening price of the coin for the time period |
data.ohlc.high | Highest price of the coin during the time period |
data.ohlc.low | Lowest price of the coin during the time period |
data.ohlc.close | Closing price of the coin for the time period |
data.ohlc.avg | Average price of the coin over the time period |
Error response
HTTP/1.1 404 Not Found
{
"status": "fail",
"type": "COIN_NOT_FOUND",
"message": "Coin not found"
}
Error responses
404
Error | Description |
COIN_NOT_FOUND | The coin could not be found. Try another UUID |
422
Error | Description |
VALIDATION_ERROR | The request could not be validated. The response should provide more details. |
REFERENCE_UNAVAILABLE | The reference currency used in the request is not available. Choose another UUID. |
Coin exchanges listings
Returns a list of exchanges for a specific coin. Meaning that if you want to know what exchanges a coin is being traded on, this endpoint helps you out.
https://insight.djuno.io/v1/coin/:uuid/exchanges
Path parameters
Parameter | Description |
uuid | UUID of the coin you want to request exchanges for |
Query parameters
Parameter | Description |
referenceCurrencyUuid (optional) | UUID of coin (either fiat or crypto), in which all the prices are calculated. Defaults to US Dollar, but you can use any coin. You can find UUIDs for reference currencies in any coin endpoint, including a convenient dedicated reference currency endpoint Default value: yhjMzLPhuIDl |
limit (optional) | Limit. Used for pagination. The maximum amount of results you can fetch in one request is 5000 for the Startup and Professional plan, and 100 for the Free plan. Default value: 50 |
offset (optional) | Offset. Used for pagination Default value: 0 |
orderBy (optional) | Index to order by. Default is 24h volume. Default value: 24hVolume |
orderDirection (optional) | Order in ascending or descending order Default value: desc |
search (optional) | Value to search for within results, i.e. exchange names Example: |
Code examples
curl https://insight.djuno.io/v1/coin/Qwsogvtv82FCd/exchanges \
-H 'x-api-key: your-api-key' \
-G
Response
HTTP/1.1 200 OK
{
"status": "success",
"stats": {
"24hVolume": "27739840257.811882",
"total": 278
},
"exchanges": [
{
"coinrankingUrl": "https://coinranking.com/exchange/Z7wAB_T0o+coinsbit",
"rank": 1,
"uuid": "Z7wAB_T0o",
"verified": false,
"recommended": false,
"numberOfMarkets": 22,
"name": "Coinsbit",
"iconUrl": "https://cdn.coinranking.com/Xx7PRnP31/coinsbit.svg",
"24hVolume": "2092377039.0491314",
"price": "6954.329554998793",
"btcPrice": "1"
},
{
"coinrankingUrl": "https://coinranking.com/exchange/8JlYgQMK+bkex",
"rank": 2,
"uuid": "8JlYgQMK",
"verified": false,
"recommended": false,
"numberOfMarkets": 14,
"name": "BKEX",
"iconUrl": "https://cdn.coinranking.com/uNp-AXDRf/BKEX.svg",
"24hVolume": "1793966025.8889403",
"price": "6952.4065930949655",
"btcPrice": "1"
}
]
}
Response fields
Property | Description |
status | Status of the request Allowed values: |
data |
|
data.stats |
|
data.stats.24hVolume | Total 24h volume of exchanges in the reference currency |
data.stats.total | Total number of exchanges |
data.exchanges |
|
data.exchanges.coinrankingUrl | The url to the page on Coinranking for this exchange |
data.exchanges.uuid | UUID of the exchange |
data.exchanges.name | Name of the exchange |
data.exchanges.iconUrl | Location of the icon |
data.exchanges.verified | DEPRECATED Exchanges that are verified to not participate in harmful practices such as wash trading are marked as verified. |
data.exchanges.recommended | Whether the exchange is recommended based on our criteria, see https://support.coinranking.com/article/82-recommended-exchanges |
data.exchanges.numberOfMarkets | Number of markets of the exchange paired with Coinranking |
data.exchanges.rank | Rank of the exchange based on volume, taking into account exchange and currency filters |
data.exchanges.24hVolume | Total volume in 24 hours |
data.exchanges.price | Price of the chosen coin on this exchange |
data.exchanges.btcPrice | Price of the chosen coin expressed in Bitcoin |
Error response
HTTP/1.1 422 Unprocessable Entity
{
"status": "fail",
"type": "REFERENCE_UNAVAILABLE",
"message": "Reference currency not available"
}
Error responses
404
Error | Description |
COIN_NOT_FOUND | The coin could not be found. Try another UUID. |
422
Error | Description |
VALIDATION_ERROR | The request could not be validated. The response should provide more details. |
REFERENCE_UNAVAILABLE | The reference currency used in the request is not available. Choose another UUID. |
Coin market listings
Similar to coin exchange listings, but a level deeper; you can find what markets a coin is trade on
https://insight.djuno.io/v1/coin/:uuid/markets
Path parameters
Parameter | Description |
uuid | UUID of the coin you want to request markets for. |
Query parameters
Parameter | Description |
referenceCurrencyUuid (optional) | UUID of coin (either fiat or crypto), the price of the reference currency is used to calculate the volume. Defaults to US Dollar, but you can use any coin. You can find UUIDs for reference currencies in any coin endpoint, including a convenient dedicated reference currency endpoint UUID of coin (either fiat or crypto), the price of the reference currency is used to calculate the volume. Defaults to US Dollar, but you can use any coin. You can find UUIDs for reference currencies in any coin endpoint, including a convenient dedicated reference currency endpoint Default value: yhjMzLPhuIDl |
limit (optional) | Limit. Used for pagination. The maximum amount of results you can fetch in one request is 5000 for the Startup and Professional plan, and 100 for the Free plan. Default value: 50 |
offset (optional) | Offset. Used for pagination Default value: 0 |
orderBy (optional) | Index to sort on. Default is 24h volume. Default value: 24hVolume |
orderDirection (optional) | Order in ascending or descending order Default value: desc |
search (optional) | Value to search for within results, e.g. exchange names, currency names, or currency symbols Example: |
Code examples
curl https://insight.djuno.io/v1/coin/Qwsogvtv82FCd/markets
-H 'x-api-key: your-api-key' \
-G
Response
HTTP/1.1 200 OK
{
"status": "success",
"data": {
"stats": {
"24hVolume": "2795922.586905519",
"total": 3
},
"markets": [
{
"uuid": "xk9M2LuHuID5",
"base": {
"uuid": "Qwsogvtv82FCd",
"symbol": "BTC"
},
"quote": {
"uuid": "yhjMzLPhuIDl",
"symbol": "USD"
},
"exchange": {
"uuid": "-zdvbieRdZ",
"name": "Binance",
"iconUrl": "https://cdn.coinranking.com/d6w2Hj3z0/BitMEX.svg"
},
"24hVolume": "771875964.9750752",
"price": "3842.9444791178726",
"btcPrice": "1",
"rank": 1,
"marketShare": "30.48",
"recommended": true,
"filters": []
},
{
"uuid": "bn7nTLHHuIq2",
"base": {
"uuid": "Qwsogvtv82FCd",
"symbol": "BTC"
},
"quote": {
"uuid": "HIVsRcGKkPFtW",
"symbol": "USDT"
},
"exchange": {
"uuid": "qn5ZJmPFP",
"name": "Coinbase Pro",
"iconUrl": "https://cdn.coinranking.com/Ama6htyHL/coinbase.svg"
},
"24hVolume": "311344830.86823833",
"price": "3869.146354559396",
"btcPrice": "1",
"rank": 2,
"marketShare": "12.35",
"recommended": true,
"filters": []
}
]
}
}
Response fields
Property | Description |
status | Status of the request Allowed values: |
data |
|
data.stats |
|
data.stats.24hVolume | Total 24h volume of exchanges in the reference currency |
data.stats.total | Total number of exchanges |
data.markets |
|
data.markets.uuid | UUID of the market |
data.markets.base | The coin on the left side of the pair, which price is calculated in units of the quote |
data.markets.base.uuid | UUID of the baseCurrency of the market |
data.markets.base.symbol | Symbol of the baseCurrency of the market |
data.markets.quote | The coin on the right side of the pair. The amount in tickers are how much quote you get for one unit of base. E.g. BTC/USD 10.000 means 1 BTC is traded for 10.000 USD. |
data.markets.quote.symbol | Symbol of the quoteCurrency of the market |
data.markets.quote.uuid | UUID of the quoteCurrency of the market |
data.markets.exchange | Exchange this market belongs to |
data.markets.exchange.name | Name of the exchange |
data.markets.exchange.uuid | UUID of the exchange |
data.markets.exchange.iconUrl | Location of the icon |
data.markets.24hVolume | 24h volume of the latest ticker in the reference currency |
data.markets.price | Price of the latest ticker in reference currency |
data.markets.btcPrice | Price of the latest ticker expressed in Bitcoin |
data.markets.rank | Rank of the market based on volume, taking into account exchange and currency filters |
data.markets.marketShare | Percentage of the total market volume reprented by this market, taking into account exchange and currency filters |
data.markets.recommended | Whether the market is recommended based on the exchange it belongs to, see https://support.coinranking.com/article/82-recommended-exchanges |
data.markets.filters | An array of filters that are applied to the market. Most of the filters will cause the market to not be included in the price calculation of the coins. Allowed values: |
Error response
HTTP/1.1 422 Unprocessable Entity
{
"status": "fail",
"type": "REFERENCE_UNAVAILABLE",
"message": "Reference currency not available"
}
Error responses
404
Error | Description |
COIN_NOT_FOUND | The coin could not be found. Try another UUID |
422
Error | Description |
VALIDATION_ERROR | The request could not be validated. The response should provide more details. |
REFERENCE_UNAVAILABLE | The reference currency used in the request is not available. Choose another UUI |
Coin blockchains
DEPRECATED: this endpoint is meant to find the blockchain or blockchains a coin is minted on.
https://insight.djuno.io/v1/coin/:uuid/issuance-blockchains
Path parameters
Parameter | Description |
uuid | UUID of the coin you want to request the blockchains for. |
Query parameters
Parameter | Description |
limit (optional) | Limit. Used for pagination. Default value: 50 |
offset (optional) | Offset. Used for pagination. Default value: 0 |
Code examples
curl https://insight.djuno.io/v1/coin/cVaOmQWainv7g/issuance-blockchains \
-H 'x-api-key: your-api-key' \
-G
Response
HTTP/1.1 200 OK
{
"status": "success",
"data": {
"total": 1,
"issuanceBlockchains": [
{
"name": "Ethereum",
"referenceName": "Ethereum contract address",
"reference": "0x7d1afa7b718fb893db30a3abc0cfc608aacfebb0"
"blockExplorerUrl": "https://etherscan.io/token/0x7d1afa7b718fb893db30a3abc0cfc608aacfebb0"
}
]
}
}
Response fields
Error | Description |
status | Status of the request Allowed values: |
data |
|
data.total | Total number of issuance blockchains for the coin. |
data.issuanceBlockchains |
|
data.issuanceBlockchains.name | Name of the blockchain. |
data.issuanceBlockchains.referenceName | Blockchain specific coin reference name. For instance, 'Ethereum contract address' for a coin's reference on the Ethereum blockchain. |
data.issuanceBlockchains.reference | 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 | 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. |
Error response
HTTP/1.1 422 Unprocessable Entity
{
"status": "fail",
"type": "VALIDATION_ERROR",
"messages": [
"Limit can only be between 1 and 100."
]
}
Error responses
422
Name | Type | Description |
VALIDATION_ERROR |
| The request could not be validated. The response should provide more details. |
Coin supply modifiers
The market cap for a coin is calculated by the price of a single unit (e.g. 1 BTC) multiplied by the "circulating supply". The circulating part of the supply is the amount of coins that are not only minted, but also in circulation (not locked up in some wallet accessible to noone). The wallets accessible to noone are what we call supply modifiers, and their balances are subtracted from the total supply.
https://insight.djuno.io/v1/coin/:uuid/modifiers
Path parameters
Parameter | Description |
uuid | UUID of the coin you want to request the modifiers for. |
Query parameters
Parameter | Description |
limit (optional) | Limit. Used for pagination Default value: 50 |
offset (optional) | Offset. Used for pagination Default value: 0 |
orderBy (optional) | Order of the modifiers can be either when they were added (createdAt) or by amount Default value: createdAt |
orderDirection (optional) | Applies direction to the orderBy query, which can be in ascending or descending order. Default value: desc |
Code examples
curl https://insight.djuno.io/v1/coin/cVaOmQWainv7g/modifiers \
-H 'x-api-key: your-api-key' \
-G
Response
HTTP/1.1 200 OK
{
"status": "success",
"data": {
"total": 3,
"modifiers": [
{
"blockchainName": "Neo",
"blockExplorerUrl": "https://neotracker.io/address/Ae2d6qj91YL3LVUMkza7WQsaTYjzjHm4z1",
"name": "Foundation",
"reference": "Ae2d6qj91YL3LVUMkza7WQsaTYjzjHm4z1",
"syncedAt": 1593436560,
"amount": "14146080"
}
]
}
}
Response fields
Property | Description |
status | Status of the request Allowed values: |
data |
|
data.total | Total number of modifiers for the coin's supply. |
data.modifiers |
|
data.modifiers.blockchainName | Name of the blockchain to which this modifier applies. |
data.modifiers.blockExplorerUrl | URL to block explorer. |
data.modifiers.name | Name we have given the modifier. |
data.modifiers.reference | Address of the modifier. |
data.modifiers.syncedAt | Epoch timestamp in seconds when the amount has last been synced. |
data.modifiers.amount | Balance on the address retrieved at the syncedAt time. |
Error response
HTTP/1.1 422 Unprocessable Entity
{
"status": "fail",
"type": "VALIDATION_ERROR",
"messages": [
"Limit can only be between 1 and 100."
]
}
Error responses
422
Error | Description |
VALIDATION_ERROR | The request could not be validated. The response should provide more details. |
Coin market cap history
The market cap for every coin fluctuates throughout time by differing supply and price values. You can find the history in this endpoint.
https://insight.djuno.io/v1/coin/:uuid/market-caps
Path parameters
Parameter | Description |
uuid | UUID of the coin you want to request the Market cap data for. |
Query parameters
Parameter | Description |
interval (optional) | The interval determines the time period over which each market cap item is determined. Default value: day |
limit (optional) | Limit. Limit the amount of time periods for which the marketCaps are retrieved. For example, when interval=hour and limit is 10, data will be returned for the last 10 hours. The maximum amount of results you can fetch in one request is 5000 for the Startup and Professional plan, and 100 for the Free plan. Default value: 50 |
Code examples
curl https://insight.djuno.io/v1/coin/Qwsogvtv82FCd/marketCaps \
-H 'x-api-key: your-api-key' \
-G
Response
HTTP/1.1 200 OK
{
"status": "success",
"data": {
"history": [
{
"timestamp": 1698220800,
"marketCap": "663355719491"
},
{
"timestamp": 1698217200,
"marketCap": "662740429329"
},
{
"timestamp": 1698213600,
"marketCap": "666715637188"
},
]
}
}
Response fields
Property | Description |
status | Status of the request Allowed values: |
data |
|
data.history | List of market cap items |
data.history.timestamp | An Epoch timestamp in seconds |
data.history.marketCap | the market cap in US Dollars |
Error response
HTTP/1.1 404 Not Found
{
"status": "fail",
"type": "COIN_NOT_FOUND",
"message": "Coin not found"
}
Error responses
404
Error | Description |
COIN_NOT_FOUND | The coin could not be found. Try another UUID. |
422
Error | Description |
VALIDATION_ERROR | The request could not be validated. The response should provide more details. |
Coin rank history
How a coin ranked throughout time.
https://insight.djuno.io/v1/coin/:uuid/ranks
Path parameters
Parameter | Description |
uuid | UUID of the coin you want to request the rank data for. |
Query parameters
Parameter | Description |
interval (optional) | The interval determines the time period over which each rank item is determined. Default value: day |
limit (optional) | Limit. Limit the amount of time periods for which the ranks are retrieved. For example, when interval=hour and limit is 10, data will be returned for the last 10 hours. The maximum amount of results you can fetch in one request is 5000 for the Startup and Professional plan, and 100 for the Free plan. Default value: 50 |
Code examples
curl https://insight.djuno.io/v1/coin/Qwsogvtv82FCd/ranks \
-H 'x-api-key: your-api-key' \
-G
Response
HTTP/1.1 200 OK
{
"status": "success",
"data": {
"history": [
{
"startingAt": 1698310800,
"tier": "1",
"marketCapRank": "1",
"fullyDilutedMarketCapRank": "1",
"volumeRank": "2",
"priceRank": "2"
},
{
"startingAt": 1698307200,
"tier": "1",
"marketCapRank": "1",
"fullyDilutedMarketCapRank": "1",
"volumeRank": "2",
"priceRank": "2"
}
]
}
}
Response fields
Property | Description |
status | Status of the request Allowed values: |
data |
|
data.history | List of rank items |
data.history.startingAt | An Epoch timestamp in seconds marking the start of the time period on which the rank values are based. |
data.history.tier | Tier of the coin. We have three distinct tiers. |
data.history.marketCapRank | The rank of the coin based on market cap. This is the rank we use on our website by default. time period |
data.history.fullyDilutedMarketCapRank | The rank of the coin based on fully diluted market cap. Fully diluted market cap is a coin's price multiplied by its max supply. Or total supply if the max supply is not known. |
data.history.volumeRank | Market cap based on its trading volume in the past 24 hours. |
data.history.priceRank | The rank of the coin based on how much US Dollars just one unit of the coin is worth. This metric greatly favors coins with a low supply. |
Error response
HTTP/1.1 404 Not Found
{
"status": "fail",
"type": "COIN_NOT_FOUND",
"message": "Coin not found"
}
Error responses
404
Error | Description |
COIN_NOT_FOUND | The coin could not be found. Try another UUID |
422
Error | Description |
VALIDATION_ERROR | The request could not be validated. The response should provide more details. |
Coin supply history
The supply for a coin rises when new coins are mined, and decreases when they are burned or otherwise rendered useless (this last part only counts for circulating supply, not total). You can track the history of a coins supply amount with this enpdoint.
https://insight.djuno.io/v1/coin/:uuid/supplies
Path parameters
Parameter | Description |
uuid | UUID of the coin you want to request the supply data for. |
Query parameters
Parameter | Description |
interval (optional) | The interval determines the time period over which each supply item is determined. Default value: day |
limit (optional) | Limit. Limit the amount of time periods for which the supplies are retrieved. For example, when interval=hour and limit is 10, data will be returned for the last 10 hours. The maximum amount of results you can fetch in one request is 5000 for the Startup and Professional plan, and 100 for the Free plan. Default value: 50 |
Code examples
curl https://insight.djuno.io/v1/coin/Qwsogvtv82FCd/supplies \
-H 'x-api-key: your-api-key' \
-G
Response
HTTP/1.1 200 OK
{
"status": "success",
"data": {
"history": [
{
"timestamp": 1698624000,
"circulating": "19527731",
"total": "19527731"
},
{
"timestamp": 1698537600,
"circulating": "19526875",
"total": "19526875"
},
{
"timestamp": 1698451200,
"circulating": "19525868",
"total": "19525868"
}
]
}
}
Response fields
Parameter | Description |
status | Status of the request Allowed values: |
data |
|
data.history | List of supply items |
data.history.timestamp | An Epoch timestamp in seconds |
data.history.circulating | the circulating supply in US Dollars |
data.history.total | the total supply in US Dollars |
Error response
json Copy codeHTTP/1.1 404 Not Found { "status": "fail", "type": "COIN_NOT_FOUND", "message": "Coin not found" }Error responses
404
Error | Description |
COIN_NOT_FOUND | The coin could not be found. Try another UUID |
422
Error | Description |
VALIDATION_ERROR | The request could not be validated. The response should provide more details. |
Blockchains
Blockchains
https://insight.djuno.io/v1/blockchains
Code examples
curl https://insight.djuno.io/v1/blockchains \
-H 'x-api-key: your-api-key' \
-G
Response
HTTP/1.1 200 OK
{
"status": "success",
"data": {
"blockchains": [
"bitcoin",
"eos",
"ethereum",
"tron"
]
}
}
Response fields
Property | Description |
status | Status of the request Allowed values: |
data |
|
data.blockchains | List of blockchains |
Blockchain details
https://insight.djuno.io/v1/blockchain/:name
Path parameters
Parameter | Description |
blockchain | Name of the blockchain you want to request. You can find a list of all possible values by making a request to blockchains endpoint. |
Code examples
curl https://insight.djuno.io/v1/blockchain/ethereum \
-H 'x-api-key: your-api-key' \
-G
Response
HTTP/1.1 200 OK
{
"status": "success",
"data": {
"blockchain": {
"name": "ethereum",
"totalCoins": 2
}
}
}
}
Response fields
Property | Description |
status | Status of the request Allowed values: |
data |
|
data.blockchain |
|
data.blockchain.name | Name of the blockchain |
data.blockchain.totalCoins | Amount of coins listed for this blockchain |
Error response
HTTP/1.1 404 Not Found
{
"status": "fail",
"type": "BLOCKCHAIN_NOT_FOUND",
"message": "Blockchain not found. Find a list of possible values at https://insight.djuno.io/v1/blockchains"
}
Error responses
404
Error | Description |
BLOCKCHAIN_NOT_FOUND | The blockchain could not be found. |
Blockchain contract address
https://insight.djuno.io/v1/blockchain/:blockchain/:address
Path parameters
Parameter | Description |
blockchain | 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 | 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
curl https://insight.djuno.io/v1/blockchain/ethereum/0xdac17f958d2ee523a2206206994597c13d831ec7 \
-H 'x-api-key: your-api-key' \
-G
Response
HTTP/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 | Status of the request Allowed values: |
data |
|
data.coin |
|
data.coin.UUID | Uuid of the coin |
data.coin.name | Name of the coin |
data.coin.symbol | Symbol of the coin (e.g. BTC, ETH, XRP) |
data.coin.contractAddresses | List of contract addresses for this coin. The format is |
data.coin.coinrankingUrl | Where to find the coin on coinranking.com |
Error response
HTTP/1.1 404 Not Found
{
"status": "fail",
"type": "COIN_NOT_FOUND",
"message": "Coin not found"
}
Error responses
404
Error | Description |
COIN_NOT_FOUND | The coin could not be found. Try another UUID |
422
Error | Description |
VALIDATION_ERROR | The request could not be validated. The response should provide more details. |
Exchanges
Exchanges
https://api.coinranking.com/v2/exchanges
Query parameters
Parameter | Description |
referenceCurrencyUuid (optional) | UUID of coin (either fiat or crypto), in which all the prices are calculated. Defaults to US Dollar, but you can use any coin. You can find UUIDs for reference currencies in any coin endpoint, including a convenient dedicated reference currency endpoint Default value: yhjMzLPhuIDl |
limit (optional) | Limit. Used for pagination. Only usable when no filters are applied. The maximum amount of results you can fetch in one request is 5000 for the Startup and Professional plan, and 100 for the Free plan. Default value: 50 |
offset (optional) | Offset. Used for pagination. Default value: 0 |
orderBy (optional) | Order by either 24h volume, number of markets or latest ticker. Ordering can only be done when no filters are applied. Default value: 24hVolume |
orderDirection (optional) | Applies direction to the orderBy query, which can be in ascending or descending order. Only usable when no filters are applied. Default value: desc |
uuids (optional) | Exchange UUIDs to filter the exchanges on. Example: |
search (optional) | Value to search for within results, e.g. exchange names. Example: |
Code examples
curl https://insight.djuno.io/v1/exchanges \
-H 'x-api-key: your-api-key' \
-G
Response
HTTP/1.1 200 OK
{
"status": "success",
"data": {
"stats": {
"24hVolume": "6554685985.623574",
"total": 198
},
"exchanges": [
{
"coinrankingUrl": "https://coinranking.com/exchange/-zdvbieRdZ+binance",
"uuid": "-zdvbieRdZ",
"name": "Binance",
"iconUrl": "https://cdn.coinranking.com/mDTK5qrmq/binance.svg",
"numberOfMarkets": 3,
"24hVolume": "776337030.2052088",
"rank": 1,
"marketShare": "12.22",
"verified": true,
"recommended": true
},
{
"coinrankingUrl": "https://coinranking.com/exchange/XHp8eCjIDc+zb",
"uuid": "XHp8eCjIDc",
"name": "ZB",
"iconUrl": null,
"lastTickerCreatedAt": 1546960123000,
"numberOfMarkets": 128,
"24hVolume": "693976176.906341",
"rank": 2,
"marketShare": "10.92",
"verified": false,
"recommended": false
}
]
}
}
Response fields
Property | Description |
status | Status of the request Allowed values: |
data |
|
data.stats |
|
data.stats.24hVolume | Total 24h volume of exchanges in the reference currency |
data.stats.total | Total number of exchanges |
data.exchanges | List of exchanges |
data.exchanges.uuid | UUID of the exchange |
data.exchanges.name | Name of the exchange |
data.exchanges.iconUrl | Location of the icon |
data.exchanges.verified | DEPRECATED Exchanges that are verified to not participate in harmful practices such as wash trading are marked as verified. |
data.exchanges.recommended | Whether the exchange is recommended based on our criteria, see https://support.coinranking.com/article/82-recommended-exchanges |
data.exchanges.numberOfMarkets | Number of markets of the exchange paired with Coinranking |
data.exchanges.24hVolume | Total volume in 24 hours |
data.exchanges.rank | Rank of the exchange based on volume, taking into account exchange and currency filters |
data.exchanges.marketShare | Percentage of the total exchange volume reprented by this exchange. |
data.exchanges.coinrankingUrl | Where to find the exchange on coinranking.com |
Error response
HTTP/1.1 422 Unprocessable Entity
{
"status": "fail",
"type": "REFERENCE_UNAVAILABLE",
"message": "Reference currency not available"
}
Error responses
422
Error | Description |
VALIDATION_ERROR | The request could not be validated. The response should provide more details. |
REFERENCE_UNAVAILABLE | The reference currency used in the request is not available. Choose another UUID. |
Exchange details
https://insight.djuno.io/v1/exchange/:uuid
Path parameters
Parameter | Description |
uuid | UUID of the exchange you want to request. |
Query parameters
Parameter | Description |
referenceCurrencyUuid (optional) | UUID of coin (either fiat or crypto), in which all the prices are calculated. Defaults to US Dollar, but you can use any coin. You can find UUIDs for reference currencies in any coin endpoint, including a convenient dedicated reference currency endpoint Default value: yhjMzLPhuIDl |
Code examples
curl https://insight.djuno.io/v1/exchange/-zdvbieRdZ \
-H 'x-api-key: your-api-key' \
-G
Response
HTTP/1.1 200 OK
{
"status": "success",
"data": {
"exchange": {
"numberOfMarkets": 3,
"numberOfCoins": 59,
"24hVolume": "776337030.2052088",
"uuid": "-zdvbieRdZ",
"name": "Binance",
"description": "Binance is a blockchain ecosystem cryptocurrency exchange.",
"iconUrl": "https://cdn.coinranking.com/mDTK5qrmq/binance.svg",
"websiteUrl": "https://www.binance.com/",
"verified": true,
"recommended": true,
"lastTickerCreatedAt": 1546959293000,
"links": [
{
"name": "binance.com",
"url": "https://www.binance.com/en/register?ref=35424440",
"type": "website"
},
{
"name": "Support",
"url": "https://www.binance.com/en/support",
"type": "website"
},
{
"name": "binance",
"url": "https://www.facebook.com/binance",
"type": "facebook"
}
],
"rank": 1,
"marketShare": "12.2209741947213",
"coinrankingUrl": "https://coinranking.com/exchange/-zdvbieRdZ+binance"
"delistedAt": null,
"notices": [
{
"type":"DELISTED",
"value":"This exchange is inactive on Coinranking. Its data is not up to date."
}
],
"tags": [
"DEX"
]
}
}
}
Response fields
Property | Description |
status | Status of the request Allowed values: |
data |
|
data.exchange |
|
data.exchange.uuid | UUID of the exchange |
data.exchange.name | Name of the exchange |
data.exchange.description | Description of the exchange |
data.exchange.iconUrl | Location of the icon |
data.exchange.websiteUrl | Website URL to the exchange |
data.exchange.verified | DEPRECATED A verified exchange is verified to not participate in harmful practices such as wash trading. |
data.exchange.recommended | Whether the exchange is recommended based on our criteria, see https://support.coinranking.com/article/82-recommended-exchanges |
data.exchange.numberOfMarkets | Number of markets of the exchange paired with Coinranking |
data.exchange.numberOfCoins | Number of coins listed for this exchange on Coinranking |
data.exchange.24hVolume | Total volume in 24 hours |
data.exchange.lastTickerCreatedAt | Timestamp of the latest ticker |
data.exchange.links | List of links, like social media pages |
data.exchange.links.name | Name of the link |
data.exchange.links.url | Url to the specific link |
data.exchange.links.type | The type of link Allowed values: |
data.exchange.rank | Rank of the exchange based on volume, taking into account exchange and currency filters |
data.exchange.marketShare | Percentage of the total exchange volume represented by this exchange. |
data.exchange.coinrankingUrl | Where to find the exchange on coinranking.com |
data.exchange.delistedAt | The date at which an exchange is delisted at Coinranking, which means no new data is being fetched from the exchange. This is done when an exchange ceases to exist or is hard to reach. When the value is null, the exchange is not delisted. |
data.exchange.notices | List of notices, which signal some important information about the exchange. E.g. that the exchange has been delisted and no new price data is being fetched from it. The notices are in JSON format, and in most cases consist of a "type" property with an important keyword such as "DELISTED", and a more human readable message in a "value" property. |
data.exchange.tags | List of tags, like "DEX" or "CEX" |
Error response
HTTP/1.1 422 Unprocessable Entity
{
"status": "fail",
"type": "REFERENCE_UNAVAILABLE",
"message": "Reference currency not available"
}
Error responses
404
Error | Description |
EXCHANGE_NOT_FOUND | The exchange could not be found. Try another UUID |
422
Error | Description |
VALIDATION_ERROR | The request could not be validated. The response should provide more details. |
REFERENCE_UNAVAILABLE | The reference currency used in the request is not available. Choose another UUID. |
Exchange coin listings
https://insight.djuno.io/v1/exchange/:uuid/coins
Path parameters
Parameter | Description |
uuid | UUID of the exchange you want to request |
Query parameters
Parameter | Description |
referenceCurrencyUuid (optional) | UUID of coin (either fiat or crypto), the price of the reference currency is used to calculate the volume. Defaults to US Dollar, but you can use any coin. You can find UUIDs for reference currencies in any coin endpoint, including a convenient dedicated reference currency endpoint Default value: yhjMzLPhuIDl |
limit (optional) | Limit. Used for pagination. The maximum amount of results you can fetch in one request is 5000 for the Startup and Professional plan, and 100 for the Free plan. Default value: 50 |
offset (optional) | Offset. Used for pagination Default value: 0 |
orderBy (optional) | Index to sort on. Default is 24h volume Default value: 24hVolume |
orderDirection (optional) | order in ascending or descending order Default value: desc |
search (optional) | Filter the results by searching for coin names or symbols.
|
Code examples
curl https://insight.djuno.io/v1/exchange/-zdvbieRdZ/coins \
-H 'x-api-key: your-api-key' \
-G
Response
HTTP/1.1 200 OK
{
"status": "success",
"data": {
"stats": {
"total": 3
},
"coins": [
{
"rank": 3,
"uuid": "ETHxDUgYGNAdQ",
"symbol": "ETH",
"name": "Ethereum",
"iconUrl": "https://cdn.coinranking.com/rk4RKHOuW/eth.svg",
"price": "203",
"btcPrice": "0.3",
"24hVolume": "380",
"numberOfMarkets": 2,
"coinrankingUrl": "https://coinranking.com/coin/razxDUgYGNAdQ+ethereum-eth"
},
{
"rank": 2,
"uuid": "USDxDUgYGNAdQ",
"symbol": "USDT",
"name": "Tether",
"iconUrl": "https://cdn.coinranking.com/SJs1nH_OZ/usdt.svg",
"price": "1",
"btcPrice": "0.0055573924999568905",
"24hVolume": "2795542.586905519",
"numberOfMarkets": 2,
"coinrankingUrl": "https://coinranking.com/coin/HIVsRcGKkPFtW+tether-usdt"
}
]
}
}
Response fields
Property | Description |
status | Status of the request Allowed values: |
data |
|
data.stats |
|
data.stats.total | Total number of exchanges |
data.coins |
|
data.coins.rank | The rank for this coin in this exchange |
data.coins.uuid | UUID of the coin |
data.coins.symbol | Currency symbol |
data.coins.name | Name of the coin |
data.coins.iconUrl | Location of the icon |
data.coins.price | Price of the coin |
data.coins.btcPrice | Price of the coin expressed in Bitcoin. |
data.coins.24hVolume | 24h trade volume |
data.coins.numberOfMarkets | The amount of markets this coin is exchanged in on this exchange |
data.coins.coinrankingUrl | Where to find the coin on coinranking.com |
Error response
HTTP/1.1 422 Unprocessable Entity
{
"status": "fail",
"type": "REFERENCE_UNAVAILABLE",
"message": "Reference currency not available"
}
Error responses
404
Error | Description |
EXCHANGE_NOT_FOUND | The exchange could not be found. Try another UUID |
422
Error | Description |
VALIDATION_ERROR | The request could not be validated. The response should provide more details. |
REFERENCE_UNAVAILABLE | The reference currency used in the request is not available. Choose another UUID. |
Exchange list of markets
https://insight.djuno.io/v1/exchange/:uuid/markets
Path parameters
Parameter | Description |
uuid | UUID of the exchange. |
Query parameters
Parameter | Description |
referenceCurrencyUuid (optional) | UUID of coin (either fiat or crypto), the price of the reference currency is used to calculate the volume. Defaults to US Dollar, but you can use any coin. You can find UUIDs for reference currencies in any coin endpoint, including a convenient dedicated reference currency endpoint Default value: yhjMzLPhuIDl |
limit (optional) | Limit. Used for pagination. The maximum amount of results you can fetch in one request is 5000 for the Startup and Professional plan, and 100 for the Free plan. Default value: 50 |
offset (optional) | Offset. Used for pagination Default value: 0 |
orderBy (optional) | Index to sort on. Default is 24h volume. Default value: 24hVolume |
orderDirection (optional) | Order in ascending or descending order Default value: desc |
search (optional) | Value to search for within results, e.g. exchange names, currency names, or currency symbols Example: |
Code examples
curl https://insight.djuno.io/v1/exchange/-zdvbieRdZ/markets \
-H 'x-api-key: your-api-key' \
-G
Response
HTTP/1.1 200 OK
{
"status": "success",
"data": {
"stats": {
"24hVolume": "2795922.586905519",
"total": 3
},
"markets": [
{
"uuid": "xk9M2LuHuID5",
"active": 1,
"base": {
"uuid": "Qwsogvtv82FCd",
"symbol": "BTC"
},
"quote": {
"symbol": "USD",
"uuid": "yhjMzLPhuIDl"
},
"exchange": {
"name": "Binance",
"uuid": "-zdvbieRdZ",
"iconUrl": "https://cdn.coinranking.com/d6w2Hj3z0/BitMEX.svg"
},
"24hVolume": "771875964.9750752",
"price": "3842.9444791178726",
"btcPrice": "1",
"rank": 1,
"marketShare": "30.48",
"recommended": true,
"filters": []
},
{
"uuid": "bn7nTLHHuIq2",
"active": 1,
"base": {
"uuid": "Qwsogvtv82FCd",
"symbol": "BTC"
},
"quote": {
"symbol": "USDT",
"uuid": "HIVsRcGKkPFtW"
},
"exchange": {
"name": "Coinbase Pro",
"uuid": "qn5ZJmPFP",
"iconUrl": "https://cdn.coinranking.com/Ama6htyHL/coinbase.svg"
},
"24hVolume": "311344830.86823833",
"price": "3869.146354559396",
"btcPrice": "1",
"rank": 2,
"marketShare": "12.35",
"recommended": true,
"filters": []
}
]
}
}
Response fields
Property | Description |
status | Status of the request Allowed values: |
data |
|
data.stats |
|
data.stats.24hVolume | Total 24h volume of exchanges in the reference currency |
data.stats.total | Total number of exchanges |
data.markets |
|
data.markets.uuid | UUID of the market |
data.markets.active | If the market is enabled or not |
data.markets.base | The coin on the left side of the pair, which price is calculated in units of the quote |
data.markets.base.symbol | Symbol of the baseCurrency of the market |
data.markets.base.uuid | UUID of the baseCurrency of the market |
data.markets.quote | The coin on the right side of the pair. The amount in tickers are how much quote you get for one unit of base. E.g. BTC/USD 10.000 means 1 BTC is traded for 10.000 USD. |
data.markets.quote.uuid | UUID of the quoteCurrency of the market |
data.markets.quote.symbol | Symbol of the quoteCurrency of the market |
data.markets.exchange | Exchange this market belongs to |
data.markets.exchange.name | Name of the exchange |
data.markets.exchange.uuid | UUID of the exchange |
data.markets.exchange.iconUrl | Location of the icon |
data.markets.24hVolume | 24h volume of the latest ticker in the reference currency |
data.markets.price | Price of the latest ticker in reference currency |
data.markets.btcPrice | Price of the latest ticker expressed in Bitcoin. |
data.markets.rank | Rank of the market based on volume, taking into account exchange and currency filters |
data.markets.marketShare | Percentage of the total market volume reprented by this market, taking into account exchange and currency filters |
data.markets.recommended | Whether the market is recommended based on the exchange it belongs to, see https://support.coinranking.com/article/82-recommended-exchanges |
data.markets.filters | An array of filters that are applied to the market. Most of the filters will cause the market to not be included in the price calculation of the coins. Allowed values: |
Error response
json Copy codeHTTP/1.1 422 Unprocessable Entity { "status": "fail", "type": "REFERENCE_UNAVAILABLE", "message": "Reference currency not available" }Error responses
404
Error | Description |
EXCHANGE_NOT_FOUND | The exchange could not be found. Try another UUID |
422
Error | Description |
VALIDATION_ERROR | The request could not be validated. The response should provide more details. |
REFERENCE_UNAVAILABLE | The reference currency used in the request is not available. Choose another UUID. |
Markets
Markets
https://insight.djuno.io/v12/markets
Query parameters
Parameter | Description |
referenceCurrencyUuid (optional) | UUID of coin (either fiat or crypto), in which all the prices are calculated. Defaults to US Dollar, but you can use any coin. You can find UUIDs for reference currencies in any coin endpoint, including a convenient dedicated reference currency endpoint Default value: yhjMzLPhuIDl |
limit (optional) | Limit. Used for pagination. Only usable when no filters are applied Default value: 50 |
offset (optional) | Offset. Used for pagination only usable when no filters are applied Default value: 0 |
orderBy (optional) | Sort by either 24h volume or price. Only usable when no filters are applied Default value: 24hVolume |
orderDirection (optional) | Sort in ascending or descending order. Only usable when no filters are applied. Default value: desc |
search (optional) | Filter the results by searching for coin names, symbols or exchange names. Example: |
Code examples
curl https://insight.djuno.io/v1/markets \
-H 'x-api-key: your-api-key' \
-G
Response
HTTP/1.1 200 OK
{
"status": "success",
"data": {
"stats": {
"24hVolume": "6554685985.623574",
"total": 27521
},
"markets": [
{
"uuid": "xk9M2LuHuID5",
"base": {
"uuid": "Qwsogvtv82FCd",
"symbol": "BTC"
},
"quote": {
"uuid": "yhjMzLPhuIDl",
"symbol": "USD"
},
"exchange": {
"name": "Binance",
"uuid": "-zdvbieRdZ",
"iconUrl": "https://cdn.coinranking.com/d6w2Hj3z0/BitMEX.svg"
},
"24hVolume": "771875964.9750752",
"price": "3842.9444791178726",
"btcPrice": "1",
"rank": 1,
"marketShare": "30.48",
"recommended": true,
"filters": []
},
{
"uuid": "bn7nTLHHuIq2",
"base": {
"uuid": "Qwsogvtv82FCd",
"symbol": "BTC"
},
"quote": {
"uuid": "HIVsRcGKkPFtW",
"symbol": "USDT"
},
"exchange": {
"name": "Coinbase Pro",
"uuid": "qn5ZJmPFP",
"iconUrl": "https://cdn.coinranking.com/Ama6htyHL/coinbase.svg"
},
"24hVolume": "311344830.86823833",
"price": "3869.146354559396",
"btcPrice": "1",
"rank": 2,
"marketShare": "12.35",
"recommended": true,
"filters": []
}
]
}
}
Response fields
Property | Description |
status | Status of the request Allowed values: |
data |
|
data.stats |
|
data.stats.24hVolume | Total 24h volume of markets in the reference currency |
data.stats.total | Total number of markets |
data.markets | List of markets |
data.markets.uuid | UUID of the market |
data.markets.base | The coin on the left side of the pair, which price is calculated in units of the quote |
data.markets.base.uuid | UUID of the baseCurrency of the market |
data.markets.base.symbol | Symbol of the baseCurrency of the market |
data.markets.quote | The coin on the right side of the pair. The amount in tickers are how much quote you get for one unit of base. E.g. BTC/USD 10.000 means 1 BTC is traded for 10.000 USD. |
data.markets.quote.uuid | UUID of the quoteCurrency of the market |
data.markets.quote.symbol | Symbol of the quoteCurrency of the market |
data.markets.exchange | Exchange this market belongs to |
data.markets.exchange.name | Name of the exchange |
data.markets.exchange.uuid | UUID of the exchange |
data.markets.exchange.iconUrl | Location of the icon |
data.markets.24hVolume | The 24 hour volume of the base currency in the reference currency which defaults to US Dollar. For example in an ETH/BTC market the volume would be Ethereum in US Dollar. |
data.markets.price | The latest price of the base currency in the reference currency which defaults to US Dollar. For example in an ETH/BTC market the price would be Ethereum in US Dollar. |
data.markets.btcPrice | The latest price of the base currency in Bitcoin. |
data.markets.rank | Rank of the market based on volume, taking into account exchange and currency filters |
data.markets.marketShare | Percentage of the total market volume reprented by this market, taking into account exchange and currency filters |
data.markets.recommended | Whether the market is recommended based on the exchange it belongs to, see https://support.coinranking.com/article/82-recommended-exchanges |
data.markets.filters | An array of filters that are applied to the market. Most of the filters will cause the market to not be included in the price calculation of the coins. Allowed values: |
Error response
HTTP/1.1 422 Unprocessable Entity
{
"status": "fail",
"type": "REFERENCE_UNAVAILABLE",
"message": "Reference currency not available"
}
Error responses
422
Error | Description |
VALIDATION_ERROR | The request could not be validated. The response should provide more details. |
REFERENCE_UNAVAILABLE | The reference currency used in the request is not available. Choose another UUID. |
Market details
https://insight.djuno.io/v1/market/:uuid
Path parameters
Parameter | Description |
uuid | Uuid of the market you want to request |
Query parameters
Parameter | Description |
referenceCurrencyUuid (optional) | UUID of coin (either fiat or crypto), the price of the reference currency is used to calculate the volume. Defaults to US Dollar, but you can use any coin. You can find UUIDs for reference currencies in any coin endpoint, including a convenient dedicated reference currency endpoint Default value: yhjMzLPhuIDl |
Code examples
curl https://nsight.djuno.io/v1/market/MP77r-vKf4 \
-H 'x-api-key: your-api-key' \
-G
Response
HTTP/1.1 200 OK
{
"status": "success",
"data": {
"market": {
"uuid": "MP77r-vKf4",
"rank": 7,
"base": {
"uuid": "Qwsogvtv82FCd",
"symbol": "BTC",
"name": "Bitcoin",
"type": "coin"
},
"quote": {
"symbol": "USDT",
"uuid": "HIVsRcGKkPFtW",
"name": "Tether",
"type": "coin"
},
"exchange": {
"name": "Binance",
"uuid": "-zdvbieRdZ",
"iconUrl": "https://cdn.coinranking.com/mDTK5qrmq/binance.svg",
"websiteUrl": "https://www.binance.com"
},
"latestTicker": {
"createdAt": 1594808541,
"close": "10190.495525500779",
"base24hVolume": "34878",
"quote24hVolume": "354103375"
},
"marketShare": "1.23",
"price": "9488.518829659914",
"btcPrice": "1",
"24hVolume": "353383358.2006244",
"recommended": true,
"filters": []
}
}
}
Response fields
Property | Description |
status | Status of the request Allowed values: |
data |
|
data.market |
|
data.market.uuid | Uuid of the market |
data.markets.base | The coin on the left side of the pair, which price is calculated in units of the quote |
data.market.base.uuid | Uuid of the baseCurrency of the market |
data.market.base.symbol | Symbol of the baseCurrency of the market |
data.market.base.type | Indicates if the base of the market is a coin or if it is fiat Allowed values: |
data.market.base.name | Name of the baseCurrency of the market |
data.markets.quote | The coin on the right side of the pair. The amount in tickers are how much quote you get for one unit of base. E.g. BTC/USD 10.000 means 1 BTC is traded for 10.000 USD. |
data.market.quote.uuid | Uuid of the quoteCurrency of the market |
data.market.quote.symbol | Symbol of the quoteCurrency of the market |
data.market.quote.name | Name of the quoteCurrency of the market |
data.market.quote.type | Indicates if the quote of the market is a coin or if it is fiat Allowed values: |
data.markets.exchange | Exchange this market belongs to |
data.market.exchange.name | Name of the exchange |
data.market.exchange.uuid | Uuid of the exchange |
data.market.exchange.iconUrl | Location of the icon |
data.market.exchange.websiteUrl | Url that points to the website of the exchange |
data.market.latestTicker.createdAt | An Epoch timestamp in seconds when the latest ticker was received |
data.market.latestTicker.close | The last price received from the market |
data.market.latestTicker.base24hVolume | Moving average of the base volume of the market in the last 24 hours. For example in a BTC/USD market it would be the Bitcoins traded within a 24 hour timespan. |
data.market.latestTicker.quote24hVolume | Moving average of the quote volume of the market in the last 24 hours. For example in a BTC/USD market it would be the US dollars traded within a 24 hour timespan. |
data.market.24hVolume | The 24 hour volume of the base currency in the reference currency which defaults to US Dollar. For example in an ETH/BTC market the volume would be Ethereum in US Dollar. |
data.market.price | The latest price of the base currency in the reference currency which defaults to US Dollar. For example in an ETH/BTC market the price would be Ethereum in US Dollar. |
data.market.btcPrice | The latest price of the base currency in Bitcoin. |
data.market.rank | Rank of the market based on volume, taking into account exchange and currency filters |
data.market.marketShare | Percentage of the total market volume reprented by this market |
data.market.recommended | Whether the market is recommended based on the exchange it belongs to, see https://support.coinranking.com/article/82-recommended-exchanges |
data.market.filters | An array of filters that are applied to the market. Most of the filters will cause the market to not be included in the price calculation of the coins. Allowed values: |
Error response
HTTP/1.1 422 Unprocessable Entity
{
"status": "fail",
"type": "REFERENCE_UNAVAILABLE",
"message": "Reference currency not available"
}
Error responses
422
Error | Description |
VALIDATION_ERROR | The request could not be validated. The response should provide more details. |
REFERENCE_UNAVAILABLE | The reference currency used in the request is not available. Choose another UUID |
Reference currencies
https://insight.djuno.io/v1/reference-currencies
Query parameters
Parameter | Description |
limit (optional) | Limit. Used for pagination. The maximum amount of results you can fetch in one request is 5000 for the Startup and Professional plan, and 100 for the Free plan. Default value: 20 |
offset (optional) | Offset. Used for pagination Default value: 0 |
types (optional) | A currency is one of three types: coin (e.g. Bitcoin, Ethereum, etc.), fiat (US Dollar, Euro, Yen, etc.) or a denominator (e.g. Satoshi). Filter the response by providing one or more types. Allowed values: |
search (optional) | Filter the results by searching for currency names or symbols. Example: |
Code examples
curl https://insight.djuno.io/v1/reference-currencies \
-H 'x-api-key: your-api-key' \
-G
Response
HTTP/1.1 200 OK
{
"status": "success",
"data": {
"stats": {
"total": 3
},
"currencies": [
{
"uuid": "Qwsogvtv82FCd",
"type": "coin",
"symbol": "BTC",
"name": "Bitcoin",
"iconUrl": "https://cdn.coinranking.com/bOabBYkcX/bitcoin_btc.svg",
"sign": "₿"
},
{
"uuid": "razxDUgYGNAdQ",
"type": "coin",
"symbol": "ETH",
"name": "Ethereum",
"iconUrl": "https://cdn.coinranking.com/rk4RKHOuW/eth.svg",
"sign": "Ξ"
},
{
"uuid": "yhjMzLPhuIDl",
"type": "fiat",
"symbol": "USD",
"name": "US Dollar",
"iconUrl": "https://cdn.coinranking.com/kz6a7w6vF/usd.svg",
"sign": "$"
}
]
}
}
Response fields
Property | Description |
status | Status of the request Allowed values: |
data |
|
data.stats |
|
data.stats.total | Total number of coins |
data.currencies | List of reference currencies |
data.currencies.uuid | UUID of the reference currency |
data.currencies.type | The type of the currency can be either 'coin' (BTC, ETH, etc.), 'fiat' (USD, EUR, etc.) or 'denominator' (Satoshi, Wei, etc.) |
data.currencies.symbol | Currency symbol |
data.currencies.name | Name of the currency |
data.currencies.iconUrl | Location of the icon |
data.currencies.sign | Some currencies have a symbol, like $ for USD and ₿ for BTC |
Error response
HTTP/1.1 422 Unprocessable Entity
{
"status": "fail",
"type": "VALIDATION_ERROR",
"message": "limit must be at least 1 and most 100"
}
Error responses
422
Error | Description |
VALIDATION_ERROR | The request could not be validated. The response should provide more details. |
Coin Stats
Global stats
https://insight.djuno.io/v1/stats
Query parameters
Parameter | Description |
referenceCurrencyUuid (optional) | UUID of coin (either fiat or crypto), in which all the prices are calculated. Defaults to US Dollar, but you can use any coin. You can find UUIDs for reference currencies in any coin endpoint, including a convenient dedicated reference currency endpoint Default value: yhjMzLPhuIDl |
Code examples
curl https://insight.djuno.io/v1/stats \
-H 'x-api-key: your-api-key' \
-G
Response
HTTP/1.1 200 OK
{
"status": "success",
"data": {
"totalCoins": 3220,
"totalMarkets": 27497,
"totalExchanges": 190,
"totalMarketCap": "425992114544",
"total24hVolume": "23752040073",
"btcDominance": 39.65
"bestCoins": [
{
"uuid": "razxDUgYGNAdQ",
"symbol": "ETH",
"name": "Ethereum",
"iconUrl": "https://cdn.coinranking.com/rk4RKHOuW/eth.svg",
"coinrankingUrl": "https://coinranking.com/coin/razxDUgYGNAdQ+ethereum-eth"
},
{
"uuid": "Qwsogvtv82FCd",
"symbol": "BTC",
"name": "Bitcoin",
"iconUrl": "https://cdn.coinranking.com/Sy33Krudb/btc.svg",
"coinrankingUrl": "https://coinranking.com/coin/Qwsogvtv82FCd+bitcoin-btc"
},
{
"uuid": "HIVsRcGKkPFtW",
"symbol": "USDT",
"name": "Tether",
"iconUrl": "https://cdn.coinranking.com/mgHqwlCLj/usdt.svg",
"coinrankingUrl": "https://coinranking.com/coin/HIVsRcGKkPFtW+tetherusd-usdt"
}
],
"newestCoins": [
{
"uuid": "razxDUgYGNAdQ",
"symbol": "ETH",
"name": "Ethereum",
"iconUrl": "https://cdn.coinranking.com/rk4RKHOuW/eth.svg",
"coinrankingUrl": "https://coinranking.com/coin/razxDUgYGNAdQ+ethereum-eth"
},
{
"uuid": "Qwsogvtv82FCd",
"symbol": "BTC",
"name": "Bitcoin",
"iconUrl": "https://cdn.coinranking.com/Sy33Krudb/btc.svg",
"coinrankingUrl": "https://coinranking.com/coin/Qwsogvtv82FCd+bitcoin-btc"
},
{
"uuid": "HIVsRcGKkPFtW",
"symbol": "USDT",
"name": "Tether",
"iconUrl": "https://cdn.coinranking.com/mgHqwlCLj/usdt.svg",
"coinrankingUrl": "https://coinranking.com/coin/HIVsRcGKkPFtW+tetherusd-usdt"
}
]
}
}
Response fields
Property | Description |
status | Status of the request Allowed values: |
data |
|
data.totalCoins | Total number of coins |
data.totalMarkets | Total amount of markets used for price calculation |
data.totalExchanges | Total amount of exchanges paired with Coinranking |
data.totalMarketCap | Market capitalization. Price times circulating supply |
data.total24hVolume | Total trade volume in 24 hours, calculated in the reference currency |
data.btcDominance | Current percentage of the total crypto market capitalization accounted for by Bitcoin |
data.bestCoins | List of the three best performing coins in the selected timePeriod |
data.bestCoins.uuid | UUID of the coin |
data.bestCoins.symbol | Currency symbol |
data.bestCoins.name | Name of the coin |
data.bestCoins.iconUrl | Location of the icon |
data.bestCoins.coinrankingUrl | Where to find the coin on coinranking.com |
data.newestCoins | List of the three newest coins |
data.newestCoins.uuid | UUID of the coin |
data.newestCoins.symbol | Currency symbol |
data.newestCoins.name | Name of the coin |
data.newestCoins.iconUrl | Location of the icon |
data.newestCoins.coinrankingUrl | Where to find the coin on coinranking.com |
Error response
HTTP/1.1 422 Unprocessable Entity
{
"status": "fail",
"type": "REFERENCE_UNAVAILABLE",
"message": "Reference currency not available"
}
Error responses
422
Error | Description |
VALIDATION_ERROR | The request could not be validated. The response should provide more details. |
REFERENCE_UNAVAILABLE | The reference currency used in the request is not available. Choose another UUID. |
Stats for selection of coins
https://insight.djuno.io/v1/stats/coins
Query parameters
Parameter | Description |
referenceCurrencyUuid (optional) | UUID of coin (either fiat or crypto), in which all the prices are calculated. Defaults to US Dollar, but you can use any coin. You can find UUIDs for reference currencies in any coin endpoint, including a convenient dedicated reference currency endpoint Default value: yhjMzLPhuIDl |
timePeriod (optional) | Negative changes, positive changes and the change in market cap are influenced by the time period. Default value: 24h |
uuids (optional) | UUIDs to filter the list on. If you know the UUIDs of the coins you want to fetch, you can use this filter to get the specific coins. Uuids does not work in combination with tags. If you use both filters, the tag filter takes precedence. Example: |
tags (optional) | Tags to filter the list on. If you provide a tag, this takes precedence over the uuids filter. Allowed values: |
Code examples
curl https://insight.djuno.io/v1/stats/coins \
-H 'x-api-key: your-api-key' \
-G
Response
HTTP/1.1 200 OK
{
"status": "success",
"data": {
"stats": {
"positiveChanges": 3118,
"negativeChanges": 3725,
"numberOfCoins": 31110,
"volume": "226221134262.99506",
"volumeShare": "100",
"marketCap": "1278354560622",
"marketCapChange": "0.06",
"marketCapShare": "100",
"topCurrencySymbol": "BTC",
"topCurrencyMarketCap": "668081784272",
"topCurrencyDominance": "52.26"
}
}
}
Response fields
Property | Description |
status | Status of the request Allowed values: |
data |
|
data.stats |
|
data.stats.positiveChanges | The amount of coins within the group that now have a higher price than at the beginning of the selected timeperiod. |
data.stats.negativeChanges | The amount of coins within the group that now have a lower price than at the beginning of the selected timeperiod. |
data.stats.numberOfCoins | The amount of coins selected for these stats based on the filters provided. See either the tag or uuids filter for more information about filtering these stats. |
data.stats.volume | The trading volume in US Dollar of the coins within the group, within the time period. |
data.stats.volumeShare | The percentage of trading volume compared to coins outside of the selection. E.g. if you have used the tag filter to only get DeFi coins, this is the percentage of trading volume of DeFi coins compared to all other coins. |
data.stats.marketCap | The market cap in US Dollars of the selected coins. |
data.stats.marketCapChange | The change in market cap in US Dollars of the selected coins, as compared to the beginning of the selected time period. |
data.stats.marketCapShare | Similar to volumeShare, this compares the selection of coins against all other coins, but for market cap. |
data.stats.topCurrencySymbol | The symbol of the currency that currently holds the highest market cap within the selection. |
data.stats.topCurrencyMarketCap | The market cap in US Dollars of the currency that currently holds the highest market cap |
data.stats.topCurrencyDominance | A percentage that tells you how big the biggest coin in the selection is compared to the rest of the selection, measured in market cap. |
Error response
HTTP/1.1 404 Not Found
{
"status": "fail",
"type": "TAG_NOT_FOUND",
"message": "Tag not found"
}
Error responses
404
Error | Description |
TAG_NOT_FOUND | The tag could not be found. Try another tag. |
422
Error | Description |
VALIDATION_ERROR | The request could not be validated. The response should provide more details. |
REFERENCE_UNAVAILABLE | The reference currency used in the request is not available. Choose another UUID. |
Search
https://insight.djuno.io/v1/search-suggestions
Query parameters
Parameter | Description |
query (optional) | Value to search on. Can be a part of a name or symbol, or a complete smart contract address. Example: |
referenceCurrencyUuid (optional) | UUID of coin (either fiat or crypto), in which all the prices are calculated. Defaults to US Dollar, but you can use any coin. You can find UUIDs for reference currencies in any coin endpoint, including a convenient dedicated reference currency endpoint Default value: yhjMzLPhuIDl |
Code examples
curl https://insight.djuno.io/v1/search-suggestions?query=bitco \
-H 'x-api-key: your-api-key' \
-G
Response
HTTP/1.1 200 OK
{
"status": "success",
"data": {
"coins": [
{
"uuid": "Qwsogvtv82FCd",
"iconUrl": "https://cdn.coinranking.com/gNsKAuE-W/bitcoin_btc.svg",
"name": "Bitcoin",
"symbol": "BTC",
"price": "65955.43592725793773050345"
},
{
"uuid": "ZlZpzOJo43mIo",
"iconUrl": "https://cdn.coinranking.com/By8ziihX7/bch.svg",
"name": "Bitcoin Cash",
"symbol": "BCH",
"price": "629.06361906860411030862"
}
],
"exchanges": [
{
"uuid": "YY5LBnZ-G",
"iconUrl": "https://cdn.coinranking.com/tG3ps5jPI/bitforex.svg",
"name": "Bitforex",
"recommended": false
},
{
"uuid": "C2gDcXEHIFD",
"iconUrl": "https://cdn.coinranking.com/lQYXlA0LJ/hotbit.svg",
"name": "HOTBIT",
"recommended": false
}
],
"markets": [
{
"uuid": "MP77r-vKf4",
"baseSymbol": "BTC",
"quoteSymbol": "USDT",
"baseUuid": "Qwsogvtv82FCd",
"quoteUuid": "HIVsRcGKkPFtW",
"exchangeIconUrl": "https://cdn.coinranking.com/mDTK5qrmq/binance.svg",
"exchangeName": "Binance",
"exchangeUuid": "-zdvbieRdZ",
"recommended": true
},
{
"uuid": "6NVfmwRwJEp",
"baseSymbol": "BTC",
"quoteSymbol": "USDT",
"baseUuid": "Qwsogvtv82FCd",
"quoteUuid": "HIVsRcGKkPFtW",
"exchangeIconUrl": "https://cdn.coinranking.com/tBA4j321g/Okex.svg",
"exchangeName": "OKEx",
"exchangeUuid": "hUlMcwWZp_",
"recommended": true
}
],
"fiat": [
{
"uuid": "yhjMzLPhuIDl",
"iconUrl": "https://cdn.coinranking.com/kz6a7w6vF/usd.svg",
"name": "US Dollar",
"symbol": "USD",
"price": "1"
}
],
"categories": [
{
"slug": "defi",
"shortname": "DeFi",
"name": "DeFi coins",
"iconUrl": "https://cdn.coinranking.com/MlN0Muv9-/defi.svg",
"numberOfCoins": 100
}
]
}
}
Response fields
Property | Description |
data.coins | List of coins matching the search pattern |
data.coins.uuid | UUID of the coin |
data.coins.iconUrl | Location of the icon |
data.coins.name | Name of the coin |
data.coins.symbol | Currency symbol |
data.coins.price | Price of the coin |
data.exchanges | List of exchanges matching the search pattern |
data.exchanges.uuid | UUID of the exchange |
data.exchanges.iconUrl | Location of the icon |
data.exchanges.name | Name of the exchange |
data.exchanges.recommended | Whether the exchange is recommended based on our criteria, see https://support.coinranking.com/article/82-recommended-exchanges |
data.markets | List of markets matching the search pattern |
data.markets.uuid | UUID of the market |
data.markets.baseSymbol | The base symbol of this market |
data.markets.quoteSymbol | The quote symbol of this market |
data.markets.baseUuid | The UUID of the base currency |
data.markets.quoteUuid | The UUID of the quote currency |
data.markets.exchangeIconUrl | Location of the icon of the exchange this market belongs to |
data.markets.exchangeName | Name of the exchange |
data.markets.exchangeUuid | UUID of the exchange |
data.markets.recommended | Whether the market is recommended based on the exchange it belongs to, see https://support.coinranking.com/article/82-recommended-exchanges |
data.fiat | List of fiat currencies matching the search pattern |
data.fiat.uuid | UUID of the currency |
data.fiat.iconUrl | Location of the icon |
data.fiat.name | Name of the currency |
data.fiat.symbol | Currency symbol |
data.fiat.price | Rate of the currency |
data.categories | List of categories matching the search pattern |
data.categories.slug | Slug of the category |
data.categories.shortname | Shortened name of the category |
data.categories.name | Full name of the category |
data.categories.iconUrl | Location of the icon |
data.categories.numberOfCoins | Number of coins in the category |
Error response
HTTP/1.1 422 Unprocessable Entity
{
"status": "fail",
"type": "REFERENCE_UNAVAILABLE",
"message": "Reference currency with UUID of HxDUgYGNAdQz not available"
}
Error responses
422
Error | Description |
VALIDATION_ERROR | The request could not be validated. The response should provide more details. |
REFERENCE_UNAVAILABLE | The reference currency used in the request is not available. Choose another UUID. |
Bulk coins
Get bulk data of all coins
https://insight.djuno.io/v1/bulk/coins
Code examples
curl https://insight.djuno.io/v1/bulk/coins \
-H 'x-api-key: your-api-key' \
-G \
--compressed \
-o output.json
Response
HTTP/1.1 200 OK
[
{
"uuid": "Qwsogvtv82FCd",
"updatedAt": 1717497619,
"symbol": "BTC",
"name": "Bitcoin",
"iconUrl": "https://cdn.coinranking.com/bOabBYkcX/bitcoin_btc.svg",
"links": [
{
"name": "coinmarketcap.com",
"url": "https://coinmarketcap.com/currencies/bitcoin/",
"type": "cmc"
},
{
"name": "bitcoin.org",
"type": "website",
"url": "https://bitcoin.org"
},
{
"name": "bitcoinmagazine.com",
"url": "https://bitcoinmagazine.com/",
"type": "website"
},
{
"name": "bitcointalk.org",
"url": "https://bitcointalk.org/",
"type": "bitcointalk"
},
{
"name": "bitcoin/bitcoin",
"url": "https://github.com/bitcoin/bitcoin",
"type": "github"
},
{
"name": "r/bitcoin",
"url": "https://www.reddit.com/r/bitcoin/",
"type": "reddit"
},
{
"name": "Bitcoin_Magazine",
"url": "https://t.me/Bitcoin_Magazine",
"type": "telegram"
},
{
"name": "bitcoin",
"url": "https://t.me/bitcoin",
"type": "telegram"
},
{
"name": "Bitcoin Whitepaper",
"url": "https://bitcoin.org/bitcoin.pdf",
"type": "whitepaper"
}
],
"color": "#f7931A",
"listedAt": 1330214400,
"tags": [
"halal",
"layer-1",
"proof-of-work"
],
"maxSupply": "21000000",
"issuanceBlockchains": [
{
"name": "Bitcoin",
"reference": null
}
],
"price": "63862.61655770243",
"marketCap": "1260990482199",
"fullyDilutedMarketCap": "1341114947712",
"volume": "18250228627",
"price1hAgo": "63726.554724983194",
"price3hAgo": "63678.81020397417",
"price12hAgo": "64307.79866234446",
"price24hAgo": "63875.484884689606",
"price7dAgo": "58276.0082622311",
"price30dAgo": "68209.40347294786",
"price3mAgo": "69292.28673341914",
"price1yAgo": "26105.28335075832",
"price3yAgo": "48964.152023526825",
"price5yAgo": "11128.14084828205",
"sparkline1h": [
"63732.6373736823",
"63804.065328475575",
"63805.210272342294",
"63814.84456413123",
"63884.988264620246",
"63889.33447772621",
"63881.19217540353",
"63873.45171566927",
"63827.557089906426",
"63840.35091096729",
"63820.777952423945",
"63801.05118316911"
],
"sparkline3h": [
"63687.76257058441",
"63680.83148990669",
"63687.49773374934",
"63737.68373843064",
"63651.971120019894",
"63594.77559678086",
"63582.360019921136",
"63627.05910891343",
"63616.84573408292",
"63670.04758040921",
"63717.599140458275",
"63795.32818428669",
"63835.71307270205",
"63873.045312203234",
"63873.58522943921",
"63885.1864699553",
"63878.351712229174",
"63852.66539625142",
"63816.1340335506",
"63875.72235069205",
"63864.179209679714",
"63783.48295116012",
"63732.460763109724",
"63733.60544661863",
"63732.6373736823",
"63804.065328475575",
"63805.210272342294",
"63814.84456413123",
"63884.988264620246",
"63889.33447772621",
"63881.19217540353",
"63873.45171566927",
"63827.557089906426",
"63840.35091096729",
"63820.777952423945",
"63801.05118316911"
],
"sparkline12h": [
"64209.36059539615",
"64045.41146503717",
"63956.316769021374",
"64043.82010288767",
"64078.97899566623",
"63968.90559088486",
"63881.15098867481",
"63717.58127508807",
"63746.42980051067",
"63664.188439289115",
"63839.906871673265",
null
],
"sparkline24h": [
"63854.824634413206",
"63960.263376078954",
"64086.60855653837",
"64094.922117160444",
"64035.45858629048",
"64028.84352626344",
"64073.72382426766",
"64109.42000098187",
"64123.64766347129",
"64279.34661749917",
"64351.15657397337",
"64488.53034681197",
"64209.36059539615",
"64045.41146503717",
"63956.316769021374",
"64043.82010288767",
"64078.97899566623",
"63968.90559088486",
"63881.15098867481",
"63717.58127508807",
"63746.42980051067",
"63664.188439289115",
"63839.906871673265",
null
],
"sparkline7d": [
"58315.7416229473",
"58791.701413270544",
"60301.55942385245",
"60409.909764954034",
"59118.32796110784",
"59202.28058024403",
"59314.197913159456",
"60430.58812900159",
"60470.683482964225",
"60672.71313819922",
"60306.84223197134",
"60613.189530980235",
"60966.095259633",
"62914.189873396004",
"63665.00673377523",
"64049.81473710139",
"63989.6747763024",
"64086.06253970083",
"63908.11711019808",
"64143.08525610675",
null
],
"sparkline30d": [
"68272.70659573431",
"67828.649680657",
"68608.93468746012",
"66392.89017648668",
"66002.68126841332",
"64148.641812763075",
"63774.98642313582",
"61218.351190596615",
"59897.098875387215",
"53309.561507537466",
"55695.36680514959",
"56184.898845142045",
"57937.96609604841",
"60525.28675448115",
"60616.16849657428",
"60378.107966110605",
"58857.23706507162",
"59521.01114470784",
"60015.62693184799",
"58315.63646578822",
"58258.613302413905",
"59146.301908392845",
"59606.50841226364",
"58560.516768527465",
"59899.53231140319",
"59681.57229628631",
"60469.13425292371",
"61559.6880355543",
"63909.379992665985",
null
],
"sparkline3m": [
"70102.4792279725",
"67572.28256716863",
"65054.84486125128",
"61271.13171207098",
"59541.29150863424",
"57581.48889099909",
"64712.095988249974",
"66738.90398971722",
"64291.94063346326",
"57378.20808415549",
"59019.0711363704",
"60679.97060956016"
],
"sparkline1y": [
"27961.943919693163",
"26371.625474865472",
"29633.24486966322",
"36568.86810204725",
"42485.30156767775",
"42983.90947715237",
"49493.6921579507",
"67521.51926360297",
"65957.60742591304",
"65126.468394876836",
"66039.87161267948",
"62736.060425649324"
],
"sparkline3y": [
"45555.62253995916",
"46068.47710174408",
"57649.81453020378",
"60655.41632735349",
"49508.66357342172",
"41246.77485314933",
"40607.72438072867",
"41912.09515693388",
"41663.992627414125",
"31895.66868440294",
"24506.968817433946",
"21443.195974740876",
"22475.79672591635",
"19820.700505355522",
"19631.646983618004",
"17692.386339316545",
"16956.53383822057",
"20122.632580692836",
"23322.489210018375",
"25066.567104971662",
"28965.94740028308",
"27626.19994847011",
"27692.261473295755",
"30098.86914264737",
"27961.943919693163",
"26371.625474865472",
"29633.24486966322",
"36568.86810204725",
"42485.30156767775",
"42983.90947715237",
"49493.6921579507",
"67521.51926360297",
"65957.60742591304",
"65126.468394876836",
"66039.87161267948",
"62736.060425649324"
],
"sparkline5y": [
"10581.577361264544",
"9777.0862199913",
"8403.771596580265",
"8398.429802452603",
"7301.277276701419",
"8330.368055730407",
"9652.198447196064",
"6923.761670593226",
"7175.493631036374",
"9236.051553886908",
"9528.875288642546",
"9562.621811849573",
"11635.706740132911",
"10662.11303663457",
"11832.604461036553",
"16496.570513744904",
"21806.565653850892",
"34652.26296063312",
"46118.84041977686",
"54639.07833588483",
"57645.548150653",
"47602.29856520422",
"35789.82581266557",
"33953.36407052421",
"45555.62253995916",
"46068.47710174408",
"57649.81453020378",
"60655.41632735349",
"49508.66357342172",
"41246.77485314933",
"40607.72438072867",
"41912.09515693388",
"41663.992627414125",
"31895.66868440294",
"24506.968817433946",
"21443.195974740876",
"22475.79672591635",
"19820.700505355522",
"19631.646983618004",
"17692.386339316545",
"16956.53383822057",
"20122.632580692836",
"23322.489210018375",
"25066.567104971662",
"28965.94740028308",
"27626.19994847011",
"27692.261473295755",
"30098.86914264737",
"27961.943919693163",
"26371.625474865472",
"29633.24486966322",
"36568.86810204725",
"42485.30156767775",
"42983.90947715237",
"49493.6921579507",
"67521.51926360297",
"65957.60742591304",
"65126.468394876836",
"66039.87161267948",
"62736.060425649324"
],
"allTimeHighPrice": 73646.0632562494,
"allTimeHighDate": 1710400080,
"tier": 1,
"circulatingSupply": "19745362",
"totalSupply": "19745362",
"marketCapRank": 1,
"fullyDilutedMarketCapRank": 1,
"volumeRank": 2,
"change1hRank": 166,
"change3hRank": 281,
"change12hRank": 349,
"change24hRank": 301,
"change7dRank": 485,
"change30dRank": 307,
"change3mRank": 80,
"change1yRank": 114,
"change3yRank": 38,
"change5yRank": 35,
"numberOfExchanges": 109,
"numberOfMarkets": 2665
}
]
Response fields
Property | Description |
| The response is a list of objects of all our coins |
uuid | UUID of a coin; a unique identifier |
updatedAt | Timestamp of the last change made to the coin's static data |
symbol | Symbol of a coin |
name | Name of a coin |
iconUrl | URL to the icon of a coin |
links | List of links, like social media pages |
links.name | Name of the link |
links.url | Url to the specific link |
links.type | The type of link Allowed values: |
color | of the coin in hexadecimal format |
listedAt | Timestamp of when the coin was listed on coinranking |
tags | List of tags, like "Staking" or "Meme" |
issuanceBlockchains | List of issuance blockchains. This is our name for blockchains where the coin is issued on, which in some cases means multiple blockchains. For example Tether is issued on nine different blockchains. |
issuanceBlockchains.name | The name of the blockchain |
issuanceBlockchains.reference | The reference, such as a smart contract address, of a coin on the blockchain |
price | Price of the coin in US Dollar |
marketCap | Market capitalization in US Dollar. Price times circulating supply |
fullyDilutedMarketCap | Market capitalization in US Dollar. Price times circulating supply Full Market capitalization. Fully diluted market cap is a coin's price multiplied by its max supply. Or total supply if the max supply is not known. It shows what the market cap could be if all coins were in circulation, with the current price. |
24hVolume | 24h trade volume in US Dollar |
price1hAgo | Price 1 hour ago in US Dollar. Useful to calculate the change percentage over 1 hour. You can use the 1h price of a different coin to calculate the price in a different reference currency. For example, you can look up the current price of Euro now and 1 hour ago, and use its rate to calculate the Bitcoin price in Euro. Next, you could use these rates to calculate the change percentage of Bitcoin in Euro. In our regular coins endpoint we can do this for you; we return a change percentage in the response and you can provide a reference currency of your choosing (such as EUR, YEN or BTC) and all the prices including the change percentage are calculated using this reference currency. |
price3hAgo | Price 3 hours ago in US Dollar. See price1hAgo for more details. |
price12hAgo | Price 12 hours ago in US Dollar. See price1hAgo for more details. |
price24hAgo | Price 24 hours ago in US Dollar. See price1hAgo for more details. |
price7dAgo | Price 7 days ago in US Dollar. See price1hAgo for more details. |
price30dAgo | Price 30 days ago in US Dollar. See price1hAgo for more details. |
price3mAgo | Price 3 months ago in US Dollar. See price1hAgo for more details. |
price1yAgo | Price 1 year ago in US Dollar. See price1hAgo for more details. |
price3yAgo | Price 3 years ago in US Dollar. See price1hAgo for more details. |
price5yAgo | Price 5 years ago in US Dollar. See price1hAgo for more details. |
sparkline1h | Array of about 25 price points spread out over the last 1 hour. Useful for a small chart |
sparkline3h | Array of about 25 price points spread out over the last 3 hours. Useful for a small chart |
sparkline12h | Array of about 25 price points spread out over the last 12 hours. Useful for a small chart |
sparkline24h | Array of about 25 price points spread out over the last 24 hours. Useful for a small chart |
sparkline7d | Array of about 25 price points spread out over the last 7 days. Useful for a small chart |
sparkline30d | Array of about 25 price points spread out over the last 30 days. Useful for a small chart |
sparkline3m | Array of about 25 price points spread out over the last 3 months. Useful for a small chart |
sparkline1y | Array of about 25 price points spread out over the last 1 year. Useful for a small chart |
sparkline3y | Array of about 25 price points spread out over the last 3 years. Useful for a small chart |
sparkline5y | Array of about 25 price points spread out over the last 5 years. Useful for a small chart |
allTimeHighPrice | Highest price the coin ever reached in US Dollar |
allTimeHighDate | Timestamp of when the coin reached its highest price ever reached in US Dollar |
circulatingSupply | Number of coins that are circulating in the public market |
totalSupply | Number of coins that are in existence |
maxSupply | Maximum amount the coin's supply can ever be. |
marketCapRank | Ranking of the coin based on its market capitalization. |
fullyDilutedMarketCapRank | Ranking of the coin based on its fully diluted market capitalization. |
volumeRank | Ranking of the coin based on its trading volume. |
change1hRank | Ranking of the coin based on its performance in the last 1 hour. |
change3hRank | Ranking of the coin based on its performance in the last 3 hours. |
change12hRank | Ranking of the coin based on its performance in the last 12 hours. |
change24hRank | Ranking of the coin based on its performance in the last 24 hours. |
change7dRank | Ranking of the coin based on its performance in the last 7 days. |
change30dRank | Ranking of the coin based on its performance in the last 30 days. |
change3mRank | Ranking of the coin based on its performance in the last 3 months. |
change1yRank | Ranking of the coin based on its performance in the last 1 year. |
change3yRank | Ranking of the coin based on its performance in the last 3 years. |
change5yRank | Ranking of the coin based on its performance in the last 5 years. |
numberOfExchanges | The number of exchanges that the coin is listed on. |
numberOfMarkets | The number of markets that the coin is available in. |
Real-time
Authentication
wss://insight.djuno.io/v1/real-time/rates?x-api-key=your-api-key
Subscribe to rates
professional This endpoint requires the professional plan or higher
Establish a WebSocket connection to get rates in real-time. There are two ways to subscribe to coins; directly establish a connection with subscriptions by using query parameters to select your subscriptions, or establish a connection and send a JSON message through the socket with the subscriptions you require.
wss://api.coinranking.com/v2/real-time/rates
Query parameters
Parameter | Description |
uuids | With the UUIDs parameter, you can select which coins to subscribe to. Provide a list of coin UUIDs to make your selection, use our other endpoints or our website to find the UUIDs of coins you want. There is a maximum of hundred UUIDs you can subscribe to within one WebSocket. Size range: 1-100 |
throttle (optional) | With the throttle parameter, you prevent getting overloaded with rates. This is useful if performance is an issue, e.g. when using WebSockets in your frontend and want to prevent straining your client's their devices too much. Throttling works per coin. If you select a throttle, this means rates for the same coin will not be pushed more than once within the specified duration. When you have subscribed to multiple coins, you still receive more messages within the specified duration. You can choose between 1s (At least one second interval between a rate for each coin) or 10s (ten seconds). Default value: 1s |
list (optional) | With the list parameter, you can subscribe to a list of coins. The default is to subscribe to none and filter on UUIDs. Besides the none option, you can also choose all to subscribe to every rate. You can choose between none (no list is selected and you can use the UUIDs parameter to filter the list) or all (every rate). Default value: none |
Code examples
// Send a JSON formatted message through the WebSocket client after establishing a connection
const connection = new WebSocket('wss://api.coinranking.com/v2/real-time/rates?x-api-key=your-api-key');
connection.onopen = () => {
const subscriptions = {
throttle: '10s',
uuids: [
'Qwsogvtv82FCd',
'razxDUgYGNAdQ',
],
};
connection.send(JSON.stringify(subscriptions));
};
};
Response
{
"currencyUuid": "Qwsogvtv82FCd",
"price": "59585.64479860372914892766",
"volume": "33769051110.0956537043822976375655904"
}
Response fieldsProperty | Description |
currencyUuid | The currency of this rate |
price | The latest price of this coin |
volume | The latest volume of this coin |