KUCOIN API

Get Open Orders By Page

GET

https://api.kucoin.com/api/v1/hf/orders/active/page

domain:Spot

api-channel:Private

api-permission:General

api-rate-limit-pool:Spot

sdk-service:Spot

sdk-sub-service:Order

sdk-method-name:getOpenOrdersByPage

api-rate-limit-weight:2

Description

This interface is to obtain Spot active order (uncompleted order) lists by page. The returned data is sorted in descending order according to the create time of the order.

After the user successfully places an order, the order is in Active state, and the user can use inOrderBook to determine whether the order has entered the order. Canceled or fully filled orders are marked as completed Done status.

Tips

For high-frequency trading users, we recommend locally caching, maintaining your own order records, and using market data streams to update your order information in real time.

Request

Query Params

symbol

string

required

Symbol

Example:

BTC-USDT

pageNum

integer

optional

Current page

>= 1

Default:

pageSize

integer

optional

Size per page

>= 1<= 50

Default:

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request GET 'https://api.kucoin.com/api/v1/hf/orders/active/page?symbol=BTC-USDT&pageNum&pageSize'

Responses

🟢200OK

application/json

Body

code

string

required

data

object

required

currentPage

integer

required

pageSize

integer

required

totalNum

integer

required

totalPage

integer

required

items

array [object {34}]

required

Example

{
  "code": "200000",
  "data": {
    "currentPage": 1,
    "pageSize": 20,
    "totalNum": 1,
    "totalPage": 1,
    "items": [
      {
        "id": "67c1437ea5226600071cc080",
        "symbol": "BTC-USDT",
        "opType": "DEAL",
        "type": "limit",
        "side": "buy",
        "price": "50000",
        "size": "0.00001",
        "funds": "0.5",
        "dealSize": "0",
        "dealFunds": "0",
        "fee": "0",
        "feeCurrency": "USDT",
        "stp": null,
        "timeInForce": "GTC",
        "postOnly": false,
        "hidden": false,
        "iceberg": false,
        "visibleSize": "0",
        "cancelAfter": 0,
        "channel": "API",
        "clientOid": "5c52e11203aa677f33e493fb",
        "remark": "order remarks",
        "tags": null,
        "cancelExist": false,
        "createdAt": 1740718974367,
        "lastUpdatedAt": 1741867658590,
        "tradeType": "TRADE",
        "inOrderBook": true,
        "cancelledSize": "0",
        "cancelledFunds": "0",
        "remainSize": "0.00001",
        "remainFunds": "0.5",
        "tax": "0",
        "active": true
      }
    ]
  }
}

Modified at about 1 month ago

Get Open Orders

Get Closed Orders