{"id":51880456,"url":"https://github.com/nirholas/cryptocurrency.cv","last_synced_at":"2026-07-25T12:04:00.715Z","repository":{"id":331475869,"uuid":"1126779651","full_name":"nirholas/cryptocurrency.cv","owner":"nirholas","description":"Free crypto news API - real-time aggregator for Bitcoin, Ethereum, DeFi, Solana \u0026 altcoins. No API key required. RSS/Atom feeds, JSON REST API, historical archive with market context, embeddable widgets, ChatGPT plugin, Claude MCP server, SDKs (Python, TypeScript, Go, React, PHP). AI/LLM ready. Vibe coding friendly. Open source.","archived":false,"fork":false,"pushed_at":"2026-07-19T20:44:48.000Z","size":282599,"stargazers_count":263,"open_issues_count":15,"forks_count":39,"subscribers_count":2,"default_branch":"main","last_synced_at":"2026-07-19T22:21:52.665Z","etag":null,"topics":["ai-agent","api","bitcoin","chatgpt","claude","crypto","cryptocurrency","defi","ethereum","free-api","javascript","langchain","mcp","molt","moltbot","news","nextjs","python","trading-bot","web3"],"latest_commit_sha":null,"homepage":"https://cryptocurrency.cv","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/nirholas.png","metadata":{"files":{"readme":"README.ar.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":"CITATION.cff","codeowners":".github/CODEOWNERS","security":"SECURITY.md","support":"SUPPORT.md","governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null},"funding":{"github":"nirholas"}},"created_at":"2026-01-02T15:06:43.000Z","updated_at":"2026-07-19T21:15:06.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/nirholas/cryptocurrency.cv","commit_stats":null,"previous_names":["nirholas/free-crypto-news","nirholas/cryptocurrency.cv"],"tags_count":0,"template":true,"template_full_name":null,"purl":"pkg:github/nirholas/cryptocurrency.cv","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nirholas%2Fcryptocurrency.cv","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nirholas%2Fcryptocurrency.cv/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nirholas%2Fcryptocurrency.cv/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nirholas%2Fcryptocurrency.cv/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/nirholas","download_url":"https://codeload.github.com/nirholas/cryptocurrency.cv/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nirholas%2Fcryptocurrency.cv/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":35878267,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-07-20T02:08:10.276Z","status":"online","status_checked_at":"2026-07-25T02:00:06.922Z","response_time":64,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai-agent","api","bitcoin","chatgpt","claude","crypto","cryptocurrency","defi","ethereum","free-api","javascript","langchain","mcp","molt","moltbot","news","nextjs","python","trading-bot","web3"],"created_at":"2026-07-25T12:03:59.650Z","updated_at":"2026-07-25T12:04:00.708Z","avatar_url":"https://github.com/nirholas.png","language":"TypeScript","funding_links":["https://github.com/sponsors/nirholas"],"categories":[],"sub_categories":[],"readme":"🌐 **اللغة:** [English](README.md) | [Español](README.es.md) | [Français](README.fr.md) | [Deutsch](README.de.md) | [Português](README.pt.md) | [日本語](README.ja.md) | [简体中文](README.zh-CN.md) | [繁體中文](README.zh-TW.md) | [한국어](README.ko.md) | [العربية](README.ar.md) | [Русский](README.ru.md) | [Italiano](README.it.md) | [Nederlands](README.nl.md) | [Polski](README.pl.md) | [Türkçe](README.tr.md) | [Tiếng Việt](README.vi.md) | [ไทย](README.th.md) | [Bahasa Indonesia](README.id.md)\n\n---\n\n\u003cdiv dir=\"rtl\"\u003e\n\n# 🆓 واجهة برمجة تطبيقات أخبار العملات المشفرة المجانية\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://github.com/nirholas/free-crypto-news/stargazers\"\u003e\u003cimg src=\"https://img.shields.io/github/stars/nirholas/free-crypto-news?style=for-the-badge\u0026logo=github\u0026color=yellow\" alt=\"نجوم GitHub\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://github.com/nirholas/free-crypto-news/blob/main/LICENSE\"\u003e\u003cimg src=\"https://img.shields.io/github/license/nirholas/free-crypto-news?style=for-the-badge\u0026color=blue\" alt=\"الترخيص\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://github.com/nirholas/free-crypto-news/issues\"\u003e\u003cimg src=\"https://img.shields.io/github/issues/nirholas/free-crypto-news?style=for-the-badge\u0026color=orange\" alt=\"المشاكل\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://github.com/nirholas/free-crypto-news/pulls\"\u003e\u003cimg src=\"https://img.shields.io/github/issues-pr/nirholas/free-crypto-news?style=for-the-badge\u0026color=purple\" alt=\"طلبات السحب\"\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\".github/demo.svg\" alt=\"عرض Free Crypto News API\" width=\"700\"\u003e\n\u003c/p\u003e\n\n\u003e ⭐ **إذا وجدت هذا مفيدًا، يرجى إعطاء نجمة للمستودع!** هذا يساعد الآخرين على اكتشاف هذا المشروع ويحفز على التطوير المستمر.\n\n---\n\nاحصل على أخبار العملات المشفرة في الوقت الفعلي من 7 مصادر رئيسية باستدعاء API واحد.\n\n```bash\ncurl https://cryptocurrency.cv/api/news\n```\n\n---\n\n## المقارنة\n\n| | Free Crypto News | CryptoPanic | أخرى |\n|---|---|---|---|\n| **السعر** | 🆓 مجاني للأبد | $29-299/شهر | مدفوع |\n| **مفتاح API** | ❌ غير مطلوب | مطلوب | مطلوب |\n| **حد الطلبات** | غير محدود* | 100-1000/يوم | محدود |\n| **المصادر** | 12 إنجليزي + 12 دولي | 1 | متنوع |\n| **التدويل** | 🌏 كوري، صيني، ياباني، إسباني + ترجمة | لا | لا |\n| **استضافة ذاتية** | ✅ نشر بنقرة واحدة | لا | لا |\n| **PWA** | ✅ قابل للتثبيت | لا | لا |\n| **MCP** | ✅ Claude + ChatGPT | لا | لا |\n\n---\n\n## 🌿 الفروع\n\n| الفرع | الوصف |\n|--------|-------------|\n| `main` | فرع الإنتاج المستقر — التصميم الأصلي المركز على API |\n| `redesign/pro-news-ui` | إعادة تصميم واجهة المستخدم المتقدمة — أسلوب CoinDesk/CoinTelegraph مع الوضع الداكن والمكونات المحسنة وبيانات SEO المهيكلة ودعم PWA الكامل |\n\nلاختبار إعادة التصميم محليًا:\n```bash\ngit checkout redesign/pro-news-ui\nnpm install \u0026\u0026 npm run dev\n```\n\n---\n\n## 🌍 مصادر الأخبار الدولية\n\nاحصل على أخبار العملات المشفرة من **12 مصدرًا دوليًا** بالكورية والصينية واليابانية والإسبانية — مترجمة تلقائيًا للإنجليزية!\n\n### المصادر المدعومة\n\n| المنطقة | المصادر |\n|--------|---------|\n| 🇰🇷 **كوريا** | Block Media, TokenPost, CoinDesk Korea |\n| 🇨🇳 **الصين** | 8BTC (باييت), Jinse Finance (جينسي), Odaily (أوديلي) |\n| 🇯🇵 **اليابان** | CoinPost, CoinDesk Japan, Cointelegraph Japan |\n| 🇪🇸 **أمريكا اللاتينية** | Cointelegraph Español, Diario Bitcoin, CriptoNoticias |\n\n### أمثلة سريعة\n\n```bash\n# الحصول على جميع الأخبار الدولية\ncurl \"https://cryptocurrency.cv/api/news/international\"\n\n# الحصول على أخبار كورية مترجمة للإنجليزية\ncurl \"https://cryptocurrency.cv/api/news/international?language=ko\u0026translate=true\"\n\n# الحصول على أخبار منطقة آسيا\ncurl \"https://cryptocurrency.cv/api/news/international?region=asia\u0026limit=20\"\n```\n\n### الميزات\n\n- ✅ **ترجمة تلقائية** للإنجليزية عبر Groq AI\n- ✅ **تخزين مؤقت للترجمة 7 أيام** للكفاءة\n- ✅ الحفاظ على **النص الأصلي + الإنجليزي**\n- ✅ **تحديد المعدل** (1 طلب/ثانية) احترامًا للـ APIs\n- ✅ **تراجع سلس** للمصادر غير المتاحة\n- ✅ **إزالة التكرار** عبر المصادر\n\nراجع [وثائق API](docs/API.md#get-apinewsinternational) للتفاصيل الكاملة.\n\n---\n\n## 📱 تطبيق ويب تقدمي (PWA)\n\nFree Crypto News هو **PWA قابل للتثبيت بالكامل** يعمل دون اتصال.\n\n### الميزات\n\n| الميزة | الوصف |\n|---------|-------------|\n| 📲 **قابل للتثبيت** | أضف إلى الشاشة الرئيسية على أي جهاز |\n| 📴 **وضع دون اتصال** | اقرأ الأخبار المخزنة مؤقتًا بدون شبكة |\n| 🔔 **إشعارات الدفع** | تلقي تنبيهات الأخبار العاجلة |\n| ⚡ **سريع جدًا** | استراتيجيات تخزين مؤقت عدوانية |\n| 🔄 **مزامنة في الخلفية** | تحديث تلقائي عند العودة للاتصال |\n| 🎯 **اختصارات** | وصول سريع للأحدث والشائع وبيتكوين |\n| 📤 **مشاركة** | مشاركة الروابط مباشرة في التطبيق |\n| 🚨 **تنبيهات فورية** | تنبيهات قابلة للتكوين للسعر وشروط الأخبار |\n\n### تثبيت التطبيق\n\n**سطح المكتب (Chrome/Edge):**\n1. قم بزيارة [cryptocurrency.cv](https://cryptocurrency.cv)\n2. انقر على أيقونة التثبيت (⊕) في شريط URL\n3. انقر \"تثبيت\"\n\n**iOS Safari:**\n1. قم بزيارة الموقع في Safari\n2. اضغط على مشاركة (📤) → \"إضافة إلى الشاشة الرئيسية\"\n\n**Android Chrome:**\n1. قم بزيارة الموقع\n2. اضغط على لافتة التثبيت أو القائمة → \"تثبيت التطبيق\"\n\n### تخزين Service Worker المؤقت\n\nيستخدم PWA استراتيجيات تخزين ذكية:\n\n| المحتوى | الاستراتيجية | مدة التخزين |\n|---------|----------|----------------|\n| استجابات API | Network-first | 5 دقائق |\n| الأصول الثابتة | Cache-first | 7 أيام |\n| الصور | Cache-first | 30 يومًا |\n| التنقل | Network-first + احتياطي دون اتصال | 24 ساعة |\n\n### اختصارات لوحة المفاتيح\n\nتنقل سريع عبر الأخبار باستخدام لوحة المفاتيح:\n\n| الاختصار | الإجراء |\n|----------|--------|\n| `j` / `k` | المقال التالي / السابق |\n| `/` | تركيز البحث |\n| `Enter` | فتح المقال المحدد |\n| `d` | تبديل الوضع الداكن |\n| `g h` | الذهاب للرئيسية |\n| `g t` | الذهاب للشائع |\n| `g s` | الذهاب للمصادر |\n| `g b` | الذهاب للمفضلة |\n| `?` | عرض جميع الاختصارات |\n| `Escape` | إغلاق النافذة المنبثقة |\n\n📖 **دليل المستخدم الكامل:** [docs/USER-GUIDE.md](docs/USER-GUIDE.md)\n\n---\n\n## المصادر\n\nنجمع من **7 وسائل إعلام موثوقة**:\n\n- 🟠 **CoinDesk** — أخبار العملات المشفرة العامة\n- 🔵 **The Block** — المؤسسات والأبحاث\n- 🟢 **Decrypt** — Web3 والثقافة\n- 🟡 **CoinTelegraph** — أخبار العملات المشفرة العالمية\n- 🟤 **Bitcoin Magazine** — متطرفو البيتكوين\n- 🟣 **Blockworks** — DeFi والمؤسسات\n- 🔴 **The Defiant** — DeFi الأصلي\n\n---\n\n## نقاط النهاية\n\n| نقطة النهاية | الوصف |\n|----------|-------------|\n| `/api/news` | آخر الأخبار من جميع المصادر |\n| `/api/search?q=bitcoin` | البحث بكلمة مفتاحية |\n| `/api/defi` | أخبار متعلقة بـ DeFi |\n| `/api/bitcoin` | أخبار متعلقة بـ Bitcoin |\n| `/api/breaking` | آخر ساعتين فقط |\n| `/api/trending` | المواضيع الرائجة مع تحليل المشاعر |\n| `/api/analyze` | الأخبار مع تصنيف المواضيع |\n| `/api/stats` | التحليلات والإحصائيات |\n| `/api/sources` | قائمة جميع المصادر |\n| `/api/health` | حالة صحة API والخلاصات |\n| `/api/rss` | خلاصة RSS مجمعة |\n| `/api/atom` | خلاصة Atom مجمعة |\n| `/api/opml` | تصدير OPML لقارئات RSS |\n| `/api/docs` | وثائق API تفاعلية |\n| `/api/webhooks` | تسجيل webhooks |\n| `/api/archive` | أرشيف الأخبار التاريخية |\n| `/api/push` | إشعارات Web Push |\n| `/api/origins` | العثور على المصدر الأصلي للأخبار |\n| `/api/portfolio` | أخبار مبنية على المحفظة + الأسعار |\n| `/api/news/international` | مصادر دولية مع ترجمة |\n\n### 🤖 نقاط نهاية مدعومة بالذكاء الاصطناعي (مجاني عبر Groq)\n\n| نقطة النهاية | الوصف |\n|----------|-------------|\n| `/api/digest` | ملخص يومي مُنشأ بالذكاء الاصطناعي |\n| `/api/sentiment` | تحليل مشاعر السوق |\n| `/api/summarize?url=` | تلخيص أي URL |\n| `/api/ask` | اسأل الذكاء الاصطناعي عن أخبار العملات المشفرة |\n| `/api/entities` | استخراج الكيانات المذكورة |\n| `/api/claims` | التحقق من الادعاءات |\n| `/api/clickbait` | اكتشاف العناوين المضللة |\n\n### 💹 نقاط نهاية السوق\n\n| نقطة النهاية | الوصف |\n|----------|-------------|\n| `/api/fear-greed` | مؤشر الخوف والطمع مع بيانات تاريخية |\n| `/api/arbitrage` | فرص المراجحة عبر البورصات |\n| `/api/signals` | إشارات تداول تقنية |\n| `/api/funding` | معدلات التمويل عبر بورصات المشتقات |\n| `/api/options` | تدفق الخيارات وأقصى ألم |\n| `/api/liquidations` | بيانات التصفية في الوقت الفعلي |\n| `/api/whale-alerts` | تتبع صفقات الحيتان |\n| `/api/orderbook` | بيانات دفتر الطلبات المجمعة |\n\n---\n\n## البداية السريعة\n\n### استخدام cURL\n\n```bash\n# الحصول على آخر الأخبار\ncurl \"https://cryptocurrency.cv/api/news\"\n\n# البحث في الأخبار\ncurl \"https://cryptocurrency.cv/api/search?q=ethereum\"\n\n# الحصول على ملخص AI\ncurl \"https://cryptocurrency.cv/api/digest\"\n\n# الحصول على مؤشر الخوف والطمع\ncurl \"https://cryptocurrency.cv/api/fear-greed\"\n```\n\n### استخدام JavaScript\n\n```javascript\n// الحصول على آخر الأخبار\nconst response = await fetch('https://cryptocurrency.cv/api/news');\nconst data = await response.json();\n\nconsole.log(data.articles);\n// [{ title, link, source, pubDate, timeAgo, ... }, ...]\n```\n\n### استخدام Python\n\n```python\nimport requests\n\n# الحصول على آخر الأخبار\nresponse = requests.get('https://cryptocurrency.cv/api/news')\ndata = response.json()\n\nfor article in data['articles'][:5]:\n    print(f\"• {article['title']} ({article['source']})\")\n```\n\n---\n\n## الاستضافة الذاتية\n\n### نشر بنقرة واحدة\n\n[![انشر مع Vercel](https://vercel.com/button)](https://vercel.com/new/clone?repository-url=https://github.com/nirholas/free-crypto-news)\n[![انشر مع Railway](https://railway.app/button.svg)](https://railway.app/new/template?template=https://github.com/nirholas/free-crypto-news)\n\n### التثبيت المحلي\n\n```bash\n# استنساخ المستودع\ngit clone https://github.com/nirholas/free-crypto-news.git\ncd free-crypto-news\n\n# تثبيت التبعيات\nnpm install\n\n# تشغيل خادم التطوير\nnpm run dev\n\n# افتح http://localhost:3000\n```\n\n### متغيرات البيئة\n\n```env\n# اختياري: لميزات AI (مجاني من groq.com)\nGROQ_API_KEY=gsk_your_key_here\n\n# اختياري: التحليلات\nNEXT_PUBLIC_ANALYTICS_ID=your_id\n```\n\n---\n\n## الوثائق\n\n| الوثيقة | الوصف |\n|---|---|\n| [📚 مرجع API](docs/API.md) | وثائق نقاط النهاية الكاملة |\n| [🏗️ الهندسة](docs/ARCHITECTURE.md) | تصميم النظام |\n| [🚀 النشر](docs/DEPLOYMENT.md) | دليل الإنتاج |\n| [🧪 الاختبار](docs/TESTING.md) | دليل الاختبار |\n| [🔐 الأمان](docs/SECURITY.md) | سياسة الأمان |\n| [📖 دليل المستخدم](docs/USER-GUIDE.md) | دليل PWA والميزات |\n| [💻 دليل المطور](docs/DEVELOPER-GUIDE.md) | وثائق المساهمين |\n\n---\n\n## المساهمة\n\nالمساهمات مرحب بها! راجع [CONTRIBUTING.md](CONTRIBUTING.md) للإرشادات.\n\n```bash\n# Fork المستودع\n# إنشاء فرع الميزة\ngit checkout -b feature/amazing-feature\n\n# تنفيذ التغييرات\ngit commit -m 'Add amazing feature'\n\n# الدفع وإنشاء Pull Request\ngit push origin feature/amazing-feature\n```\n\n---\n\n## الترخيص\n\nMIT License - راجع ملف [LICENSE](LICENSE).\n\n---\n\n## التواصل\n\n- 🐛 **الأخطاء**: [GitHub Issues](https://github.com/nirholas/free-crypto-news/issues)\n- 💬 **النقاشات**: [GitHub Discussions](https://github.com/nirholas/free-crypto-news/discussions)\n- 🐦 **Twitter**: [@nirholas](https://twitter.com/nirholas)\n\n---\n\n\u003cp align=\"center\"\u003e\n  صُنع بـ ❤️ لمجتمع العملات المشفرة\n  \u003cbr\u003e\n  \u003ca href=\"https://cryptocurrency.cv\"\u003ecryptocurrency.cv\u003c/a\u003e\n\u003c/p\u003e\n\n\u003c/div\u003e\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnirholas%2Fcryptocurrency.cv","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnirholas%2Fcryptocurrency.cv","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnirholas%2Fcryptocurrency.cv/lists"}