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 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 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 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ẽ bị thất bại.
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 Mã
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
Tôi nên làm gì nếu WebSocket không thể kết nối hoặc liên tục bị ngắt kết nối?
Xác nhận rằng bạn đang sử dụng đúng URL WebSocket cho trang web và dịch vụ API của mình. Kiểm tra mạng lưới, proxy, cài đặt TLS, tham số đăng ký, cơ chế Ping/Pong heartbeat và logic kết nối lại. Nếu sự cố vẫn tiếp diễn, vui lòng cung cấp kênh, thời gian xảy ra, thông báo lỗi đầy đủ và nhật ký đã được làm mờ thông tin nhạy cảm.
Tôi nên xử lý lỗi mã API hoặc tham số yêu cầu không hợp lệ như thế nào?
Tra cứu mã lỗi trong tài liệu API chính thức của trang web bạn, sau đó xác minh endpoint, phương thức HTTP, tham số yêu cầu, chế độ tài khoản và các hạn chế sản phẩm. Nếu nguyên nhân vẫn chưa rõ, hãy cung cấp mã lỗi đầy đủ, sCode/sMsg, thời gian xảy ra, cùng với yêu cầu và phản hồi đã được chỉnh sửa.
Tại sao việc đặt lệnh, sửa đổi hoặc hủy lệnh qua API của tôi lại thất bại?
Vui lòng sử dụng thông báo lỗi và mã lỗi do API trả về để xác định nguyên nhân cụ thể. Nếu bạn không chắc lỗi có ý nghĩa gì, vui lòng cung cấp đầy đủ các tham số yêu cầu và chi tiết lỗi để chúng tôi có thể điều tra thêm.
Tôi nên làm gì nếu dữ liệu thị trường, nến hoặc dữ liệu sổ lệnh có vẻ không chính xác?
Xác nhận tên kênh, instId, các tham số đăng ký và tần suất yêu cầu, đồng thời phân biệt dữ liệu snapshot với các cập nhật tăng dần. Đối với sổ lệnh, cũng cần xác minh các ID chuỗi và dấu thời gian. Nếu dữ liệu có vẻ bị thiếu, hãy ghi lại kênh, khoảng thời gian và phản hồi thô đã được chỉnh sửa.
Tại sao số dư API, vị thế hoặc giá trị ký quỹ lại khác với trên website hoặc ứng dụng?
Trước tiên phân biệt giữa tài khoản Giao dịch và tài khoản Funding, sau đó xác minh chế độ tài khoản, chiều đồng tiền, endpoint và thời gian cập nhật dữ liệu. Đối với các phép tính số dư, vị thế và ký quỹ, hãy sử dụng tài liệu sản phẩm và API mới nhất cho trang web áp dụng.
Tôi nên làm gì nếu một giao dịch nạp, rút tiền hoặc chuyển tiền qua API bị thất bại?
Kiểm tra quyền API, đồng tiền, mạng lưới, tài khoản đích, cũng như các yêu cầu về sổ địa chỉ hoặc danh sách trắng, sau đó khắc phục sự cố bằng cách sử dụng mã lỗi trả về. Các hạn chế về bảo mật tài khoản, tuân thủ hoặc rủi ro có thể cần được bộ phận hỗ trợ xem xét thêm cho trang web áp dụng.
Làm thế nào để tôi tạo và sử dụng mã API cho một tài khoản phụ?
Tạo mã API dưới tài khoản phụ dự định và sử dụng quyền hạn, Mật khẩu, cùng tên miền trang web của tài khoản phụ đó. Không được trộn lẫn mã API, Bí mật hoặc Mật khẩu của tài khoản chính và tài khoản phụ.
Tôi nên làm gì sau khi kích hoạt giới hạn tốc độ API?
Giảm tốc độ gửi yêu cầu theo giới hạn của endpoint cụ thể, và sử dụng hàng đợi yêu cầu, lùi lại theo cấp số nhân, hoặc các endpoint theo lô khi thích hợp. Phạm vi và hạn mức giới hạn tốc độ có thể khác nhau tùy theo endpoint, vì vậy đừng giả định tất cả các endpoint đều có cùng hạn mức.
Tôi có thể tìm tài liệu API, SDK và ví dụ mã ở đâu?
Bạn có thể tham khảo Tài liệu API (V5). Tham khảo REST + WebSocket, nhật ký thay đổi, mã lỗi, mẫu yêu cầu/phản hồi cho từng endpoint. SDK chính thức (GitHub) — github.com/okxapi Ví dụ mã nguồn có thể tìm thấy trong SDK.
Tôi nên cung cấp những thông tin gì nếu tôi chỉ có thể nói “API không hoạt động”?
Cung cấp endpoint, phương thức HTTP, thao tác dự kiến, mã lỗi hoặc thông báo lỗi đầy đủ, thời gian xảy ra, trang tài khoản, môi trường mạng lưới và yêu cầu cùng phản hồi đã được che mờ. Không bao giờ gửi API Secret, Passphrase, mã xác minh hoặc chữ ký chưa được che mờ.
Tôi nên làm gì nếu vẫn còn thắc mắc về API? Hay tôi có thể trò chuyện với CS API không?
Nếu bạn có bất kỳ câu hỏi nào khác, bạn có thể tham gia nhóm hỗ trợ API của chúng tôi:
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.