واجهة API للشركاء
واجهة JSON API للقراءة فقط: ملخصاتنا الإخبارية مع روابط المصادر الأصلية، وبيانات السوق، والمشتقات، وتقويم الأحداث، وأداة فرز العملات. البيانات المنشورة فقط.
المرجع الكامل (OpenAPI 3.1)تنزيل openapi.yaml
الترخيص والإسناد
- يجب عرض «Satoshi Daily» مع رابط إلى الموقع بجوار البيانات. تتضمن كل استجابة كائن attribution وترويسة X-Attribution.
- الأخبار ملخصات من إعدادنا، أما المقالات الأصلية فملك لناشريها: اعرض الروابط الواردة في sources[] ولا تقدّم الملخص على أنه نص الناشر.
- بيانات السوق مصدرها CoinGecko وGeckoTerminal وواجهات 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=ar&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=ar" 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=ar"
ودجات بلا مفتاح
لعرض الأسعار أو بطاقة عملة أو شريط الأخبار أو مؤشر الخوف والطمع على موقعك، استخدم الودجات الجاهزة. لا تحتاج إلى مفتاح، والحد يُحسب حسب Origin. منشئ الودجات →