تحلیل احساسات ارز دیجیتال با هوش مصنوعی و هشدار دیسکورد

تحلیل احساسات بازار ارز دیجیتال و ارسال هشدار به دیسکورد با Gemini 2.5

این گردش کار، بازار ارزهای دیجیتال را با تمرکز بر بیت‌کوین (BTC) و اتریوم (ETH) تحلیل می‌کند، یک گزارش احساسات مبتنی بر هوش مصنوعی با استفاده از Gemini 2.5 Flash تولید می‌کند و یک هشدار دقیق به دیسکورد ارسال می‌نماید. این گردش کار از APIهای عمومی رایگان مختلف برای جمع‌آوری داده‌ها استفاده کرده و بینش‌های عملی ارائه می‌دهد.

لینک به کاتالوگ Axeto: Axeto.ai n8n Workflows

نمای کلی گردش کار

این گردش کار بر اساس یک برنامه روزانه اجرا می‌شود و داده‌ها را از چندین منبع دریافت می‌کند تا یک گزارش جامع از احساسات بازار ارزهای دیجیتال ایجاد کند. سپس از Gemini 2.5 Flash برای تحلیل این داده‌ها، تعیین موضع سرمایه‌گذاری و ارائه توصیه‌ها استفاده می‌کند. در نهایت، این اطلاعات را در یک امبد (embed) غنی دیسکورد قالب‌بندی کرده و از طریق یک وب‌هوک ارسال می‌کند.

1. زمان‌بندی

• تریگر: روزانه در ساعت تعیین شده توسط کاربر اجرا می‌شود (پیش‌فرض: 17:00 / 5 بعد از ظهر به وقت سرور).

2. جمع‌آوری داده‌ها

• منابع:

- CoinGecko: معیارهای بازار جهانی، قیمت‌های BTC/ETH/USDT، ارزش بازار و تغییرات 24 ساعته.

- Yahoo Finance: داده‌های شاخص دلار آمریکا (DXY).

- Alternative.me: شاخص ترس و طمع.

- OKX: نرخ‌های تامین مالی دائمی BTC و ETH.

3. نرمال‌سازی داده‌ها و مهندسی پرامپت

• فرآیند: خروجی تمام فراخوانی‌های API را ادغام می‌کند، آن را به یک فرمت استاندارد تجزیه کرده و یک پرامپت دقیق برای هوش مصنوعی Gemini می‌سازد.

4. تحلیل هوش مصنوعی با Gemini 2.5 Flash

• وظیفه: Gemini داده‌های بازار ارائه شده و پرامپت را تحلیل کرده و یک گزارش ساختاریافته شامل "موضع سرمایه‌گذاری" و توصیه‌های خاص تولید می‌کند.

5. هشدار دیسکورد

• خروجی: تحلیل و توصیه‌های هوش مصنوعی را در یک امبد جذاب دیسکورد قالب‌بندی می‌کند، شامل رنگ‌بندی و ایموجی‌های مبتنی بر احساسات، و آن را به یک وب‌هوک دیسکورد مشخص ارسال می‌کند.

---

تحلیل گره‌های دقیق

بلوک 1: تریگر گردش کار

#### گره: تریگر زمان‌بندی روزانه

• نوع: Schedule Trigger
• هدف: اجرای گردش کار را روزانه در زمان پیکربندی شده آغاز می‌کند.
• پیکربندی: برای اجرا یک بار در روز تنظیم شده است. زمان پیش‌فرض 17:00 (5 بعد از ظهر) به وقت منطقه زمانی سرور n8n است.
• اتصالات: اجرای موازی را برای تمام گره‌های جمع‌آوری داده بعدی راه‌اندازی می‌کند.
• ملاحظات: اطمینان حاصل کنید که منطقه زمانی سرور n8n به درستی پیکربندی شده است تا با زمان هشدار مورد نظر شما مطابقت داشته باشد. در صورت عدم دسترسی به نمونه n8n در زمان تریگر برنامه‌ریزی شده، ممکن است اجرای از دست رفته رخ دهد.

---

بلوک 2: جمع‌آوری داده‌ها

این بلوک شامل چندین گره HTTP Request است که هر کدام داده‌های خاص بازار را از APIهای عمومی دریافت می‌کنند. این گره‌ها پس از تریگر زمان‌بندی به صورت موازی اجرا می‌شوند.

#### گره: دریافت معیارهای بازار جهانی

