Документация по публичному API CoinMarketCap

Перечень конечных точек

• Листинги
• Тикер
• Тикер (конкретной валюты)
• Глобальные данные

Листинги

• Конечная точка: /listings/
• Метод: GET
• Описание: Эта конечная точка демонстрирует все действующие листинги криптовалют в одном вызове. Используйте поле "Код" в конечной точке Тикер для запроса дополнительной информации о конкретной криптовалюте.
• Пример: https://api.coinmarketcap.com/v2/listings/
• Образец ответа:

  {
      "data": [
          {
              "id": 1, 
              "name": "Bitcoin", 
              "symbol": "BTC", 
              "website_slug": "bitcoin"
          }, 
          {
              "id": 2, 
              "name": "Litecoin", 
              "symbol": "LTC", 
              "website_slug": "litecoin"
          }, 
          ...
      },
      "metadata": {
          "timestamp": 1525137187, 
          "num_cryptocurrencies": 1602, 
          "error": null
      }
  ]                               

Тикер

• Конечная точка: /ticker/
• Метод: GET
• Описание: Эта конечная точка демонстрирует данные о тикерах в порядке ранжирования. Максимальное количество результатов на один вызов – 100. Для разбиения на страницы воспользуйтесь параметрами start иlimit.
• Дополнительные параметры:
  • (int) start - return results starting from the specified number (default is 1)
  • (int) limit – показ максимально [limit] результатов (по умолчанию – 100; максимум – 100)
  • (string) sort – показ результатов, сортированных по [sort] . Допустимые значения – id, rank, volume_24h, и percent_chang_24h (по умолчанию – rank).
    Note: It is strongly recommended to use id to sort if paginating through all available results since id is the only sort option guaranteed to return in a consistent order.
  • (string) structure – показ структуры основного поля данных. Допустимые значения – dictionary и >array (по умолчанию – dictionary).
  • (string) convert – показ информации о цене в другой валюте.
    Допустимые коды фиатных валют: "AUD", "BRL", "CAD", "CHF", "CLP", "CNY", "CZK", "DKK", "EUR", "GBP", "HKD", "HUF", "IDR", "ILS", "INR", "JPY", "KRW", "MXN", "MYR", "NOK", "NZD", "PHP", "PKR", "PLN", "RUB", "SEK", "SGD", "THB", "TRY", "TWD", "ZAR"
    Допустимые коды криптовалют: "BTC", "ETH" "XRP", "LTC", а также "BCH"
• Пример: https://api.coinmarketcap.com/v2/ticker/
• Пример: https://api.coinmarketcap.com/v2/ticker/?limit=10
• Пример: https://api.coinmarketcap.com/v2/ticker/?limit=10&sort=id
• Пример: https://api.coinmarketcap.com/v2/ticker/?start=101&limit=10
• Пример: https://api.coinmarketcap.com/v2/ticker/?start=101&limit=10&sort=id
• Пример: https://api.coinmarketcap.com/v2/ticker/?start=101&limit=10&sort=id&structure=array
• Пример: https://api.coinmarketcap.com/v2/ticker/?convert=EUR&limit=10
• Пример: https://api.coinmarketcap.com/v2/ticker/?convert=BTC&limit=10
• Образец ответа:

  {
      "data": {
          "1": {
              "id": 1, 
              "name": "Bitcoin", 
              "symbol": "BTC", 
              "website_slug": "bitcoin", 
              "rank": 1, 
              "circulating_supply": 17008162.0, 
              "total_supply": 17008162.0, 
              "max_supply": 21000000.0, 
              "quotes": {
                  "USD": {
                      "price": 9024.09, 
                      "volume_24h": 8765400000.0, 
                      "market_cap": 153483184623.0, 
                      "percent_change_1h": -2.31, 
                      "percent_change_24h": -4.18, 
                      "percent_change_7d": -0.47
                  }
              }, 
              "last_updated": 1525137271
          }, 
          "1027": {
              "id": 1027, 
              "name": "Ethereum", 
              "symbol": "ETH", 
              "website_slug": "ethereum", 
              "rank": 2, 
              "circulating_supply": 99151888.0, 
              "total_supply": 99151888.0, 
              "max_supply": null, 
              "quotes": {
                  "USD": {
                      "price": 642.399, 
                      "volume_24h": 2871290000.0, 
                      "market_cap": 63695073558.0, 
                      "percent_change_1h": -3.75, 
                      "percent_change_24h": -7.01, 
                      "percent_change_7d": -2.32
                  }
              }, 
              "last_updated": 1525137260
          } 
          ...
      },
      "metadata": {
          "timestamp": 1525137187, 
          "num_cryptocurrencies": 1602, 
          "error": null
      }
  ]                               

