نوبیتکس در انجیر؛ قیمت و آمار بازار با واحد مشخص

شروع

در سازنده، برنامه را با «نوبیتکس»، nobitex یا «هشدار قیمت» پیدا کنید. اکشن موردنظر را انتخاب کنید، رمزارز و واحد قیمت را تعیین کنید و آزمایش بگیرید. در این نسخه مرحله اتصال حساب وجود ندارد.

رمزارز فقط نماد پایه است: BTC، ETH یا USDT؛ نام‌های رایج مثل بیت کوین، اتریوم و تتر هم پذیرفته می‌شوند. پسوند IRT یا USDT را به نماد اضافه نکنید. برای بازار BTC در برابر تتر، رمزارز BTC و واحد تتر را انتخاب کنید.

دریافت آمار بازار

آخرین قیمت (latest)، بهترین خرید و فروش (bestBuy و bestSell)، کمینه و بیشینه روز (dayLow و dayHigh)، باز و بسته‌شدن روز (dayOpen و dayClose)، درصد تغییر (dayChangePercent) و حجم (volumeAsset و volumeQuote) برمی‌گردند.

تمام قیمت‌ها و حجم برحسب ارز مقصد، با واحد انتخابی هستند. حجم خود رمزارز تبدیل نمی‌شود و درصد تغییر هم همان درصد است. isClosed وضعیت بسته‌بودن بازار را نشان می‌دهد. برای گزارش روزانه می‌توانید این اکشن را بعد از تریگر زمان‌بندی قرار دهید.

دریافت دفتر سفارش

تعداد ردیف هر سمت را بین ۱ و ۲۴ بگذارید. خروجی bids سفارش‌های خرید و asks سفارش‌های فروش است؛ هر ردیف price و amount دارد. مقدار رمزارز تبدیل نمی‌شود. price در سطح اصلی، قیمت آخرین معامله است.

updatedAt زمان به‌روزرسانی اعلام‌شده توسط بازار است. observedAt زمان خواندن توسط انجیر است. تفاوت این دو برای تشخیص داده قدیمی مفید است.

دریافت معاملات اخیر بازار

حداکثر ۲۰ معامله عمومی اخیر با time، price، amount و side برمی‌گردند. این فهرست تاریخچه معاملات شخصی شما نیست. خروجی محدود به موارد اخیر API است و آرشیو کامل بازار محسوب نمی‌شود.

عبور قیمت از آستانه

رمزارز، واحد، جهت و قیمت آستانه را تعیین کنید. تریگر آخرین قیمت معامله را دوره‌ای می‌خواند و عبور مشاهده‌شده را یک بار برمی‌گرداند. بعد از بازگشت قیمت به سمت دیگر، برای عبور بعدی آماده می‌شود. هنگام فعال‌شدن، قیمت فعلی مبنا می‌شود؛ عبور کوتاه بین بررسی‌ها ممکن است دیده نشود.

آزمایش، قیمت واقعی فعلی را فوری برمی‌گرداند و علامت isTest: true دارد. منتظر عبور نمی‌ماند و سابقه پایش را تغییر نمی‌دهد.

برای ساخت مسیر دلخواه، تریگر «عبور قیمت از آستانه» را به مرحله ارسال پیام وصل کنید. پیش از انتشار، واحد آستانه و چت مقصد را بررسی کنید.

قیمت‌ها و واحدها

با واحد تومان، قیمت خام ریالی دقیقاً بر ده تقسیم می‌شود؛ ریال همان داده اصلی است. با واحد تتر، بازار جداگانه تتری خوانده می‌شود. واحد تتر برای رمزارز USDT معتبر نیست.

قیمت‌ها به‌صورت متن عددی برمی‌گردند تا اعداد بزرگ و اعشار دقتشان را از دست ندهند. در دفتر سفارش و تریگر، rawPrice و rawUnit مقدار اصلی API را نشان می‌دهند. آستانه ارقام فارسی و عربی، اعشار و جداکننده هزارگان مثل ۱۰۰٬۰۰۰ را می‌پذیرد.

محدودیت درخواست و خطاها

اگر خطای محدودیت درخواست دیدید، کمی بعد دوباره آزمایش کنید. اگر خطا ادامه داشت، نام مرحله و زمان اجرا را به پشتیبانی انجیر بدهید. بررسی ظرفیت و محدودیت مشترک سرویس بر عهده انجیر است.

خطا	اقدام
بازار نامعتبر	نماد رمزارز و واحد را بررسی کنید؛ بازار USDT با واحد USDT معتبر نیست.
شبکه یا پایان مهلت	کمی بعد دوباره آزمایش کنید و در صورت ادامه، کد خطا را برای پشتیبانی بفرستید.
محدودیت درخواست	دوباره‌زدن پی‌درپی تست را متوقف کنید؛ کمی بعد تلاش کنید و تداوم خطا را اطلاع دهید.

داده عمومی به کلید نیاز ندارد؛ کلید یا رمز را در فیلد نماد یا پیام پشتیبانی نگذارید.

این نسخه به موجودی، سفارش شخصی، ثبت معامله یا برداشت دسترسی ندارد. اتصال حساب خصوصی مرحله جداگانه‌ای است و مطابق مستندات فعلی نوبیتکس، کلید امضاشده با دسترسی محدود می‌خواهد.

مستندات رسمی نوبیتکس