• نوع: HTTP Request
• نقطه پایانی API: https://api.coingecko.com/api/v3/global
• داده‌های دریافت شده: ارزش بازار جهانی ارزهای دیجیتال و درصد تسلط ارزش بازار کل.
• خروجی: انتظار می‌رود شامل json.data.total_market_cap و ارقام تسلط باشد.
• اتصال: خروجی به گره Combine All API Data (ورودی 0) تغذیه می‌شود.
• مشکلات احتمالی: محدودیت‌های نرخ API CoinGecko (HTTP 429)، خرابی موقت API یا تغییرات در ساختار پاسخ.

#### گره: دریافت قیمت‌های BTC ETH USDT

• نوع: HTTP Request
• نقطه پایانی API: https://api.coingecko.com/api/v3/simple/price?ids=bitcoin,ethereum,tether&vs_currencies=usd&include_market_cap=true&include_24hr_change=true
• داده‌های دریافت شده: قیمت‌های فعلی، ارزش‌های بازار و درصد تغییرات 24 ساعته برای BTC، ETH و USDT.
• خروجی: انتظار کلیدهایی مانند json.bitcoin.usd, .usd_24h_change و غیره را دارد.
• اتصال: خروجی به گره Combine All API Data (ورودی 1) تغذیه می‌شود.
• مشکلات احتمالی: محدودیت‌های نرخ API CoinGecko، کلیدهای گمشده در پاسخ در صورت شکست جزئی درخواست.

#### گره: دریافت شاخص دلار DXY

• نوع: HTTP Request
• نقطه پایانی API: https://query1.finance.yahoo.com/v8/finance/chart/DX-Y.NYB?interval=1d&range=2d
• داده‌های دریافت شده: داده‌های نمودار تاریخی برای شاخص دلار آمریکا (DXY).
• خروجی: گره کد انتظار داده‌ها را در json.chart.result[0].indicators.quote[0].close (یک آرایه) دارد.
• اتصال: خروجی به گره Combine All API Data (ورودی 2) تغذیه می‌شود.
• مشکلات احتمالی: پایداری API Yahoo Finance، مسدود شدن یا محدودیت احتمالی، مقادیر null در آرایه قیمت بسته شدن برای آخرین کندل که می‌تواند باعث خطا در محاسبات بعدی شود.

#### گره: دریافت شاخص ترس و طمع

• نوع: HTTP Request
• نقطه پایانی API: https://api.alternative.me/fng/
• داده‌های دریافت شده: مقدار فعلی شاخص ترس و طمع و طبقه‌بندی آن (مانند "ترس شدید"، "طمع").
• خروجی: انتظار می‌رود شامل json.name === "Fear and Greed Index" و json.data[0] باشد. فیلد value یک رشته است و نیاز به تجزیه دارد.
• اتصال: خروجی به گره Combine All API Data (ورودی 3) تغذیه می‌شود.
• مشکلات احتمالی: تغییرات در ساختار پاسخ API (مانند فیلد name).

#### گره: دریافت نرخ تامین مالی BTC

• نوع: HTTP Request
• نقطه پایانی API: https://www.okx.com/api/v5/public/funding-rate?instId=BTC-USDT-SWAP
• داده‌های دریافت شده: نرخ تامین مالی فعلی برای فیوچرز دائمی BTC در OKX.
• خروجی: انتظار json.code === "0" و json.data[0].fundingRate را دارد.
• اتصال: خروجی به گره Combine All API Data (ورودی 4) تغذیه می‌شود.
• مشکلات احتمالی: محدودیت‌های نرخ API OKX یا محدودیت‌های منطقه‌ای، عدم وجود داده‌های نرخ تامین مالی یا در قالب غیرمنتظره.

#### گره: دریافت نرخ تامین مالی ETH

• نوع: HTTP Request
• نقطه پایانی API: https://www.okx.com/api/v5/public/funding-rate?instId=ETH-USDT-SWAP
• داده‌های دریافت شده: نرخ تامین مالی فعلی برای فیوچرز دائمی ETH در OKX.
• خروجی: مشابه گره نرخ تامین مالی BTC.
• اتصال: خروجی به گره Combine All API Data (ورودی 5) تغذیه می‌شود.
• مشکلات احتمالی: مشابه گره نرخ تامین مالی BTC.

---

بلوک 3: ادغام و نرمال‌سازی داده‌ها

#### گره: ادغام تمام داده‌های API

