راهنمای نوبیتکس در انجیر؛ قیمت بازار، موجودی و سفارش‌ها
از دریافت قیمت و هشدار بازار تا خواندن موجودی و سفارش‌های حساب؛ برنامه مناسب را انتخاب و اتصال موردنیاز را مرحله‌به‌مرحله تنظیم کنید.
· ۵ دقیقه خواندن · تیم انجیر
شروع
در سازنده، برنامه را با «نوبیتکس»، 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 معتبر نیست. |
| شبکه یا پایان مهلت | کمی بعد دوباره آزمایش کنید و در صورت ادامه، کد خطا را برای پشتیبانی بفرستید. |
| محدودیت درخواست | دوباره‌زدن پی‌درپی تست را متوقف کنید؛ کمی بعد تلاش کنید و تداوم خطا را اطلاع دهید. |
داده عمومی به کلید نیاز ندارد؛ کلید یا رمز را در فیلد نماد یا پیام پشتیبانی نگذارید.
اتصال حساب برای موجودی و سفارش‌های شخصی
برای دیدن موجودی و سفارش‌های خودتان، اتصال حساب را بسازید. برای دریافت قیمت عمومی، نیازی به این اتصال ندارید.
- وارد پنل نوبیتکس شوید و از «پروفایل ← خدمات API» به صفحه خدمات API بروید.
- یک کلید بسازید و فقط دسترسی READ یا خواندن را انتخاب کنید.
- مقدارهای «کلید API» و «Secret Key» را کپی کنید.
- در انجیر، نوبیتکس را جست‌وجو کنید و یکی از اکشن‌های حساب، مثلاً «موجودی یک ارز در حساب» را انتخاب کنید.
- در فیلد اتصال، اتصال تازه بسازید. کلید API و Secret Key را در فیلدهای هم‌نام وارد کنید؛ سپس اتصال را آزمایش و ذخیره کنید.
- ارز کیف‌پول را انتخاب و اکشن را آزمایش کنید. موجودی صفر هم نتیجه معتبر است؛ خرید یا واریز برای آزمایش لازم نیست.
اگر کلید را به IP محدود کرده‌اید، IP سرور انجیر را از پشتیبانی بگیرید. برای این اتصال از کلید حساب اصلی استفاده کنید؛ انتخاب محیط آزمایشی در فرم فعلی وجود ندارد.
| اکشن حساب | کاربرد |
|---|---|
| موجودی کیف‌پول‌های حساب | فهرست کیف‌پول‌ها و موجودی آن‌ها |
| موجودی یک ارز در حساب | موجودی ارز انتخابی |
| فهرست سفارش‌های حساب | بررسی سفارش‌ها با فیلترهای همان اکشن |
| وضعیت یک سفارش حساب | خواندن سفارش با شناسه آن |
| معاملات انجام‌شده حساب | خواندن معاملات شخصی، جدا از معاملات عمومی بازار |
نام فیلدهای اتصال با پنل نوبیتکس یکسان است. Secret Key را در تیکت یا تصویر نفرستید.
اکشن‌های حساب فقط اطلاعات را می‌خوانند؛ ثبت سفارش خریدوفروش و برداشت در این نسخه وجود ندارد.
بیشتر در راهنمای برنامه‌ها
همه
موجودی و سفارش‌های نوبیتکس را در انجیر بررسی کنید
اتصال حساب نوبیتکس برای دیدن موجودی، وضعیت سفارش‌ها و معاملات انجام‌شده؛ با دسترسی خواندن.
اتصال GapGPT به انجیر؛ پاسخ‌نویسی و استخراج اطلاعات با حساب خودتان
حساب GapGPT را با کلید API به انجیر وصل کنید، مدل انتخاب کنید و پاسخ متنی یا خروجی JSON بگیرید. این راهنما تنظیم اتصال، سقف مصرف و خطاهای رایج را توضیح می‌دهد.
اتصال Groq به انجیر؛ هوش مصنوعی سریع با پلن رایگان برای شروع
Groq با یک کلید هم ویس فارسی را به متن تبدیل میکند هم از متن ستونهای مرتب بیرون میکشد؛ سریع است و پلن رایگانش برای ساختن و آزمایش اولین گردشکارها کافی است.