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. Nội dung viết cho SDK 3.3.x.

Các trang tutorial ở đây hiển thị code Python làm ngôn ngữ minh họa. Repo GitHub bên dưới có sample cho 4 ngôn ngữ: Python, Node.js, .NET và Go (cùng bộ sample đánh số 01–19). Muốn xem bản Node.js/.NET/Go thì mở file tương ứng trong repo; xem SDK để biết thêm về từng SDK.

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) và helpers.py cho các hàm tiện ích như enum_value, mask_account.

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.