Pertanyaan Umum tentang API

2018-06-05 09:38

Terakhir diperbarui: Tanggal 15 November 2024

Dokumentasi APIPustaka Sumber Terbuka API dan Contoh-Contoh

Apa batasannya?

Ringkasan

Ada tiga jenis limit dan semuanya dapat berubah setiap saat:

  1. Hard-limit
  2. Limit ML (Machine Learning)
  3. Limit WAF (Web Application Firewall)

Hard-Limit

  • 6.000 bobot permintaan per menit (perlu diingat bahwa ini belum tentu sama dengan 6.000 permintaan)
  • 100 order per 10 detik
  • 200.000 order per 24 jam

Hard limit kami terdaftar di[/api/v3/exchangeInfo]endpoint.

Limit Machine Learning

Perilaku perdagangan akan dievaluasi terhadap pengguna rata-rata. Jika Anda menyimpang terlalu jauh, Anda akan diblokir untuk jangka waktu tertentu yang berkisar dari 5 menit hingga 3 hari.

Misalnya, Anda memiliki skor penyalahgunaan perdagangan. Skor Anda akan meningkat jika:

  • Anda berulang kali "mendahulukan" atau melakukan "frontrunning" Bid/Ask terbaik pada Buku Order.
  • Anda melakukan spam pembuatan dan pembatalan order dengan sangat cepat tanpa melakukan perdagangan.
  • "Kurs konversi" Anda rendah. "Kurs konversi" adalah jumlah perdagangan Anda dibagi total pembuatan dan pembatalan order selama periode 24 jam (Jumlah Perdagangan / (Order + Pembatalan)).
  • "Bobot" Anda rendah. "Bobot" didefinisikan sebagai total jumlah perdagangan Anda dibagi total pembuatan dan pembatalan order selama periode 24 jam (Total Jumlah Perdagangan / (Order + Pembatalan)).
  • Ketika pasangan dagang memiliki BNB sebagai aset dasar atau aset penawaran, skor penyalahgunaan Anda akan semakin besar.

Informasi yang lebih spesifik dari yang di atas tidak akan diberikan. Silakan gunakan trial dan error untuk mendapatkan pola perdagangan ideal Anda atau diskusikan perilaku optimal dengan pengguna API lainnya.

Limit Web Application Firewall

Meskipun kami tidak menyediakan detail pasti mengenai aturan WAF kami, jika Anda menerima kesalahan HTTP 403, artinya Anda telah melanggar aturan. Kemungkinan besar hal tersebut adalah akibat dari permintaan yang berlebihan dalam jangka waktu 5 menit. Namun, jika Anda mengirimkan permintaan yang dapat dianggap berbahaya, hal tersebut juga dapat mengakibatkan pembatasan dalam jangka waktu yang lebih panjang.

Jika saya melebihi limit, apakah akun, Kunci API, atau Alamat IP saya akan dibatasi?

Untuk hard limit, melebihi bobot permintaan per menit (saat ini adalah 6.000) akan mengakibatkan pembatasan IP. Limit order (saat ini adalah 50 kali/10 detik dan 160.000 kali/24 jam) akan bergantung pada akun. Jika limit order telah terlampaui, pengguna juga tidak akan dapat membuat order baru di situs web (atau aplikasi kami yang lain).

Untuk limit Machine Learning, pembatasan akan berlaku pada akun. Jika telah dibatasi oleh sistem ML, Anda dapat memeriksa alasan dan durasi dengan menggunakan endpoint [/sapi/v1/account/status] (tercantum dalamdokumentasi APIkami).

Limit WAF hanya akan diterapkan oleh IP. Biasanya, larangan WAF akan berdurasi selama 5 menit. Namun, jika server menafsirkan permintaan pengguna sebagai bahaya, maka larangan dapat diperpanjang.

Saya dibatasi karena melewati limit, tetapi saya telah memperbaiki kode saya. Apakah pembatasan saya akan dibatalkan lebih awal?

Tidak. Anda harus menunggu hingga pembatasan berakhir.

Mengapa saya menerima kesalahan HTTP 403 saat menggunakan API?

Anda telah melanggar aturan WAF (Web Application Firewall), kemungkinan besar dengan melanggar batas limit atau mengirim permintaan yang berbahaya (sebagaimana dijelaskan pada bagian limit dokumen ini). Biasanya, larangan ini akan berlangsung selama 5 menit.

