Partner API
A read-only JSON API with our news summaries (linked to the original sources), market data, derivatives, the events calendar and the token screener. Published data only.
Full reference (OpenAPI 3.1)Download openapi.yaml
License and attribution
- You must show “Satoshi Daily” with a link to the site next to the data. Every response includes an attribution object and an X-Attribution header.
- News items are our own summaries. The original articles belong to their publishers: show the links in sources[] and do not present a summary as the publisher’s text.
- Market data comes from CoinGecko, GeckoTerminal and public exchange APIs. Nothing in the API is investment advice.
{
"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. …"
}
}Keys and plans
Satoshi Daily issues the keys. A key is shown once: keep it on your server, not in the browser. Send it in the X-API-Key header or as Authorization: Bearer.
| Plan | Requests per minute | Requests per day (UTC) |
|---|---|---|
| free | 60 | 5,000 |
| pro | 300 | 100,000 |
| business | 1,200 | 1,000,000 |
Limits
The per-minute window is sliding. Every response includes X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset (seconds), and the same headers with a -Day suffix. Over the limit you get 429 with Retry-After in seconds. A missing or revoked key returns 401.
Endpoints
Base URL: https://satoshidaily.net/api/public/v1
| GET /news?lang=ru&coin=&min_importance=&limit=&cursor= | Published stories: summary, “why it matters”, links to the sources |
| GET /news/{id}?lang= | One story |
| GET /market | Market cap, volume, dominance, Fear & Greed, top-100, top gainers and losers |
| GET /coins/{id}?days=7&lang= | Coin card, price history, related stories |
| GET /derivatives | Funding rates, open interest, liquidations by coin |
| GET /derivatives/{coin}?hours=24 | One coin across exchanges, with history |
| GET /events?from=&to=&type=&coin=&lang= | Events calendar (published only) |
| GET /events/{id}?lang= | One event |
| GET /screener?preset=&mcap_min=&…&sort=&page= | Top-1000 screener: filters, sorting, pages |
| GET /screener/meta | Categories, chains, presets, data freshness |
| GET /widget/ticker · /widget/coins/{id} · /widget/news · /widget/fear-greed | Widget data, no key (limited per Origin) |
Examples
curl -s -H "X-API-Key: $SD_API_KEY" "https://satoshidaily.net/api/public/v1/news?lang=en&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=en" 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=en"
Keyless widgets
To show quotes, a coin card, a news feed or the Fear & Greed index on your site, use the ready-made widgets. They need no key and are limited per Origin. Widget builder →