Câu hỏi thường gặp về API của OKX

Passphrase nghĩa là gì?

Đây là mật khẩu bạn đã điền khi đăng ký APIKey. Bạn cần tự ghi nhớ thông tin này. Nếu quên, bạn sẽ không thể lấy lại và sẽ cần tạo một APIKey mới.

Cách tạo APIKey đĩa mô phỏng?

Để giao dịch trên API đĩa mô phỏng, bạn cần tạo APIKey trên đĩa mô phỏng. Bạn chỉ cần làm theo các bước sau:

Đăng nhập vào Tài khoản OKX > Giao dịch > Giao dịch mô phỏng > Trung tâm cá nhân > Tạo APIKey tài khoản mô phỏng > Bắt đầu giao dịch mô phỏng

APIKey có hết hạn không?

APIKey không liên kết với IP và có quyền giao dịch hoặc rút tiền sẽ tự động bị xóa sau 14 ngày không hoạt động. APIKey sẽ không bị coi là không hoạt động nếu được sử dụng để gọi giao diện riêng tư hoặc liên quan đến tài khoản yêu cầu xác minh danh tính, chẳng hạn như xem số dư tài khoản, dữ liệu hóa đơn hoặc đặt lệnh.

Chỉ có APIKey read-only được liên kết với IP hoặc các quyền cụ thể sẽ không hết hạn.

Có thể đặt lệnh theo đơn vị tiền tệ khi thực hiện lệnh qua giao diện không?

Không; đối với lệnh hợp đồng, giao diện mặc định là lệnh theo số hợp đồng. Nếu cần tính toán chuyển đổi giữa số lượng hợp đồng và coin, bạn có thể tham khảo giao diện chuyển đổi số lượng hợp đồng sang coin tại đây.

Cách lấy tỷ lệ biến động của giao diện?

Giao diện không thể trực tiếp lấy mức tăng hoặc giảm giá, nhưng có thể tính bằng công thức tính toán.

Giá trị tăng và giảm của giá giao dịch mới nhất so với giá mở của biểu đồ nến 24 giờ trước/100% giá mở của biểu đồ nến 24 giờ trước.

Bạn có thể lấy dữ liệu công thức trên thông qua giao diện thị trường tại đây (mới nhất-mở 24 giờ)/mở 24 giờ.

Lý do nào dẫn đến thông báo lỗi "51000 Parameter posSide error" khi đặt lệnh?

Trước tiên, bạn cần kiểm tra chế độ tài khoản; chế độ mua và bán/chế độ mở và đóng, có thể xem tại đây để lấy PosMode.

Lưu ý:

• Trong trường hợp mở và đóng vị thế cũng như đặt lệnh bằng hợp đồng, thông số posSide là bắt buộc và vị thế mua hoặc vị thế bán sẽ được khớp.

• Nếu đó là chế độ mua và bán, hoặc giao dịch crypto hoặc giao dịch đòn bẩy được thực hiện trong chế độ mở và đóng, posSide chỉ hỗ trợ giao dịch ròng hoặc không truyền.

Có thể sử dụng giao diện nào để lấy face value hợp đồng và số lượng lệnh tối thiểu?

Bạn có thể sử dụng giao diện này để lấy thông tin cơ bản về các sản phẩm giao dịch tại đây.

face value hợp đồng: ctVal, số lượng lệnh tối thiểu: minSz.

Định dạng của instId là gì?

Bạn có thể trực tiếp sử dụng giao diện này để lấy thông tin cơ bản về các sản phẩm giao dịch tại đây.

Cách thiết lập lệnh dừng lỗ và chốt lời?

Nếu lệnh có kèm theo chốt lời dừng lỗ thì bạn có thể tham khảo giao diện lệnh tại đây: đính kèm thông số mảng AlgoOrds.

Tuy nhiên, nếu đó là lệnh dừng lỗ riêng biệt, bạn có thể tham khảo giao diện hoa hồng chiến lược tại đây.

Tại sao có lỗi được báo cáo khi thiết lập giá kích hoạt cho lệnh chốt lời và dừng lỗ: 51046, 51047, 51048, 51049?

Quy tắc thiết lập giá kích hoạt lệnh dừng lỗ/giá kích hoạt lệnh chốt lời – trong khi bán, giá kích hoạt lệnh chốt lời cao hơn giá giao dịch mới nhất và giá kích hoạt lệnh dừng lỗ thấp hơn giá giao dịch mới nhất; trong khi mua, giá kích hoạt lệnh chốt lời thấp hơn giá giao dịch mới nhất và giá kích hoạt lệnh dừng lỗ cao hơn giá giao dịch mới nhất.

"Lỗi giao diện: 50102 Yêu cầu dấu thời gian đã hết hạn" là gì?

