WEEX API İnteqrasiya Bələdçisi: Autentifikasiya, Limitlər və 403 Xətası

Kripto birja API-ləri üçün əksər bələdçilər "bir açar yaradın və botunuzu ona yönləndirin" prinsipi ilə bitir. Bu sizi ilk -1052 xətanıza aparır, işlək bir inteqrasiyaya yox. WEEX API ikiqat sistemdir — spot və fyuçerslər fərqli domenlərdə və fərqli sifariş sxemləri ilə işləyir — və tərtibatçıların ən çox vaxtını alan uğursuzluqlar konseptual deyil. Bunlar çatışmayan User-Agent başlığı, 31 saniyə geri qalan saat və birjada mövcud olan, lakin proqramlaşdırılmış giriş üçün aktivləşdirilməmiş ticarət cütlüyüdür.

Bu bələdçi WEEX API inteqrasiyasını əvvəldən sona qədər izah edir: API nələri əhatə edir, sizi bloklamayacaq bir açarı necə təmin etmək olar, imza necə qurulur, istehsalda qarşılaşacağınız limitlər və ilk cəhdlərin çoxunu pozan spesifik xətalar. Buradakı hər bir rəqəm 2026-cı ilin avqust ayına olan WEEX V3 sənədlərindən götürülüb.

WEEX API Nələri Əhatə Edir — və Nələri Hələ Etmir

WEEX API iki müstəqil REST səthini və bir WebSocket qatını təqdim edir. Onlar bir-birini əvəz etmir və bu, inteqrasiyanın düzgün etməli olduğu ilk struktur qərardır.

Əhatə dairəsi realdır, lakin məhduddur. WEEX OpenAPI beta elanı 140-dan çox dəstəklənən cütlüyü sadalayır — lakin bölgü qeyri-bərabərdir: fyuçers cədvəli təxminən 130 perpetual müqaviləyə çatır, spot siyahısı isə təxminən 25 cütlükdür. Əgər strategiyanız orta kapitallı bir spot cütlüyü ilə ticarət edirsə, kod yazmazdan əvvəl bu siyahını yoxlayın, çünki veb interfeysində canlı olan bir cütlük API sifarişlərini qəbul edəcəyi mənasına gəlmir.

Başqa bir məkandan miqrasiya edən hər kəs üçün iki çatışmazlıq vacibdir. WEEX-in 14 aprel 2026-cı il tarixində yenilənmiş spot API FAQ-ı açıq şəkildə bildirir ki, nə FIX API, nə də TradingView inteqrasiyası hazırda dəstəklənmir. Əgər icra yığınınız FIX sessiyasını və ya TradingView-dən yönləndirilmiş veb-qarmaq xəbərdarlıqlarını nəzərdə tutursa, siz həmin qatı REST və WebSocket əsasında yenidən qurursunuz.

Həmçinin qeyd etmək lazımdır: V1 və V2 son nöqtələri istifadədən çıxarılır və WEEX yeni quruluşlar üçün V3-ü tövsiyə edir. Üçüncü tərəf bot platformalarında tapdığınız nümunə kodlar hələ də V2 yollarını hədəfləyə bilər.

Özünüzü Bloklamadan WEEX API Açarını Necə Yaratmaq Olar

Açarın yaradılması Hesab bölməsi altında WEEX API İdarəetmə səhifəsində baş verir. Mexanika iki dəqiqə çəkir. Konfiqurasiya qərarları daha uzun çəkir və onlardan üçü geri dönməzdir.

