تحلیل داده‌های بازار ارز دیجیتال با HTX API و GPT-4o

تحلیل داده‌های بازار ارز دیجیتال با HTX API، GPT-4o و تلگرام

این گردش کار از HTX API، GPT-4o و تلگرام برای ارائه داده‌های بازار ارز دیجیتال به صورت بلادرنگ و ساختاریافته مستقیماً به چت شما استفاده می‌کند. این گردش کار به دستورات گوش می‌دهد، داده‌های جامع بازار را از HTX دریافت می‌کند، آن را با استفاده از GPT-4o پردازش می‌کند و یک گزارش HTML تمیز و خوانا را از طریق تلگرام ارسال می‌کند.

این گردش کار و موارد دیگر را در کاتالوگ n8n در Axeto.ai کاوش کنید.

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

گردش کار به طور منطقی به چهار بلوک اصلی تقسیم می‌شود:

1. دریافت ورودی و احراز هویت: پیام‌های ورودی تلگرام را مدیریت می‌کند، کاربران مجاز را تأیید می‌کند و فراداده جلسه را آماده می‌کند.

2. ایجنت دریافت داده‌های بازار: فراخوانی به نقاط پایانی مختلف HTX API را برای بازیابی داده‌های خام بازار هماهنگ می‌کند.

3. پردازش و استدلال هوش مصنوعی: از GPT-4o و ابزارهای کمکی هوش مصنوعی برای تفسیر، قالب‌بندی و تولید گزارش نهایی استفاده می‌کند.

4. مدیریت و تحویل پیام: گزارش را برای تلگرام قالب‌بندی می‌کند و آن را به کاربر بازمی‌گرداند، و محدودیت‌های احتمالی طول پیام را مدیریت می‌کند.

---

تحلیل دقیق بلوک‌ها

۱. دریافت ورودی و احراز هویت

این بلوک تضمین می‌کند که فقط کاربران مجاز می‌توانند با گردش کار تعامل داشته باشند و اطلاعات لازم جلسه را آماده می‌کند.

نودها:

• Telegram Trigger: با استفاده از یک ربات تلگرام پیکربندی شده، به پیام‌های ورودی گوش می‌دهد.

* Type: telegramTrigger

* نقش: گردش کار را هنگام دریافت پیام جدید آغاز می‌کند.

* پیکربندی: به یک اعتبارنامه ربات تلگرام نیاز دارد.

* خروجی: داده‌های خام پیام از تلگرام.

• User Authentication (Replace Telegram ID): یک نود کد که بررسی می‌کند آیا شناسه تلگرام فرستنده با شناسه مجاز از پیش تعریف شده مطابقت دارد یا خیر.

* Type: code

* نقش: پیام‌ها را فیلتر می‌کند و فقط به کاربران مجاز اجازه ادامه می‌دهد.

* پیکربندی: جایگزین <<Replace>> را با شناسه کاربری تلگرام واقعی جایگزین کنید. عبارت جاوا اسکریپت این است: $input.first().json.message.from.id !== <<Replace>>.

* خروجی: در صورت مجاز بودن، داده‌ها را عبور می‌دهد؛ در غیر این صورت، آن را به عنوان غیرمجاز علامت‌گذاری می‌کند.

• Set Session Metadata: یک نود Set برای افزودن جزئیات ضروری جلسه.

* Type: set

* نقش: sessionId (شناسه چت تلگرام) و message (محتوای متنی پیام تلگرام) را برای استفاده بعدی اضافه می‌کند.

* پیکربندی: از عبارات استفاده می‌کند:

* sessionId = $json.message.chat.id

* message = $json.message.text

* خروجی: داده‌های غنی شده شامل شناسه جلسه و متن پیام.

---

۲. ایجنت دریافت داده‌های بازار

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

نودها:

• HTX AI Agent: ایجنت LangChain اصلی مسئول تصمیم‌گیری در مورد استفاده از کدام ابزارهای HTX API بر اساس درخواست کاربر.

* Type: @n8n/n8n-nodes-langchain.agent

* نقش: فراخوانی‌های API و بازیابی داده‌ها را هماهنگ می‌کند.

* پیکربندی:

* Model: gpt-4.1-mini (نیاز به اعتبارنامه OpenAI API دارد).

* System Message: پیکربندی شده برای دستور دادن به ایجنت که فقط داده‌های بازار را دریافت کند، بدون انجام تجزیه و تحلیل یا پیش‌بینی.

* ورودی: متن پیام کاربر.

* خروجی: داده‌های ساختاریافته دریافت شده از HTX API.

• HTX API Tools (HTTP Request Nodes): این نودها فراخوانی‌های فردی به HTX REST API را نشان می‌دهند.

* 24h Stats: آمار بازار غلتان ۲۴ ساعته را دریافت می‌کند.

* Type: httpRequestTool

* Endpoint: /market/detail

* Parameters: symbol (به صورت پویا تنظیم شده).

* Order Book Depth: دفتر سفارش (خرید و فروش) را با عمق و تجمیع مشخص بازیابی می‌کند.

* Type: httpRequestTool