Lỗi này xảy ra khi dấu thời gian đã hết hạn. Bạn cần gọi giao diện thời gian hệ thống tại đây để đồng bộ hóa thời gian cục bộ với thời gian trên máy chủ của chúng tôi. Việc giữ chênh lệch thời gian trong vòng 30 giây có thể giúp tránh được sự cố này.

Lưu ý: thời gian trong tiêu đề yêu cầu là theo UTC0. Khi gọi giao diện thời gian máy chủ, thời gian được cung cấp theo giờ UTC + 8.

"Lỗi giao diện: 50101 APIKey không khớp với môi trường hiện tại" là gì?

Điều này là do APIKey và môi trường hiện tại không khớp nhau. Các lệnh gọi tài khoản thật yêu cầu sử dụng APIKey của tài khoản thật, đồng thời giá trị của thông số x-simulated-trading trong phần request header phải được đặt là 0. Lệnh gọi tài khoản mô phỏng yêu cầu sử dụng APIKey của tài khoản mô phỏng và giá trị của thông số giao dịch mô phỏng x trong tiêu đề yêu cầu cần phải bằng 1.

"Lỗi giao diện: 51010 Yêu cầu không được hỗ trợ ở chế độ tài khoản hiện tại" là gì?

Điều này liên quan đến chế độ tài khoản của bạn. Nếu bạn muốn đặt một hợp đồng hoặc đòn bẩy đơn tệ, bạn cần điều chỉnh sang ba chế độ khác ngoại trừ chế độ spot! Bạn có thể thiết lập thông qua cài đặt giao diện tại đây hoặc có thể thiết lập trên web hoặc ứng dụng.

Lưu ý: Cài đặt đầu tiên phải được thiết lập trên trang hoặc ứng dụng; tùy chọn cài đặt trên menu chính của trang giao dịch - Chế độ tài khoản.

"Lỗi giao diện: 51121 Số lượng lệnh phải là bội số của kích thước lot" là gì?

Trong API, hợp đồng lệnh được tính theo đơn vị của bảng và phải là bội số số số lệnh tối thiểu của đồng tiền cặp. Bạn có thể nhận số lượng lệnh tối thiểu thông qua trường minSz của giao diện sản phẩm tại đây.

"Lỗi rút tiền: 58207 Địa chỉ rút tiền không nằm trong whitelist để được miễn xác minh; tại sao việc xác minh danh sách cho phép vẫn báo cáo lỗi khi bị đóng trên trang rút tiền?

Để rút coin bằng giao diện API, bạn cần thêm địa chỉ rút tiền trên trang và kiểm tra nút chưa được xác minh bằng visa. Việc xác minh danh sách cho phép đã bị tắt trên trang sẽ không ảnh hưởng đến chức năng giao diện.

"Lỗi giao diện: 50004 API điểm cuối yêu cầu hết thời gian chờ" là gì (không có nghĩa là yêu cầu thành công hoặc không thành công, vui lòng kiểm tra kết quả yêu cầu)?

50004 thường là do áp lực máy chủ quá mức. 8, 16 và 24 giờ sáng là những điểm thời gian thu phí vốn mỗi ngày. Tại thời điểm này, áp lực máy chủ đang ở mức cao. Nên xen kẽ các giao dịch vào những thời điểm này. Nếu lỗi 50004 được báo cáo vào thời điểm khác, bạn có thể thử lại sau. Nếu lệnh được đặt với lỗi 50004, sẽ không thể hiện kết quả thực tế của yêu cầu giao diện. Yêu cầu có thể thành công hoặc không thành công. Vui lòng tham khảo kết quả thực tế.

Lưu ý: nếu có bất kỳ câu hỏi hoặc thắc mắc nào khác liên quan đến API, bạn có thể liên hệ với chúng tôi bằng cách quét mã bên dưới thông qua ứng dụng.

Lỗi "50119 API key doesn't exist" là gì?

Lỗi này thường xảy ra khi miền tài khoản của bạn không khớp với khu vực mà bạn đang sử dụng.

• Đối với người dùng EEA, vui lòng thay đổi tên miền yêu cầu API thành eea.okx.com thay vì www.okx.com.

• Đối với người dùng US, vui lòng thay đổi tên miền yêu cầu API thành us.okx.com thay vì www.okx.com.

• Nếu bạn đang sử dụng phần mềm của bên thứ ba để kết nối với OKX và thấy lỗi này, vui lòng kiểm tra với nhà cung cấp phần mềm xem họ có hỗ trợ tên miền khu vực hay không. Ví dụ: người dùng EEA phải kết nối thông qua eea.okx.com, nếu không, yêu cầu sẽ không thành công.

Tại sao lại hiển thị lỗi "50110" khi liên kết với phần mềm của bên thứ ba?

Lỗi này có thể xảy ra nếu loại mã API hiện tại không tương thích với phần mềm liên kết bên thứ ba. Hãy thử đăng ký loại giao dịch mã API mà không liên kết danh sách IP, rồi kết nối lại phần mềm bên thứ ba.