API para parceiros
Uma API JSON somente leitura com nossos resumos de notícias (com links para as fontes originais), dados de mercado, derivativos, a agenda de eventos e o screener de tokens. Apenas dados publicados.
Referência completa (OpenAPI 3.1)Baixar openapi.yaml
Licença e atribuição
- É obrigatório exibir “Satoshi Daily” com um link para o site junto aos dados. Toda resposta traz um objeto attribution e o cabeçalho X-Attribution.
- As notícias são resumos próprios. Os artigos originais pertencem aos seus veículos: exiba os links de sources[] e não apresente o resumo como texto da fonte original.
- Os dados de mercado vêm da CoinGecko, da GeckoTerminal e das APIs públicas das corretoras. Nada na API é recomendação de investimento.
{
"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. …"
}
}Chaves e planos
As chaves são emitidas pela redação do Satoshi Daily. A chave aparece uma única vez: guarde-a no seu servidor, não no navegador. Envie-a no cabeçalho X-API-Key ou como Authorization: Bearer.
| Plano | Requisições por minuto | Requisições por dia (UTC) |
|---|---|---|
| free | 60 | 5.000 |
| pro | 300 | 100.000 |
| business | 1.200 | 1.000.000 |
Limites
A janela por minuto é deslizante. Toda resposta traz X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset (em segundos) e os mesmos cabeçalhos com o sufixo -Day. Acima do limite, a resposta é 429 com Retry-After em segundos. Sem chave ou com chave revogada, a resposta é 401.
Métodos
URL base: https://satoshidaily.net/api/public/v1
| GET /news?lang=ru&coin=&min_importance=&limit=&cursor= | Histórias publicadas: resumo, “por que importa” e links para as fontes |
| GET /news/{id}?lang= | Uma história |
| GET /market | Capitalização, volume, dominância, Índice de Medo e Ganância, top 100, maiores altas e quedas |
| GET /coins/{id}?days=7&lang= | Ficha da moeda, histórico de preços, histórias relacionadas |
| GET /derivatives | Taxas de funding, contratos em aberto, liquidações por moeda |
| GET /derivatives/{coin}?hours=24 | Uma moeda por corretora, com histórico |
| GET /events?from=&to=&type=&coin=&lang= | Agenda de eventos (somente publicados) |
| GET /events/{id}?lang= | Um evento |
| GET /screener?preset=&mcap_min=&…&sort=&page= | Screener do top 1000: filtros, ordenação, paginação |
| GET /screener/meta | Categorias, redes, filtros prontos, atualização dos dados |
| GET /widget/ticker · /widget/coins/{id} · /widget/news · /widget/fear-greed | Dados dos widgets, sem chave (limite por Origin) |
Exemplos
curl -s -H "X-API-Key: $SD_API_KEY" "https://satoshidaily.net/api/public/v1/news?lang=pt&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=pt" 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=pt"
Widgets sem chave
Para mostrar cotações, a ficha de uma moeda, um feed de notícias ou o Índice de Medo e Ganância no seu site, use os widgets prontos. Eles não precisam de chave e o limite vale por Origin. Criador de widgets →