Mengapa koneksi WebSocket Saya dihentikan/diputus?

Setiap 3 menit, koneksi WebSocket aktif akan menerima ping. Jika Anda tidak menanggapi dengan ping yang sesuai, koneksi Anda akan dihentikan.

Untuk aliran data pengguna, jika sebuah keep-alive tidak diterima setidaknya sekali dalam 60 menit, listen key akan kedaluwarsa. Hal ini juga dijelaskan dalamdokumentasi APIkami.

Saya menggunakan layanan pihak ketiga/wrapper dan layanan tersebut tidak berfungsi. Bisakah Anda membantu?

Sayang sekali, kami tidak mendukung layanan atau alat pihak ketiga. Silakan hubungi layanan pendukung dan/atau pengembang untuk mendapatkan bantuan lebih lanjut.

Selain itu, memasukkan kunci API Binance Anda dan/atau Kunci Rahasia Anda pada platform pihak ketiga mana pun memunculkan risiko keamanan. Harap gunakan layanan tersebut sesuai kebijakan Anda sendiri.

Harap diingat bahwa kami juga menghindari memberikan bantuan pemrogramam umum.

Meskipun tidak membuat perubahan, saya tiba-tiba menerima kesalahan. Apa yang terjadi?

Sayang sekali, kami tidak bisa memberikan dukungan terkait dengan penerapan pribadi Anda. Jika Anda menggunakan wrapper/alat pihak ketiga, harap hubungi tim dukungan/pengembang mereka untuk mendapatkan bantuan.

Saya membutuhkan akses ke Kunci Rahasia saya, tetapi yang ditampilkan hanya "***". Bagaimana cara mendapatkannya kembali?

Untuk alasan keamanan dan berdasarkan rancangannya, Kunci Rahasia hanya terlihat saat Kunci API dibuat. Kapan pun setelahnya, Kunci Rahasia akan disamarkan. Jika Anda kehilangan atau tidak mencatatnya, Anda perlu membuat Kunci API baru dan menggunakannya sebagai Kunci Rahasia baru.

Apakah saya dapat meningkatkan limit atau aliran/bandwidth khusus saya?

Sayang sekali, saat ini hal tersebut tidak ditawarkan.. Batasan yang telah diberikan seharusnya memungkinkannya untuk berfungsi.

Kunci API saya hilang.

Hanya ada dua kemungkinan penjelasan untuk Kunci API yang "menghilang":

  • Jika Anda tidak aktif belakangan ini dan Anda menggunakan API sebelum tanggal 07 Maret 2018, Kunci API Anda mungkin dihapus untuk memastikan keamanan akun Anda.
  • Jika Anda telah menonaktifkan akun Anda, hal ini akan mengakibatkan penghapusan setiap Kunci API yang aktif.

Anda seharusnya dapat membuat Kunci API baru tanpa masalah.

Saya menerima "Kesalahan -1021 (Pesan: Stempel waktu untuk permintaan ini berada di luar jendela penerima)". Bagaimana cara mengatasinya?

Biasanya, kesalahan ini terjadi jika waktu server dan waktu sistem Anda tidak sinkron. Anda mungkin perlu menyinkronkan jam sistem Anda. Namun, proses ini berbeda-beda tergantung pada sistem operasi.

Untuk Windows, Anda dapat menggunakan alat seperti "Atomic Clock" sesuai kebijakan sendiri. Pengguna Linux dan Mac dapat mencoba menyinkronkan dengan "ntpdate" melalui command line.

Jika masalah masih berlanjut, masalah tersebut kemungkinan berkaitan dengan latensi (masalah jaringan). Silakan coba sesuaikan recvWindow Anda.

Bisakah saya meminta fungsionalitas API baru?

Jika fungsionalitas yang diminta tidak ada dalam dokumentasi kami, Anda dapat beranggapan bahwa kami tidak menyediakannya. Jika Anda ingin memberikan saran tentang fitur, Anda dapat membuka tiket dukungan dan kami akan meninjaunya.

Saya yakin ada sebuah masalah dengan API. Bagaimana cara melaporkannya?

Jika Anda merasa ada masalah pada sistem dan bukan pada penerapan Anda, harap berikan bukti untuk mendukung klaim Anda dengan menghubungi kami diforum pengembang, lalu kami akan menyelidikinya. Harap diperhatikan bahwa kami tidak menerima pesan yang tidak jelas sebagai keluhan yang sah.