KUCOIN API
HomeChange LogAPI DOC V1
Language
  • 繁體中文(即將上綫)
  • Русский (скоро)
HomeChange LogAPI DOC V1
More
SDK
Telegram
Kucoin
  1. Developing
  2. UTA
  3. Market data
  • Introduction
  • Authentication
  • Enums Definitions
  • Terms Definitions
  • SDK
  • Rate Limit
  • Change Log
  • User Service
    • Market Making Incentive Scheme
    • VIP Fast Track
    • Broker Program
  • 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
        • Get Currency
          GET
        • Get Symbol
          GET
        • Get Ticker
          GET
        • Get Recent Trades
          GET
        • Get OrderBook
          GET
        • Get Klines
          GET
        • Get Futures Funding Rate
          GET
        • Get Funding Rate History
          GET
        • Get Cross Margin Config
          GET
        • Get Service Status
          GET
      • Account
        • Get Account
        • Get Sub Account
        • Get Actual Fee
        • Get Transfer Quotas
        • Get Account Ledger
      • TRADE
        • Set DCP
        • Get DCP
    • Flex Transfer
      POST
  1. Developing
  2. UTA
  3. Market data

Get Announcements

GET
https://api.kucoin.com/api/ua/v1/market/announcement
domain:Spot
api-channel:Public
api-permission:NULL
api-rate-limit-pool:Public
sdk-service:Spot
sdk-sub-service:Market
sdk-method-name:getAnnouncements_UA
api-rate-limit-weight:20
Description
This interface can obtain the latest news announcements, and the default page search is for announcements within a month.

Request

Query Params
language
enum<string> 
optional
Language type
Allowed values:
zh_HKja_JPko_KRen_USpl_PLes_ESfr_FRar_AEit_ITid_IDnl_NLpt_PTvi_VNde_DEtr_TRms_MYru_RUth_THhi_INbn_BDfil_PHur_PK
Default:
en_US
Example:
en_US
type
enum<string> 
optional
Announcement types
Allowed values:
latest-announcements activities product-updates vip maintenance-updatesdelistings othersapi-campaigns new-listingsfutures-announcements
Default:
latest-announcements
Example:
latest-announcements
pageNumber
integer 
optional
Page number
Example:
1
pageSize
integer 
optional
Page size
Example:
50
startTime
integer <int64>
optional
Announcement online start time (milliseconds)
Example:
1729594043000
endTime
integer <int64>
optional
Announcement online end time (milliseconds)
Example:
1729697729000

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
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
curl --location --request GET 'https://api.kucoin.com/api/ua/v1/market/announcement?language=en_US&type=latest-announcements&pageNumber=1&pageSize=50&startTime=1729594043000&endTime=1729697729000'

Responses

