KuCoin API

Name: KuCoin API API
Brand: KuCoin API
Availability: InStock

★ 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.

Quickstart

Get started with KuCoin API in minutes using your preferred integration method.

# Add to your MCP client config (Claude Desktop, Cursor, Windsurf)
{
  "jentic": {
    "url": "https://api.jentic.com/mcp",
    "auth": "oauth"
  }
}

# Then ask your agent:
"place a spot order on kucoin"

# → Jentic returns the GET /events tool with parameter schema, agent executes.

Capabilities

What an agent can do with KuCoin API 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

GET STARTED

Start building with KuCoin API API

Explore with Jentic

View OpenAPI Document

Jentic publishes the only available OpenAPI document for KuCoin API, keeping it validated and agent-ready.

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.

Use Cases

Patterns agents use KuCoin API 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

Why though 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.

Alternative

Binance

Higher-volume exchange with deeper liquidity and broader pair coverage

Choose Binance when the strategy needs the deepest order book and the widest pair selection.

Alternative

Kraken

US-friendly spot exchange with HMAC-SHA512 signing and similar account endpoints

Choose Kraken when US regulatory standing and fiat on-ramps matter more than altcoin breadth.

Alternative

Bybit

Spot and derivatives exchange with similar API key plus HMAC model

Choose Bybit when the workflow spans both spot and derivatives on the same venue.

Complementary

CoinGecko

Cross-exchange market data used to validate KuCoin pricing

Use CoinGecko alongside KuCoin to compare prices across venues before placing trades.

FAQs

Specific to using KuCoin API 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.