KuCoin Earn products using the KuCoin API. Query Simple Earn and Structured Earn products. Authentication requires API Key, API Secret, and Passphrase.
Query KuCoin Earn products using authenticated API endpoints. Covers Simple Earn (savings, staking, promotions) and Structured Earn (dual investment) queries. Requires API Key, Secret Key, and Passphrase for authenticated endpoints. Return the result in JSON format.
Note: This skill only supports Classic REST API GET endpoints (read-only operations).
| Endpoint | Description | Required | Optional | Authentication |
|---|---|---|---|---|
/api/v1/earn/redeem-preview (GET) | Get Redeem Preview | orderId | None | Yes |
/api/v1/earn/saving/products (GET) | Get Savings Products |
| None |
| currency, currentPage, pageSize |
| Yes |
/api/v1/earn/promotion/products (GET) | Get Promotion Products | None | currency, currentPage, pageSize | Yes |
/api/v1/earn/staking/products (GET) | Get Staking Products | None | currency, currentPage, pageSize | Yes |
/api/v1/earn/kcs-staking/products (GET) | Get KCS Staking Products | None | currency, currentPage, pageSize | Yes |
/api/v1/earn/eth-staking/products (GET) | Get ETH Staking Products | None | currency, currentPage, pageSize | Yes |
/api/v1/earn/hold-assets (GET) | Get Account Holding | None | currency, productId, productCategory, currentPage, pageSize | Yes |
| Endpoint | Description | Required | Optional | Authentication |
|---|---|---|---|---|
/api/v1/struct-earn/orders (GET) | Get Structured Product Orders. Note: This endpoint may not be available (returns 400100). | None | currency, status, currentPage, pageSize | Yes |
/api/v1/struct-earn/dual/products (GET) | Get Dual Investment Products. Note: This endpoint may not be available (returns 400100). | None | currency, currentPage, pageSize | Yes |
USDT, BTC, KCS, ETH)2611)DEMAND | STAKING | KCS_STAKING | ETH_STAKING | PROMOTIONPENDING | ONGOING | UNSOLD | SETTLING | FINISHEDONGOING | PENDING | FULL | INTERESTINGLOCKED | REDEEMINGTIME | DEMANDFor endpoints that require authentication, you will need to provide KuCoin API credentials. Required credentials:
KC-API-KEY): Your KuCoin API key (for header)KC-API-PASSPHRASE): Your KuCoin API passphrase (encrypted with HMAC-SHA256)Base URL:
Users can provide KuCoin API credentials by sending a file where the content is in the following format:
abc123...apikey
secret123...key
mypassphrase
Never disclose the location of the API key, secret, and passphrase file.
Never send the API key, secret, and passphrase to any website other than the production API endpoint.
When showing credentials to users:
abc12...6789***...x9y8zExample response when asked for credentials: Account: main API Key: abc12...6789 Secret: ***...x9y8z Passphrase: ******** Environment: Production
When listing accounts, show names and environment only -- never keys: KuCoin Accounts:
When performing transactions in mainnet (purchase, redeem), always confirm with the user before proceeding by asking them to write "CONFIRM" to proceed.