Tài khoản & Đăng ký
Tôi chưa có tài khoản SSI, có thể dùng API không?
Để sử dụng API, bạn cần có tài khoản giao dịch tại SSI. Vui lòng đăng ký tài khoản theo hướng dẫn trên trang chủ.
Tôi có thể dùng API miễn phí không?
Chi phí sử dụng API sẽ được thông báo trong chính sách của SSI. Vui lòng tham khảo thêm trong tài liệu hoặc liên hệ bộ phận hỗ trợ để biết chi tiết.
Một tài khoản có thể tạo nhiều API Key không?
Có, một tài khoản có thể tạo nhiều API Key để phục vụ các ứng dụng hoặc mục đích khác nhau.
API Key & Authentication
API Key bị lộ, phải làm gì?
Nếu API Key của bạn bị lộ, ngay lập tức hãy hủy (revoke) API Key đó trong phần quản lý tài khoản và tạo một API Key mới để đảm bảo an toàn.
Tôi quên API Secret, lấy lại ở đâu?
Bạn không thể lấy lại API Secret cũ vì lý do bảo mật. Bạn cần tạo một API Key mới và sẽ nhận được Secret mới.
Token hết hạn, phải lấy lại token mới sao?
Khi token hết hạn, bạn cần gọi lại API xác thực (ví dụ: POST /api/v3/auth/token) với apiKey và apiSecret hợp lệ để nhận được access token mới.
Sao token của tôi không đặt lệnh được?
Có một số nguyên nhân phổ biến: 1. Token hết hạn: Hãy lấy token mới. 2. Không đủ quyền (scope): Đảm bảo API Key của bạn được cấp quyền trading hoặc quyền tương ứng để thực hiện giao dịch. 3. Tài khoản không đủ số dư hoặc không đáp ứng điều kiện giao dịch.
Dữ liệu & Market Data
Market Data có độ trễ không?
Dữ liệu thời gian thực (real-time) được cung cấp với độ trễ thấp nhất có thể. Có thể có một số loại dữ liệu tham chiếu hoặc lịch sử không phải là real-time. Kiểm tra mô tả cụ thể cho từng API.
Dữ liệu lịch sử có bao nhiêu năm?
Thời lượng dữ liệu lịch sử có thể khác nhau tùy theo loại dữ liệu và mã tài sản. Vui lòng tham khảo tài liệu của từng endpoint để biết giới hạn cụ thể.
Trading & Orders
Đặt lệnh báo lỗi 'Insufficient Balance'?
Lỗi này cho biết số dư tài khoản của bạn (bao gồm cả ký quỹ) không đủ để thực hiện lệnh. Hãy kiểm tra số dư khả dụng và khối lượng/giá trị lệnh đặt.
Làm sao để hủy lệnh đã đặt?
Bạn có thể hủy lệnh đã đặt bằng cách gửi yêu cầu đến endpoint hủy lệnh (ví dụ: DELETE /api/v3/trading/order/{orderId}). Lưu ý rằng không phải lệnh nào cũng có thể hủy thành công (ví dụ: lệnh đã khớp một phần).
API hỗ trợ những loại lệnh nào?
API hỗ trợ nhiều loại lệnh như Lệnh giới hạn (Limit), Lệnh thị trường (Market), Lệnh điều kiện (FCO) với các loại như Stop, Stop Limit, OCO, Good Till Date, Trailing Stop, v.v. Xem chi tiết trong Tham khảo đặt lệnh điều kiện.
Technical Issues
Lỗi 429 Too Many Requests?
Lỗi này cho biết bạn đã vượt quá giới hạn tốc độ yêu cầu (rate limit) trong một khoảng thời gian nhất định. Vui lòng giảm tần suất gọi API hoặc thực hiện theo chiến lược backoff (chờ và thử lại) như hướng dẫn trong tài liệu.
WebSocket bị disconnect liên tục?
Có thể do: 1. Token hết hạn hoặc không hợp lệ. 2. Mất kết nối mạng. 3. Không gửi được ping/pong để giữ kết nối. Hãy kiểm tra token, xác nhận kết nối mạng và thực hiện cơ chế tự động kết nối lại (reconnect) có xử lý lỗi.
Làm sao test API mà không ảnh hưởng tài khoản thật?
Bạn nên sử dụng môi trường giả lập (sandbox) hoặc tài khoản demo do SSI cung cấp để thực hiện các bài test. Nếu có, hãy sử dụng tài khoản thử nghiệm riêng biệt với số dư ảo.
Support
Gặp lỗi không tự giải quyết được, liên hệ ai?
Bạn có thể liên hệ với bộ phận hỗ trợ kỹ thuật của SSI Developer qua email hoặc các kênh được cung cấp trên trang chủ developers.ssi.com.vn.