合作伙伴 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=zh&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=zh" 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=zh"
免密钥小组件
想在自己的网站上展示行情、币种卡片、新闻流或恐惧与贪婪指数,可以直接使用现成的小组件。无需密钥,按 Origin 限流。 小组件生成器 →