KUCOIN API
HomeChange LogAPI DOC V1
Language
  • 繁體中文(即將上綫)
  • Русский (скоро)
HomeChange LogAPI DOC V1
Language
  • 繁體中文(即將上綫)
  • Русский (скоро)
SDK
Telegram
Kucoin
  1. Websocket API
  2. Spot Trading
  3. Public Channels
  • Introduction
  • Authentication
  • Enums Definitions
  • Terms Definitions
  • SDK
  • Rate Limit
  • Change Log
  • 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
        • Add sub-account
        • Add sub-account Margin Permission
        • Add sub-account Futures Permission
        • Get sub-account List - Summary Info
        • Get sub-account Detail - Balance
        • Get sub-account List - Spot Balance (V2)
        • Get sub-account List - Futures Balance (V2)
      • Sub Account API
        • Add sub-account API
        • Modify sub-account API
        • Get sub-account API List
        • Delete sub-account API
      • Deposit
        • Add Deposit Address (V3)
        • Get Deposit Address (V3)
        • Get Deposit History
      • Withdrawals
        • Get Withdrawal Quotas
        • Withdraw (V3)
        • Cancel Withdrawal
        • Get Withdrawal History
        • Get Withdrawal History By ID
      • Transfer
        • Get Transfer Quotas
        • Flex Transfer
      • Trade Fee
        • Get Basic Fee - Spot/Margin
        • Get Actual Fee - Spot/Margin
        • Get Actual Fee - Futures
    • Spot Trading
      • Market Data
        • Get Announcements
        • Get Currency
        • Get All Currencies
        • Get Symbol
        • Get All Symbols
        • Get Ticker
        • Get All Tickers
        • Get Trade History
        • Get Klines
        • Get Part OrderBook
        • Get Full OrderBook
        • Get Call Auction Part OrderBook
        • Get Call Auction Info
        • Get Fiat Price
        • Get 24hr Stats
        • Get Market List
        • Get Client IP Address
        • Get Server Time
        • Get Service Status
      • 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
      • Market Data
        • Get Symbols - Cross Margin
        • Get ETF Info
        • Get Mark Price Detail
        • Get Margin Config
        • Get Mark Price List
        • Get Symbols - Isolated Margin
      • Orders
        • Add Order
        • Add Order Test
        • Cancel Order By OrderId
        • Cancel Order By ClientOid
        • Cancel All Orders By Symbol
        • Get Symbols With Open Order
        • Get Open Orders
        • Get Closed Orders
        • Get Trade History
        • Get Order By OrderId
        • Get Order By ClientOid
      • Debit
        • Borrow
        • Get Borrow History
        • Repay
        • Get Repay History
        • Get Interest History
        • Modify Leverage
      • Credit
        • Get Loan Market
        • Get Loan Market Interest Rate
        • Purchase
        • Modify Purchase
        • Get Purchase Orders
        • Redeem
        • Get Redeem Orders
      • Risk Limit
        • Get Margin Risk Limit
    • Futures Trading
      • Introduction
      • Market Data
        • Get Symbol
        • Get All Symbols
        • Get Ticker
        • Get All Tickers
        • Get Full OrderBook
        • Get Part OrderBook
        • Get Trade History
        • Get Klines
        • Get Mark Price
        • Get Spot Index Price
        • Get Interest Rate Index
        • Get Premium Index
        • Get 24hr stats
        • Get Server Time
        • Get Service Status
      • 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
        • Get Margin Mode
        • Switch Margin Mode
        • Batch Switch Margin Mode
        • Get Max Open Size
        • Get Position Details
        • Get Position List
        • Get Positions History
        • Get Max Withdraw Margin
        • Get Cross Margin Leverage
        • Modify Cross Margin Leverage
        • Add Isolated Margin
        • Remove Isolated Margin
        • Get Cross Margin Risk Limit
        • Get Isolated Margin Risk Limit
        • Modify Isolated Margin Risk Limit
      • Funding Fees
        • Get Current Funding Rate
        • Get Public Funding History
        • Get Private Funding History
    • Copy Trading
      • Introduction
      • Add Order Test
      • Add Take Profit And Stop Loss Order
      • Cancel Order By OrderId
      • Cancel Order By ClientOid
      • Add Order
      • Get Max Open Size
      • Modify Isolated Margin Auto-Deposit Status
      • Modify Isolated Margin Risk Limit
      • Remove Isolated Margin
      • Add Isolated Margin
      • Get Max Withdraw Margin
    • Convert
      • Introduction
      • Get Convert Symbol
      • Get Convert Currencies
      • Add Convert Order
      • Get Convert Quote
      • Get Convert Order Detail
      • Get Convert Order History
      • Add Convert Limit Order
      • Get Convert Limit Quote
      • Get Convert Limit Order Detail
      • Get Convert Limit Orders
      • Cancel Convert Limit Order
    • Earn
      • Purchase
      • Get Redeem Preview
      • Redeem
      • Get Savings Products
      • Get Promotion Products
      • Get Staking Products
      • Get KCS Staking Products
      • Get ETH Staking Products
      • Get Account Holding
    • VIP Lending
      • Introduction
      • Get Discount Rate Configs
      • Get Loan Info
      • Get Accounts
    • Affiliate
      • Introduction
      • Get Account
    • Broker
      • Introduction
      • Instructions
      • Broker Application
      • API Broker
        • Introduction
        • Get Broker Rebate
      • Exchange Broker
        • Introduction
        • Submit KYC
        • Get KYC Status
        • Get KYC Status List
        • Get Broker Info
        • Add sub-account
        • Get sub-account
        • Add sub-account API
        • Get sub-account API
        • Modify sub-account API
        • Delete sub-account API
        • Transfer
        • Get Transfer History
        • Get Deposit List
        • Get Deposit Detail
        • Get Withdraw Detail
        • Get Broker Rebate
  • Websocket API
    • Base Info
      • Introduction
      • Get Public Token - Spot/Margin
      • Get Private Token - Spot/Margin
      • Get Public Token - Futures
      • Get Private Token - Futures
    • Spot Trading
      • Public Channels
        • Ticker
        • All Tickers
        • Orderbook - Level1
        • Orderbook - Level5
        • Orderbook - Level50
        • Orderbook - Increment
        • Call Auction Orderbook - Level50
        • Call Auction Data
        • Klines
        • Trade
        • Symbol Snapshot
        • Market Snapshot
      • Private Channels
        • Order V2
        • Order V1
        • Balance
        • Stop Order
    • Margin Trading
      • Public Channels
        • Index Price
        • Mark Price
      • Private Channels
        • Cross Margin Position
        • Isolated Margin Position
    • Futures Trading
      • Public Channels
        • Ticker V2
        • Ticker V1
        • Orderbook - Level5
        • Orderbook - Level50
        • Orderbook- Increment
        • Klines
        • Trade
        • Instrument
        • Funding Fee Settlement
        • Symbol Snapshot
      • Private Channels
        • Orders
        • Balance
        • Positions
        • Margin Mode
        • Cross Margin Leverage
        • Stop Orders
    • Add/Cancel Order
      • Add Order
      • Cancel Order
  • Error Code
    • HTTP
    • Spot
    • Margin
    • Futures
    • Earn
    • Broker
    • CopyTrading
  • 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
      • Orders
        • Add Order - Old
        • Add Order Test - Old
        • Batch Add Orders - Old
        • Cancel Order By OrderId - Old
        • Cancel Order By ClientOid - Old
        • Batch Cancel Order - Old
        • Get Orders List - Old
        • Get Recent Orders List - Old
        • Get Order By OrderId - Old
        • Get Order By ClientOid - Old
        • Get Trade History - Old
        • Get Recent Trade History - Old
    • Margin Trading
      • Get Account Detail - Margin
      • Add Order - V1
      • Add Order Test - V1
      • Get Account List - Isolated Margin - V1
      • Get Account Detail - Isolated Margin - V1
    • Futures Trading
      • Modify Isolated Margin Auto-Deposit Status
      • Cancel All Orders - V1
  • Developing
    • Introduction
    • Margin Trading
      • Add Stop Order
      • Cancel Stop Order By OrderId
      • Cancel Stop Order By ClientOid
      • 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
    • Futures Trading
      • Get Cross Mode Margin Requirement
    • UTA
      • Market data
        • Get Announcements
        • Get Currency
        • Get Symbol
        • Get Ticker
        • Get Recent Trades
        • Get OrderBook
        • Get Klines
        • Get Futures Funding Rate
        • Get Funding Rate History
        • Get Cross Margin Config
        • Get Service Status
      • Account
        • Get Account
        • Get Sub Account
        • Get Actual Fee
        • Get Transfer Quotas
        • Get Account Ledger
      • TRADE
        • Set DCP
        • Get DCP
    • Flex Transfer
  1. Websocket API
  2. Spot Trading
  3. Public Channels

