Получение данных по тикеру для контракта

📘 GET /contracts/{platform_id}/{contract_address} — Получить тикер по адресу контракта

Позволяет получить рыночные данные (тикер) токена по его смарт-контрактному адресу на указанной платформе. Подходит для быстрого определения цены и других характеристик токена, если известен его контракт.

🕒 Частота обновления данных: каждые 5 минут

---

🔗 Endpoint

https://api.cryptoskop.ru/v1/contracts/{platform_id}/{contract_address}

---

📥 Path-параметры

Параметр	Тип	Обязателен	Описание
platform_id	string	✅	Идентификатор платформы (например, eth-ethereum)
contract_address	string	✅	Адрес смарт-контракта токена в блокчейне (в hex-формате)

---

📄 Пример ответа

{
  "id": "omg-omisego",
  "name": "OMG Network",
  "symbol": "OMG",
  "rank": 196,
  "circulating_supply": 140245398,
  "total_supply": 140245398,
  "max_supply": null,
  "beta_value": 1.06969,
  "first_data_at": "2017-07-23T00:00:00Z",
  "last_updated": "2025-08-08T07:15:00Z",
  "quotes": {
    "USD": {
      "price": 0.7542,
      "volume_24h": 22504464,
      "volume_change_24h": -10.18,
      "market_cap": 105796800,
      "market_cap_change_24h": -8.94,
      "percent_change_15m": 0.11,
      "percent_change_30m": 0.08,
      "percent_change_1h": -0.2,
      "percent_change_6h": 1.28,
      "percent_change_12h": -1.17,
      "percent_change_24h": -8.94,
      "percent_change_7d": -15.42,
      "percent_change_30d": -24.53,
      "percent_change_1y": -58.29,
      "ath_price": 28.35,
      "ath_date": "2018-01-08T00:00:00Z",
      "percent_from_price_ath": -97.34
    }
  }
}

---

🧾 Поля в ответе

Поле	Тип	Описание
id	string	Уникальный ID токена в системе
name	string	Название токена
symbol	string	Символ токена
rank	integer	Позиция в глобальном рейтинге
circulating_supply	number	Объём токенов в обращении
total_supply	number	Общее количество выпущенных токенов
max_supply	number/null	Максимальное количество токенов (если задано)
beta_value	number	Коэффициент волатильности
first_data_at	string	Дата первой записи о токене (ISO 8601)
last_updated	string	Дата/время последнего обновления данных
quotes	object	Рыночные данные по валютам
quotes.{symbol}	object	Ценовые данные по конкретной валюте (например, USD)

---

⚠️ Примечания

• Если контракт не найден, возвращается ошибка 404.

• Данные цен обновляются раз в 5 минут, объёмы — раз в минуту.

• Можно использовать в связке с эндпоинтом GET /contracts/{platform_id} для поиска адреса контракта.