Ví Web3 & Công cụ
API demo OKX: tạo key riêng, dùng header và xử lý lỗi thường gặp
Thiết lập API demo OKX bằng khóa riêng, đúng endpoint theo khu vực và header x-simulated-trading; kiểm tra lỗi môi trường, timestamp và chế độ tài khoản.
API demo OKX dùng để kiểm thử kết nối và vòng đời lệnh với tài sản mô phỏng. Quy tắc đầu tiên là tách khóa demo khỏi khóa thật, dùng đúng endpoint theo khu vực và gửi x-simulated-trading: 1 trong request REST demo. Một lần gọi thành công không chứng minh chiến lược sẽ có lãi hoặc khớp giống thị trường thật.
Nếu chỉ muốn tìm màn hình đặt lệnh, hãy bắt đầu với cách mở demo trên web và app. Bài này dành cho người kết nối chương trình với API và cần kiểm soát ranh giới giữa môi trường mô phỏng và tài khoản thật.
Ảnh tài liệu công khai được chụp ngày 10/09/2026, kiểm tra lại ngày 27/09/2026. Ảnh không chứa thông tin tài khoản hoặc khóa truy cập; endpoint phải được đối chiếu với tài liệu áp dụng cho khu vực của bạn.
Thiết lập lần đầu theo năm bước
- Đăng nhập OKX và chuyển sang Trade → Demo Trading.
- Tìm Personal Center → Demo Trading API để tạo khóa cho môi trường demo.
- Chỉ cấp quyền cần cho bài kiểm thử; không sao chép cấu hình khóa thật sang đây.
- Lấy địa chỉ REST và WebSocket từ tài liệu áp dụng cho khu vực của tài khoản.
- Thêm
x-simulated-trading: 1và bắt đầu bằng một request chỉ đọc trước khi thử đặt lệnh mô phỏng.
Tên menu có thể đổi. Nếu đường dẫn hoặc máy chủ khác tài liệu bạn đang đọc, dừng và kiểm tra lại khu vực; đừng thử tuần tự nhiều máy chủ với cùng một bộ thông tin xác thực.
Tách cấu hình demo và tài khoản thật
Dùng tệp cấu hình hoặc mục lưu bí mật riêng, tên biến rõ ràng và một nhãn môi trường nhìn thấy được trong chương trình. Khi tên môi trường không hợp lệ, chương trình nên dừng thay vì tự chuyển sang live.
| Mục cần kiểm tra | Demo | Tài khoản thật |
|---|---|---|
| Khóa API | Tạo trong Demo Trading API | Tạo trong phần API của tài khoản thật |
| Header môi trường | x-simulated-trading: 1 |
Không dùng giá trị demo |
| Tài sản | Mô phỏng | Có giá trị thật |
| WebSocket | Máy chủ demo theo khu vực | Máy chủ production theo khu vực |
| Nạp và rút để thử kết nối | Không được hỗ trợ | Có thể chuyển tài sản thật, không dùng làm bài thử kết nối |
Đọc thêm quyền hạn và bảo mật API key. Không ghi khóa, secret, passphrase hoặc chữ ký vào mã nguồn, ảnh chụp, nhật ký hay hội thoại hỗ trợ.
Chọn endpoint REST và WebSocket nào?
Tài liệu toàn cầu được kiểm tra liệt kê REST https://openapi.okx.com và các kênh WebSocket demo trên wspap.okx.com. Tài liệu Mỹ dùng máy chủ khu vực khác, như https://us.okx.com và wsuspap.okx.com. Đó là ví dụ cho sự khác biệt, không phải một danh sách để thử tùy ý.
Kiểm tra đồng thời nơi tạo khóa, khu vực tài khoản và địa chỉ máy chủ. Với WebSocket, chọn đường dẫn public, private hoặc business theo loại kênh đang đăng ký; không giả định mọi dữ liệu đều nằm ở public.
Header x-simulated-trading làm gì?
Request REST demo cần có header:
Content-Type: application/json
x-simulated-trading: 1
Header này xác định môi trường, không thay thế xác thực. Request riêng tư vẫn cần thông tin xác thực và chữ ký đúng. Tạo timestamp và chữ ký tại thời điểm gửi, tránh tái sử dụng một request đã ký sau khi nó nằm chờ quá lâu.
Trước request đặt lệnh đầu tiên, xác nhận chương trình ghi rõ DEMO, khóa được tạo trong demo, máy chủ đúng khu vực và dữ liệu trả về thuộc môi trường mô phỏng. Chỉ sau đó mới thử một lệnh ảo nhỏ, đọc trạng thái, rồi hủy hoặc đóng để kiểm tra toàn bộ vòng đời.
Xử lý ba lỗi cấu hình thường gặp
Lỗi 50101: khóa không khớp môi trường
Đối chiếu nguồn của khóa, máy chủ và header môi trường. Sửa một thành phần trong khi hai thành phần còn lại vẫn sai có thể giữ nguyên lỗi. Không khắc phục bằng cách thử khóa thật trong chương trình demo.
Lỗi 50102: timestamp hết hạn
Kiểm tra đồng hồ máy và thời gian máy chủ theo API FAQ. Tạo timestamp mới ngay trước khi ký. Nếu request phải chờ hàng đợi hoặc được thử lại, không gửi nguyên chữ ký cũ như thể thời gian chưa trôi qua.
Lỗi 51010: chế độ tài khoản không hỗ trợ request
Kiểm tra sản phẩm và chế độ tài khoản. Tài liệu OKX yêu cầu lần thiết lập chế độ đầu tiên thực hiện trên web hoặc app. Đọc các chế độ tài khoản OKX trước khi đổi thiết lập chỉ để làm một lỗi biến mất.
Khi ghi nhận lỗi, lưu mã lỗi và mã request nếu có. Che thông tin xác thực trước khi chia sẻ nhật ký; một lỗi kết nối không phải lý do mở rộng quyền API không cần thiết.
Demo không kiểm thử được những chức năng nào?
Tài liệu nêu các chức năng không hỗ trợ, gồm nạp, rút và mua/hoàn trả một số sản phẩm. Một lỗi ở các đường dẫn này không chứng minh code nạp rút hay Earn của bạn đã đúng. Tách chúng thành bài kiểm thử riêng dựa trên tài liệu, mô phỏng phần mềm và quy trình kiểm soát phù hợp.
Một bài thử demo có ích khi chứng minh chương trình xác thực đúng, chọn đúng môi trường, đọc trạng thái và không gửi lặp lệnh ngoài ý muốn. Nó không chứng minh thanh khoản, trượt giá, độ trễ hoặc lợi nhuận trong tài khoản thật.
Kiểm tra trước khi thay đổi môi trường
- Khóa và cấu hình demo được lưu riêng.
- Môi trường không xác định khiến chương trình dừng.
- Khối lượng và giá có giới hạn độc lập với tín hiệu chiến lược.
- Timeout được xử lý bằng đối chiếu trạng thái, không gửi lặp một lệnh theo phản xạ.
- Nhật ký không chứa bí mật hoặc chữ ký.
- Có cách dừng chương trình và thu hồi khóa khi cần.
Không cần chuyển sang tiền thật chỉ vì bài thử đã chạy được. Nếu chỉ gặp vấn đề số dư hoặc tính năng trên màn hình, xem FAQ demo và reset số dư.
Nguồn chính thức
Các nguồn được kiểm tra ngày 27/09/2026. Bài viết mang tính giáo dục; API có quyền giao dịch có thể đặt lệnh. OKAVG độc lập và không liên kết chính thức với OKX.