Kết nối DNSE (cổ phiếu Việt Nam)

DNSE cho phép Fastbot xem danh mục cổ phiếu Việt Nam và đặt lệnh trên HOSE / HNX. Cổ phiếu và tiền vẫn nằm trong tài khoản DNSE của bạn.

Vì sao DNSE cần nhiều khoá hơn các sàn khác

DNSE bắt buộc xác thực hai lớp cho mọi phiên giao dịch: cứ 8 tiếng một lần, hệ thống gửi mã OTP 6 số vào email của bạn. Nếu không có cách đọc mã đó, bạn sẽ phải nhập tay mỗi 8 tiếng.

Fastbot giải quyết bằng cách đọc email của bạn qua IMAP, lấy mã OTP và tự gia hạn. Vì thế ngoài API key, bạn cần thêm mật khẩu ứng dụng Gmail.

Bước 1: Lấy API key DNSE

Đăng nhập DNSE Entrade, vào phần cài đặt API.
Tạo cặp khoá mới, lưu lại API Key và API Secret.
Ghi nhớ email bạn dùng cho tài khoản DNSE — đây là nơi nhận OTP.

Bước 2: Tạo mật khẩu ứng dụng Gmail

Đây là mật khẩu ứng dụng 16 ký tự, KHÔNG phải mật khẩu Gmail của bạn.

Tài khoản Gmail phải bật xác minh 2 bước trước.
Vào myaccount.google.com/apppasswords.
Tạo một mật khẩu ứng dụng mới, đặt tên fastbot.
Google hiện một chuỗi 16 ký tự — copy lại ngay, nó chỉ hiện một lần.

Mật khẩu ứng dụng chỉ cho phép đọc thư, có thể thu hồi bất cứ lúc nào mà không ảnh hưởng mật khẩu chính.

Bước 3: Nhập vào Fastbot

⚙️ Cài đặt → ⚙️ Cập nhật .env, nhập năm giá trị:

Tên cấu hình	Giá trị
`DNSE_ENABLED`	`true`
`DNSE_API_KEY`	API Key từ DNSE
`DNSE_API_SECRET`	API Secret từ DNSE
`DNSE_EMAIL`	Email tài khoản DNSE (nơi nhận OTP)
`IMAP_PASSWORD`	Mật khẩu ứng dụng Gmail 16 ký tự

Khoá nào chưa có trong danh sách thì bấm ➕ Thêm biến mới và gửi dạng DNSE_ENABLED=true.

Nhập xong, bấm 🔄 Restart Bot.

Kiểm tra

Mở 🇻🇳 DNSE → 💰 Tài khoản DNSE:

Fastbot💰 Tài khoản DNSE

🇻🇳 Tài khoản DNSE Phiên: Khớp lệnh liên tục (sáng) Tài khoản: 0003693208 Số dư: Tiền: 5.200.000 VND Giá trị cổ phiếu: 28.500.000 VND NAV: 33.700.000 VND Vị thế: • HPG: 1000 cp @ 26.800 VND Giá hiện tại: 28.500 VND | Giá trị: 28.500.000 VND 🟢 PnL: 1.700.000 VND (+6.34%) 🟢 Tổng PnL: 1.700.000 VND (6.34%)

💰 Tài khoản DNSE

🔵 Đặt lệnh cổ phiếu

« Menu chính

Màn này luôn hiện phiên giao dịch hiện tại để bạn biết có đặt lệnh được hay không.

Nếu OTP không về

Fastbot báo rõ: "Không thấy OTP mới từ noreply@mail.dnse.com.vn sau 120s. Kiểm tra thư có vào hộp thư đến không." Thường do:

Bộ lọc Gmail chuyển thư OTP sang thư mục khác — hãy để thư vào Hộp thư đến.
Dán nhầm mật khẩu Gmail thay vì mật khẩu ứng dụng 16 ký tự.
Mật khẩu ứng dụng đã bị thu hồi — tạo lại cái mới.

Tiếp theo: Đặt lệnh & tích sản DNSE.