Thực hành

Tổng quan

Các tutorial hướng dẫn bạn sử dụng FastConnect Python SDK (ssi_sdk) để tích hợp với hệ thống giao dịch chứng khoán — từ xác thực, truy vấn dữ liệu thị trường, đặt/hủy lệnh, đến streaming real-time và auto trading.

Mỗi tutorial tương ứng với một sample code Python hoàn chỉnh, có cả phiên bản sync và async.

Các tutorial ở đây sử dụng Python làm ngôn ngữ minh họa. Repo GitHub bên dưới cũng chứa source code cho các ngôn ngữ khác — tham khảo SDK để xem danh sách đầy đủ.

Source code

Toàn bộ source code của các tutorial có sẵn trên GitHub:

git clone https://github.com/SSI-Securities-Inc/ssi-fastconnect-v3-tutorials.git

Yêu cầu

• Tài khoản FastConnect API (Consumer ID, API Key, API Secret, Private Key)
• Python 3.10+
• Cài đặt SDK: pip install ssi-sdk

Lộ trình học

Luồng tổng thể

Auth (token cache) → Market Data → Account Check → Place Order → Track/Cancel → Realtime Update

• Manual flow: Auth → Market Data → Account Check → Place Order → Track/Cancel → Realtime Update
• Auto flow: Auth → OHLC/Indicator → Signal Engine → Risk Check → Auto Order → Monitor → P&L Logging

Cấu trúc code

Mỗi tutorial cung cấp:

• Mục tiêu — code làm gì và tại sao
• Luồng — sơ đồ từng bước
• Sync sample — code tuần tự đơn giản
• Async sample — code dùng asyncio cho workload đồng thời
• Ghi chú — lưu ý quan trọng và best practices

Tất cả sample dùng chung module auth_helper.py để cache token (giới thiệu ở Tutorial 1).

Mẹo

• Bắt đầu với Tutorial 1 (Xác thực) — tất cả tutorial khác đều phụ thuộc vào nó.
• Tutorial 1–4 không cần OTP, nên bạn có thể khám phá dữ liệu thị trường mà không cần trading credentials.
• Lưu credentials trong biến môi trường hoặc config file, không hard-code.
• Thêm token_cache.json vào .gitignore.