Pertanyaan yang Sering Diajukan

Tanya 1: Tidak dapat menarik dana meskipun sudah menambahkan alamat ke whitelist

Penyebab:

1. Whitelist pada halaman penarikan dan whitelist penarikan API bersifat independen satu sama lain.
2. Alamat yang ditambahkan melalui [Halaman Penarikan] > [Manajemen Alamat Penarikan] tidak berlaku untuk penarikan API.
    

Solusi:

Kunjungi halaman Manajemen Whitelist Penarikan API: https://www.coinex.com/apikey
Tambahkan alamat penarikan ke whitelist khusus API.

Tanya 2: Error access_id not exist

Penyebab Umum:

1. Kunci API yang baru dibuat biasanya membutuhkan waktu sekitar 10 menit agar aktif. Memanggil API segera setelah pembuatan dapat memicu error ini.
2. access_id yang salah.
3. Verifikasi tanda tangan (signature) tidak valid.
4. Header permintaan (request header) yang salah.

Solusi:

1. Lihat [Dokumentasi API CoinEx] untuk mempelajari cara membuat permintaan otentikasi HTTP.
2. Demo:

Q3: 3008/4001 service unavailable Error

Cause: This error may occur when canceling orders during periods of high server load.

Solution:

(1) Prioritize canceling important orders.

(2) Retry after 1-2 seconds.

(3) If the response returns code: 0 but the order is not canceled:

• Record the complete request and response.
• Contact customer support and provide the main/sub-account information for assistance.

Q4: Invalid Parameter Error

Cause: This usually occurs when the uploaded parameters do not match the types specified in the API documentation.

Solution: Taking the POST /spot/cancel-order endpoint as an example:

(1) Strictly compare the parameter names and types in the API documentation.

(2) Pay special attention to the differences between numeric and string types.

Tanya 5: Apa itu API rate limits?

Batasan rate API dibagi menjadi batas jangka pendek dan batas jangka panjang, yang dapat dikenali melalui Response Header:

• Batas Jangka Pendek:
  Jika nilai X-RateLimit-Limit lebih besar dari 0, batas jangka pendek belum terpenuhi.
  Mekanisme batas jangka pendek menggunakan token bucket, dengan batas independen untuk akun utama dan sub-akun.
  
  Error umum setelah terpenuhi:
  • Code: 213, 4213
  • Message: Please don't try too frequently.
  • Batas Jangka Panjang:
    Jika X-RateLimit-LongPeriod-{period}-Remaining dikembalikan, batas jangka panjang telah terpenuhi. Sistem mengevaluasi volume dan kualitas permintaan pengguna untuk menentukan apakah akan membatasi total permintaan dalam periode yang lebih panjang. Setelah terpenuhi, laju permintaan untuk semua endpoint (kecuali pembatalan order) dibatasi menjadi 1 permintaan per detik.
  • Error umum: Code: 213, 4213
  • Penilaian tambahan diperlukan melalui Response Header.
     

Pertanyaan Umum Lainnya

Tanya 1: Bagaimana cara mengurangi latensi permintaan API?

Server ditempatkan di AWS Tokyo dan mendukung cross-region load balancing. Pilih wilayah terdekat untuk meminimalkan latensi.

Zona yang tersedia:

• ap-northeast-1a
• ap-northeast-1c
• ap-northeast-1d
   

Tanya 2: Apakah 2FA diperlukan untuk penarikan API?
Untuk alasan keamanan:

1. Sebelum menggunakan penarikan API, Anda harus masuk dan mengotorisasi melalui 2FA.
2. Setelah menambahkan alamat penarikan ke [Withdrawal Whitelist], Anda dapat melakukan penarikan API tanpa verifikasi 2FA tambahan.
    

Tanya 3: Apakah alamat whitelist penarikan bisa ditambahkan melalui API?
Saat ini, menambahkan alamat whitelist penarikan melalui API tidak didukung. Silakan pergi ke [Manajemen API] > [Withdrawal Whitelist] untuk menambahkan alamat secara manual atau batch.

Tanya 4: Error Signature incorrect
Solusi:

1. Periksa apakah access_id dan secret_key dikonfigurasi dengan benar.
2. Pastikan request body dan parameter yang digunakan untuk membuat signature identik. Prakondisikan parameter permintaan sebagai string dan pastikan konsistensi sebelum dan sesudah penandatanganan.
3. Jika menggunakan library pihak ketiga untuk signing, pastikan dikonfigurasi dengan benar.
    

Tanya 5: Error Tonce check error - Correct tonce should be within one minute of the current time
Solusi:

(1) Pastikan timestamp semua permintaan API dalam milidetik.

Contoh:

(2) Pastikan komputer Anda mengaktifkan sinkronisasi waktu otomatis.
 

Tanya 6: Bagaimana cara mendapatkan saldo tersedia dan nilai bersih akun futures?

(1) Gunakan endpoint /assets/futures/balance untuk mendapatkan field available, yang menunjukkan saldo tersedia saat ini.

(2) API saat ini tidak mendukung pengembalian nilai bersih akun. Nilai bersih = jumlah untung/rugi realisasi + unrealized.

(3) Untung/rugi yang belum direalisasi bersifat dinamis dan dapat berubah sesuai posisi. Perhitungan manual diperlukan untuk hasil yang tepat.

(4)Untuk rumus perhitungan, lihat dokumentasi “How to Calculate Linear Contract Equity and PNL”.
 

Tanya 7: Bagaimana cara memproses data yang dikembalikan oleh WebSocket API?

 WebSocket API mengembalikan data dalam format JSON string terkompresi, yang harus didekompresi sebelum digunakan (misalnya menggunakan modul gzip).

Error umum:
utf-8 codec can't decode byte 0x8b in position 1: invalid start byte

Tanya 8: Apa yang harus dilakukan jika platform pajak pihak ketiga melaporkan error?
Layanan V1 dihentikan pada 25 September 2024. Error mungkin disebabkan karena platform belum memperbarui kode mereka ke V2. Hubungi platform pajak terkait untuk bantuan.

Tanya 9: Bagaimana cara memastikan koneksi WebSocket berhasil?
Setelah berlangganan berhasil, akan diterima respon hasil langganan.
Selanjutnya, Anda akan menerima update pesan dari subscription.

Tanya 10: Mengapa koneksi WebSocket terputus secara otomatis? Bagaimana cara mempertahankan koneksinya?

(1) Putusnya koneksi WebSocket biasanya disebabkan oleh masalah jaringan. Silakan periksa apakah koneksi jaringan Anda stabil.

(2) Untuk mempertahankan koneksi WebSocket, Anda perlu menggunakan server.ping agar koneksi tetap aktif (keep-alive).

(3) Jika tidak ada komunikasi dengan server selama 1 menit, koneksi WebSocket akan terputus secara otomatis. Disarankan untuk mengatur interval pengiriman dalam waktu kurang dari 60 detik melalui antarmuka ping untuk menjaga koneksi tetap aktif.

Untuk kesalahan API lainnya, silakan klik DI SINI untuk menghubungi dukungan pelanggan dan berikan informasi berikut untuk membantu menyelesaikan masalah:

(1) Email akun utama atau nama pengguna sub-akun.
(2) Detail lengkap permintaan (request) dan respons (response).

Catan: Jangan membagikan access_id dan secret_key dalam pesan error untuk menghindari kerugian yang tidak perlu.