1. Açarı yaradın. Hər hesab 10-a qədər API açar qrupunu dəstəkləyir. Yeni açarlar standart olaraq Read Only (Yalnız oxumaq) rejimində olur.
2. İcazələri dəqiq seçin. Readonly, Spot və Futures/Contract müstəqildir. Spot-u yoxlamaq fyuçerslərə giriş vermir və yalnız spot açarı ilə göndərilən fyuçers sifarişi daha təsviri bir şey əvəzinə -1052 INSUFFICIENT_PERMISSIONS xətası qaytarır.
3. Parolu diqqətlə təyin edin. WEEX-in öz təhlükəsizlik təlimatları yalnız alfanumerik simvollardan istifadə etməyi tövsiyə edir — paroldakı xüsusi simvollar sənədləşdirilmiş autentifikasiya xətalarının mənbəyidir. Parol dəyişdirilə və ya bərpa edilə bilməz. Onu itirsəniz, yeni bir açar yaradırsınız.
4. IP ağ siyahısını bağlayın. Vergüllə ayrılmış 10-a qədər IP. Məhdudiyyətsiz açarlar API quraşdırmasında ən böyük saxlama riskidir və WEEX onları bu şəkildə işarələyir.
5. Gözləyin. Yeni yaradılmış və ya dəyişdirilmiş açarların WEEX sistemləri üzrə yayılması təxminən 15 dəqiqə çəkir. Tərtibatçılar adətən bu pəncərəni pozulmuş imza kimi şərh edir və işlək kodu yenidən yazmağa başlayırlar.

Yaradılma zamanı APIKey, SecretKey və Passphrase-i saxlayın. Yalnız APIKey sonradan əldə edilə bilər.

İlk gündən qəbul etməyə dəyər bir vərdiş: ticarət prosesində yaşayan bir açarda vəsait çıxarılması ilə bağlı icazələri heç vaxt aktivləşdirməyin. Monitorinq üçün yalnız oxuna bilən açarları icra üçün ticarət icazəsi olan açarlardan ayırın və hər birinə öz IP bağlamasını verin. Əməliyyat dəyəri on dəqiqədir; qarşısını aldığı uğursuzluq rejimi isə tamdır.

WEEX API Sorğusunu İmzalamaq: 30 Saniyəlik Pəncərə

Hər bir şəxsi WEEX API zəngi dörd başlıq və bir məzmun növü daşıyır:

İmzaladığınız mesaj bir birləşmədir və birləşmə qaydası sorğu sətirinin olub-olmamasından asılı olaraq dəyişir:

# queryString mövcuddur
timestamp + METHOD + requestPath + "?" + queryString + body

# queryString yoxdur
timestamp + METHOD + requestPath + body

METHOD böyük hərflərlədir. body ötürdüyünüz xam JSON sətiridir, bayt-bayt ötürdüyünüzlə eynidir — bir dəfə seriyalaşdırın, həmin sətri imzalayın, həmin sətri göndərin. İmzalanma və göndərilmə arasında yenidən seriyalaşdırma ən çox yayılmış öz-özünə vurulan imza xətasıdır, çünki açar sıralaması və ya boşluqlar dəyişir və heş artıq uyğun gəlmir.

WEEX imza spesifikasiyasından dərinliyi əldə etmək üçün işlənmiş bir nümunə:

1591089508404GET/api/v3/market/depth?symbol=BTCUSDT&limit=20

Və bir sifariş:

1561022985382POST/api/v3/order{"symbol":"BTCUSDT","side":"BUY","type":"LIMIT","timeInForce":"GTC","quantity":"1","price":"68900","newClientOrderId":"my-order-001"}

Sonra gizli açarınızla HMAC-SHA256, sonra Base64.

İstehsalda insanları yaxalayan məhdudiyyət saatdır. Sorğular ACCESS-TIMESTAMP WEEX server vaxtından 30 saniyədən çox fərqlənərsə rədd edilir və -1046 ACCESS_TIMESTAMP_EXPIRED qaytarır. Saatları sürüşən konteynerlər, serverless soyuq başlamalar və NTP-si olmayan VM-lərin hamısı bu xətanı fasilələrlə verir — bu, ardıcıl uğursuzluqdan daha pisdir, çünki şəbəkə problemi kimi görünür. Başlanğıcda server vaxtı son nöqtəsini sorğulayın, ofseti saxlayın və onu hər zaman damğasına tətbiq edin.

