# Kết nối KuCoin với SetupBook bằng khóa API quyền General và đồng bộ lệnh

> Tạo khóa API KuCoin chỉ với quyền General, thêm passphrase trong 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-kucoin-nhat-ky-giao-dich
- Site: SetupBook
- Language: vi
- Published: 2026-10-30
- Tags: đồng bộ, kucoin, công cụ
- en: https://setupbook.io/blog/connect-kucoin-trading-journal
- tr: https://setupbook.io/tr/blog/kucoin-islem-gunlugu-baglama
- es: https://setupbook.io/es/blog/conectar-kucoin-diario-de-trading
- pt: https://setupbook.io/pt/blog/conectar-kucoin-diario-de-trades
- id: https://setupbook.io/id/blog/menghubungkan-kucoin-jurnal-trading
- de: https://setupbook.io/de/blog/kucoin-mit-trading-tagebuch-verbinden
- fr: https://setupbook.io/fr/blog/connecter-kucoin-journal-de-trading
- ar: https://setupbook.io/ar/blog/connect-kucoin-trading-journal

KuCoin không có công tắc nào gọi là "chỉ đọc". Khóa chỉ đọc của nó là khóa có quyền **General** và không gì khác. SetupBook đọc các lệnh khớp của bạn bằng khóa như vậy, 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ì. KuCoin cũng yêu cầu một **passphrase** khi bạn tạo khóa, và SetupBook cần nó. 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 MEXC, xem [hướng dẫn MEXC](https://setupbook.io/vi/blog/ket-noi-mexc-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 KuCoin. KuCoin yêu cầu một bước kiểm tra bảo mật khi bạn tạo khóa: mật khẩu giao dịch của bạn, cộng với mã từ email và từ ứng dụng xác thực.
- 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 đánh dấu **General** và để tắt Spot, Futures, Margin, Earn và Withdrawal. 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 Management và tạo khóa

Trên website KuCoin, bấm avatar của bạn, chọn **API Management** và bấm **Create API**. KuCoin hỏi khóa dùng để làm gì: hãy chọn **API Trading**, tùy chọn tạo một khóa của riêng bạn. Sau đó gõ **API name** (đặt là SetupBook) và một **API passphrase**.

![Hình vẽ form Create API của KuCoin: chỉ ô General được đánh dấu, Spot, Futures và Withdrawal để tắt](https://setupbook.io/blog/connect/kucoin-api-key-general-permission.svg)

*Create API: một cái tên, passphrase của riêng bạn, General được đánh dấu, mọi thứ khác để tắt.*

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

Ở bước quyền, đánh dấu **General**. KuCoin mô tả nó là chỉ giới hạn ở các thao tác đọc: thông tin tài khoản, sao kê và thông tin lệnh. Để tắt **Spot**, **Futures**, **Margin**, **Earn** và **Withdrawal**, và để tắt cả mọi ô khác. Chữ trên form có thể khác đôi chút giữa các khu vực (trang EU gọi bước này là *API Restrictions*), nên hãy tìm ô General.

**Giới hạn IP:** trợ giúp của KuCoin nói khóa có quyền giao dịch phải gắn với một địa chỉ IP. Khóa của bạn không giao dịch, nên để tắt giới hạn. Nếu form vẫn đòi một địa chỉ, hãy hỏi chúng tôi qua form phản hồi dưới phần kết nối: hiện chúng tôi chưa thể đưa bạn một địa chỉ cố định để cho phép. 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, secret và passphrase

Xác nhận bước kiểm tra bảo mật. KuCoin hiện **API key** và **secret**. Sao chép cả hai vào một nơi an toàn, cùng với passphrase của bạn. KuCoin không thể khôi phục bất kỳ thứ nào trong ba thứ này khi đã mất, nên nếu bạn làm mất một thứ, hãy tạo khóa mới.

## 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 **KuCoin**. 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**. Với spot, KuCoin 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ụ `BTC-USDT, ETH-USDT`. Cặp của những coin bạn đang giữ được thêm tự động. Futures không cần danh sách.

Để **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 KuCoin của SetupBook với các trường khóa API, secret và passphrase, thị trường và cặp spot được làm nổi bật](https://setupbook.io/blog/connect/setupbook-kucoin-connection-dialog.vi.svg)

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

KuCoin không cho khóa biết các quyền của chính nó, nên SetupBook không thể cảnh báo nếu bạn lỡ đánh dấu một ô giao dịch. Hãy xem quyền của khóa trên KuCoin một lần cho chắc.

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

Lần đồng bộ đầu bắt đầu ngay. Futures lùi khoảng ba tháng; spot được đọc theo từng cặp, xa nhất KuCoin phục vụ. 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 KuCoin 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-kucoin-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.
- **Kích thước hợp đồng.** Một hợp đồng futures có giá trị bằng một lượng coin cố định (hợp đồng BTC XBTUSDTM là 0,001 BTC), và SetupBook dùng con số đó, nên khối lượng và kết quả khớp với KuCoin.
- **Trường bị khóa.** Mã, chiều, giờ, giá, khối lượng, phí và kết quả ròng đến từ KuCoin 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 KuCoin 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.

## Demo hay thực

SetupBook chỉ kết nối tài khoản thực của KuCoin. KuCoin không có giao dịch demo nào mà SetupBook đọc được.

## 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 đã gõ 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 | KuCoin không thể khôi phục | Tạo khóa mới và 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 | **Perpetual USDT** 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 bị bỏ qua |
| Không có gì về và trạng thái là *Lỗi* | Khóa đã bị xóa trên KuCoin | Tạo khóa mới và thay vào |

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ó **General** 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 KuCoin và kết nối dừng.

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

KuCoin ký mọi yêu cầu bằng passphrase cùng với khóa và secret. Thiếu nó, KuCoin 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.

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

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