1. Dịch vụ FastConnect V3
FastConnect là gì, các nhóm API hiện có, điều kiện/quy trình đăng ký, môi trường UAT/Production, và rate limit.
FastConnect là gì?
FastConnect là nền tảng API giao dịch điện tử của SSI Securities, cung cấp REST API và WebSocket cho đối tác fintech, nhà đầu tư tổ chức và developer bên thứ ba để giao dịch chứng khoán qua HoSE/HNX/UPCOM và tra cứu dữ liệu thị trường.
FastConnect hiện có những nhóm API nào?
6 nhóm chính: Authentication (xác thực, cấp token), Trading (đặt/sửa/hủy lệnh, truy vấn tài khoản), Lệnh điều kiện — FCO (đặt lệnh tự động theo điều kiện thị trường), Market Data (dữ liệu thị trường qua REST), WebSocket (dữ liệu realtime, push-only), và WebSocket API (đặt/sửa/hủy lệnh, kể cả hàng loạt, thuần qua WebSocket). Xem tổng quan tại API Reference.
Tôi cần điều kiện gì để đăng ký FastConnect API?
Bạn cần có tài khoản chứng khoán tại SSI trước. FastConnect API chỉ cấp cho khách hàng đã có tài khoản giao dịch — nếu chưa có, hãy mở tài khoản SSI trước khi đăng ký API.
Đăng ký và sử dụng API có mất phí không?
Hiện tại SSI chưa thu phí sử dụng dịch vụ FastConnect API.
Quy trình đăng ký diễn ra thế nào, mất bao lâu?
Đăng ký và kích hoạt hoàn toàn qua Developer Portal: tạo tài khoản developer, xác nhận điều khoản sử dụng, tạo API Key, chọn môi trường (UAT/Production). Toàn bộ quy trình thực hiện online, không cần chờ duyệt thủ công qua email như trước — xem chi tiết tại Đăng ký.
Một tài khoản có thể tạo bao nhiêu API Key?
Bạn có thể tạo nhiều API Key trên cùng một tài khoản, mỗi key có thể gán mục đích/scope riêng (ví dụ: 1 key chỉ đọc Market Data, 1 key khác được cấp thêm quyền Trading) để tăng tính bảo mật khi vận hành nhiều hệ thống.
Môi trường UAT và Production khác nhau thế nào?
UAT (User Acceptance Test) dùng để tích hợp và kiểm thử mà không ảnh hưởng dữ liệu/tài khoản thật. API Key của UAT và Production hoàn toàn tách biệt — bạn cần đăng ký/kích hoạt riêng cho từng môi trường trên Developer Portal. SSI sẽ thông báo cho khách hàng khi môi trường kiểm thử sẵn sàng cho khách hàng sử dụng.
Giới hạn tần suất gọi API (rate limit) được áp dụng thế nào?
Mỗi API Key có hạn mức riêng theo từng endpoint/method. Hạn mức hiện tại được trả về minh bạch qua header X-RATELIMIT-LIMIT/X-RATELIMIT-REMAINING/X-RATELIMIT-RESET trên mọi response — bạn có thể theo dõi và tự điều chỉnh tần suất gọi dựa trên các header này thay vì phải đoán.