WebSocket şəxsi kanalları daha qısa bir mesajdan istifadə edir: timestamp + "/v3/ws/private", eyni şəkildə imzalanır — eyni başlıqlar, eyni HMAC-SHA256 və Base64 addımları, sadəcə fərqli bir sətir.

Həqiqətən Qarşılaşacağınız WEEX API Limitləri

Limitin aşılması HTTP 429 və 10 saniyəlik qadağa qaytarır. WEEX limitləri iki müstəqil büdcəyə bölür, bu da əksər inteqrasiyaların səhv modelləşdirdiyi hissədir.

Rate limitləri WEEX spot API sənədlərindən və FAQ-dan götürülüb, 14 aprel 2026-cı il tarixinə qədər aktualdır.

Vacib olan fərq: sifariş yerləşdirmə hesab tərəfindən, digər hər şey isə IP tərəfindən məhdudlaşdırılır. Yerləşdirmə son nöqtələri sıfır IP çəkisi istehlak edir — cavab başlıqlarındakı IP sayğacı 0 oxuyur. Beləliklə, bir IP arxasında üç strategiya işlətmək sifariş büdcənizi üçqat artırmır (hesab başına olduğu üçün), lakin bazar məlumatları və sorğular üçün 500-çəkili IP hovuzunun istehlakını üçqat artırır.

Təxmin etmək əvəzinə başlıqları oxuyun. Hər cavab X-USED-WEIGHT-1M və X-REMAINING-WEIGHT-1M daşıyır; sifariş son nöqtələri X-ORDER-COUNT-10S və X-ORDER-REMAINING-10S daşıyır. Qalan çəki başlığı ilə idarə olunan bir geri çəkilmə, sərt kodlaşdırdığınız hər hansı sabit yuxu intervalından daha yaxşı performans göstərəcək.

Spot və Fyuçers Sifarişləri Sxemi Paylaşmır

Bu, paylaşılan abstraksiya qatlarını pozan fərqlilikdir və sənədlərdə heç yerdə qabarıq şəkildə qeyd olunmayıb — bunu iki sifariş səhifəsini müqayisə edərək tapırsınız.

Sonuncu sətir vurğulanmağa layiqdir. Fyuçers son nöqtəsi {"success": false, "errorCode": "...", "errorMessage": "..."} ilə HTTP 200 qaytara bilər. Yalnız HTTP statusunu yoxlayan kod rədd edilmiş sifarişi icra edilmiş kimi qeyd edəcək və sahib olmadığı bir mövqeni qurmağa xoşbəxtliklə davam edəcək. Hər fyuçers sifarişi cavabında success-i açıq şəkildə yoxlayın.

Sənədlərin özündə də canlı bir uyğunsuzluq var. Spot API İctimai Parametrlər səhifəsi hələ də force sahəsi ilə yanaşı kiçik hərflərlə enums (buy, sell, limit, market) sadalayır, Ticarət altındakı V3 sifariş son nöqtələri isə böyük hərflərlə BUY, SELL, LIMIT və timeInForce istifadə edir. Son nöqtə səhifələri V3-ü əks etdirir; parametrlər səhifəsi V2 dövrünün dəyərlərini daşıyır. Onlar razılaşmadıqda, son nöqtə səhifəsinə etibar edin — və səhv olanı köçürdüyünüzə dair bir siqnal olaraq loglarınıza -1116 INVALID_ORDER_TYPE göndərin.

Simvollar böyük-kiçik hərfə həssasdır və böyük hərflərlə olmalıdır. btcusdt -1121 qaytarır.

Əksər WEEX API İnteqrasiyalarını Pozan Beş Xəta