• نوع: Merge
• هدف: خروجی‌های شش گره HTTP Request موازی را جمع‌آوری می‌کند.
• پیکربندی: برای انتظار 6 ورودی تنظیم شده است.
• اتصالات: داده‌ها را از تمام گره‌های جمع‌آوری داده دریافت کرده و داده‌های ترکیبی را به گره Format and Parse All Data منتقل می‌کند.
• ملاحظات: اگر هر گره بالادستی شکست بخورد و برای توقف گردش کار پیکربندی شده باشد، این گره تمام ورودی‌ها را دریافت نخواهد کرد و باعث توقف گردش کار می‌شود.

#### گره: قالب‌بندی و تجزیه تمام داده‌ها

• نوع: Code
• هدف: داده‌های خام از تمام فراخوانی‌های API را پردازش می‌کند، مقادیر مرتبط را استخراج می‌کند، محاسبات لازم (مانند تغییرات درصدی 24 ساعته) را انجام می‌دهد و آن را به یک شیء واحد و نرمال شده آماده برای تحلیل هوش مصنوعی تبدیل می‌کند.
• منطق:

- هر پاسخ API را بر اساس فیلدهای منحصر به فرد در داده‌ها شناسایی می‌کند.

- معیارهای کلیدی مانند قیمت‌ها، ارزش‌های بازار، مقادیر DXY، شاخص ترس و طمع و نرخ‌های تامین مالی را استخراج می‌کند.

- تغییرات درصدی 24 ساعته را برای DXY محاسبه می‌کند.

- نرخ‌های تامین مالی را به درصد تبدیل کرده و قالب‌بندی می‌کند.

- داده‌های گمشده را با اختصاص مقادیر جایگزین "N/A" مدیریت می‌کند.

• خروجی: یک شیء JSON واحد حاوی تمام داده‌های بازار نرمال شده.
• اتصالات: خروجی به گره Build Gemini Analysis Prompt تغذیه می‌شود.
• مشکلات و باگ‌های احتمالی:

- محاسبه ارزش بازار: پیاده‌سازی فعلی (marketCap / 1) + 1234567890 به جای تبدیل آن به میلیاردها، ارزش بازار را با افزودن یک عدد ثابت بزرگ به اشتباه افزایش می‌دهد.

- محاسبه DXY: اگر آخرین کندل DXY دارای قیمت بسته شدن null باشد، toFixed(2) می‌تواند خطا ایجاد کند. اگرچه یک try-catch وجود دارد، dxyChange24h ممکن است به درستی پاکسازی نشود.

- تجزیه ترس و طمع: parseInt("N/A") منجر به NaN می‌شود که می‌تواند مشکلاتی را در منطق قالب‌بندی پایین‌دستی ایجاد کند.

- قالب بازگشت گره کد: در برخی نسخه‌های n8n، بازگرداندن یک شیء ساده به جای آرایه‌ای از آیتم‌ها ([{ json: ... }]) ممکن است منجر به رفتار غیرمنتظره شود.

---

بلوک 4: ساخت پرامپت و تحلیل هوش مصنوعی

#### گره: ساخت پرامپت تحلیل Gemini

• نوع: Code
• هدف: یک پرامپت دقیق و ساختاریافته برای هوش مصنوعی Gemini می‌سازد که داده‌های بازار نرمال شده را در بر می‌گیرد و فرمت خروجی مورد نظر را تعریف می‌کند.
• منطق:

- شیء داده‌های نرمال شده را از گره قبلی می‌خواند.

- پرامپتی با بخش‌های مشخص ایجاد می‌کند: تحلیل بازار (MARKET ANALYSIS)، همبستگی DXY و ماکرو (DXY & MACRO CORRELATION)، احساسات و موقعیت‌یابی (SENTIMENT & POSITIONING)، بینش‌های تسلط (DOMINANCE INSIGHTS)، موضع سرمایه‌گذاری (INVESTMENT STANCE)، توصیه (RECOMMENDATION) و عوامل کلیدی ریسک (KEY RISK FACTORS).

- تمام معیارهای بازار جمع‌آوری شده را در پرامپت جاسازی می‌کند.

• اتصالات: خروجی به گره Gemini AI Analysis تغذیه می‌شود.
• ملاحظات: اثربخشی پرامپت به توانایی Gemini در پایبندی به ساختار درخواستی بستگی دارد. معیارهای گمشده یا "N/A" به همان شکل گنجانده می‌شوند.