* Endpoint: /market/depth

* Parameters: symbol, type (مرحله تجمیع), depth.

* Price (Latest): آخرین قیمت معامله و بهترین قیمت خرید/فروش را دریافت می‌کند.

* Type: httpRequestTool

* Endpoint: /market/detail/merged

* Parameters: symbol.

* Best Bid/Ask: بهترین قیمت‌های خرید و فروش را بازیابی می‌کند.

* Type: httpRequestTool

* Endpoint: /market/detail/merged

* Parameters: symbol.

* Klines (Candles): داده‌های شمعی (OHLCV) را برای یک دوره و اندازه مشخص دریافت می‌کند.

* Type: httpRequestTool

* Endpoint: /market/history/kline

* Parameters: symbol, period (مثلاً '1min', '1day'), size.

* Average Price: داده‌های تیکر ادغام شده را دریافت می‌کند، که اغلب در کنار Calculator برای معیارهای مشتق شده استفاده می‌شود.

* Type: httpRequestTool

* Endpoint: /market/detail/merged

* Parameters: symbol.

* Recent Trades: لیستی از آخرین معاملات را بازیابی می‌کند.

* Type: httpRequestTool

* Endpoint: /market/history/trade

* Parameters: symbol, size.

• AI Processing Tools: این نودها به ایجنت هوش مصنوعی در پردازش و استدلال کمک می‌کنند.

* Calculator: عملیات ریاضی مورد نیاز برای تجزیه و تحلیل را انجام می‌دهد (مثلاً محاسبه تفاوت قیمت یا اسپرد).

* Type: @n8n/n8n-nodes-langchain.toolCalculator

* نقش: محاسبات ریاضی را بر اساس داده‌های ارائه شده توسط ایجنت اجرا می‌کند.

* Think: یک ابزار استدلال عمومی که برای دستکاری داده‌های میانی، پاکسازی و قالب‌بندی قبل از تولید گزارش نهایی استفاده می‌شود.

* Type: @n8n/n8n-nodes-langchain.toolThink

* نقش: ساختارهای داده را پردازش و اصلاح می‌کند.

* Simple Memory: تاریخچه مکالمه و وضعیت را برای حفظ زمینه در طول چندین نوبت ذخیره می‌کند.

* Type: @n8n/n8n-nodes-langchain.memoryBufferWindow

* نقش: آگاهی از زمینه را برای ایجنت هوش مصنوعی فعال می‌کند.

---

۳. پردازش و استدلال هوش مصنوعی

این بلوک بر استفاده از GPT-4o-mini برای تفسیر داده‌های بازار دریافت شده و تولید یک گزارش کاربرپسند تمرکز دارد.

نودها:

• OpenAI Chat Model: نود اصلی LLM برای تولید گزارش نهایی.

* Type: @n8n/n8n-nodes-langchain.lmChatOpenAi

* نقش: داده‌های خام و دستورالعمل‌ها را دریافت می‌کند، سپس آن را به یک گزارش HTML قابل خواندن مناسب برای تلگرام قالب‌بندی می‌کند.

* پیکربندی: مدل روی gpt-4.1-mini تنظیم شده است.

* ورودی: داده‌های پردازش شده از ایجنت هوش مصنوعی و ابزارهای دیگر.

* خروجی: متن گزارش قالب‌بندی شده.

• Calculator: (همانطور که در بخش ۲ توضیح داده شد) در اینجا برای هرگونه محاسبات نهایی مورد نیاز برای گزارش استفاده می‌شود.
• Think: (همانطور که در بخش ۲ توضیح داده شد) برای ساختاردهی و قالب‌بندی نهایی داده‌ها قبل از خروجی استفاده می‌شود.

---

۴. مدیریت و تحویل پیام

این بلوک نهایی تضمین می‌کند که گزارش تولید شده به درستی قالب‌بندی شده و از طریق تلگرام به کاربر ارسال می‌شود.

نودها:

• Split Message (if > 4000 chars): یک نود کد برای مدیریت محدودیت طول پیام تلگرام.

* Type: code

* نقش: گزارش گزارش شده توسط هوش مصنوعی را در صورت تجاوز از ۴۰۰۰ کاراکتر به بخش‌های کوچکتر تقسیم می‌کند.

* پیکربندی: رشته ورودی ($json.output) را به بخش‌هایی با طول حداکثر ۴۰۰۰ کاراکتر تقسیم می‌کند.

* ورودی: متن کامل گزارش از بلوک پردازش هوش مصنوعی.

* خروجی: یک یا چند بخش پیام.

• Telegram: پیام(های) نهایی را به کاربر ارسال می‌کند.

* Type: telegram (نود ارسال پیام)

* نقش: گزارش HTML قالب‌بندی شده (یا بخش‌های آن) را به چت تلگرام مبدأ منتقل می‌کند.

* پیکربندی: از اعتبارنامه ربات تلگرام و chatId از تریگر اولیه استفاده می‌کند.

* ورودی: بخش(های) پیام از نود تقسیم کننده.

* خروجی: تأیید تحویل پیام.

---

جدول خلاصه