Orderbook - Level50

wss://ws-api-spot.kucoin.com

Topic:/spotMarket/level2Depth50:{symbol},{symbol}#

Description
The system will return the 50 best ask/bid orders data
A topic supports up to 100 symbols.
If there is no change in the market, data will not be pushed
Push frequency: once every 100ms

Subscribe Message#

{
  "id": 1545910660739,
  "type": "subscribe",
  "topic": "/spotMarket/level2Depth50:BTC-USDT",
  "response": true
}

Response#

Data Schema
orderbookLevel50
type
string 
required
topic
string 
required
subject
string 
required
data
object 
required
asks
array [array] 
required
price, size
bids
array [array] 
required
timestamp
integer <int64>
required
Example
{
    "topic": "/spotMarket/level2Depth50:BTC-USDT",
    "type": "message",
    "subject": "level2",
    "data": {
        "asks": [
            [
                "95964.3",
                "0.08168874"
            ],
            [
                "95967.9",
                "0.00985094"
            ],
            [
                "95969.9",
                "0.00078081"
            ],
            [
                "95971.2",
                "0.10016039"
            ],
            [
                "95971.3",
                "0.12531139"
            ],
            [
                "95971.7",
                "0.00291"
            ],
            [
                "95971.9",
                "0.10271829"
            ],
            [
                "95973.3",
                "0.00021"
            ],
            [
                "95974.7",
                "0.10271829"
            ],
            [
                "95976.9",
                "0.03095177"
            ],
            [
                "95977",
                "0.10271829"
            ],
            [
                "95978.7",
                "0.00022411"
            ],
            [
                "95979.1",
                "0.00023017"
            ],
            [
                "95981",
                "0.00022008"
            ],
            [
                "95981.2",
                "0.14330324"
            ],
            [
                "95982.3",
                "0.27922082"
            ],
            [
                "95982.5",
                "0.02302674"
            ],
            [
                "95983.8",
                "0.00011035"
            ],
            [
                "95985",
                "0.00104222"
            ],
            [
                "95985.1",
                "0.00021808"
            ],
            [
                "95985.5",
                "0.211127"
            ],
            [
                "95986.2",
                "0.09690904"
            ],
            [
                "95986.3",
                "0.31261"
            ],
            [
                "95986.9",
                "0.09225037"
            ],
            [
                "95987",
                "0.01042013"
            ],
            [
                "95990.5",
                "0.12712438"
            ],
            [
                "95990.6",
                "0.0916115"
            ],
            [
                "95992.2",
                "0.279"
            ],
            [
                "95992.7",
                "0.00521084"
            ],
            [
                "95995.2",
                "0.00033"
            ],
            [
                "95999.1",
                "0.02973561"
            ],
            [
                "96001.1",
                "0.083825"
            ],
            [
                "96002.6",
                "0.01900906"
            ],
            [
                "96002.7",
                "0.00041665"
            ],
            [
                "96002.8",
                "0.12531139"
            ],
            [
                "96002.9",
                "0.279"
            ],
            [
                "96004.8",
                "0.02081884"
            ],
            [
                "96006.3",
                "0.00065542"
            ],
            [
                "96008.5",
                "0.00033166"
            ],
            [
                "96011",
                "0.08776246"
            ],
            [
                "96012.5",
                "0.279"
            ],
            [
                "96013.3",
                "0.00066666"
            ],
            [
                "96013.9",
                "0.26097183"
            ],
            [
                "96014",
                "0.01087009"
            ],
            [
                "96017",
                "0.06248892"
            ],
            [
                "96017.1",
                "0.20829641"
            ],
            [
                "96022",
                "0.00107066"
            ],
            [
                "96022.1",
                "0.279"
            ],
            [
                "96022.9",
                "0.0006499"
            ],
            [
                "96024.6",
                "0.00104131"
            ]
        ],
        "bids": [
            [
                "95964.2",
                "1.35483359"
            ],
            [
                "95964.1",
                "0.01117492"
            ],
            [
                "95962.1",
                "0.0062"
            ],
            [
                "95961.8",
                "0.03081549"
            ],
            [
                "95961.7",
                "0.10271829"
            ],
            [
                "95958.5",
                "0.04681571"
            ],
            [
                "95958.4",
                "0.05177498"
            ],
            [
                "95958.2",
                "0.00155911"
            ],
            [
                "95957.8",
                "0.10271829"
            ],
            [
                "95954.7",
                "0.16312181"
            ],
            [
                "95954.6",
                "0.44102109"
            ],
            [
                "95952.6",
                "0.10271829"
            ],
            [
                "95951.3",
                "0.0062"
            ],
            [
                "95951",
                "0.17075141"
            ],
            [
                "95950.9",
                "0.279"
            ],
            [
                "95949.5",
                "0.13567811"
            ],
            [
                "95949.2",
                "0.05177498"
            ],
            [
                "95948.3",
                "0.10271829"
            ],
            [
                "95947.2",
                "0.04634798"
            ],
            [
                "95944.7",
                "0.10271829"
            ],
            [
                "95944.2",
                "0.05177498"
            ],
            [
                "95942.3",
                "0.26028569"
            ],
            [
                "95942.2",
                "0.10271829"
            ],
            [
                "95940.6",
                "0.12531139"
            ],
            [
                "95940.2",
                "0.43349327"
            ],
            [
                "95938.3",
                "0.01041604"
            ],
            [
                "95937.4",
                "0.04957577"
            ],
            [
                "95937.2",
                "0.00305"
            ],
            [
                "95936.3",
                "0.10271829"
            ],
            [
                "95934",
                "0.05177498"
            ],
            [
                "95931.9",
                "0.03394093"
            ],
            [
                "95931.8",
                "0.10271829"
            ],
            [
                "95930",
                "0.01041814"
            ],
            [
                "95927.9",
                "0.10271829"
            ],
            [
                "95927",
                "0.13312774"
            ],
            [
                "95926.9",
                "0.33077498"
            ],
            [
                "95924.9",
                "0.10271829"
            ],
            [
                "95924",
                "0.00180915"
            ],
            [
                "95923.8",
                "0.00022434"
            ],
            [
                "95919.6",
                "0.00021854"
            ],
            [
                "95919.1",
                "0.01471872"
            ],
            [
                "95919",
                "0.05177498"
            ],
            [
                "95918.1",
                "0.00001889"
            ],
            [
                "95917.8",
                "0.1521089"
            ],
            [
                "95917.5",
                "0.00010962"
            ],
            [
                "95916.2",
                "0.00021958"
            ],
            [
                "95915.5",
                "0.12531139"
            ],
            [
                "95915.3",
                "0.279"
            ],
            [
                "95913.6",
                "0.01739249"
            ],
            [
                "95913.5",
                "0.05177498"
            ]
        ],
        "timestamp": 1733124805073
    }
}

Request

Query Params
token
string 
required
The token required to establish a websocket connection
Example:
2neAiuYvAU61ZDXANAGAsiL4-iAExhsBXZxftpOeh_55i3Ysy2q2LEsEWU64mdzUOPusi34M_wGoSf7iNyEWJ_dm3WIc2VYfQG_14cxWCE7mHih-uOn90tiYB9J6i9GjsxUuhPw3Blq6rhZlGykT3Vp1phUafnulOOpts-MEmEEospqlVGyc9kAqzTuhanTCJBvJHl5Vs9Y=.CHw5RcLXqmXUv-MVK2otxw==
connectId
string 
optional
Connection Id, a unique value taken from the client side. Both the id of the welcome message and the id of the error message are connectId.
Example:
121345
Modified at 2025-06-25 09:39:43
Previous
Orderbook - Level5
Next
Orderbook - Increment