🟢200OK
application/json
Body
code
string 
required
data
object 
required
totalNumber
integer 
required
Total Number
totalPage
integer 
required
Total Page
pageNumber
integer 
required
pageNumber
pageSize
integer 
required
Page size
list
array [object {7}] 
required
Example
{
  "code": "200000",
  "data": {
    "totalNumber": 14,
    "totalPage": 1,
    "pageNumber": 1,
    "pageSize": 50,
    "list": [
      {
        "id": 129275,
        "title": "KuCoin Trading Bot Will Delist the Orion Protocol (ORN) Project",
        "type": [
          "latest-announcements",
          "delistings"
        ],
        "description": "KuCoin Trading Bot Will Delist the Orion Protocol (ORN) Project",
        "releaseTime": 1729684087000,
        "language": "en_US",
        "url": "https://www.kucoin.com/announcement/kucoin-trading-bot-will-delist-the-orn-project?lang=en_US"
      },
      {
        "id": 129253,
        "title": "KuCoin Will Temporarily Close the Trading and Withdraw Services for Orion Protocol (ORN)",
        "type": [
          "latest-announcements"
        ],
        "description": "KuCoin will temporarily close the trading service for the ORN/USDT trading pair and withdraw service for Orion Protocol (ORN) at 8:00:00 on October 24, 2024 (UTC).",
        "releaseTime": 1729681569000,
        "language": "en_US",
        "url": "https://www.kucoin.com/announcement/en-kucoin-will-temporarily-close-the-trading-and-withdraw-services-for-orion-protocol-orn-20241023?lang=en_US"
      },
      {
        "id": 129209,
        "title": "2024 September VTHO Distribution for VET Holders Completed",
        "type": [
          "latest-announcements"
        ],
        "description": "2024 September VTHO Distribution for VET Holders Completed",
        "releaseTime": 1729679652000,
        "language": "en_US",
        "url": "https://www.kucoin.com/announcement/en-2024-september-vtho-distribution-for-vet-holders-completed?lang=en_US"
      },
      {
        "id": 129231,
        "title": "KuCoin Will Adjust the Price Increment of UNFIUP, UNFIDOWN",
        "type": [
          "latest-announcements"
        ],
        "description": "In order to increase market liquidity and improve trading experience, KuCoin will be adjusting the price increment unit (API symbol: Price Increment) of UNFIUP/USDT at 09:00:00 on October 25, 2024 (UTC), which will be more reasonable and beneficial for match making trade off.",
        "releaseTime": 1729679041000,
        "language": "en_US",
        "url": "https://www.kucoin.com/announcement/kucoin-etf-notice-241023?lang=en_US"
      },
      {
        "id": 129203,
        "title": "KuCard Halloween $8,000 to Giveaway - Trick or Trade, & Win Big!",
        "type": [
          "latest-announcements"
        ],
        "description": "Dear KuCoin Users, During the Halloween event period, KuCoin is offering generous rewards for all KuCard users. Pay more, earn more with KuCard. Don't miss out!",
        "releaseTime": 1729676521000,
        "language": "en_US",
        "url": "https://www.kucoin.com/announcement/kucard-halloween-activity?lang=en_US"
      },
      {
        "id": 129091,
        "title": "XDB Chain (XDB) GemSlot Campaign: Finish Easy Tasks to Share a 120 Million XDB Prize Pool!!",
        "type": [
          "latest-announcements"
        ],
        "description": "Complete simple tasks, and you can share the 120 million XDB prize pool!",
        "releaseTime": 1729674847000,
        "language": "en_US",
        "url": "https://www.kucoin.com/announcement/en-xdb-chain-xdb-gemslot-campaign-finish-easy-tasks-to-share-a-120-million-xdb-prize-pool-20241023?lang=en_US"
      },
      {
        "id": 129113,
        "title": "KuCoin Earn Will Be Launching the SCR Saving Coin",
        "type": [
          "latest-announcements"
        ],
        "description": "KuCoin Earn Will Be Launching the SCR Saving Coin",
        "releaseTime": 1729670536000,
        "language": "en_US",
        "url": "https://www.kucoin.com/announcement/kucoin-earn-will-be-launching-the-scr-saving-coin?lang=en_US"
      },
      {
        "id": 129069,
        "title": "Earn Wednesday Week 69: USDT Fixed 6% APR",
        "type": [
          "latest-announcements",
          "activities"
        ],
        "description": "Earn Wednesday Week 69: USDT Fixed 6% APR",
        "releaseTime": 1729670400000,
        "language": "en_US",
        "url": "https://www.kucoin.com/announcement/en-earn-wednesday-week-69-usdt-fixed-6-apr?lang=en_US"
      },
      {
        "id": 128867,
        "title": "Cros (CROS) Listing Campaign, 340,000 CROS to Giveaway!",
        "type": [
          "latest-announcements",
          "activities"
        ],
        "description": "Cros (CROS) Listing Campaign, 340,000 CROS to Giveaway!",
        "releaseTime": 1729667622000,
        "language": "en_US",
        "url": "https://www.kucoin.com/announcement/en-cros-cros-listing-campaign-340000-cros-to-giveaway?lang=en_US"
      },
      {
        "id": 129135,
        "title": "KuCoin Pre-Market Update: Closure & Delivery Schedule for X Empire (X)",
        "type": [
          "latest-announcements"
        ],
        "description": "KuCoin Pre-Market Update: Closure & Delivery Schedule for X Empire (X)",
        "releaseTime": 1729666270000,
        "language": "en_US",
        "url": "https://www.kucoin.com/announcement/en-kucoin-pre-market-update-closure-delivery-schedule-for-x-empire-x?lang=en_US"
      },
      {
        "id": 129157,
        "title": "KuCoin Futures Has Launched the USDT-Margined SCR Contract",
        "type": [
          "latest-announcements",
          "new-listings",
          "futures-announcements"
        ],
        "description": "KuCoin Futures Has Launched the USDT-Margined SCR Contract",
        "releaseTime": 1729663200000,
        "language": "en_US",
        "url": "https://www.kucoin.com/announcement/en-kucoin-futures-has-launched-the-usdt-margined-scr-contract?lang=en_US"
      },
      {
        "id": 129179,
        "title": "KuCoin Futures Has Launched the USDT-Margined DEEP Contract",
        "type": [
          "latest-announcements"
        ],
        "description": "KuCoin Futures Has Launched the USDT-Margined DEEP Contract",
        "releaseTime": 1729663200000,
        "language": "en_US",
        "url": "https://www.kucoin.com/announcement/en-kucoin-futures-has-launched-the-usdt-margined-deep-contract?lang=en_US"
      },
      {
        "id": 128845,
        "title": "Cros (CROS) Gets Listed on KuCoin! World Premiere!",
        "type": [
          "latest-announcements"
        ],
        "description": "Trading: 11:00 on October 23, 2024 (UTC)",
        "releaseTime": 1729655431000,
        "language": "en_US",
        "url": "https://www.kucoin.com/announcement/en-cros-cros-gets-listed-on-kucoin-world-premiere?lang=en_US"
      },
      {
        "id": 129045,
        "title": "KuCoin Isolated Margin Adds the Scroll (SCR) Trading Pair",
        "type": [
          "latest-announcements"
        ],
        "description": "To enrich the variety of assets available, KuCoin’s Isolated Margin Trading platform has added the Scroll (SCR) asset and trading pair.",
        "releaseTime": 1729594043000,
        "language": "en_US",
        "url": "https://www.kucoin.com/announcement/kucoin-isolated-margin-adds-scr?lang=en_US"
      }
    ]
  }
}
Modified at 8 days ago
Previous
Get Cross Mode Margin Requirement
Next
Get Currency