HGP-89: KuCoin Perpetual Connector Compatibility Update

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.