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 đã thiết lập khi đăng ký mã API. Bạn cần tự ghi nhớ thông tin này. Nếu quên passphrase, bạn sẽ không thể khôi phục lại và cần tạo mã API mới.
Làm thế nào để tạo mã API?
Trên ứng dụng:
1. Đăng nhập tài khoản OKX > Chọn Menu > Cuộn xuống và chọn API > Tạo mã API.
2. Điền Tên API > Chọn Tài khoản và Mục đích sử dụng > Nhập danh sách cho phép địa chỉ IP > Chọn Quyền > nhập Passphrase.
Trên trang web:
1. Đăng nhập tài khoản OKX > Vào Hồ sơ > Chọn API và kết nối > Tạo mã API.
2. Điền Tên mã API > Chọn Tài khoản và Mục đích sử dụng
3. Nhập danh sách cho phép địa chỉ IP > chọn Quyền > nhập Passphrase.
Lưu ý:
Địa chỉ IP giúp bảo vệ mã API của bạn. Bạn có thể liên kết tối đa 20 địa chỉ IP cho mỗi mã API, được ngăn cách bằng dấu phẩy hoặc dấu cách.
Bạn sẽ cần passphrase để xem thông tin API và truy cập giao diện liên quan. Hãy lưu giữ thông tin này cẩn thận. Nếu bị mất, bạn sẽ cần tạo mã API mới vì hệ thống không hỗ trợ khôi phục.
Làm thế nào để tạo mã API cho giao dịch mô phỏng?
Để giao dịch qua API trong môi trường giao dịch mô phỏng, bạn cần tạo mã API riêng cho tài khoản mô phỏng. Thực hiện theo các bước sau:
Đăng nhập tài khoản OKX > Giao dịch > Giao dịch mô phỏng > Trung tâm cá nhân > Tạo mã API tài khoản mô phỏng > Bắt đầu giao dịch mô phỏng
Mã API có hết hạn không?
Hệ thống sẽ tự động xoá những mã API không liên kết địa chỉ IP và có quyền giao dịch hoặc rút tiền sau 14 ngày không hoạt động. Một mã API sẽ không bị xem là không hoạt động nếu vẫn được dùng để gọi các API riêng tư hoặc các API liên quan đến tài khoản cần xác minh danh tính. Ví dụ: xem số dư tài khoản, dữ liệu sao kê hoặc đặt lệnh.
Chỉ mã API chỉ đọc có gắn IP hoặc quyền riêng mới 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.
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 mã API không khớp với môi trường hiện tại. Lệnh gọi trên tài khoản thật phải dùng mã API của tài khoản thật và giá trị x-simulated-trading trong header phải là 0. Lệnh gọi trên tài khoản mô phỏng phải dùng mã API của tài khoản mô phỏng và giá trị x-simulated-trading trong header phải là 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.
Cách nhận giá giao dịch mới nhất của một cặp tiền nhất định?
Chi tiết sử dụng tại đây cho các ticker (tickers) và đối với ticker, xem tại đây. Giao diện tickers được dùng để lấy giá giao dịch mới nhất của nhiều cặp tiền cùng lúc, còn ticker được dùng để lấy giá giao dịch mới nhất các cặp tiền riêng lẻ.
Ví dụ về thông số phản hồi của giá giao dịch gần nhất trong mục Tickers