KuCoin API
★ Only Publicly Available OpenAPI DocumentFinanceBankingapiKey25 EndpointsREST
For Agents
Trade spot crypto on KuCoin — read market data, place and cancel orders, manage balances, deposits, withdrawals, and inner transfers — using API key plus HMAC signing and an encrypted passphrase.
Use for: Get the latest ticker for BTC-USDT on KuCoin, Place a limit buy order for 0.01 BTC at 60000 USDT, Cancel a KuCoin order by its order ID, List all my KuCoin accounts and balances
Not supported: Does not handle futures derivatives, margin lending, or fiat on-ramps — use for spot crypto market data, trading, and funding only.
Jentic publishes the only available OpenAPI specification for KuCoin API, keeping it validated and agent-ready. The KuCoin API exposes 25 endpoints for the KuCoin cryptocurrency exchange covering server time, symbols and tickers, order books, klines, currencies, account balances, spot order placement and cancellation, stop orders, fills, deposits, withdrawals, and inner-account transfers. Authentication uses three coupled headers — API key, HMAC signature, and an encrypted passphrase — which the spec models as separate apiKey schemes. The base path follows /api/v1 and /api/v2 prefixes, with v2 reserved for newer deposit-address and inner-transfer flows.
Install Jentic One Beta
Connect the KuCoin API to your agent
Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the KuCoin API, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.
Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.
1
Step 1: Jentic One Host machine
# On the machine that will host your Jentic One instance:
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh2
Step 2: Agent machine
# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh
jentic register # connects your agent to your Jentic One instanceJentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.
Capabilities
What an agent can do with KuCoin API.
Place market, limit, and stop spot orders, including bulk submissions, on KuCoin trading pairs
Cancel a single order by ID and list active stop orders for monitoring
Fetch tickers, 24-hour stats, level-2 order book snapshots, candle klines, and trade histories
List accounts, retrieve a single account detail, and inspect available currencies
Read paginated fills, deposit history, and withdrawal history for reconciliation
Apply a withdrawal to a whitelisted address and move funds via inner account transfers
Use Cases
Patterns agents use KuCoin API for, with concrete tasks.
★ Algorithmic spot trading bot
A trading bot subscribes to ticker, klines, and order book endpoints to compute signals, then places and cancels orders via POST /api/v1/orders and DELETE /api/v1/orders/{orderId}. KuCoin requires the API key, HMAC-SHA256 signature, and encrypted passphrase on every private call, so the signing layer is the bulk of the integration work. Direct integration takes 1-2 weeks; a structured client cuts that to a few days.
Place a limit buy via POST /api/v1/orders with symbol 'BTC-USDT', side 'buy', type 'limit', size '0.01', price '60000' and confirm the orderId in the response.
Stop-loss and take-profit automation
A risk system places stop orders via POST /api/v1/stop-order to bracket spot positions, then watches GET /api/v1/stop-order to confirm activation status. Stop orders sit alongside live limit orders in the KuCoin engine, which lets the bot off-load conditional execution to the exchange rather than holding logic in the bot.
Place a stop-loss via POST /api/v1/stop-order for symbol 'ETH-USDT', side 'sell', type 'limit', stopPrice '2900' and price '2895'.
Funding and treasury automation
A treasury workflow uses GET /api/v1/deposits, GET /api/v1/withdrawals, GET /api/v2/deposit-addresses, POST /api/v1/withdrawals, and POST /api/v2/accounts/inner-transfer to move funds in and out of KuCoin and between sub-accounts. Withdrawals require whitelisted addresses configured inside the KuCoin UI, so the API surface assumes prior wallet setup.
Apply a withdrawal via POST /api/v1/withdrawals with currency 'USDT', address '<whitelisted>', amount '500' and chain 'TRC20', then poll GET /api/v1/withdrawals to confirm status.
Agent-driven trading workflows via Jentic
An agent searches Jentic for 'place a kucoin order' and receives POST /api/v1/orders with its full input schema. Jentic computes the API key, HMAC signature, and encrypted passphrase from MAXsystem at request time, so the agent supplies only business inputs — symbol, size, side — and receives a structured response.
Use the Jentic MCP tool kucoin_place_order to place a market buy on 'BTC-USDT' with funds '50' USDT and return the orderId.
Key Endpoints
25 endpoints — jentic publishes the only available openapi specification for kucoin api, keeping it validated and agent-ready.
METHOD
PATH
DESCRIPTION
GET
/api/v1/market/allTickers
Get all tickers
GET
/api/v1/market/candles
Get klines for a symbol
GET
/api/v1/accounts
List accounts and balances
POST
/api/v1/orders
Place a spot order
DELETE
/api/v1/orders/{orderId}
Cancel an order by ID
POST
/api/v1/stop-order
Place a stop order
POST
/api/v1/withdrawals
Apply a withdrawal
POST
/api/v2/accounts/inner-transfer
Inner transfer between accounts
GET
/api/v1/market/allTickers
Get all tickers
GET
/api/v1/market/candles
Get klines for a symbol
GET
/api/v1/accounts
List accounts and balances
POST
/api/v1/orders
Place a spot order
DELETE
/api/v1/orders/{orderId}
Cancel an order by ID
POST
/api/v1/stop-order
Place a stop order
POST
/api/v1/withdrawals
Apply a withdrawal
POST
/api/v2/accounts/inner-transfer
Inner transfer between accounts
Why Jentic?
Three things that make agents converge on Jentic-routed access.
Credential isolation
KuCoin's API key, secret, and encrypted passphrase are stored in the Jentic vault (MAXsystem). Jentic computes the HMAC-SHA256 signature and the passphrase encryption on every private call, so agents never see any of the three secrets.
Intent-based discovery
Agents search Jentic by intent (e.g. 'place a kucoin order', 'list kucoin balances') and Jentic returns the matching /api/v1 or /api/v2 operation with its parameter schema, abstracting the three-header signing model.
Time to first call
Direct KuCoin integration: 1-2 weeks for HMAC plus passphrase signing, retry semantics, and weighted rate-limit handling. Through Jentic: under a day — search, load schema, execute.
Related APIs
Alternatives and complements available in the Jentic catalogue.
FAQs
Specific to using KuCoin API through Jentic.
Why is there no official OpenAPI spec for KuCoin API?
KuCoin does not publish an OpenAPI specification. Jentic generates and maintains this spec so that AI agents and developers can call KuCoin API via structured tooling. It is validated against the live API and kept up to date. Get started at https://app.jentic.com/sign-up.
What authentication does the KuCoin API use?
Private endpoints require three coupled headers — KC-API-KEY, KC-API-SIGN (HMAC-SHA256 of the request), and KC-API-PASSPHRASE (encrypted with the API secret). The spec models these as three apiKey schemes that all apply together. Jentic computes the signature inside MAXsystem so the secret and passphrase never enter the agent's context.
Can I place stop-loss orders with the KuCoin API?
Yes. Use POST /api/v1/stop-order with stopPrice and price fields to register a conditional order on the matching engine. Active stops appear in GET /api/v1/stop-order until they are triggered or cancelled.
What are the rate limits for the KuCoin API?
KuCoin enforces weighted rate limits per endpoint group, with public market data on a separate counter from private trading endpoints. Limits are tightened for accounts that hit penalty thresholds — refer to docs.kucoin.com for current figures and design retries with exponential backoff.
How do I move funds between my KuCoin accounts through Jentic?
Search Jentic for 'kucoin inner transfer', load POST /api/v2/accounts/inner-transfer, and execute it with currency, from-account, to-account, and amount. Install with pip install jentic and Jentic injects the signed headers automatically.
Does the KuCoin API support futures and margin trading?
This spec covers the spot REST API surface. KuCoin Futures and margin endpoints sit on a separate API (futures.kucoin.com) and are not enumerated here — bring those in via a separate spec when needed.
GET STARTED