# Kết nối Binance với SetupBook bằng khóa API chỉ đọc và đồng bộ lệnh

> Tạo khóa API Binance chỉ đọc, dán vào SetupBook và các lệnh futures lẫn spot tự về nhật ký của bạn. Từng bước có hình.

- Source: https://setupbook.io/vi/blog/ket-noi-binance-nhat-ky-giao-dich
- Site: SetupBook
- Language: vi
- Published: 2026-10-30
- Tags: đồng bộ, binance, công cụ
- en: https://setupbook.io/blog/connect-binance-trading-journal
- tr: https://setupbook.io/tr/blog/binance-islem-gunlugu-baglama
- es: https://setupbook.io/es/blog/conectar-binance-diario-de-trading
- pt: https://setupbook.io/pt/blog/conectar-binance-diario-de-trades
- id: https://setupbook.io/id/blog/menghubungkan-binance-jurnal-trading
- de: https://setupbook.io/de/blog/binance-mit-trading-tagebuch-verbinden
- fr: https://setupbook.io/fr/blog/connecter-binance-journal-de-trading
- ar: https://setupbook.io/ar/blog/connect-binance-trading-journal

Binance nhớ mọi lệnh khớp, nhưng chỉ trong một thời gian, và xuất danh sách bằng tay mỗi tháng là việc bạn sẽ bỏ qua. SetupBook có thể đọc các lệnh khớp của bạn qua một khóa API chỉ đọc. Bạn tạo khóa một lần, dán vào, và các lệnh futures lẫn spot tự về. Việc này mất khoảng năm phút.