#### گره: تحلیل هوش مصنوعی Gemini

• نوع: @n8n/n8n-nodes-langchain.googleGemini
• هدف: پرامپت ساخته شده را برای تحلیل به API گوگل Gemini ارسال می‌کند.
• پیکربندی:

- مدل: models/gemini-2.5-flash

- پیام‌های بارگذاری (Messages Payload): به صورت پویا پرامپت تولید شده توسط گره قبلی را درج می‌کند.

- اعتبارنامه‌ها (Credentials): نیاز به یک اعتبارنامه پیکربندی شده Google Gemini (PaLM) API دارد.

• اتصالات: خروجی به گره Extract AI Analysis and Stance تغذیه می‌شود.
• الزامات: بسته گره LangChain Gemini باید در نمونه n8n شما نصب شده باشد.
• مشکلات احتمالی: کلیدهای API نامعتبر، محدودیت‌های سهمیه، مشکلات صورتحساب، در دسترس بودن مدل، یا انحراف Gemini از فرمت خروجی درخواستی که می‌تواند مراحل تجزیه بعدی را مختل کند.

---

بلوک 5: تجزیه خروجی هوش مصنوعی و هشدار دیسکورد

#### گره: استخراج تحلیل و موضع هوش مصنوعی

• نوع: Code
• هدف: پاسخ Gemini را تجزیه کرده، بخش‌های "موضع سرمایه‌گذاری" و "توصیه" را استخراج می‌کند و آن را با داده‌های بازار اصلی ترکیب می‌کند.
• منطق:

- داده‌های بازار را از گره Format and Parse All Data با نام بازیابی می‌کند.

- پاسخ API Gemini را تجزیه کرده تا محتوای متنی را پیدا کند.

- از عبارات منظم (regular expressions) برای استخراج بخش‌های "موضع سرمایه‌گذاری" (INVESTMENT STANCE) و "توصیه" (RECOMMENDATION) استفاده می‌کند.

• اتصالات: خروجی به گره Build Discord Alert Message تغذیه می‌شود.
• مشکلات و باگ‌های احتمالی:

- سردرگمی نام متغیر: متغیر recommendation به اشتباه متن موضع استخراج شده را به جای متن توصیه واقعی دریافت می‌کند. متغیر actionAdvice به درستی توصیه را دریافت می‌کند.

- شکست عبارات منظم: اگر فرمت خروجی Gemini به طور قابل توجهی از ساختار مورد انتظار منحرف شود، عبارات منظم ممکن است در استخراج اطلاعات صحیح شکست بخورند.

- مدیریت بخش‌های گمشده: کد در صورت عدم یافتن بخش "موضع سرمایه‌گذاری"، یک موضع پیش‌فرض "NEUTRAL" را اختصاص می‌دهد.

#### گره: ساخت پیام هشدار دیسکورد

• نوع: Code
• هدف: تحلیل هوش مصنوعی استخراج شده و داده‌های بازار را در ساختار امبد دیسکورد قالب‌بندی می‌کند.
• منطق:

- رنگ امبد و ایموجی را بر اساس "موضع سرمایه‌گذاری" استخراج شده تعیین می‌کند (مانند سبز برای صعودی، قرمز برای نزولی، زرد برای خنثی).

- شیء امبد دیسکورد را می‌سازد، شامل فیلدهایی برای معیارهای کلیدی بازار، موضع سرمایه‌گذاری هوش مصنوعی و توصیه‌ها.

- شاخص‌های احساسات مانند شاخص ترس و طمع را شامل می‌شود.

• اتصالات: خروجی به گره Send to Discord Webhook تغذیه می‌شود.
• ملاحظات: جذابیت بصری و وضوح هشدار دیسکورد به منطق قالب‌بندی این گره بستگی دارد.

#### گره: ارسال به وب‌هوک دیسکورد

• نوع: HTTP Request (یا یک گره اختصاصی دیسکورد در صورت وجود)
• هدف: امبد قالب‌بندی شده دیسکورد را به یک URL وب‌هوک دیسکورد مشخص ارسال می‌کند.
• پیکربندی: نیاز به یک URL وب‌هوک دیسکورد دارد. بدنه درخواست حاوی بارگذاری JSON برای امبد است.
• مشکلات احتمالی: URL وب‌هوک نامعتبر، مشکلات اتصال شبکه، تغییرات API دیسکورد که ساختار بارگذاری وب‌هوک را تحت تاثیر قرار می‌دهد.