Skip to main content

Tài khoản & Đăng ký

Để 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ủ.
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.
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

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

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

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

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.