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

📘 GET /contracts/{platform_id}/{contract_address}/historical — Исторические данные по контракту

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

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

---

🔗 Endpoint

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

---

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

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

---

🔍 Query-параметры

Параметр	Тип	Обязателен	По умолчанию	Описание
start	string	✅	—	Начальная дата/время исторических данных (форматы: yyyy-mm-dd, ISO 8601, Unix timestamp в секундах)
end	string	❌	NOW	Конечная дата/время исторических данных (поддерживает те же форматы, что и start)
limit	integer	❌	1000	Кол-во строк в ответе (макс. 5000)
quote	string	❌	usd	Валюта котировки (доступны: usd, btc)
interval	string	❌	5m	Интервал данных (5m, 10m, 15m, 30m, 45m, 1h, 2h, 3h, 6h, 12h, 24h, 1d, 7d, 14d, 30d, 90d, 365d)

---

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

[
  {
    "timestamp": "2019-01-01T00:00:00Z",
    "price": 1.3275,
    "volume_24h": 1223345.23,
    "market_cap": 18765432.55
  },
  {
    "timestamp": "2019-01-02T00:00:00Z",
    "price": 1.2158,
    "volume_24h": 1120456.78,
    "market_cap": 17123456.78
  }
]

---

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

Поле	Тип	Описание
timestamp	string	Метка времени точки данных (ISO 8601)
price	number	Цена токена в выбранной валюте
volume_24h	number	Объём торгов за последние 24 часа
market_cap	number	Рыночная капитализация в выбранной валюте

---

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

• Для больших диапазонов рекомендуется использовать более крупный интервал (1d, 7d, 30d), чтобы не превысить лимит строк.

• Исторические данные зависят от доступности на платформе и могут отсутствовать для новых токенов.

• Значение NOW в end автоматически подставляет текущий момент времени.