Hướng dẫn OKX API: tạo key, phân quyền, giao dịch tự động

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ý.

Cập nhật lần cuối 2026-11
Công bố: link đăng ký OKX trong bài là link đối tác của Blave. Nếu bạn đăng ký qua link này, Blave có thể nhận hoa hồng.

Chưa có tài khoản OKX? Đăng ký OKX

Điểm chính
  • API key của OKX gồm ba thứ: API key, secret key và passphrase. Passphrase do bạn tự đặt, quên thì chỉ có thể xóa key và tạo lại.
  • Giao dịch tự động chỉ cần quyền Read và Trade. Không bao giờ bật Withdraw.
  • Key có quyền giao dịch mà không gắn IP sẽ bị OKX tự xóa sau 14 ngày không hoạt động.
  • Lệnh báo quá thời gian 50004 hoặc 51149 không có nghĩa là chưa khớp. Hãy kiểm tra lệnh trước, đừng gửi lại ngay.

OKX API là gì?

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.

Tạo API key OKX thế nào?

Đăng ký tài khoản OKX
Không bao giờ bật quyền rút tiền. Giao dịch tự động chỉ cần quyền đọc và giao dịch. Dù key bị lộ, không có quyền rút tiền thì không ai chuyển được coin của bạn đi.
  1. Đăng nhập OKX trên web, vào Profile → API and connections, bấm Create API key.
  2. Điền tên cho API key, chọn tài khoản và mục đích sử dụng.
  3. Đặt danh sách IP trắng (xem phần tiếp theo).
  4. Quyền chọn Read và Trade, không chọn Withdraw.
  5. Đặt passphrase và ghi lại. OKX sẽ không hiện lại sau khi tạo.
  6. Hoàn tất xác minh bảo mật, ghi lại API key và secret key, cất ở nơi an toàn.

Đư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.

Có nên đặt danh sách IP trắng không?

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.

Các mã lỗi OKX API hay gặp

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ĩaCá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
50111API 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
50113Chữ ký không hợp lệThường do dán sai secret key, dán lại một lần
50105Passphrase saiĐiền cái bạn tự đặt khi tạo key, không phải mật khẩu đăng nhập
50110IP không có trong danh sách trắngThêm IP mới của máy chạy chương trình vào danh sách trắng
50119Key không tồn tạiCó thể đã bị xóa (ví dụ do quy tắc 14 ngày), tạo key mới
50100API bị đóng băngLiê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
51010Chế độ 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
51008Không đủ ký quỹNạp thêm tiền hoặc giảm số tiền của chiến lược
51020Thấp hơn khối lượng đặt lệnh tối thiểuTă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
50102Dấ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
50004Yê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
50001Dịch vụ tạm thời không khả dụngĐừng gửi lại, kiểm tra lệnh trước
50026Lỗ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.

Nối OKX qua Blave Agent, không cần tự xử lý những việc này

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ính

Cá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.

Câu hỏi thường gặp

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.

Nói trước về rủi ro

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.