# HGP-89: KuCoin Perpetual Connector Compatibility Update

- Space: [Hummingbot](https://snapshot.box/s:hbot.eth.md)
- Author: 0x6CA6D8E475D8cB2cAa5f0CF42D063d8De9f9Bf72
- State: Passed
- Voting type: Basic
- Start: 2026-06-12 11:42 UTC
- End: 2026-06-15 11:42 UTC
- Votes: 2
- Quorum: 5,000,000 voting power
- Open in Snapshot: https://snapshot.box/#/s:hbot.eth/proposal/0xf27c9d99f80df24712086f616d6aa231b1c669c6d28ead8e1254fd679d970d95

## Results

- For: 50,642,099.86 voting power, 100.0%
- Against: 0 voting power, 0.0%
- Abstain: 0 voting power, 0.0%

## Proposal

Summary
Allocate development resources to update and restore full functionality of the KuCoin Perpetual connector following multiple KuCoin API and WebSocket changes introduced throughout 2026.

Users have reported that the connector remains stuck in a non-ready state (kucoin_perpetual is not ready. Please wait...) and cannot be reliably used for trading strategies. Recent KuCoin infrastructure upgrades introduced breaking changes affecting order management, account updates, position tracking, and websocket event handling.

Issue ticket
https://github.com/hummingbot/hummingbot/issues/8256

Bounty:
Sponsor: Hummingbot Foundation
Developer portion: 200 USDC

Pull request:
https://github.com/hummingbot/hummingbot/pull/8273

Objectives
The implementation should:

Restore connector readiness and normal startup behavior.
Update deprecated REST endpoints used by the connector.
Ensure compatibility with current KuCoin Futures WebSocket streams.
Validate order, trade, balance, and position synchronization.
Support updated account and position schemas.
Ensure reliable operation after websocket disconnects and reconnects.
Update tests and validation coverage where necessary.

Scope
The contributor should audit and update the KuCoin Perpetual connector against the latest KuCoin Futures API specifications, including:

REST API
Replace deprecated order-management endpoints.
Validate position, account, and trading endpoints.
Update rate-limit configurations where required.

WebSockets
Verify private websocket authentication and subscriptions.
Support updated execution event payloads.
Update account event subscriptions migrated to unified wallet topics.
Validate trade, order, balance, and position event processing.

Position & Risk Management
Support newly introduced position metadata.
Validate leverage, funding, and risk-related updates.

Reliability
Validate connector startup and readiness checks.
Verify reconnect and recovery behavior.
Ensure order and account state remain synchronized after reconnects.

Deliverables
The contributor must provide:

A working KuCoin Perpetual connector compatible with the latest KuCoin API.
Passing CI and test suite.
Updated tests where necessary.

Validation logs demonstrating:

Connector initialization
Order placement and cancellation
Partial and full fills
Position updates
WebSocket reconnect recovery
Documentation summarizing implemented API compatibility updates.

Acceptance Criteria
The proposal will be considered complete when:

The connector reaches ready state successfully.
Orders can be created and cancelled successfully.
Trade fills are received correctly.
Position updates are synchronized correctly.
Account balances remain synchronized.
WebSocket reconnection works without requiring bot restart.
No known deprecated critical API endpoints remain in use.
CI checks pass.
Review comments are addressed.
Testing evidence is provided using a live KuCoin Futures account.

Success Metric
Users can run Strategy V2 controllers on KuCoin Perpetual without readiness failures and can reliably trade using the latest KuCoin Futures infrastructure.

---

To vote or create proposals from an AI assistant, connect the Snapshot MCP at https://mcp.snapshot.box

