Pertanyaan Umum (FAQ) Tentang API

Binance
2018-06-05 09:38

Dokumentasi APIContoh API tidak resmi 

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:
  • 1.200 bobot permintaan per menit (perlu diingat bahwa ini belum tentu sama dengan 1.200 permintaan)
  • 50 order per 10 detik
  • 160.000 order per 24 jam
Hard limit kami terdaftar di [/api/v3/exchangeInfo] endpoint.
Limit ML (Machine Learning):
Perilaku perdagangan akan dievaluasi terhadap pengguna rata-rata dan jika Anda menyimpang terlalu jauh, maka Anda akan diblokir untuk jangka waktu tertentu yang berkisar antara 5 menit sampai 3 hari.
Misalnya, Anda memiliki skor penyalahgunaan perdagangan. Skor Anda akan meningkat jika: 
  • Anda berulang kali "menaikkan" atau "menjalankan" Penawaran/Permintaan terbaik pada Buku Order.
  • Anda melakukan spam pembuatan dan pembatalan order dengan sangat cepat tanpa melakukan perdagangan.
  • "Kurs konversi" Anda rendah. "Kurs konversi" didefinisikan sebagai jumlah perdagangan Anda dibagi dengan total pembuatan dan pembatalan order selama periode 24 jam (Jumlah Perdagangan / (Order + Pembatalan)).
  • "Bobot" Anda rendah. "Bobot" didefinisikan sebagai total jumlah perdagangan Anda dibagi dengan 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 lakukan percobaan sendiri untuk mendapatkan pola perdagangan ideal Anda atau diskusikan perilaku optimal dengan pengguna API lainnya.
Limit WAF (Web Application Firewall)
Ketika kami tidak memberikan detail pasti tentang aturan WAF dan Anda menerima kesalahan HTTP 403, 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 lama.

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

Untuk hard limit, melebihi bobot permintaan per menit (saat ini 1.200) akan mengakibatkan pembatasan IP. Batas Order (saat ini 10 per detik dan 100.000 per 24 jam) akan bergantung pada akun. Jika batas Order telah terlampaui, pengguna juga akan dibatasi untuk membuat order baru di situ web (atau aplikasi kami yang lain).
Untuk Limit Machine Learning, pembatasan akan berlaku pada akun. Jika pengguna telah dibatasi oleh sistem ML, mereka dapat memeriksa alasan dan durasi menggunakan [/sapi/v1/account/status] endpoint (tercantum dalam Dokumentasi API kami).
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 batas, tetapi saya telah memperbaiki kode saya. Apakah pembatasan saya akan dibatalkan lebih awal?

Tidak. Anda harus menunggu hingga pembatasan berakhir.

Saya menerima error HTTP 403 ketika menggunakan API. Mengapa?

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 pong yang sesuai, koneksi Anda akan dihentikan.
Untuk aliran data pengguna, jika sebuah keep-alive (aktifkan terus) tidak diterima setidaknya sekali dalam 60 menit, listen key akan kedaluwarsa. Hal ini juga dijelaskan dalam Dokumentasi API kami.

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 mencatat Kunci Rahasia, Anda perlu membuat Kunci API baru dan menggunakan kunci baru tersebut sebagai Kunci Rahasia baru.

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

Sayang sekali, saat ini hal tersebut bukan yang kami tawarkan. Batasan yang kami berikan seharusnya memungkinkannya untuk berfungsi. 

Kunci API saya hilang. Tolong!

Hanya ada dua kemungkinan penjelasan untuk Kunci API yang "menghilang":
  1. Jika Anda tidak aktif baru-baru ini dan Anda menggunakan API sebelum tanggal 7 Maret 2018, kemungkinan Kunci API Anda dihapus untuk memastikan keamanan akun Anda.
  2. Jika tidak, Anda telah memilih untuk menonaktifkan akun Anda dan mengakibatkan penghapusan setiap dan semua 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 untuk 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 ini tidak dapat diselesaikan, masalah tersebut kemungkinan berkaitan dengan latensi (masalah jaringan) dan mungkin recvWindow Anda perlu disesuaikan.

Bisakah saya meminta fungsionalitas API baru?

Jika fungisonalitas yang diminta tidak ada dalam dokumentasi kami, Anda harus menganggap bahwa kami tidak menyediakannya. Jika Anda ingin membuat saran fitur, Anda dapat membuka tiket dukungan beserta saran dan kami akan meninjaunya.

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

Jika Anda merasa ada sebuah masalah dengan sistem dan tidak dengan penerapan Anda, harap memberikan bukti untuk mendukung klaim Anda dengan menghubungi kami di Obrolan Telegram API, dan kami akan menyelidikinya. Harap diketahui bahwa kami tidak menerima pesan yang tidak jelas sebagai keluhan yang sah. Selain itu, grup ini tidak ditujukan sebagai dukungan pemrograman resmi; ini adalah sebuah grup komunitas pengguna API Binance.