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.
Install Jentic One Beta
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.
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 | shStep 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.
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
GET STARTED
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.
KuCoin publishes official OpenAPI specifications for its API in its own Kucoin/kucoin-universal-sdk GitHub repository, split across 23 per-product documents under spec/rest/api with no merged file. This page describes a curated, agent-optimized Jentic specification that covers the spot REST surface as one document: 25 endpoints for 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. Private requests carry the KC-API-KEY, KC-API-SIGN, KC-API-TIMESTAMP, KC-API-PASSPHRASE and KC-API-KEY-VERSION headers; this specification models three of them 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.
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 an external address and move funds via inner account transfers
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}. Private calls carry KC-API-KEY, KC-API-SIGN, KC-API-TIMESTAMP, KC-API-PASSPHRASE and KC-API-KEY-VERSION, with the signature recomputed per request over timestamp, method, endpoint and body, so the signing layer is the bulk of the integration work.
Place a limit buy via POST /api/v1/orders with a fresh clientOid, 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 with a fresh clientOid, 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 need the API key's Transfer permission, which KuCoin only grants with IP restriction enabled, and if you switch on its favourite-address check the destination must already be saved on the account, so the API surface assumes prior wallet setup.
Apply a withdrawal via POST /api/v1/withdrawals with currency 'USDT', address '<saved-address>', 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. Your KuCoin key, secret, and passphrase stay in your own Jentic One instance rather than the agent's environment, so the agent supplies only business inputs - clientOid, symbol, size, side - and receives a structured response.
Place a market buy via POST /api/v1/orders with a fresh clientOid, symbol 'BTC-USDT', side 'buy', type 'market', funds '50' and return the orderId.
25 endpoints — kucoin publishes official openapi specifications for its api in its own kucoin/kucoin-universal-sdk github repository, split across 23 per-product documents under spec/rest/api with no merged file.
METHOD
PATH
DESCRIPTION
/api/v1/market/allTickers
Get all tickers
/api/v1/market/candles
Get klines for a symbol
/api/v1/accounts
List accounts and balances
/api/v1/orders
Place a spot order
/api/v1/orders/{orderId}
Cancel an order by ID
/api/v1/stop-order
Place a stop order
/api/v1/withdrawals
Apply a withdrawal
/api/v2/accounts/inner-transfer
Inner transfer between accounts
/api/v1/market/allTickers
Get all tickers
/api/v1/market/candles
Get klines for a symbol
/api/v1/accounts
List accounts and balances
/api/v1/orders
Place a spot order
/api/v1/orders/{orderId}
Cancel an order by ID
Three things that make agents converge on Jentic-routed access.
Credential isolation
Your KuCoin key, secret, and passphrase are stored once, encrypted, by your own Jentic One instance rather than in the agent's environment. None of the three secrets enter the agent's prompt, logs, or context.
Intent-based discovery
Agents search Jentic by intent such as 'place a KuCoin order' or 'list KuCoin balances', and Jentic returns the matching v1 or v2 operation with its parameter schema, so the agent calls the right endpoint without browsing the reference docs or hand-assembling the signed headers.
Time to first call
Alternatives and complements available in the Jentic catalogue.
Specific to using KuCoin API through Jentic.
Is there a KuCoin MCP server?
You don't need an MCP server to give your agent the KuCoin API. Jentic connects it directly from the API Directory: import KuCoin, store your key, secret, and passphrase once, and your agent can read markets, place and cancel spot orders, and move funds across the 25 endpoints in this specification, without loading another server's tool definitions into its context.
What authentication does the KuCoin API use?
KuCoin's own docs state that private REST requests must contain five headers: KC-API-KEY, KC-API-SIGN (the base64-encoded HMAC-SHA256 of timestamp + method + endpoint + body, computed with your API secret), KC-API-TIMESTAMP, KC-API-PASSPHRASE (itself HMAC-SHA256-encrypted with the API secret for v2 keys) and KC-API-KEY-VERSION. This specification models three of the five as apiKey schemes that apply together, and marks them required on 15 of its 25 operations; the remaining 10 market-data operations need no credential. Your key, secret, and passphrase are stored by your own Jentic One instance rather than in the agent's environment.
Can I place stop-loss orders with the KuCoin API?
Yes. Use POST /api/v1/stop-order with clientOid, symbol, side and stopPrice, adding price for a limit stop, 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 restricts private endpoints per account user ID and per endpoint, and public endpoints per IP, so market data sits on a separate counter from trading. Its docs give a Cloudflare IP ceiling that all endpoints share, currently 500/10s, plus a stated limit on each private endpoint's own page, such as 45 times/3s for POST /api/v1/orders. Check the KuCoin API docs 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 clientOid, currency, from, to, and amount, all of which the operation marks required. You install Jentic One once from github.com/jentic/jentic-one, and your KuCoin key, secret, and passphrase stay in that instance rather than in the agent's environment.
Does the KuCoin API support futures and margin trading?
This specification covers the spot REST surface only. KuCoin Futures is served from a separate host, api-futures.kucoin.com, so it is a different API and is not enumerated here. Margin trading is not on a separate host: margin order endpoints such as /api/v1/margin/order are served from the same base as spot, https://api.kucoin.com, but this specification does not include them. KuCoin publishes official OpenAPI documents for both futures and margin at https://github.com/Kucoin/kucoin-universal-sdk/tree/main/spec/rest/api, so bring those in from there when you need them.
Can I limit what my agent is allowed to do with the KuCoin API?
Yes, on two levels. Because you run Jentic One yourself, you decide exactly which KuCoin operations your agent may call, so you can grant read-only access to market data like GET /api/v1/market/allTickers and GET /api/v1/accounts while withholding everything else. Money-moving operations such as POST /api/v1/withdrawals and POST /api/v2/accounts/inner-transfer are not available to the agent unless you deliberately add them to that set. KuCoin also scopes the credential itself: its API key permissions are General (read-only queries), Spot, Margin, Futures and Transfer, and the Transfer permission that covers withdrawals and deposit addresses requires IP restriction to be enabled. Your key, secret, and passphrase stay inside your instance rather than entering the agent's context.
/api/v1/stop-order
Place a stop order
/api/v1/withdrawals
Apply a withdrawal
/api/v2/accounts/inner-transfer
Inner transfer between accounts