Son güncelleme: 14 Mayıs 2024
Binance Portföy Marjini Pro Programı, Binance Vadeli İşlemler API bağlantı paketi aracılığıyla kullanılabilir ve Binance Vadeli İşlemler API alım satım arayüzünü etkinleştirmiş olan kullanıcılara açıktır. Çapraz Marjin, USDⓈ-M Vadeli İşlemler ve COIN-M Vadeli İşlemler piyasalarındaki mevcut alım satım API uç noktaları, Binance Portföy Marjini Pro Programı kapsamında kullanılmaya devam edecektir ve standart hesap alım satım uygulamalarıyla uyumludur.
Portföy Marjini Pro API uç noktalarının Binance Portföy Marjini Pro ile uyumlu olduğunu ve Portföy Marjini için kullanılamayacağını (istisnai durumlar haricinde) lütfen unutmayın. Portföy Marjini Pro ile Portföy Marjini arasındaki farkların kapsamlı bir şekilde açıklandığı bu makalemize bakabilirsiniz.
Portföy Marjini için kullanılabilecek uç noktaların tam listesi için Binance Portföy Marjini API'si bölümüne bakabilirsiniz.
Binance Portföy Marjini Pro Programı API ayrıntıları
Binance Portföy Marjini Pro Programı kapsamında, Binance'in standart API uç noktalarına ek olarak özel uç noktalar eklenmiştir ve aşağıdaki çıktıları sağlamaktadır:
1. uniMMR, Portföy Marjini Pro Hesap Durumu
2. İflas Kredisi Kaydı (GET) ve Geri Ödeme (POST)
3. İşlem Çifti Başına Teminat Oranı
4. Sözleşme Başına Nosyonel Limit Değeri
5. Ek Portföy Marjini Pro Programı API İstisnaları
6. Portföy Marjini Pro Hesap Bilgileri (USER_DATA)
7. Portföy Marjini Pro Masraf Geçmişi (USER_DATA)
8. Portföy Marjini Pro Masraf Oranı (USER_DATA)
9. Hata kodları
1. uniMMR ve Portföy Marjini Pro Hesap Durumu
Aşağıdaki talepler bunlara karşılık gelen çıktıları getirecektir:
Hesaplanan öğe | Açıklama |
uniMMR | Birleştirilmiş Marjin Sürdürme marjini oranı |
accountEquity | Birleştirilmiş marjin hesabı net değeri, USD cinsinden |
actualEquity | Birleştirilmiş marjin hesabının USD cinsinden fiili net değeri (teminat oranı olmadan) |
accountMaintMargin | Birleştirilmiş Marjin Sürdürme Marjini, açık pozisyon ve kredi için gereken marjin, USD cinsinden |
accountStatus | Birleştirilmiş Marjin Hesabı mevcut durumu: "NORMAL", "MARGIN_CALL", "SUPPLY_MARGIN", "REDUCE_ONLY", "ACTIVE_LIQUIDATION", "FORCE_LIQUIDATION", "BANKRUPTED" |
API Parametreleri:
Ad | Tür | Zorunlu |
recvWindow | Uzun | HAYIR |
timestamp | Uzun | EVET |
API Yanıtları:
Yanıt Türü | Yanıt İçeriği |
Normal Yanıt | { "uniMMR": "1,87987800", "accountEquity": "122.607,35137903", "actualEquity": "142.607,35137903", "accountMaintMargin": "23,72469206", "accountStatus": "NORMAL" } |
Hesapta Portföy Marjini Pro Programı etkinleştirilmemişse | { "kod":-21001, "msg": "geçersiz talep: talep kimliği bir Portföy Marjini Hesabı değil" } |
2. Portföy Marjini Pro İflas Kredisi
- Portföy Marjini Pro İflas Kredisi Kaydı
Aşağıdaki talepler bunlara karşılık gelen çıktıları getirecektir:
Hesaplanan öğe | Açıklama |
Varlık | Varsayılan kredi varlığı (USDT) |
tutar | USDT cinsinden Portföy Marjini Pro iflas kredisi tutarı |
API Parametreleri:
| Ad | Tür | Zorunlu |
| recvWindow | Uzun | HAYIR |
| timestamp | Uzun | EVET |
API Yanıtları:
Yanıt Türü | Yanıt İçeriği |
Normal Yanıt | { "varlık": "USDT", "tutar": "579,45", } |
Kullanıcının Portföy Marjini İflas Kredisi bulunmuyorsa | { "hata kodu": -21004, "msg":"Ödenmemiş pmLoan yok" } |
- Portföy Marjini Pro İflas Kredisi Geri Ödemesi
API Parametreleri:
| Ad | Tür | Zorunlu |
| recvWindow | Uzun | HAYIR |
| timestamp | Uzun | EVET |
API Yanıtları:
Yanıt Türü | Yanıt İçeriği |
Normal Yanıt | { "tranId": 58203331886213504 } |
| Kullanıcının Spot Cüzdanında Portföy Marjini Pro İflas Kredisini geri ödemek için yeterli USDT yoksa | { "hata kodu": -21005, "mesaj":"pmLoan geri ödemesi için yeterli USDT yok" } |
| Kullanıcının Portföy Marjini İflas Kredisi geri ödemesi işleniyorsa | { "error code": -21006, "msg":"pmLoan geri ödemesi işleniyor" } |
| Kullanıcı, likidasyon devam ettiği için Portföy Marjini İflas Kredisini geri ödeyememişse | { "error code": -21007, "msg":"Likidasyon devam ettiği için geri ödeme başarısız" } |
3. Portföy Marjini Teminat Oranı (MARKET_DATA)
Aşağıdaki talepler bunlara karşılık gelen çıktıları getirecektir:
Hesaplanan öğe | Açıklama |
Varlık | Teminat varlık türü |
collateralRate | Karşılık gelen teminat oranı |
API Yanıtları:
Yanıt Türü | Yanıt İçeriği |
Normal Yanıt | { "varlık": "USDT", "collateralRate": "1,0000", } |
4. Ek Portföy Marjini Pro Programı API İstisnaları
İstemci Durumu | Yanıt İçeriği |
Kullanıcı Marjin Cüzdanından Vadeli İşlemler Cüzdanına varlık transfer ederse | /sapi/v1/asset/transfer: { "error code": -21002, "msg":"Portföy Marjini Hesabı, marjinden vadeli işlemlere transferi desteklemiyor” } |
Marjin varlıkları zamanında geri alınamadıysa | /sapi/v1/margin/maxTransferable /sapi/v1/asset/transfer /sapi/v1/margin/transfer /sapi/v1/future/transfer { "hata kodu": -21003, "msg":"marjin varlıkları geri alınamadı” } |
Marjin varlıkları sistem tarafından zamanında güncellenmediyse | /sapi/v1/margin/maxBorrowable/sapi/v1/margin/loan /sapi/v1/margin/order with MARGIN_BUY { "hata kodu": -21003, "msg":"marjin varlıkları geri alınamadı” } |
5. Portföy Marjini Pro Güncel Hesap Bilgileri
Aşağıdaki talepler bunlara karşılık gelen çıktıları getirecektir:
Hesaplanan öğe | Açıklama |
maxWithdrawAmountUSD | Portföy Marjini Pro Hesabından USD cinsinden dışa transfer edilebilecek maksimum tutar (tahmini dönüştürme değerine göre)* |
maxWithdrawAmount | Portföy Marjini Pro Hesabından dışa transfer edilebilecek maksimum tutar* |
* Kullanıcının Spot Cüzdanına transfer
API Parametreleri:
| Ad | Tür | Zorunlu |
| Varlık | DİZE | EVET |
| recvWindow | Uzun | HAYIR |
API Yanıtları:
Yanıt Türü | Yanıt İçeriği |
Normal Yanıt | { "maxWithdrawAmountUSD": "25.347,92083245", // Portföy Marjininde USD cinsinden dışa transfer edilecek maksimum sanal tutar "asset": "BTC", // varlık adı "maxWithdrawAmount": "1.33663654", // dışa transfer edilecek maksimum tutar } |
6. Portföy Marjini Pro Masraf Geçmişi (USER_DATA)
API Parametreleri:
| Ad | Tür | Zorunlu |
| Varlık | DİZE | HAYIR |
| startTime | Uzun | HAYIR |
| endTime | Uzun | HAYIR |
| boyut | Uzun | Varsayılan:10 Maks.:100 |
| recvWindow | Uzun | HAYIR |
| timestamp | Uzun | EVET |
API Yanıtları:
Yanıt Türü | Yanıt İçeriği |
Normal Yanıt | [ { "varlık": "USDT", "masraf": "0,00000604", "anapara": "0,04902887", "interestRate": "0,00012329", "tür": "UM_NEGATIVE_BALANCE", "interestAccruedTime": 1678924800000 } ] |
7. Portföy Marjini Pro Masraf Oranı (USER_DATA)
API Parametreleri:
| Ad | Tür | Zorunlu |
| Varlık | DİZE | HAYIR |
| recvWindow | Uzun | HAYIR |
| timestamp | Uzun | EVET |
API Yanıtları:
Yanıt Türü | Yanıt İçeriği |
Normal Yanıt | [ { "varlık": "USDT", "dailyInterest": "0.00012329", //günlük faiz oranı "yearlyInterest": "0.045" //yıllık faiz oranı } ] } |
8. Hata Kodları
API uç noktasından "-21003" hata koduyla veya grafik kullanıcı arayüzünden (GUI) "NET_ASSET_MUST_LTE_RATIO" hata mesajıyla karşılaşırsanız, lütfen Çapraz Marjin Cüzdanınıza ufak tutarda herhangi bir varlığı transfer etmeyi deneyin. Hata, transfer sonrasında giderilecektir.