Câu hỏi thường gặp về API OKX
Passphrase đề cập đến điều gì?
Đây là mật khẩu bạn đã điền khi đăng ký mã API. Bạn cần tự nhớ mật khẩu này. Nếu quên, bạn sẽ không thể lấy lại và phải tạo mã API mới.
Làm thế nào để tôi tạo mã API?
Trên Ứng dụng:
1. Đăng nhập vào Tài khoản OKX của bạn > Chọn Menu (⋮⋮⋮) > Kéo 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 > Nhập danh sách cho phép địa chỉ IP > Chọn quyền hạn > Nhập cụm mật khẩu
Trên Web:
1. Đăng nhập vào Tài khoản OKX của bạn > Vào Hồ sơ và chọn API và kết nối > Tạo mã API
2. Điền vào 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 Cụm mật khẩu
Lưu ý:
Địa chỉ IP giúp bảo mật mã API của bạn. Bạn có thể liên kết tối đa 20 địa chỉ cho mỗi mã, ngăn cách chúng bằng dấu phẩy hoặc dấu cách.
Bạn cần xem thông tin API và truy cập giao diện của nó. Vui lòng giữ mật khẩu của bạn an toàn. Bạn có thể tạo API mới nếu mất mật khẩu, vì chúng tôi không thể khôi phục các API.
Làm thế nào để tôi quản lý hoặc chỉnh sửa mã API?
Để quản lý hoặc chỉnh sửa mã API của bạn trên OKX:
Đăng nhập vào Tài khoản OKX của bạn và đi tới Hồ sơ > API.
Bạn sẽ thấy danh sách các khóa API hiện có của mình. Nhấp vào khóa bạn muốn quản lý.
Từ đây bạn có thể:
Xem tên mã API, quyền hạn và danh sách trắng IP liên kết.
Chỉnh sửa tên khóa, quyền hạn (Đọc, Giao dịch, rút tiền), hoặc địa chỉ IP đã liên kết.
Xóa khóa nếu không còn cần thiết.
Lưu ý: Bạn không thể xem lại Cụm mật khẩu sau khi tạo lần đầu. Nếu bị mất, bạn sẽ cần xóa khóa hiện tại và tạo khóa mới. Luôn lưu trữ thông tin đăng nhập của bạn một cách an toàn.
Làm thế nào để tôi phân biệt giữa giao dịch Spot và giao dịch ký quỹ nếu tôi giao dịch bằng API?
Cách phân biệt giao dịch Spot và giao dịch ký quỹ qua API có thể khác nhau tùy thuộc vào loại tài khoản và cài đặt của bạn. Chúng tôi khuyến nghị bạn tham khảo tài liệu API của OKX để có các tham số chính xác và cập nhật nhất phù hợp với cấu hình tài khoản của bạn.
Nếu bạn cần làm rõ thêm, vui lòng liên hệ với Trợ lý OKX để được hướng dẫn cá nhân hóa.
Làm thế nào để tôi tạo mã API demo disk?
Để giao dịch trên API demo disk, bạn cần tạo một mã API trên demo disk. Hãy làm theo các bước dưới đây:
Đăng nhập vào Tài khoản OKX của bạn > 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?
Các khóa API không ràng buộc 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. Các khóa API sẽ không bị coi là không hoạt động nếu chúng được sử dụng để gọi các 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 thanh toán hoặc đặt lệnh.
Chỉ các khóa API chỉ đọc được ràng buộc với một IP hoặc quyền hạn cụ thể mới không hết hạn.
Quyền Vay, sinh lời và chuyển tiền là gì?
Chuyển tiền: Cho phép khóa chuyển tiền giữa các tài khoản của bạn. Khả dụng cho tất cả các tài khoản.
Vay: Cho phép người dùng vay, hoàn trả và quản lý các khoản vay. Chỉ hiển thị nếu tài khoản của bạn đủ điều kiện sử dụng tính năng này.
Sinh lời: Cho phép khóa đăng ký và tất toán các sản phẩm sinh lời. Chỉ hiển thị nếu tài khoản của bạn đủ điều kiện tính năng yêu cầu.
Nếu API Key của bạn trước đây đã được bật quyền Giao dịch, cả ba quyền sẽ tự động được kích hoạt khi cập nhật này. Không cần thiết lập thủ công.
Có thể đặt lệnh theo đơn vị đồng tiền khi đặt lệnh qua giao diện không?
Không; đối với các lệnh hợp đồng, giao diện mặc định hiển thị số lượng theo số hợp đồng. Nếu bạn cần tính toán quy đổi giữa số hợp đồng và coin, bạn có thể tham khảo giao diện quy đổi số hợp đồng sang coin tại đây.
Làm thế nào để lấy tỷ lệ biến động của giao diện?
Giao diện không thể trực tiếp lấy được mức tăng hoặc giảm giá, nhưng có thể tính toán thông qua công thức tính.
Giá trị tăng giảm của giá giao dịch mới nhất so với giá mở cửa của nến K-line cách đây 24 giờ / 100% giá mở cửa của nến K-line cách đây 24 giờ.
Dữ liệu công thức trên có thể được lấy qua giao diện thị trường tại đây.
Lý do của thông báo lỗi "51000 Parameter posSide error" khi đặt lệnh là gì?
Bạn cần kiểm tra chế độ tài khoản trước; chế độ mua 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 sử dụng hợp đồng, tham số posSide là bắt buộc, và cần điền vị thế mua hoặc vị thế bán.
Nếu là chế độ mua bán, hoặc một giao dịch tài sản mã hóa hoặc giao dịch đòn bẩy được thực hiện theo chế độ mở và đóng, posSide chỉ hỗ trợ net hoặc không truyền.
Giao diện nào có thể được sử dụng để lấy mệnh giá hợp đồng và số lượng lệnh tối thiểu?
Bạn có thể sử dụng giao diện để lấy thông tin cơ bản về các sản phẩm giao dịch tại đây.
mệnh giá 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ể sử dụng trực tiếp giao diện để lấy thông tin cơ bản về các sản phẩm giao dịch tại đây.
Làm thế nào để đặt dừng lỗ và chốt lời?
Nếu lệnh được gắn với chốt lời dừng lỗ, bạn có thể tham khảo giao diện lệnh tại đây: các tham số mảng attachAlgoOrds.
Tuy nhiên, nếu đó là một 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 lại báo lỗi khi đặt giá kích hoạt cho chốt lời và dừng lỗ: 51046, 51047, 51048, 51049?
Quy tắc đặt giá kích hoạt dừng lỗ/giá kích hoạt chốt lời – khi bán, giá kích hoạt chốt lời phải cao hơn giá giao dịch gần nhất, và giá kích hoạt dừng lỗ phải thấp hơn giá giao dịch gần nhất; còn khi mua, giá kích hoạt chốt lời phải thấp hơn giá giao dịch gần nhất, và giá kích hoạt dừng lỗ phải cao hơn giá giao dịch gần nhất.
"Lỗi giao diện: 50102 Yêu cầu dấu thời gian đã đáo hạn" là gì?
Lỗi này xảy ra khi dấu thời gian đã đáo hạn. Bạn cần gọi giao diện thời gian hệ thống tại đây để đồng bộ thời gian cục bộ của bạn với thời gian của máy chủ chúng tôi. Giữ chênh lệch thời gian trong vòng 30 giây có thể giúp tránh vấn đề 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 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 sự không khớp giữa mã API và môi trường hiện tại. Các cuộc gọi tài khoản thực yêu cầu sử dụng mã API tài khoản thực, và giá trị của tham số x-simulated-trading trong tiêu đề yêu cầu cần là 0. Các cuộc gọi tài khoản mô phỏng yêu cầu sử dụng mã API tài khoản mô phỏng, và giá trị của tham số x-simulated-trading trong tiêu đề yêu cầu cần là 1.
"Lỗi giao diện: 51010 Yêu cầu không được hỗ trợ trong 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 đòn bẩy hoặc hợp đồng cho một đồng tiền duy nhất, bạn cần điều chỉnh sang ba chế độ còn lại, 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 bạn cũng 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 trong 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 lô là gì?
Trong API, các lệnh hợp đồng được tính theo đơn vị tờ và phải là bội số của số lượng lệnh tối thiểu của cặp đồng tiền. Số lượng lệnh tối thiểu có thể được lấy 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 không có trong danh sách cho phép để được miễn xác minh"; tại sao xác minh danh sách cho phép vẫn báo lỗi khi nó đã được tắt trên trang rút tiền?
Để rút coin qua giao diện API, bạn cần thêm địa chỉ rút trên trang và chọn nút chưa xác minh bằng visa. Việc tắt xác minh danh sách cho phép trên trang sẽ không ảnh hưởng đến chức năng của giao diện.
"Lỗi giao diện: 50004 API endpoint request timeout" có nghĩa là gì (không có nghĩa là yêu cầu đã thành công hay thất bại, vui lòng kiểm tra kết quả yêu cầu)?
Mã lỗi 50004 thường do áp lực máy chủ quá lớn gây ra. 8 giờ, 16 giờ và 24 giờ là các mốc thời gian thu phí vốn mỗi ngày. Vào những thời điểm này, áp lực máy chủ rất cao. Khuyến nghị nên tránh giao dịch đồng thời vào các khung giờ này. Nếu lỗi 50004 xuất hiện vào các thời điểm khác, bạn có thể thử lại sau. Nếu một lệnh được đặt mà gặp lỗi 50004, điều đó không phản ánh 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 thất bại. Vui lòng tham khảo kết quả thực tế.
Lỗi "50119 API key không tồn tại" 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 của bạn.
Đối với người dùng EEA, vui lòng thay đổi tên miền yêu cầu API của bạn thành eea.okx.com thay vì www.okx.com.
Đối với người dùng tại Mỹ, vui lòng thay đổi tên miền yêu cầu API của bạn thành us.okx.com thay vì www.okx.com.
Nếu bạn đang sử dụng phần mềm bên thứ ba để kết nối với OKX và gặp 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ợ các miền khu vực hay không. Ví dụ, người dùng EEA phải kết nối qua eea.okx.com, nếu không yêu cầu sẽ không thành công.
Tại sao khi liên kết với phần mềm bên thứ ba lại hiển thị lỗi "50110"?
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 việc liên kết phần mềm bên thứ ba. Hãy thử đăng ký loại giao dịch mã API, không liên kết danh sách IP, sau đó kết nối lại phần mềm bên thứ ba.
Làm thế nào để tôi có được giá giao dịch mới nhất của một cặp đồng tiền nhất định?
Sử dụng Chi tiết tại đây cho các Mã và cho Mã, xem tại đây. Giao diện Mã được sử dụng để lấy giá giao dịch mới nhất của các cặp đồng tiền theo lô, và Mã được sử dụng để lấy giá giao dịch mới nhất của từng cặp đồng tiền riêng lẻ.
Ví dụ về tham số phản hồi của giá khớp gần nhất trong phần Tickers
Yêu cầu để tạo mã API là gì?
Cần có số dư Tài sản Quản lý (AUM) tối thiểu là 100 USD để tạo mã API.
Yêu cầu có tổng tài sản quản lý (AUM) lớn hơn 100 USD (AUM > 100U) để tạo mã API
Đối với tài khoản chính hoặc tài khoản phụ, chỉ những tài khoản có AUM > 100U mới được phép tạo khóa API
Lưu ý: Yêu cầu này chỉ áp dụng cho người dùng ở một số khu vực nhất định
Lưu ý:
Nếu bạn có câu hỏi về WebSocket hoặc các chủ đề liên quan đến API khác, hãy nhấp vào liên kết bài viết và quét Mã QR ở cuối bài viết bằng ứng dụng OKX để tham gia nhóm và liên hệ với chuyên gia hỗ trợ API của chúng tôi.
Cách quét: trên ứng dụng, chạm vào Menu > biểu tượng Quét, sau đó quét mã QR.