Từ tạo API key, chọn quyền, đặt danh sách IP trắng, đến ý nghĩa từng mã lỗi khi lệnh bị từ chối và cách xử lý.
Chưa có tài khoản OKX? Đăng ký OKX
OKX API là giao diện để chương trình làm việc trực tiếp với tài khoản OKX: xem số dư, xem vị thế, đặt lệnh, hủy lệnh mà không cần mở web. Chương trình giao dịch tự động đặt lệnh theo quy tắc qua API.
Muốn dùng API thì phải tạo một key. Chương trình dùng key này để chứng minh "tôi được tài khoản này cấp quyền". Key làm được gì tùy vào quyền bạn bật khi tạo.
Đưa cả ba cho chương trình giao dịch tự động, thiếu một thứ là không kết nối được.
Mục API FAQ chính thức của OKX ghi rõ: key có quyền giao dịch hoặc rút tiền mà không gắn IP sẽ bị tự xóa sau 14 ngày không hoạt động. Gắn IP rồi thì key không hết hạn vì để lâu, và người khác có được key cũng không dùng được từ nơi khác. Một key gắn tối đa 20 IP.
Nếu gắn, hãy điền IP công khai của "máy chạy chương trình", không phải IP điện thoại hay mạng bạn lướt web hằng ngày. IP mạng ở nhà có thể đổi, đổi rồi thì phải thêm IP mới vào danh sách trắng.
Nếu dùng Blave Agent: hộp kết nối của máy chủ đám mây sẽ hiện IP của máy chủ, cứ điền theo. Bản máy tính không bắt buộc gắn, không gắn thì phải nhớ quy tắc 14 ngày.
Dưới đây là các lỗi giao dịch tự động hay gặp nhất. Ý nghĩa theo tài liệu API chính thức của OKX (51008 theo cách phân loại của chương trình đặt lệnh Blave), cách xử lý là gợi ý chung.
| Mã | Ý nghĩa | Cách xử lý |
|---|---|---|
| Nhóm thứ nhất: lỗi key và quyền, bị từ chối ngay khi kết nối hoặc đặt lệnh | ||
| 50111 | API key không hợp lệ | Kiểm tra có dán sai không, đầu cuối có thừa khoảng trắng không |
| 50113 | Chữ ký không hợp lệ | Thường do dán sai secret key, dán lại một lần |
| 50105 | Passphrase sai | Điền cái bạn tự đặt khi tạo key, không phải mật khẩu đăng nhập |
| 50110 | IP không có trong danh sách trắng | Thêm IP mới của máy chạy chương trình vào danh sách trắng |
| 50119 | Key không tồn tại | Có thể đã bị xóa (ví dụ do quy tắc 14 ngày), tạo key mới |
| 50100 | API bị đóng băng | Liên hệ bộ phận hỗ trợ của OKX |
| Nhóm thứ hai: key không có vấn đề, nhưng bản thân lệnh này không gửi được | ||
| 51010 | Chế độ tài khoản hiện tại không hỗ trợ | Spot mode không giao dịch hợp đồng được, vào phần cài đặt chế độ tài khoản đổi sang chế độ có hỗ trợ hợp đồng |
| 51008 | Không đủ ký quỹ | Nạp thêm tiền hoặc giảm số tiền của chiến lược |
| 51020 | Thấp hơn khối lượng đặt lệnh tối thiểu | Tăng số tiền của chiến lược, hoặc đổi sang coin có đơn vị tối thiểu nhỏ hơn |
| 50102 | Dấu thời gian của yêu cầu đã hết hạn | Đồng hồ máy chạy chương trình bị lệch, bật đồng bộ giờ tự động |
| Nhóm thứ ba: kết quả không chắc chắn, cần cẩn thận nhất | ||
| 50004 | Yêu cầu API quá thời gian | Đừng gửi lại, kiểm tra lệnh trước |
| 51149 | Đặt lệnh quá thời gian | Đừng gửi lại, kiểm tra lệnh trước |
| 50001 | Dịch vụ tạm thời không khả dụng | Đừng gửi lại, kiểm tra lệnh trước |
| 50026 | Lỗi hệ thống | Đừng gửi lại, kiểm tra lệnh trước |
Tài liệu OKX ghi rõ 50004 và 51149 "không có nghĩa là yêu cầu thành công hay thất bại". Lệnh có thể đã khớp, gửi lại ngay sẽ thành đặt hai lần. Gặp bốn mã này, Blave Agent không bao giờ gửi lại cùng một lệnh: lệnh thị trường hợp đồng sẽ quay lại kiểm tra lệnh đó đã khớp chưa rồi mới quyết định bước tiếp theo. Các lệnh khác sẽ dừng lại và báo cáo, không tự thử lại.
Nếu tự viết chương trình kết nối OKX API, đây là chỗ dễ xảy ra sự cố nhất.
Toàn bộ phần xử lý lỗi ở trên, gồm tự đồng bộ giờ với OKX khi gặp 50102 và không gửi lại khi quá thời gian, chương trình đặt lệnh của Blave Agent đã làm sẵn. Bạn chỉ cần dán API key, secret key và passphrase vào Giao dịch tự động › Kết nối tài khoản › OKX, chiến lược sẽ đặt lệnh trên OKX theo quy tắc.
Trước khi nối tài khoản thật, nên chạy paper trading một thời gian, không cần key, vốn ban đầu 100,000 USDT.
Tải bản máy tínhCác bước đầy đủ xem ở Thiết lập key đặt lệnh của sàn giao dịch. Toàn bộ quy trình từ ý tưởng đến chạy thật xem ở Giao dịch tự động OKX: từ ý tưởng, backtest đến chạy thật.
API key có hết hạn không?
Key đã gắn IP không hết hạn vì để lâu. Key có quyền giao dịch hoặc rút tiền mà không gắn IP sẽ bị xóa sau 14 ngày không hoạt động.
Quên passphrase thì sao?
Không lấy lại được, chỉ có thể xóa key này, tạo key mới rồi dán ba thứ mới vào chương trình.
Mỗi ngày giờ nào lệnh dễ bị quá thời gian nhất?
OKX khuyên tránh 8:00, 16:00 và 24:00 mỗi ngày (giờ Đài Loan, UTC+8). Đó là giờ thanh toán funding, máy chủ chịu tải cao nhất.
API key chính là quyền giao dịch của tài khoản, đừng dán vào trang web hay chương trình không đáng tin. Không bao giờ bật quyền rút tiền, key không dùng nữa thì xóa đi. Giao dịch tự động không làm thua lỗ biến mất, nó chỉ chạy đúng theo quy tắc. Dùng đòn bẩy thì thua lỗ cũng bị khuếch đại.