WebSocket 403 daxililəşdirməyə dəyər olanıdır. Bunun etimadnamələrinizlə heç bir əlaqəsi yoxdur — WEEX-in kənarı başlıqsız əl sıxmalarını birbaşa rədd edir, buna görə də mükəmməl imzalanmış şəxsi abunəlik imzasız olanla eyni şəkildə uğursuz olur. Tərtibatçılar onu tapmazdan əvvəl bir saat imzalarını sazlayırlar. WEEX bunu spot API FAQ-da sənədləşdirir və düzəliş bir sətirdir.

Bağlantıları da düzgün canlı saxlayın. Server dövri pinglər göndərir — ictimai kanallarda {"event":"ping","time":"..."}, şəxsi kanallarda {"type":"ping","time":"..."} — və {"method":"PONG","id":1} cavabını gözləyir. 10-dan çoxunu qaçırın və server bağlantını bağlayır. Dəyişkən bir sessiya zamanı səssiz bir bağlantının kəsilməsi botun köhnə bir kitabda ticarət etməsi ilə nəticələnir.

Tam xəta taksonomiyası WEEX spot API FAQ və xəta kodu arayışında yaşayır.

Real Marjı Riskə Atmazdan Əvvəl Demo Rejimində Test Edin

WEEX, /capi/v3/sim/ altında, eyni autentifikasiya edilmiş nümunə vasitəsilə əldə edilə bilən simulyasiya edilmiş fyuçers mühiti təqdim edir. demo balans son nöqtəsi availableBalance, frozen və unrealizePnl ilə yanaşı SUSDT — simulyasiya edilmiş USDT — ilə ifadə olunan mövqeləri qaytarır. Demo PlaceOrder, GetAllPositions və GetOrderHistory-nin hamısı açıqdır.

Ondan həqiqətən yaxşı olduğu şey üçün istifadə edin: imza quruluşunuzu, xəta idarəetmənizi və yenidən qoşulma məntiqinizi yoxlamaq. Strategiya iqtisadiyyatını yoxlamaq üçün istifadə etməyin. Simulyasiya edilmiş bir məkanda növbə mövqeyi, stres altında qismən icra davranışı və sürüşmə yoxdur — backtest-i P&L-dən ayıran üç şey.

Canlı tərəfdə kalibrləmə üçün: WEEX, 21 avqust 2026-cı il tarixinə olan BTC/USDT fyuçers bazarında BTC perpetual-larını 65,088.80 USDT qiymətində təklif edib, 400x-ə qədər leverage mövcuddur. Bu leverage tavanı avtomatlaşdırılmış sistemlə mühafizəkar olmaq üçün bir səbəbdir, arxalanacaq bir xüsusiyyət deyil. Təkrar sifarişlər verən bir imza xətası 3x-də sağ qala bilər. 400x-də isə yox.

Qısa Versiya

WEEX API üç şey doğru olduqda sadədir: saatınız 30 saniyəlik pəncərədə sinxronlaşdırılıb, WebSocket-iniz User-Agent göndərir və fyuçers kodunuz HTTP statusu əvəzinə success sahəsini yoxlayır. Digər hər şey — icazələr, IP ağ siyahıları, rate-limit geri çəkilməsi — standart birja inteqrasiyası işidir.

Standart olmayan və vaxt ayırmağa dəyər olan tək şey, spot/fyuçers sxeminin fərqliliyidir. Hər iki səthdə paylaşılan bir sifariş abstraksiyası nəzərdən keçirmədə düzgün görünəcək və istehsalda uğursuz olacaq. Onları iki adapter kimi qurun.

Başlamağa hazırsınız? WEEX-də Hesab → API İdarəetmə bölməsində bir açar yaradın, əvvəlcə demo rejiminə yönləndirin və yalnız yenidən qoşulma və xəta yollarınız sübut olunduqdan sonra icazələri genişləndirin.

FAQ

1. WEEX API istifadə etmək pulsuzdurmu?

