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

> Tạo khóa API Bitget chỉ đọc kèm passphrase, dán cả ba vào SetupBook và các lệnh futures USDT-M lẫn spot về nhật ký của bạn.

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

API của Bitget phục vụ khoảng ba tháng lệnh khớp. SetupBook có thể đọc chúng bằng một khóa chỉ đọc, nên các lệnh futures USDT-M lẫn spot về nhật ký mà bạn không phải gõ gì. Giống OKX, Bitget yêu cầu bạn tự nghĩ ra một **passphrase** khi tạo khóa, và SetupBook cần nó cùng với khóa và secret. 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 dùng OKX, xem [hướng dẫn OKX](https://setupbook.io/vi/blog/ket-noi-okx-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 Bitget.
- Một nơi để ghi lại passphrase, như trình quản lý mật khẩu.
- Năm phút.

Khóa chỉ đọc. Bạn chọn **Read-only** và để tắt các quyền giao dịch, chuyển tiền 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 và passphrase dưới dạng mã hóa trên máy chủ và dùng chúng để đọc các lệnh khớp của bạn.

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

Trên website Bitget, mở menu dưới hồ sơ của bạn và chọn **API Key Management**, rồi bấm **Create API key**. Chữ trong menu có thể hơi khác giữa web và ứng dụng, nên hãy tìm trang có tên API Key Management. Đặt cho khóa một tên bạn dễ nhận ra, ví dụ SetupBook.

![Hình vẽ form Create API key của Bitget: chọn Read-only, các tùy chọn ghi và rút tiền để tắt](https://setupbook.io/blog/connect/bitget-api-key-read-only-permissions.svg)

*Create API key: một cái tên, passphrase của riêng bạn, Read-only được chọn, không gì khác.*

## 2. Chọn Read-only

Bitget có khóa chỉ đọc và khóa đọc-ghi. Hãy chọn **Read-only**. Nhìn xem tùy chọn nào đang được chọn trước khi xác nhận, vì mặc định có thể khác nhau giữa các trang. Để tắt giao dịch, chuyển tiền và rút tiền.

**Giới hạn IP:** Bitget khuyên nên gắn một địa chỉ IP, nhưng không bắt buộc. Hãy để 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. Đặt passphrase và sao chép khóa

Gõ một **passphrase** của riêng bạn. Một khi đã đặt thì không đổi được, và Bitget không thể hiện lại: nếu bạn quên, bạn phải tạo khóa mới. Xác nhận bằng bước kiểm tra bảo mật. Bitget sau đó hiện **API key** và **secret**. Sao chép khóa, secret và passphrase vào một nơi an toàn.

## 4. Dán cả ba 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 **Bitget**. Dán khóa vào **Khóa API**, secret vào **API secret** và passphrase vào **Passphrase**.

Ở **Thị trường**, đánh dấu những thị trường bạn giao dịch: **Perpetual USDT** (futures USDT-M) và **Spot**. Bitget không cần danh sách cặp. Để **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 Bitget của SetupBook với các trường khóa API, secret và passphrase và thị trường được làm nổi bật](https://setupbook.io/blog/connect/setupbook-bitget-connection-dialog.vi.svg)

*Tài khoản → Kết nối → Thêm kết nối → Bitget. Ba trường: khóa, secret, passphrase.*

SetupBook kiểm tra khóa với Bitget trước và đọc các quyền của khóa. Nếu khóa ghi được, nó cảnh báo bạn; hãy xóa khóa đó trên Bitget 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 và lùi khoảng ba tháng. 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 Bitget 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-bitget-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ếu bạn dùng chế độ hedge, phía long và phía short được giữ thành các vị thế riêng.
- **Trường bị khóa.** Mã, chiều, giờ, giá, khối lượng, phí và kết quả ròng đến từ Bitget 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). 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 Bitget 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.

Cũ hơn ba tháng? Lịch sử đó phải vào bằng file. Nếu bạn xuất được từ Bitget ra CSV, tùy chọn *CSV khác (ánh xạ cột)* của phần nhập sẽ ánh xạ các cột: xem [hướng dẫn nhập dữ liệu](https://setupbook.io/vi/blog/nhap-lich-su-giao-dich-metatrader-binance-tradingview).

## Demo hay thực

SetupBook chỉ kết nối tài khoản thực của Bitget. Hiện chưa có tùy chọn Demo cho Bitget.

## Thay khóa

Mở menu của kết nối, chọn **Sửa** và bấm **Thay khóa**. Dán khóa, secret và passphrase mới rồi lưu: SetupBook kiểm tra chúng, quên các giá trị cũ và dùng giá trị 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ý |
| --- | --- | --- |
| *Khóa OKX, Bitget và KuCoin cần passphrase* | Trường passphrase đang trống | Dán passphrase bạn đã đặt khi tạo khóa |
| *Sàn từ chối khóa này* | Passphrase sai, secret gõ sai, hoặc khóa đã bị xóa | Kiểm tra cả ba giá trị, hoặc tạo khóa mới |
| Bạn quên passphrase | Bitget không thể hiện lại | Tạo khóa mới và dùng **Thay khóa** |
| *Khóa này có quyền giao dịch* (một cảnh báo) | Khóa là đọc-ghi | Tạo khóa Read-only mới và thay vào |
| Thiếu lệnh spot | **Spot** chưa được đánh dấu | Sửa kết nối và đánh dấu thị trường |
| Lệnh cũ hơn ba tháng | API không phục vụ chúng | Nhập một CSV lịch sử cũ bằng *CSV khác (ánh xạ cột)* |

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. Khóa chỉ đọc 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 và passphrase đượ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. Để dừng, hãy xóa khóa trên Bitget và kết nối dừng.

### Vì sao SetupBook cần passphrase?

Bitget ký mọi yêu cầu bằng passphrase cùng với khóa và secret. Thiếu nó, Bitget từ chối yêu cầu. Passphrase do chính bạn chọn khi tạo khóa.

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

Không. Để 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 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 Bitget nào được đọc?

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

### 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 BingX](https://setupbook.io/vi/blog/ket-noi-bingx-nhat-ky-giao-dich).