Những vấn đề thường gặp
Q1: Không thể rút tiền ngay cả sau khi đã thêm địa chỉ vào danh sách trắng
Nguyên nhân:
1. Danh sách trắng trên trang rút tiền và danh sách trắng rút tiền API hoạt động độc lập với nhau.
2. Các địa chỉ được thêm qua [Trang Rút tiền] > [Quản lý Địa chỉ Rút tiền] không áp dụng cho việc rút tiền qua API.
Giải pháp:
- Truy cập Trang Quản lý Danh sách trắng Rút tiền API: https://www.coinex.com/apikey
- Thêm địa chỉ rút tiền vào danh sách trắng dành riêng cho API.
Q2: Lỗi access_id not exist
Nguyên nhân phổ biến:
(1) Các khóa API mới tạo thường mất khoảng 10 phút để trở nên hoạt động. Nếu gọi API ngay sau khi tạo, lỗi này có thể xảy ra.
(2) access_id không chính xác.
(3) Chữ ký xác minh (signature) không hợp lệ.
(4) Tiêu đề yêu cầu (request header) thiết lập không đúng.
Giải pháp:
(1) Tham khảo [Tài liệu API CoinEx] để tìm hiểu cách xây dựng yêu cầu xác thực HTTP.
(2) Ví dụ:
Q3: Lỗi 3008/4001 service unavailable
Nguyên nhân: Lỗi này có thể xảy ra khi hủy lệnh trong thời điểm máy chủ chịu tải cao.
Giải pháp:
(1) Ưu tiên hủy các lệnh quan trọng.
(2) Thử lại sau 1-2 giây.
(3) Nếu phản hồi trả về code: 0 nhưng lệnh không được hủy:
- Ghi lại yêu cầu và phản hồi đầy đủ.
- Liên hệ hỗ trợ khách hàng và cung cấp thông tin tài khoản chính/phụ để được hỗ trợ.
Q4: Lỗi tham số không hợp lệ
Nguyên nhân: Điều này thường xảy ra khi các tham số được tải lên không khớp với các loại được chỉ định trong tài liệu API.
Giải pháp: Lấy endpoint POST /spot/cancel-order làm ví dụ:
(1) So sánh nghiêm ngặt tên và loại tham số trong tài liệu API.
(2) Đặc biệt chú ý đến sự khác biệt giữa các loại số và chuỗi.
Q5: Giới hạn tốc độ API là gì?
Giới hạn tốc độ được chia thành giới hạn tốc độ ngắn hạn và dài hạn, có thể được xác định qua Response Header:
1. Giới hạn tốc độ ngắn hạn: Nếu giá trị X-RateLimit-Limit lớn hơn 0, giới hạn tốc độ ngắn hạn chưa được kích hoạt.
Giới hạn ngắn hạn sử dụng cơ chế token bucket, với giới hạn tốc độ độc lập cho tài khoản chính và phụ.
- Lỗi phổ biến sau khi kích hoạt: Code: 213, 4213
- Message: Please don't try too frequently.
2. Giới hạn tốc độ dài hạn: Nếu X-RateLimit-LongPeriod-{period}-Remaining được trả về, giới hạn tốc độ dài hạn đã được kích hoạt. Hệ thống đánh giá khối lượng và chất lượng yêu cầu của người dùng để quyết định có áp đặt giới hạn cho tổng số yêu cầu trong thời gian dài hơn hay không. Sau khi kích hoạt, tốc độ yêu cầu cho tất cả các endpoint (ngoại trừ hủy lệnh) sẽ bị giới hạn ở mức 1 yêu cầu mỗi giây.
- Lỗi phổ biến: Code: 213, 4213
- Cần kiểm tra thêm trong Response Header
Các câu hỏi phổ biến khác
Q1: Làm thế nào để giảm độ trễ yêu cầu API?
Các máy chủ được triển khai trên AWS Tokyo và hỗ trợ cân bằng tải đa vùng. Bạn có thể chọn một vùng gần để giảm thiểu độ trễ.
Các vùng khả dụng:
- ap-northeast-1a
- ap-northeast-1c
- ap-northeast-1d
Q2: Có cần 2FA cho việc rút tiền qua API không?
Vì lý do bảo mật:
1. Trước khi sử dụng rút tiền qua API, bạn phải đăng nhập và xác thực qua 2FA.
2. Sau khi thêm địa chỉ rút tiền vào [Danh sách trắng rút tiền], bạn có thể khởi tạo rút tiền qua API mà không cần xác minh 2FA thêm.
Q3: Có thể thêm địa chỉ danh sách trắng rút tiền qua API không?
Hiện tại, việc thêm địa chỉ danh sách trắng rút tiền qua API không được hỗ trợ. Vui lòng truy cập [Quản lý API] > [Danh sách trắng rút tiền] để thêm địa chỉ thủ công hoặc hàng loạt.
Q4: Lỗi chữ ký không chính xác
Giải pháp:
1. Kiểm tra xem access_id và secret_key có được cấu hình chính xác không.
2. Xác minh xem phần thân yêu cầu và các tham số được sử dụng để tạo chữ ký có giống nhau không. Tiền xử lý các tham số yêu cầu dưới dạng chuỗi và đảm bảo tính nhất quán trước và sau khi ký.
3. Nếu sử dụng thư viện bên thứ ba để ký, hãy đảm bảo nó được cấu hình đúng.
Q5: Lỗi kiểm tra tonce - Tonce chính xác phải nằm trong khoảng một phút so với thời gian hiện tại
Giải pháp:
(1) Đảm bảo rằng dấu thời gian cho tất cả các yêu cầu API là tính bằng mili giây.
Ví dụ:
(2) Xác minh rằng máy tính của bạn đã bật đồng bộ hóa thời gian tự động.
Q6: Làm thế nào để lấy số dư khả dụng thực tế và giá trị ròng của tài khoản futures?
(1) Sử dụng endpoint /assets/futures/balance để lấy trường available, cho biết số dư khả dụng hiện tại của tài khoản futures.
(2) Các endpoint API hiện không hỗ trợ trả về giá trị ròng của tài khoản. Giá trị ròng là tổng của lợi nhuận và thua lỗ đã thực hiện và chưa thực hiện.
(3) Lợi nhuận và thua lỗ chưa thực hiện không phải là giá trị cố định và có thể dao động theo thay đổi vị thế. Cần tính toán thủ công để có kết quả chính xác.
(4) Để biết công thức tính toán, hãy tham khảo tài liệu "Cách tính Thu nhập tài khoản và PNL của Hợp đồng tuyến tính".
Q7: Làm thế nào để xử lý dữ liệu được trả về bởi API WebSocket?
API WebSocket trả về dữ liệu ở định dạng chuỗi JSON nén, phải được giải nén trước khi sử dụng (ví dụ: sử dụng module gzip).
Lỗi phổ biến:
utf-8 codec can't decode byte 0x8b in position 1: invalid start byte
Q8: Phải làm gì nếu nền tảng thuế bên thứ ba báo lỗi?
Dịch vụ V1 đã ngừng hoạt động vào ngày 25 tháng 9 năm 2024. Lỗi có thể do nền tảng không nâng cấp mã của họ lên V2. Vui lòng liên hệ với nền tảng thuế liên quan để được hỗ trợ.
Q9: Làm thế nào để xác nhận kết nối WebSocket thành công?
Khi đăng ký thành công, bạn sẽ nhận được phản hồi kết quả đăng ký.
Sau đó, bạn sẽ nhận được các cập nhật thông báo đã đăng ký:
Q10: Tại sao kết nối WebSocket tự động ngắt kết nối? Làm thế nào để duy trì kết nối?
(1) Ngắt kết nối WebSocket thường do vấn đề mạng. Vui lòng kiểm tra xem kết nối mạng có ổn định không.
(2) Để duy trì kết nối WebSocket, bạn cần sử dụng server.ping để giữ nó hoạt động.
(3) Nếu không có giao tiếp với máy chủ trong 1 phút, kết nối WebSocket sẽ tự động ngắt kết nối. Khuyến nghị thiết lập khoảng thời gian gửi trong vòng 60 giây qua giao diện ping để giữ kết nối hoạt động.
Đối với các lỗi API khác, vui lòng nhấp vào ĐÂY để liên hệ hỗ trợ khách hàng và cung cấp thông tin sau để giúp giải quyết vấn đề:
(1) Email của tài khoản chính hoặc tên người dùng của tài khoản phụ.
(2) Chi tiết yêu cầu và phản hồi đầy đủ.
Quan trọng: KHÔNG chia sẻ access_id và secret_key trong thông báo lỗi để tránh tổn thất không cần thiết.