Исторические ценовые данные по монете

📘 GET /tickers/{coin_id}/historical — Исторические данные по криптовалюте

Возвращает историю рыночных данных по выбранной криптовалюте: цену, объём торгов и рыночную капитализацию за указанный период времени до года.

🕒 Обновление данных — каждые 5 минут.

---

🔗 Endpoint

https://api.cryptoskop.ru/v1/tickers/{coin_id}/historical

---

🔧 Параметры запроса

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

Параметр	Тип	Обязательный	Описание
coin_id	string	✅	Уникальный идентификатор монеты. Пример: btc-bitcoin

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

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

---

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

[
  {
    "timestamp": "2023-08-01T00:00:00Z",
    "price": 29340.50,
    "volume_24h": 18956000000,
    "market_cap": 572300000000
  },
  {
    "timestamp": "2023-08-02T00:00:00Z",
    "price": 29710.12,
    "volume_24h": 19520000000,
    "market_cap": 579900000000
  }
]

---

🧾 Описание полей

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

---

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

• История доступна в зависимости от интервала и тарифа. При превышении лимита по времени или интервалу будет возвращена ошибка или усечённый результат.

• limit ограничивает количество возвращаемых точек. Если вы запрашиваете большой диапазон с мелким интервалом (например, 5m за 30 дней), указывайте limit=5000.