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

### 📘 `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-формате) |

***

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

```json
{
  "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}`](https://chatgpt.com/c/68959554-b7fc-8332-97bb-71169638d39e) для поиска адреса контракта.