Hướng dẫn này chỉ từng bước, có hình. Để biết mọi nền tảng kết nối thế nào, đọc [tổng quan về mọi kết nối](https://setupbook.io/vi/blog/ket-noi-metatrader-ctrader-bybit-binance-okx-nhat-ky-giao-dich). Nếu bạn còn giao dịch trên Bybit, xem [hướng dẫn Bybit](https://setupbook.io/vi/blog/ket-noi-bybit-nhat-ky-giao-dich).

## Trước khi bắt đầu

- Một tài khoản SetupBook có Pro. Kết nối nền tảng thuộc Pro, và mọi nhật ký đều bắt đầu với 14 ngày Pro: [bắt đầu 14 ngày miễn phí](https://setupbook.io/vi/signup).
- Một tài khoản Binance tạo được khóa API. Binance yêu cầu xác thực hai lớp, xác minh danh tính và một khoản nạp với mức bất kỳ vào ví Spot trước khi cho bạn tạo khóa.
- Năm phút.

Khóa chỉ đọc. Bạn sẽ đánh dấu một ô, **Enable Reading**, và để tắt mọi ô giao dịch và rút tiền. SetupBook không bao giờ đặt lệnh và không bao giờ chuyển tiền. Nó lưu khóa dưới dạng mã hóa trên máy chủ và dùng khóa để đọc lịch sử giao dịch của bạn.

## 1. Mở API Management và tạo khóa

Trên website Binance, bấm biểu tượng hồ sơ của bạn, rồi **Account**, rồi **API Management**, và bấm **Create API**. Trong ứng dụng Binance, đường đi là **More**, rồi mục **Other**, rồi **API Management**.

Binance có hai loại khóa. Hãy chọn **System-generated API keys**: Binance tạo khóa và secret cho bạn, và đó là hai thứ SetupBook hỏi. Đặt cho khóa một tên bạn dễ nhận ra, ví dụ SetupBook, và xác nhận bằng thiết bị xác thực hai lớp hoặc passkey.

![Hình vẽ API Management của Binance với nút Create API, ô Enable Reading được đánh dấu và các ô giao dịch, rút tiền để tắt](https://setupbook.io/blog/connect/binance-api-key-read-only-permissions.svg)

*API Management: tạo khóa System-generated, đánh dấu Enable Reading, để tắt phần còn lại.*

## 2. Đánh dấu Enable Reading và không gì khác

Ở phần hạn chế của khóa, đánh dấu **Enable Reading**. Để tắt mọi quyền giao dịch (giao dịch spot, margin và futures) và để tắt rút tiền. Khóa không giới hạn IP dù sao cũng chỉ đặt được ở quyền đọc, đúng thứ bạn cần ở đây.

**Giới hạn IP:** để tắt. Hiện chúng tôi chưa thể đưa bạn một địa chỉ cố định để cho phép. Nếu bạn muốn có, hãy hỏi chúng tôi qua form phản hồi dưới phần kết nối. Với khóa chỉ đọc, dù thế nào cũng không thể giao dịch hay rút tiền.

## 3. Sao chép khóa API và secret

Binance hiện **API key** và **secret key**. Hãy sao chép cả hai ngay vào một nơi an toàn, như trình quản lý mật khẩu. Các sàn thường chỉ hiện secret một lần, nên nếu bạn làm mất, hãy tạo khóa mới.

## 4. Dán vào SetupBook

Trong SetupBook, mở **Tài khoản → Kết nối** và bấm **Thêm kết nối**. Chọn **Binance**, để **Môi trường** ở *Thực*, rồi dán khóa vào **Khóa API** và secret vào **API secret**.

Ở **Thị trường**, đánh dấu những thị trường bạn giao dịch: **Futures USDⓈ-M** và **Spot**. Với spot, Binance không có lệnh gọi "tôi đã trade gì", nên hãy ghi các cặp bạn giao dịch vào **Cặp spot**, cách nhau bằng dấu phẩy, ví dụ `BTCUSDT, ETHUSDT`. Cặp của những coin bạn đang giữ được thêm tự động, và mã futures được tìm từ tài khoản.

Để **Vào tài khoản** ở *Tạo từ tài khoản trên nền tảng*, hoặc chọn một tài khoản của bạn, rồi bấm **Kiểm tra khóa và kết nối**.

![Hộp thoại kết nối Binance của SetupBook với các trường khóa API và secret, thị trường và cặp spot được làm nổi bật](https://setupbook.io/blog/connect/setupbook-binance-connection-dialog.vi.svg)

*Tài khoản → Kết nối → Thêm kết nối → Binance. Khóa, secret, thị trường và cặp spot.*

SetupBook kiểm tra khóa với Binance trước. Nếu khóa làm được nhiều hơn việc đọc, nó cảnh báo bạn; hãy xóa khóa đó trên Binance và tạo một khóa chỉ đọc.

## 5. Theo dõi lần đồng bộ đầu

Lần đồng bộ đầu bắt đầu ngay. Khi xong, kết nối hiện **Hoạt động**, giờ đồng bộ lần cuối và số lệnh. Sau đó SetupBook tìm lệnh khớp mới mỗi giờ, và bạn có thể bấm **Đồng bộ ngay** bất cứ lúc nào.

![Thẻ kết nối Binance trong SetupBook với trạng thái Hoạt động được làm nổi bật, giờ đồng bộ lần cuối và số lệnh](https://setupbook.io/blog/connect/setupbook-binance-connection-active-status.vi.svg)

*Trạng thái Hoạt động, lần đồng bộ cuối và số lệnh sau lần đồng bộ đầu.*

Bạn nhận được gì:

- **Vị thế, không phải các lệnh khớp rời.** Các lệnh khớp được gom thành vị thế giống như khi nhập file, nên một vị thế đóng làm ba phần là một lệnh với ba lần thoát.
- **Trường bị khóa.** Mã, chiều, giờ, giá, khối lượng, phí và kết quả ròng đến từ Binance và giữ nguyên chính xác (chúng nuôi [lãi/lỗ ròng](https://setupbook.io/vi/glossary/lai-lo-rong) của bạn). Phí trả bằng BNB được quy đổi sang tiền định giá. Kế hoạch, chất lượng setup, sai lầm, ghi chú và ảnh chụp vẫn là của bạn.
- **Múi giờ.** Giờ của Binance là UTC, nên không có gì để đặt.
- **Không gồm.** Hợp đồng coin-margined (inverse) và các khoản funding không được đọc.

## Lùi được bao xa

Lần đồng bộ đầu lùi ba tháng, vì API của Binance không phục vụ nhiều hơn. Với lịch sử cũ hơn, dùng chức năng xuất lịch sử giao dịch của chính Binance (Orders → Trade History → Export) rồi nhập file: xem [hướng dẫn nhập dữ liệu](https://setupbook.io/vi/blog/nhap-lich-su-giao-dich-metatrader-binance-tradingview). Hai cách bỏ qua các dòng trùng nhau.

## Demo Trading

Binance Demo Trading là một nơi riêng với các khóa riêng. Chuyển sang Demo Trading trên Binance (demo.binance.com), tạo khóa dưới **API Management** ở đó, rồi trong SetupBook chọn **Demo** ở ô Môi trường và dán khóa đó. Các lệnh của nó vào một tài khoản Demo. Khóa Demo chỉ chạy khi chọn Demo, và khóa thực chỉ chạy khi chọn Thực.

## Thay khóa

Khóa có thể hết hạn, và bạn có thể muốn đổi khóa. Mở menu của kết nối, chọn **Sửa** và bấm **Thay khóa**. Dán khóa và secret mới rồi lưu: SetupBook kiểm tra chúng, quên khóa cũ và dùng khóa mới từ lần đồng bộ kế tiếp. Các lệnh vẫn ở lại.

## Sự cố

| Bạn thấy | Vì sao | Cách xử lý |
| --- | --- | --- |
| *Binance không nhận ra khóa* | Khóa demo mà chọn Thực, khóa thực mà chọn Demo, hoặc khóa đã hết hạn | Đối chiếu ô Môi trường với nơi bạn tạo khóa, rồi kiểm tra khóa còn nằm trong danh sách trên Binance |
| *Khóa này có quyền giao dịch* (một cảnh báo) | Bạn đã đánh dấu một ô giao dịch | Tạo khóa mới chỉ với Enable Reading, rồi dùng **Thay khóa** |
| Thiếu lệnh spot | Cặp chưa có trong danh sách của bạn | Sửa kết nối và thêm cặp vào **Cặp spot** |
| Thiếu lệnh futures | **Futures USDⓈ-M** chưa được đánh dấu, hoặc hợp đồng là coin-margined | Đánh dấu thị trường; hợp đồng coin-margined chưa được hỗ trợ |
| Không có gì về và trạng thái là *Lỗi* | Khóa đã bị xóa hoặc hết hạn trên Binance | Tạo khóa mới và thay vào kết nối |
| Lệnh cũ hơn ba tháng | API không phục vụ chúng | Nhập file lịch sử giao dịch của Binance |

Gặp khó khi kết nối? Viết cho chúng tôi từ trang kết nối, kèm những gì bạn đã thử. Chúng tôi trả lời qua email trong 30 phút, mỗi ngày.

## Câu hỏi thường gặp

### Có an toàn không? SetupBook có giao dịch hay rút tiền được không?

Không. Với chỉ **Enable Reading**, khóa không thể đặt lệnh hay rút tiền, và SetupBook không có mã nào thử làm vậy. Khóa được lưu dưới dạng mã hóa trên máy chủ và không bao giờ gửi tới trình duyệt của bạn. Nếu muốn dừng, hãy xóa khóa trên Binance và kết nối tự dừng.

### Tôi có cần giới hạn địa chỉ IP không?

Không. Để tắt giới hạn IP. Hiện chúng tôi chưa thể đưa bạn một địa chỉ cố định để cho phép; nếu bạn muốn có, hãy hỏi chúng tôi trong form phản hồi. Khóa chỉ đọc không thể giao dịch hay rút tiền, có hay không có quy tắc IP.

### Những thị trường Binance nào được đọc?

Futures USDⓈ-M và spot. Hợp đồng coin-margined và các khoản funding chưa được đọc.

### Vì sao tôi phải liệt kê các cặp spot?

Binance không có lệnh gọi nào trả về các cặp spot bạn đã giao dịch. Bạn liệt kê các cặp, và SetupBook thêm cặp của những coin bạn đang giữ lên trên. Futures không cần danh sách.

### Có tốn phí không?

Kết nối thuộc Pro. Mọi nhật ký đều bắt đầu với 14 ngày Pro: cần thẻ khi đăng ký, nhưng không bị trừ tiền trong 14 ngày. Nếu hủy trước, bạn ở lại gói miễn phí, nơi bạn vẫn ghi lệnh bằng tay được.

Thích dùng file hơn? Nhập file vẫn dùng được: xem [hướng dẫn sử dụng](https://setupbook.io/vi/guide). Để kết nối một sàn khác, đọc [hướng dẫn OKX](https://setupbook.io/vi/blog/ket-noi-okx-nhat-ky-giao-dich).