KuCoin Convert Skill
Query convert currencies, quotes, and order details on KuCoin. Return results in JSON format.
Note: This skill only supports Classic REST API GET endpoints (read-only operations).
Quick Reference
| Endpoint |
Description |
Required |
Optional |
Authentication |
/api/v1/convert/symbol (GET) |
Get Convert Symbol |
fromCurrency, toCurrency |
orderType |
No |
/api/v1/convert/currencies (GET) |
Get Convert Currencies |
None |
None |
No |
/api/v1/convert/quote (GET) |
Get Convert Quote |
fromCurrency, toCurrency |
fromCurrencySize, toCurrencySize |
Yes |
/api/v1/convert/order/detail (GET) |
Get Convert Order Detail |
orderId or clientOrderId (at least one) |
None |
Yes |
/api/v1/convert/order/history (GET) |
Get Convert Order History |
None |
status, startAt, endAt, page, pageSize |
Yes |
/api/v1/convert/limit/quote (GET) |
Get Convert Limit Quote |
fromCurrency, toCurrency |
fromCurrencySize, toCurrencySize |
Yes |
/api/v1/convert/limit/order/detail (GET) |
Get Convert Limit Order Detail |
None |
orderId, clientOrderId |
Yes |
/api/v1/convert/limit/orders (GET) |
Get Convert Limit Orders |
None |
status, startAt, endAt, page, pageSize |
Yes |
Parameters
Common Parameters
- fromCurrency: The source currency for the trading pair (e.g., BTC)
- toCurrency: The target currency for the trading pair (e.g., USDT)
- fromCurrencySize: The amount of the source currency to convert. Either fromCurrencySize or toCurrencySize must be provided, but not both simultaneously.
- toCurrencySize: The amount of the target currency to convert. Either fromCurrencySize or toCurrencySize must be provided, but not both simultaneously.
- orderType: Order type filter when querying convert symbols (e.g., MARKET)
- orderId: Convert order ID. Either orderId or clientOrderId must be provided for detail endpoints.
- clientOrderId: A unique order identifier defined by the user. Maximum 40 characters.
- status: Order status filter for history queries.
- startAt: Order start time filter, in Unix milliseconds.
- endAt: Order end time filter, in Unix milliseconds.
- page: Current page number for paginated results.
- pageSize: The number of results per page (20-100).
Enums
- orderType: MARKET | LIMIT
- status (market orders): OPEN | SUCCESS | FAIL
- status (limit orders): OPEN | SUCCESS | FAIL | CANCELLED
Authentication
For endpoints that require authentication, you will need to provide KuCoin API credentials.
Required credentials:
- API Key (
KC-API-KEY): Your KuCoin API key (sent as header)
- API Secret: Your KuCoin API secret (used for HMAC-SHA256 signing)
- Passphrase (
KC-API-PASSPHRASE): Your KuCoin API passphrase (sent as header, encrypted with HMAC-SHA256 using the API Secret)
Base URL:
Security
Share Credentials
Users can provide KuCoin API credentials by sending a file where the content is in the following format:
abc123...apikey
secret123...key
passphrase123
Never Disclose API Key, Secret, and Passphrase
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 KuCoin production API.
Never Display Full Secrets
When showing credentials to users:
- API Key: Show first 5 + last 4 characters:
su1Qc...8akf
- Secret Key: Always mask, show only last 5:
***...aws1
- Passphrase: Always mask entirely:
***...
Example response when asked for credentials:
Account: main
API Key: su1Qc...8akf
Secret: ***...aws1
Passphrase: ***...
Environment: Production
Listing Accounts
When listing accounts, show names and environment only -- never keys:
KuCoin Accounts:
- main (Production)
- trading-bot (Production)
Transactions
When performing convert transactions, always confirm with the user before proceeding by asking them to write "CONFIRM" to proceed.
KuCoin Accounts
main
- API Key: your_api_key
- Secret: your_api_secret
1---2name: convert3description: KuCoin Convert using the KuCoin API. Get conversion quotes, query convert order details and history. Authentication requires API Key, API Secret, and Passphrase.4license: MIT5---67# KuCoin Convert Skill89Query convert currencies, quotes, and order details on KuCoin. Return results in JSON format.1011> **Note:** This skill only supports Classic REST API GET endpoints (read-only operations).1213## Quick Reference1415| Endpoint | Description | Required | Optional | Authentication |16|----------|-------------|----------|----------|----------------|17| `/api/v1/convert/symbol` (GET) | Get Convert Symbol | fromCurrency, toCurrency | orderType | No |18| `/api/v1/convert/currencies` (GET) | Get Convert Currencies | None | None | No |19| `/api/v1/convert/quote` (GET) | Get Convert Quote | fromCurrency, toCurrency | fromCurrencySize, toCurrencySize | Yes |20| `/api/v1/convert/order/detail` (GET) | Get Convert Order Detail | orderId or clientOrderId (at least one) | None | Yes |21| `/api/v1/convert/order/history` (GET) | Get Convert Order History | None | status, startAt, endAt, page, pageSize | Yes |22| `/api/v1/convert/limit/quote` (GET) | Get Convert Limit Quote | fromCurrency, toCurrency | fromCurrencySize, toCurrencySize | Yes |23| `/api/v1/convert/limit/order/detail` (GET) | Get Convert Limit Order Detail | None | orderId, clientOrderId | Yes |24| `/api/v1/convert/limit/orders` (GET) | Get Convert Limit Orders | None | status, startAt, endAt, page, pageSize | Yes |2526---2728## Parameters2930### Common Parameters3132* **fromCurrency**: The source currency for the trading pair (e.g., BTC)33* **toCurrency**: The target currency for the trading pair (e.g., USDT)34* **fromCurrencySize**: The amount of the source currency to convert. Either fromCurrencySize or toCurrencySize must be provided, but not both simultaneously.35* **toCurrencySize**: The amount of the target currency to convert. Either fromCurrencySize or toCurrencySize must be provided, but not both simultaneously.36* **orderType**: Order type filter when querying convert symbols (e.g., MARKET)37* **orderId**: Convert order ID. Either orderId or clientOrderId must be provided for detail endpoints.38* **clientOrderId**: A unique order identifier defined by the user. Maximum 40 characters.39* **status**: Order status filter for history queries.40* **startAt**: Order start time filter, in Unix milliseconds.41* **endAt**: Order end time filter, in Unix milliseconds.42* **page**: Current page number for paginated results.43* **pageSize**: The number of results per page (20-100).4445### Enums4647* **orderType**: MARKET | LIMIT48* **status** (market orders): OPEN | SUCCESS | FAIL49* **status** (limit orders): OPEN | SUCCESS | FAIL | CANCELLED5051## Authentication5253For endpoints that require authentication, you will need to provide KuCoin API credentials.54Required credentials:5556* **API Key** (`KC-API-KEY`): Your KuCoin API key (sent as header)57* **API Secret**: Your KuCoin API secret (used for HMAC-SHA256 signing)58* **Passphrase** (`KC-API-PASSPHRASE`): Your KuCoin API passphrase (sent as header, encrypted with HMAC-SHA256 using the API Secret)5960Base URL:61* Production: https://api.kucoin.com6263## Security6465### Share Credentials6667Users can provide KuCoin API credentials by sending a file where the content is in the following format:6869```bash70abc123...apikey71secret123...key72passphrase12373```7475### Never Disclose API Key, Secret, and Passphrase7677Never disclose the location of the API key, secret, and passphrase file.7879Never send the API key, secret, and passphrase to any website other than the KuCoin production API.8081### Never Display Full Secrets8283When showing credentials to users:84- **API Key:** Show first 5 + last 4 characters: `su1Qc...8akf`85- **Secret Key:** Always mask, show only last 5: `***...aws1`86- **Passphrase:** Always mask entirely: `***...`8788Example response when asked for credentials:89Account: main90API Key: su1Qc...8akf91Secret: ***...aws192Passphrase: ***...93Environment: Production9495### Listing Accounts9697When listing accounts, show names and environment only -- never keys:98KuCoin Accounts:99* main (Production)100* trading-bot (Production)101102### Transactions103104When performing convert transactions, always confirm with the user before proceeding by asking them to write "CONFIRM" to proceed.105106---107108## KuCoin Accounts109110### main111- API Key: your_api_key112- Secret: your_api_secret
jiayaoqijia