- Introduction
- Authentication
- Enums Definitions
- Terms Definitions
- SDK
- Rate Limit
- Change Log
- User Service
- REST
- Account Info
- Account & Funding
- Get Account Summary Info
- Get Apikey Info
- Get Account Type - Spot
- Get Account List - Spot
- Get Account Detail - Spot
- Get Account - Cross Margin
- Get Account - Isolated Margin
- Get Account - Futures
- Get Account Ledgers - Spot/Margin
- Get Account Ledgers - Trade_hf
- Get Account Ledgers - Margin_hf
- Get Account Ledgers - Futures
- Sub Account
- Sub Account API
- Deposit
- Withdrawals
- Transfer
- Trade Fee
- Account & Funding
- Spot Trading
- Market Data
- Get AnnouncementsGET
- Get CurrencyGET
- Get All CurrenciesGET
- Get Symbol GET
- Get All SymbolsGET
- Get TickerGET
- Get All TickersGET
- Get Trade HistoryGET
- Get KlinesGET
- Get Part OrderBookGET
- Get Full OrderBookGET
- Get Call Auction Part OrderBookGET
- Get Call Auction InfoGET
- Get Fiat PriceGET
- Get 24hr StatsGET
- Get Market ListGET
- Get Client IP AddressGET
- Get Server TimeGET
- Get Service StatusGET
- Orders
- Add Order
- Add Order Sync
- Add Order Test
- Batch Add Orders
- Batch Add Orders Sync
- Cancel Order By OrderId
- Cancel Order By OrderId Sync
- Cancel Order By ClientOid
- Cancel Order By ClientOid Sync
- Cancel Partial Order
- Cancel All Orders By Symbol
- Cancel All Orders
- Modify Order
- Get Order By OrderId
- Get Order By ClientOid
- Get Symbols With Open Order
- Get Open Orders
- Get Open Orders By Page
- Get Closed Orders
- Get Trade History
- Get DCP
- Set DCP
- Add Stop Order
- Cancel Stop Order By ClientOid
- Cancel Stop Order By OrderId
- Batch Cancel Stop Orders
- Get Stop Orders List
- Get Stop Order By OrderId
- Get Stop Order By ClientOid
- Add OCO Order
- Cancel OCO Order By OrderId
- Cancel OCO Order By ClientOid
- Batch Cancel OCO Order
- Get OCO Order By OrderId
- Get OCO Order By ClientOid
- Get OCO Order Detail By OrderId
- Get OCO Order List
- Margin Trading
- Futures Trading
- Market Data
- Orders
- Add Order
- Add Order Test
- Batch Add Orders
- Add Take Profit And Stop Loss Order
- Cancel Order By OrderId
- Cancel Order By ClientOid
- Batch Cancel Orders
- Cancel All Orders
- Cancel All Stop orders
- Get Order By OrderId
- Get Order By ClientOid
- Get Order List
- Get Recent Closed Orders
- Get Stop Order List
- Get Open Order Value
- Get Recent Trade History
- Get Trade History
- Positions
- Funding Fees
- Copy Trading
- Earn
- VIP Lending
- Affiliate
- Broker
- Websocket API
- Error Code
- Abandoned Endpoints
- Introduction
- Account & Funding
- Get sub-account List - Summary Info (V1)
- Get sub-account List - Spot Balance (V1)
- Get Deposit Addresses (V2)
- Get Deposit Addresses - V1
- Sub-account Transfer
- Get Deposit History - Old
- Internal Transfer
- Get Futures Account Transfer Out Ledger
- Get Withdrawal History - Old
- Futures Account Transfer Out
- Futures Account Transfer In
- Add Deposit Address - V1
- Withdraw - V1
- Spot Trading
- Margin Trading
- Futures Trading
- Developing
Get Klines
GET
https://api.kucoin.com/api/v1/market/candles
domain:Spot
api-channel:Public
api-permission:NULL
api-rate-limit-pool:Public
sdk-service:Spot
sdk-sub-service:Market
sdk-method-name:getKlines
api-rate-limit-weight:3
Description
For each query, the system would return at most 1500 pieces of data. To obtain more data, please page the data by time.
Tips
Request
Query Params
symbol
string
required
Example:
BTC-USDT
type
enum<string>
required
Allowed values:
1min3min5min15min30min1hour2hour4hour6hour8hour12hour1day1week1month
Example:
1min
startAt
integer <int64>
optional
Default:
0
Example:
1566703297
endAt
integer <int64>
optional
Default:
0
Example:
1566789757
Request samples
Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://api.kucoin.com/api/v1/market/candles?symbol=BTC-USDT&type=1min&startAt=1566703297&endAt=1566789757'Responses
🟢200OK
application/json
Body
code
string
required
data
array [array]
required
string
optional
Example
{
"code": "200000",
"data": [
[
"1566789720",
"10411.5",
"10401.9",
"10411.5",
"10396.3",
"29.11357276",
"302889.301529914"
],
[
"1566789660",
"10416",
"10411.5",
"10422.3",
"10411.5",
"15.61781842",
"162703.708997029"
],
[
"1566789600",
"10408.6",
"10416",
"10416",
"10405.4",
"12.45584973",
"129666.51508559"
]
]
}Modified at 2025-03-20 04:04:17