Get exchange details

professional This endpoint requires the professional plan or higher

Find information on a specific exchange listed on coinranking. An exchange is a place where cryptocurrencies are traded.

On Coinranking, we use this endpoint on our exchange detail page.

GET /exchange/:uuid


https://api.coinranking.com/v2/exchange/:uuid

Path parameters

ParameterDescription
uuid StringUUID of the exchange you want to request.

Query parameters

Parameter Description
referenceCurrencyUuid (optional) String

UUID of reference currency, which rate is used to calculate the volume. Defaults to US Dollar

Default value: yhjMzLPhuIDl

Example:
...exchange/-zdvbieRdZ?referenceCurrencyUuid=5k-_VTxqtCEI

Code examples

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

PropertyDescription
status String

Status of the request

Allowed values:
success
data Object
data.exchange Object
data.exchange.uuid String

UUID of the exchange

data.exchange.name String

Name of the exchange

data.exchange.description String

Description of the exchange

data.exchange.iconUrl String

Location of the icon

data.exchange.websiteUrl String

Website URL to the exchange

data.exchange.verified Boolean

DEPRECATED A verified exchange is verified to not participate in harmful practices such as wash trading.

data.exchange.recommended Boolean

Whether the exchange is recommended based on our criteria, see https://support.coinranking.com/article/82-recommended-exchanges

data.exchange.numberOfMarkets Number

Number of markets of the exchange paired with Coinranking

data.exchange.numberOfCoins Number

Number of coins listed for this exchange on Coinranking

data.exchange.24hVolume String

Total volume in 24 hours

data.exchange.lastTickerCreatedAt Number

Timestamp of the latest ticker

data.exchange.links Object[]

List of links, like social media pages

data.exchange.links.name String

Name of the link

data.exchange.links.url String

Url to the specific link

data.exchange.links.type String

The type of link

Allowed values:
website bitcointalk explorer discord facebook github instagram line-messenger linkedin medium qq quora reddit sina-weibo telegram tiktok twitter vkontakte wechat whitepaper youtube etc.
data.exchange.rank Number

Rank of the exchange based on volume, taking into account exchange and currency filters

data.exchange.marketShare String

Percentage of the total exchange volume represented by this exchange.

data.exchange.coinrankingUrl String

Where to find the exchange on coinranking.com

data.exchange.delistedAt String/null

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 Object[]

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 Object[]

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

On this page