API cho đối tác
API JSON chỉ đọc: bản tóm tắt tin tức của chúng tôi (kèm link nguồn gốc), dữ liệu thị trường, phái sinh, lịch sự kiện và bộ lọc token. Chỉ dữ liệu đã xuất bản.
Tài liệu đầy đủ (OpenAPI 3.1)Tải openapi.yaml
Giấy phép và ghi nguồn
- Bắt buộc hiển thị “Satoshi Daily” kèm link tới trang bên cạnh dữ liệu. Mỗi phản hồi đều có đối tượng attribution và header X-Attribution.
- Tin tức là bản tóm tắt do chúng tôi viết. Bài gốc thuộc về nhà xuất bản: hãy hiển thị các link trong sources[] và đừng trình bày bản tóm tắt như văn bản của nguồn gốc.
- Dữ liệu thị trường lấy từ CoinGecko, GeckoTerminal và API công khai của các sàn. Không nội dung nào trong API là lời khuyên đầu tư.
{
"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. …"
}
}Khóa và gói
Khóa do Satoshi Daily cấp và chỉ hiển thị một lần: hãy lưu trên máy chủ của bạn, không để trong trình duyệt. Gửi khóa qua header X-API-Key hoặc Authorization: Bearer.
| Gói | Yêu cầu mỗi phút | Yêu cầu mỗi ngày (UTC) |
|---|---|---|
| free | 60 | 5.000 |
| pro | 300 | 100.000 |
| business | 1.200 | 1.000.000 |
Giới hạn
Cửa sổ theo phút là cửa sổ trượt. Mỗi phản hồi có X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset (giây) và các header tương tự với hậu tố -Day. Vượt giới hạn sẽ nhận 429 kèm Retry-After tính bằng giây. Thiếu khóa hoặc khóa đã bị thu hồi sẽ nhận 401.
Endpoint
URL gốc: https://satoshidaily.net/api/public/v1
| GET /news?lang=ru&coin=&min_importance=&limit=&cursor= | Tin đã xuất bản: tóm tắt, “điều này có nghĩa gì”, link tới nguồn gốc |
| GET /news/{id}?lang= | Một tin |
| GET /market | Vốn hóa, khối lượng, tỷ lệ thống trị, chỉ số sợ hãi và tham lam, top 100, coin tăng/giảm mạnh nhất |
| GET /coins/{id}?days=7&lang= | Thông tin coin, lịch sử giá, tin liên quan |
| GET /derivatives | Funding rate, hợp đồng mở, thanh lý theo từng coin |
| GET /derivatives/{coin}?hours=24 | Một coin trên từng sàn, kèm lịch sử |
| GET /events?from=&to=&type=&coin=&lang= | Lịch sự kiện (chỉ sự kiện đã xuất bản) |
| GET /events/{id}?lang= | Một sự kiện |
| GET /screener?preset=&mcap_min=&…&sort=&page= | Bộ lọc top 1000: lọc, sắp xếp, phân trang |
| GET /screener/meta | Danh mục, mạng, bộ lọc mẫu, độ mới của dữ liệu |
| GET /widget/ticker · /widget/coins/{id} · /widget/news · /widget/fear-greed | Dữ liệu cho widget, không cần khóa (giới hạn theo Origin) |
Ví dụ
curl -s -H "X-API-Key: $SD_API_KEY" "https://satoshidaily.net/api/public/v1/news?lang=vi&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=vi" 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=vi"
Widget không cần khóa
Để hiển thị giá, thẻ coin, dòng tin hoặc chỉ số sợ hãi và tham lam trên trang của bạn, hãy dùng widget có sẵn. Không cần khóa, giới hạn tính theo Origin. Trình tạo widget →