Câu hỏi thường gặp về API OKX
Passphrase là gì?
Đây là mật khẩu bạn đã điền khi đăng ký mã API. Bạn cần tự ghi 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 mã 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âu diễn giải
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 tên mã API > Chọn tài khoản và Sử dụng cho
3. Nhập danh sách cho phép địa chỉ IP > Chọn Quyền > Nhập Câu diễn giải
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 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 cá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ỹ khi 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 thiết lập tài khoản của bạn.
Nếu bạn cần thêm sự giải thích, 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 đĩa demo?
Để 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 > 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 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. Khóa API sẽ không bị coi là không hoạt động nếu đượ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, Kiếm 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 khóa 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.
Kiếm: Cho phép khóa đăng ký và tất toán các sản phẩm Kiếm. Chỉ hiển thị nếu tài khoản của bạn có đủ đ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 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 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à vị thế mua hoặc vị thế bán được điền vào.
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ề 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 đính kèm 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 cắt 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 cắt lỗ phải thấp hơn giá giao dịch gần nhất; trong khi 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 cắt 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ộ 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 qua cài đặt giao diện tại đây, hoặc bạn 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ị hợp đồng 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, 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" 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á tải 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ị bạn nên phân bổ giao dịch tránh trùng 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 mã API 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 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ã, 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ì?
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ý, tín hiệu Ping/Pong 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 ẩn thông tin.
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 và yêu cầu cùng phản hồi đã được che mờ.
Tại sao việc đặt, sửa đổi hoặc hủy lệnh 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 đủ 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 hiển thị 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 làm mờ.
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ố dựa trên 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 tương ứng.
Làm thế nào để tôi tạo và sử dụng mã API cho 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 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 từng endpoint cụ thể, và sử dụng hàng đợi yêu cầu, phương pháp lùi thời gian 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 không nên giả định tất cả các endpoint đều có cùng mức cho phép.
Tôi có thể tìm tài liệu API, SDK và ví dụ mã ở đâu?
Bạn có thể xem 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 theo 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 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 bộ phận CS API không?
Nếu bạn có bất kỳ câu hỏi nào thêm, bạn có thể tham gia nhóm hỗ trợ API của chúng tôi:
Tôi nên làm gì nếu API giao dịch mô phỏng trả về mã lỗi 50123?
Mã lỗi 50123 có nghĩa là mã API không có quyền giao dịch crypto. Đối với giao dịch mô phỏng, hãy sử dụng mã API được tạo dưới mục Giao dịch mô phỏng, đảm bảo mã có quyền Giao dịch, sử dụng đúng miền API cho trang của bạn và bao gồm x-simulated-trading: 1 trong mỗi yêu cầu giao dịch mô phỏng. Mã chỉ có quyền Đọc có thể truy xuất dữ liệu tài khoản nhưng không thể đặt lệnh.
Tôi nên làm gì nếu một lệnh spot Demo trả về HTTP 503 và mã lỗi OKX 50001?
Mã lỗi 50001 kèm HTTP 503 có nghĩa là dịch vụ tạm thời không khả dụng. Vui lòng thử lại sau. Nếu lỗi vẫn tiếp diễn, hãy tham gia nhóm hỗ trợ API của chúng tôi để liên hệ với bộ phận CS API.
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.