Bəli. API girişi üçün ayrıca ödəniş yoxdur. Siz icra edilmiş sifarişlər üzrə standart spot və ya fyuçers ticarət haqlarını ödəyirsiniz, eynilə manual ticarətdə olduğu kimi.

2. WEEX-də neçə API açarı yarada bilərəm?

Hesab başına 10-a qədər API açar qrupu. Hər açar Readonly, Spot və ya Futures/Contract icazələri və 10-a qədər ünvandan ibarət öz IP ağ siyahısı ilə müstəqil şəkildə konfiqurasiya edilə bilər.

3. Niyə mənim WEEX API açarım Postman-da işləyir, lakin serverimdən işləmir?

Demək olar ki, həmişə IP ağ siyahısı (-1056) və ya saat sürüşməsi (-1046) səbəbindəndir. Bulud mühitləri tez-tez ağ siyahınızda olmayan fırlanan bir NAT IP-dən çıxır və NTP-si olmayan konteynerlər 30 saniyəlik imza pəncərəsini keçir.

4. WEEX API FIX və ya TradingView veb-qarmaqlarını dəstəkləyirmi?

Xeyr. Aprel 2026 sənəd yeniləməsinə görə, nə FIX API, nə də TradingView inteqrasiyası dəstəklənmir. REST və WebSocket mövcud nəqliyyat vasitələridir.

5. Yeni WEEX API açarı nə qədər müddətə işləməyə başlayır?

Yeni və ya dəyişdirilmiş açarın yayılması üçün təxminən 15 dəqiqə. Həmin pəncərə daxilində autentifikasiya uğursuzluqları gözləniləndir və imza problemi deyil.

6. Real vəsait olmadan WEEX API strategiyalarını test edə bilərəmmi?

Bəli, fyuçerslər için. /capi/v3/sim/ altındakı demo son nöqtələri eyni autentifikasiya edilmiş sorğuları qəbul edir və SUSDT ilə ifadə olunan balansları qaytarır. Onlara strategiya backtest-i kimi deyil, inteqrasiya test aləti kimi baxın.

Risk Xəbərdarlığı

Kripto aktivləri dəyişkəndir və onlarla ticarət qismən və ya tam kapital itkisi ilə nəticələnə bilər. API ticarəti bu riski azaltmaq əvəzinə cəmləşdirir: məntiq xətası, işlənməmiş rədd edilmə və ya köhnə WebSocket kanalı insan fərqinə varmadan əvvəl onlarla istənməyən sifariş icra edə bilər. WEEX bəzi perpetual müqavilələrdə 400x-ə qədər leverage təklif edir ki, bu da həm düzgün, həm də səhv siqnalları böyüdür — yüksək leverage ilə işləyən avtomatlaşdırılmış sistem tək bir mənfi hərəkətdə ləğv edilə bilər.

API yerləşdirilməsində nəzərə alınmalı olan spesifik risklər: hesabın tam ticarət nəzarətini verən məhdudiyyətsiz və ya sızdırılmış açarlardan saxlama riski; mövqeləri idarə olunmamış qoyan saat sürüşməsi, rate-limit qadağaları və kəsilmiş bağlantılardan əməliyyat riski; bazar sifarişinin kitabı sizə qarşı hərəkət etdirdiyi az ticarət olunan cütlüklərdə likvidlik riski; və API ticarətinin mövcudluğu və spesifik cütlüklərin xəbərdarlıq edilmədən dəyişə biləcəyi üçün kontragent və tənzimləyici risk. IP ağ siyahısını bağlayın, ticarət açarlarında vəsait çıxarma icazələrini söndürün, mövqe ölçüsünü niyyətdə deyil, kodda məhdudlaşdırın və kapital yerləşdirməzdən əvvəl xəta yollarını demo rejimində test edin. Buradakı heç bir şey investisiya məsləhəti deyil.