KUCOIN API - EU
SDK
Telegram
Kucoin
    • Introduction
    • Authentication
    • Enums Definitions
    • Terms Definitions
    • SDK
    • Rate Limit
    • Classic REST
      • Account Info
        • Account & Funding
          • Get Account Summary Info
          • Get KYC Regions
          • 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 Ledgers - Spot/Margin
          • Get Account Ledgers - Trade_hf
          • Get Account Ledgers - Margin_hf
        • Sub Account
          • Add sub-account
          • Add sub-account Margin Permission
          • Get sub-account List - Summary Info
          • Get sub-account Detail - Balance
          • Get sub-account List - Spot Balance (V2)
        • Sub Account API
          • Get sub-account API List
          • Add sub-account API
          • Modify sub-account API
          • Delete sub-account API
        • Deposit
          • Add Deposit Address (V3)
          • Get Deposit Address (V3)
          • Get Deposit History
        • Withdrawals
          • Get Withdrawal Quotas
          • Withdraw (V4)
          • 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
      • 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 Symbols - Isolated Margin
          • Get Mark Price Detail
          • Get Margin Config
          • Get Mark Price List
          • Get Margin Collateral Ratio
          • Get Market Available Inventory
        • 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
        • Risk Limit
          • Get Margin Risk Limit
      • Earn
        • Simple Earn
          • Purchase
          • Get Redeem Preview
          • Redeem
          • Get Savings Products
          • Get Promotion Products
          • Get Account Holding
      • Broker
        • Introduction
        • Broker Application
        • Instructions
        • Broker Pro
          • Introduction
          • Broker Fast API Service
          • Get Broker Rebate
          • Get Commission
          • Get User List
          • Get User Transactions
    • Classic Websocket
      • Base Info
        • Introduction
        • Get Public Token - Classic Spot/Margin
        • Get Private Token - Classic Spot/Margin
      • Spot Trading
        • Public Channels
          • Ticker
          • All Tickers
          • Orderbook - Level 1
          • Orderbook - Level 5
          • Orderbook - Level 50
          • Orderbook - Increment
          • Call Auction Orderbook - Level 50
          • 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
    • Error Code
      • HTTP
      • Spot
      • Margin
      • Earn
      • Websocket
    • 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
        • Get Deposit History - Old
        • Get Withdrawal History - Old
        • 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
    • Developing
      • Introduction

    Enums Definitions

    TimeInForce#

    Time in Force is a special strategy used during trading. It is used to specify how long an order shall remain active before being executed or expiring.
    Note: Order fills include self-fills. Market orders are not supported by the Time in Force strategy.
    ParamDescription
    GTCGood Till Canceled, Expires only when canceled
    GTTGood Till Time, Expires at a specified time
    IOCImmediate Or Cancel, Execute the portions that can be executed immediately and cancel the rest; this does not enter the order book.
    FOKFill Or Kill, Cancel if the order cannot be completely filled.

    STP (Self-Trade Prevention)#

    Self-Trade Prevention is an option in advanced settings. It is not selected by default. If you specify STP when placing orders, your order won't be matched by another one which is also yours. Conversely, if STP is not specified in advanced, your order can be matched by another one of your own orders. It should be noted that only the taker's protection strategy is effective.
    For spot STP, it should be noted that the STP function only occurs at the UID level, and spot already supports the master account level STP whitelist function. If needed, please join our official API Telegram group: https://t.me/KuCoin_API, or contact your account manager.
    ParamDescription
    DCDecrease and Cancel, Cancel the order with smaller size and change the order with larger size to the difference between old and new
    COCancel old, Cancel the old order
    CNCancel new, Cancel the new order
    CBCancel both, Cancel both sides

    Hidden Orders and Iceberg Orders (Hidden & Iceberg)#

    Hidden orders and iceberg orders can be set in advanced settings (iceberg orders are a special type of hidden order). When placing limit orders or stop limit orders, you can choose to execute according to either hidden orders or iceberg orders.
    Hidden orders are not shown in order books.
    Unlike hidden orders, iceberg orders are divided into visible and hidden portions. When engaging in iceberg orders, visible order sizes must be set. The minimum visible size for an iceberg order is 1/20 of the total order size.
    When matching, the visible portions of iceberg orders are matched first. Once the visible portions are fully matched, hidden portions will emerge. This will continue until the order is fully filled.
    Note:
    The system will charge taker fees for hidden orders and iceberg orders.
    If you simultaneously set iceberg orders and hidden orders, your order will default to an iceberg order for execution.
    Modified at 2026-01-28 12:08:30
    Previous
    Authentication
    Next
    Terms Definitions