API для партнёров
Читаемый JSON API: наши сводки новостей со ссылками на первоисточники, рынок, деривативы, календарь событий и скринер токенов. Только опубликованные данные.
Полный справочник (OpenAPI 3.1)Скачать openapi.yaml
Лицензия и атрибуция
- Указание «Satoshi Daily» со ссылкой на сайт рядом с данными обязательно. В каждом ответе есть объект attribution и заголовок X-Attribution.
- Новости — это наши собственные сводки. Исходные статьи принадлежат издателям: показывайте ссылки из sources[] и не выдавайте сводку за текст первоисточника.
- Рыночные данные — CoinGecko, GeckoTerminal, публичные API бирж. Ничто в API не является инвестиционной рекомендацией.
{
"data": { "items": [ … ], "next_cursor": "…" },
"attribution": {
"text": "Satoshi Daily",
"url": "https://satoshidaily.net",
"required": true,
"license": "Display \"Satoshi Daily\" with a link to https://satoshidaily.net next to the data. …"
}
}Ключи и планы
Ключ выдаёт редакция Satoshi Daily. Он показывается один раз, храните его на сервере, не в браузере. Передавайте его в заголовке X-API-Key или Authorization: Bearer.
| План | Запросов в минуту | Запросов в сутки (UTC) |
|---|---|---|
| free | 60 | 5 000 |
| pro | 300 | 100 000 |
| business | 1 200 | 1 000 000 |
Лимиты
Окно в минуту скользящее. В каждом ответе есть X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset (секунды) и такие же заголовки с суффиксом -Day. При превышении придёт 429 и Retry-After в секундах. Без ключа или с отозванным ключом придёт 401.
Методы
Базовый адрес: https://satoshidaily.net/api/public/v1
| GET /news?lang=ru&coin=&min_importance=&limit=&cursor= | Опубликованные истории: сводка, «что это значит», ссылки на первоисточники |
| GET /news/{id}?lang= | Одна история |
| GET /market | Капитализация, объём, доминация, индекс страха и жадности, топ-100, лидеры роста и падения |
| GET /coins/{id}?days=7&lang= | Карточка монеты, история цены, связанные истории |
| GET /derivatives | Ставки финансирования, открытый интерес, ликвидации по монетам |
| GET /derivatives/{coin}?hours=24 | Одна монета в разрезе бирж, с историей |
| GET /events?from=&to=&type=&coin=&lang= | Календарь событий (только опубликованные) |
| GET /events/{id}?lang= | Одно событие |
| GET /screener?preset=&mcap_min=&…&sort=&page= | Скринер топ-1000: фильтры, сортировка, страницы |
| GET /screener/meta | Категории, сети, пресеты, свежесть данных |
| GET /widget/ticker · /widget/coins/{id} · /widget/news · /widget/fear-greed | Данные виджетов без ключа (лимит по Origin) |
Примеры
curl -s -H "X-API-Key: $SD_API_KEY" "https://satoshidaily.net/api/public/v1/news?lang=ru&limit=5" curl -s -H "X-API-Key: $SD_API_KEY" "https://satoshidaily.net/api/public/v1/screener?preset=near_ath&per_page=20" curl -s -H "X-API-Key: $SD_API_KEY" "https://satoshidaily.net/api/public/v1/screener?mcap_min=100M&ch7d_min=10&category=layer-2&sort=ch7d" curl -s -H "Authorization: Bearer $SD_API_KEY" "https://satoshidaily.net/api/public/v1/coins/bitcoin?days=30&lang=ru" curl -si -H "X-API-Key: $SD_API_KEY" "https://satoshidaily.net/api/public/v1/derivatives" | grep -i '^x-ratelimit' curl -s "https://satoshidaily.net/api/public/v1/widget/ticker?coins=bitcoin,ethereum&lang=ru"
Виджеты без ключа
Для котировок, карточки монеты, ленты новостей и индекса страха и жадности на своём сайте используйте готовые виджеты. Ключ не нужен, лимит считается по Origin. Конструктор виджетов →