Тикер (конкретной валюты)

• Конечная точка: /ticker/{id}/
• Метод: GET
• Описание: Эта конечная точка демонстрирует данные о тикере конкретной криптовалюты. Используйте поле "Код" конечной точки Листинги в URL.
• Дополнительные параметры:
  • (string) structure – показ структуры основного поля данных. Допустимые значения – dictionary и >array (по умолчанию – dictionary).
  • (string) convert – показ информации о цене в другой валюте.
    Допустимые коды фиатных валют: "AUD", "BRL", "CAD", "CHF", "CLP", "CNY", "CZK", "DKK", "EUR", "GBP", "HKD", "HUF", "IDR", "ILS", "INR", "JPY", "KRW", "MXN", "MYR", "NOK", "NZD", "PHP", "PKR", "PLN", "RUB", "SEK", "SGD", "THB", "TRY", "TWD", "ZAR"
    Допустимые коды криптовалют: "BTC", "ETH" "XRP", "LTC", а также "BCH"
• Пример: https://api.coinmarketcap.com/v2/ticker/1/
• Пример: https://api.coinmarketcap.com/v2/ticker/1/?structure=array
• Пример: https://api.coinmarketcap.com/v2/ticker/1/?convert=EUR
• Пример: https://api.coinmarketcap.com/v2/ticker/1/?convert=BCH
• Образец ответа:

  {
      "data": {
          "id": 1, 
          "name": "Bitcoin", 
          "symbol": "BTC", 
          "website_slug": "bitcoin", 
          "rank": 1, 
          "circulating_supply": 17008162.0, 
          "total_supply": 17008162.0, 
          "max_supply": 21000000.0, 
          "quotes": {
              "USD": {
                  "price": 9024.09, 
                  "volume_24h": 8765400000.0, 
                  "market_cap": 153483184623.0, 
                  "percent_change_1h": -2.31, 
                  "percent_change_24h": -4.18, 
                  "percent_change_7d": -0.47
              }
          }, 
          "last_updated": 1525137271
      },
      "metadata": {
          "timestamp": 1525237332, 
          "error": null
      }
  }               

• Образец ошибочного ответа:

  {
      "data": null, 
      "metadata": {
          "timestamp": 1525137187, 
          "error": "id not found"
      }
  }

Глобальные данные

• Конечная точка: /global/
• Метод: GET
• Описание: Эта конечная точка демонстрирует глобальные данные, отображаемые вверху страницы сайта coinmarketcap.com.
• Дополнительные параметры:
  • (string) convert – показ информации о цене в другой валюте.
    Допустимые коды фиатных валют: "AUD", "BRL", "CAD", "CHF", "CLP", "CNY", "CZK", "DKK", "EUR", "GBP", "HKD", "HUF", "IDR", "ILS", "INR", "JPY", "KRW", "MXN", "MYR", "NOK", "NZD", "PHP", "PKR", "PLN", "RUB", "SEK", "SGD", "THB", "TRY", "TWD", "ZAR"
    Допустимые коды криптовалют: "BTC", "ETH" "XRP", "LTC", а также "BCH"
• Пример: https://api.coinmarketcap.com/v2/global/
• Пример: https://api.coinmarketcap.com/v2/global/?convert=EUR
• Пример: https://api.coinmarketcap.com/v2/global/?convert=BTC
• Образец ответа:

  {
      "data": {
          "active_cryptocurrencies": 1594, 
          "active_markets": 10526, 
          "bitcoin_percentage_of_market_cap": 37.65, 
          "quotes": {
              "USD": {
                  "total_market_cap": 407690157494.0, 
                  "total_volume_24h": 30969801118.0
              }
          }, 
          "last_updated": 1525137271
      },
      "metadata": {
          "timestamp": 1525237332, 
          "error": null
      }
  }