Paged Order Record Query

POST

platformapi

chainup

open

record

queryOrderPageByTime

curl --request POST \
  --url http://service.xxx.com/platformapi/chainup/open/record/queryOrderPageByTime \
  --header 'Content-Type: application/json' \
  --data '{
  "appKey": "{{appKey}}",
  "sign": "{{sign}}",
  "symbol": "btcusdt",
  "startDate": 1745911095000,
  "endDate": 1746170295000,
  "page": "3",
  "pageSize": "20"
}'

{
  "code": "0",
  "msg": "suc",
  "data": {
    "count": 243,
    "pageSize": 20,
    "page": 3,
    "list": [
      {
        "id": 2690536306533251000,
        "userId": 24003817,
        "side": "BUY",
        "orderType": 1,
        "status": 2,
        "source": 6,
        "symbol": "btcusdt",
        "showSymbol": "BTC1/USDT4",
        "price": "14957.89473684",
        "volume": "0.00070372",
        "avgPrice": "14793.882097896046",
        "dealMoney": "10.4107507099314056",
        "dealVolume": "0.00070372",
        "ctime": 1745995453132
      },
      {
        "id": 2690536306533251000,
        "userId": 24003817,
        "side": "BUY",
        "orderType": 1,
        "status": 2,
        "source": 6,
        "symbol": "btcusdt",
        "showSymbol": "BTC1/USDT4",
        "price": "15078.94736842",
        "volume": "0.00069808",
        "avgPrice": "14873.398895549862",
        "dealMoney": "10.3828223010054482",
        "dealVolume": "0.00069808",
        "ctime": 1745995453227
      },
      {
        "id": 2690536306533251000,
        "userId": 24003817,
        "side": "BUY",
        "orderType": 1,
        "status": 0,
        "source": 6,
        "symbol": "btcusdt",
        "showSymbol": "BTC1/USDT4",
        "price": "12900",
        "volume": "0.00103724",
        "avgPrice": "0",
        "dealMoney": "0",
        "dealVolume": "0",
        "ctime": 1745995454080
      },
      {
        "id": 2690536306533251000,
        "userId": 24003817,
        "side": "BUY",
        "orderType": 1,
        "status": 0,
        "source": 6,
        "symbol": "btcusdt",
        "showSymbol": "BTC1/USDT4",
        "price": "13021.05263157",
        "volume": "0.0010276",
        "avgPrice": "0",
        "dealMoney": "0",
        "dealVolume": "0",
        "ctime": 1745995454176
      },
      {
        "id": 2690536306533251000,
        "userId": 24003817,
        "side": "BUY",
        "orderType": 1,
        "status": 0,
        "source": 6,
        "symbol": "btcusdt",
        "showSymbol": "BTC1/USDT4",
        "price": "13142.10526315",
        "volume": "0.00101813",
        "avgPrice": "0",
        "dealMoney": "0",
        "dealVolume": "0",
        "ctime": 1745995455005
      },
      {
        "id": 2690536306533251000,
        "userId": 24003817,
        "side": "BUY",
        "orderType": 1,
        "status": 0,
        "source": 6,
        "symbol": "btcusdt",
        "showSymbol": "BTC1/USDT4",
        "price": "13263.15789473",
        "volume": "0.00100884",
        "avgPrice": "0",
        "dealMoney": "0",
        "dealVolume": "0",
        "ctime": 1745995455130
      },
      {
        "id": 2690536306533251000,
        "userId": 24003817,
        "side": "BUY",
        "orderType": 1,
        "status": 0,
        "source": 6,
        "symbol": "btcusdt",
        "showSymbol": "BTC1/USDT4",
        "price": "13384.21052631",
        "volume": "0.00099971",
        "avgPrice": "0",
        "dealMoney": "0",
        "dealVolume": "0",
        "ctime": 1745995455250
      },
      {
        "id": 2690536306533251000,
        "userId": 24003817,
        "side": "BUY",
        "orderType": 1,
        "status": 0,
        "source": 6,
        "symbol": "btcusdt",
        "showSymbol": "BTC1/USDT4",
        "price": "13505.26315789",
        "volume": "0.00099075",
        "avgPrice": "0",
        "dealMoney": "0",
        "dealVolume": "0",
        "ctime": 1745995455395
      },
      {
        "id": 2690536306533251000,
        "userId": 24003817,
        "side": "BUY",
        "orderType": 1,
        "status": 0,
        "source": 6,
        "symbol": "btcusdt",
        "showSymbol": "BTC1/USDT4",
        "price": "13626.31578947",
        "volume": "0.00098195",
        "avgPrice": "0",
        "dealMoney": "0",
        "dealVolume": "0",
        "ctime": 1745995456052
      },
      {
        "id": 2690536306533251000,
        "userId": 24003817,
        "side": "BUY",
        "orderType": 1,
        "status": 0,
        "source": 6,
        "symbol": "btcusdt",
        "showSymbol": "BTC1/USDT4",
        "price": "13747.36842105",
        "volume": "0.0009733",
        "avgPrice": "0",
        "dealMoney": "0",
        "dealVolume": "0",
        "ctime": 1745995456176
      },
      {
        "id": 2690536306533251000,
        "userId": 24003817,
        "side": "BUY",
        "orderType": 1,
        "status": 0,
        "source": 6,
        "symbol": "btcusdt",
        "showSymbol": "BTC1/USDT4",
        "price": "13868.42105263",
        "volume": "0.00096481",
        "avgPrice": "0",
        "dealMoney": "0",
        "dealVolume": "0",
        "ctime": 1745995456259
      },
      {
        "id": 2690536306533251000,
        "userId": 24003817,
        "side": "BUY",
        "orderType": 1,
        "status": 0,
        "source": 6,
        "symbol": "btcusdt",
        "showSymbol": "BTC1/USDT4",
        "price": "13989.47368421",
        "volume": "0.00095646",
        "avgPrice": "0",
        "dealMoney": "0",
        "dealVolume": "0",
        "ctime": 1745995456341
      },
      {
        "id": 2690536306533251000,
        "userId": 24003817,
        "side": "BUY",
        "orderType": 1,
        "status": 0,
        "source": 6,
        "symbol": "btcusdt",
        "showSymbol": "BTC1/USDT4",
        "price": "14110.52631578",
        "volume": "0.00094826",
        "avgPrice": "0",
        "dealMoney": "0",
        "dealVolume": "0",
        "ctime": 1745995457022
      },
      {
        "id": 2690536306533251000,
        "userId": 24003817,
        "side": "BUY",
        "orderType": 1,
        "status": 0,
        "source": 6,
        "symbol": "btcusdt",
        "showSymbol": "BTC1/USDT4",
        "price": "14231.57894736",
        "volume": "0.00094019",
        "avgPrice": "0",
        "dealMoney": "0",
        "dealVolume": "0",
        "ctime": 1745995457104
      },
      {
        "id": 2690536306533251000,
        "userId": 24003817,
        "side": "BUY",
        "orderType": 1,
        "status": 0,
        "source": 6,
        "symbol": "btcusdt",
        "showSymbol": "BTC1/USDT4",
        "price": "14352.63157894",
        "volume": "0.00093226",
        "avgPrice": "0",
        "dealMoney": "0",
        "dealVolume": "0",
        "ctime": 1745995457200
      },
      {
        "id": 2690536306533251000,
        "userId": 24003817,
        "side": "BUY",
        "orderType": 1,
        "status": 0,
        "source": 6,
        "symbol": "btcusdt",
        "showSymbol": "BTC1/USDT4",
        "price": "14473.68421052",
        "volume": "0.00092446",
        "avgPrice": "0",
        "dealMoney": "0",
        "dealVolume": "0",
        "ctime": 1745995457285
      },
      {
        "id": 2690536306533251000,
        "userId": 24003817,
        "side": "BUY",
        "orderType": 1,
        "status": 0,
        "source": 6,
        "symbol": "btcusdt",
        "showSymbol": "BTC1/USDT4",
        "price": "14594.7368421",
        "volume": "0.00091679",
        "avgPrice": "0",
        "dealMoney": "0",
        "dealVolume": "0",
        "ctime": 1745995458042
      },
      {
        "id": 2690536306533251000,
        "userId": 24003817,
        "side": "BUY",
        "orderType": 1,
        "status": 2,
        "source": 6,
        "symbol": "btcusdt",
        "showSymbol": "BTC1/USDT4",
        "price": "14715.78947368",
        "volume": "0.00090925",
        "avgPrice": "14715.78947368",
        "dealMoney": "13.38033157894354",
        "dealVolume": "0.00090925",
        "ctime": 1745995458160
      },
      {
        "id": 2690536306533251000,
        "userId": 24003817,
        "side": "BUY",
        "orderType": 1,
        "status": 2,
        "source": 6,
        "symbol": "btcusdt",
        "showSymbol": "BTC1/USDT4",
        "price": "14836.84210526",
        "volume": "0.00090183",
        "avgPrice": "14836.84210526",
        "dealMoney": "13.3803093157866258",
        "dealVolume": "0.00090183",
        "ctime": 1745995458298
      },
      {
        "id": 2690536306533251000,
        "userId": 24003817,
        "side": "BUY",
        "orderType": 1,
        "status": 2,
        "source": 6,
        "symbol": "btcusdt",
        "showSymbol": "BTC1/USDT4",
        "price": "14957.89473684",
        "volume": "0.00089454",
        "avgPrice": "14942.713796903459",
        "dealMoney": "13.3668551998820208",
        "dealVolume": "0.00089454",
        "ctime": 1745995458980
      }
    ]
  }
}

API Description

Query order information with pagination requires specifying a trading pair
Time range cannot exceed 7 days

Request Parameters

Name	Type	Required	Description
appKey	string	Yes	Unique merchant appKey
sign	string	Yes	Sign
symbol	string	Yes	Trading pair (e.g. btcusdt)
startDate	long	Yes	Start time timestamp
endDate	long	Yes	End time timestamp
page	long	No	Page number, default 1
pageSize	long	No	Records per page, default 20, max 1000

Request Example

cURL

curl --request POST \
  --url http://service.xxx.com/platformapi/chainup/open/record/queryOrderPageByTime \
  --header 'Content-Type: application/json' \
  --data '{
    "appKey": "{your_app_key}",
    "sign": "{sign}",
    "symbol": "btcusdt",
    "startDate": 1606823070215,
    "endDate": 1606909470215,
    "page": 1,
    "pageSize": 20
  }'

Response Value Enum Description:

status (Order Status):

0: init (Initialized)

1: new (New Order)

2: filled (Fully Filled)

3: part_filled (Partially Filled)

4: canceled (Canceled)

5: pending_cancel (Canceling)

6: expired (Expired)

source (Order Source):

1: web

2: app

3: api

orderType (Order Type):

1: Regular Order

2: Margin Order

3: Cross Margin Order

type (Entrust Type):

1: limit (Limit Order)

2: market (Market Order)

3: stop (Stop Order)

Response Parameters

Name	Type	Description
count	long	Total record count
page	long	Current page number
pageSize	long	Records per page
list	array	Order list
└─id	string	Order ID
└─userId	int	User ID
└─side	string	Trade side (buy/sell)
└─orderType	int	Order type
└─status	int	Order status
└─source	int	Source
└─symbol	string	Trading pair
└─showSymbol	string	Display trading pair name
└─price	string	Order price
└─volume	string	Order quantity
└─avgPrice	string	Average deal price
└─dealMoney	string	Deal amount
└─dealVolume	string	Deal quantity
└─ctime	long	Creation time (milliseconds)

Response Example

{
    "code": "0",
    "msg": "suc",
    "data": {
        "count": 5,
        "page": 1,
        "pageSize": 20,
        "list": [
            {
                "id": 327184612876959744,
                "userId": 4107676,
                "side": "BUY",
                "orderType": 1,
                "status": 4,
                "source": 1,
                "symbol": "btcusdt",
                "showSymbol": "BTC/USDT",
                "price": "581.57",
                "volume": "1",
                "avgPrice": "0",
                "dealMoney": "0",
                "dealVolume": "0",
                "ctime": 1606823070215
            },
            {
                "id": 523243960080728064,
                "userId": 4107382,
                "side": "BUY",
                "orderType": 1,
                "status": 2,
                "source": 2,
                "symbol": "btcusdt",
                "showSymbol": "BTC/USDT",
                "price": "2000",
                "volume": "12.5",
                "avgPrice": "1996.5161097808",
                "dealMoney": "24956.45137226",
                "dealVolume": "12.5",
                "ctime": 1618219033536
            }
        ]
    }
}

Body

application/json

appKey

string

required

sign

string

required

symbol

string

required

startDate

integer

required

endDate

integer

required

page

string

default: 1required

pageSize

string

default: 20required

Response

200 - application/json

code

string

required

msg

string

required

data

object

required

Batch Order Record Query (By Symbol)Query Order Detail

curl --request POST \
  --url http://service.xxx.com/platformapi/chainup/open/record/queryOrderPageByTime \
  --header 'Content-Type: application/json' \
  --data '{
  "appKey": "{{appKey}}",
  "sign": "{{sign}}",
  "symbol": "btcusdt",
  "startDate": 1745911095000,
  "endDate": 1746170295000,
  "page": "3",
  "pageSize": "20"
}'

{
  "code": "0",
  "msg": "suc",
  "data": {
    "count": 243,
    "pageSize": 20,
    "page": 3,
    "list": [
      {
        "id": 2690536306533251000,
        "userId": 24003817,
        "side": "BUY",
        "orderType": 1,
        "status": 2,
        "source": 6,
        "symbol": "btcusdt",
        "showSymbol": "BTC1/USDT4",
        "price": "14957.89473684",
        "volume": "0.00070372",
        "avgPrice": "14793.882097896046",
        "dealMoney": "10.4107507099314056",
        "dealVolume": "0.00070372",
        "ctime": 1745995453132
      },
      {
        "id": 2690536306533251000,
        "userId": 24003817,
        "side": "BUY",
        "orderType": 1,
        "status": 2,
        "source": 6,
        "symbol": "btcusdt",
        "showSymbol": "BTC1/USDT4",
        "price": "15078.94736842",
        "volume": "0.00069808",
        "avgPrice": "14873.398895549862",
        "dealMoney": "10.3828223010054482",
        "dealVolume": "0.00069808",
        "ctime": 1745995453227
      },
      {
        "id": 2690536306533251000,
        "userId": 24003817,
        "side": "BUY",
        "orderType": 1,
        "status": 0,
        "source": 6,
        "symbol": "btcusdt",
        "showSymbol": "BTC1/USDT4",
        "price": "12900",
        "volume": "0.00103724",
        "avgPrice": "0",
        "dealMoney": "0",
        "dealVolume": "0",
        "ctime": 1745995454080
      },
      {
        "id": 2690536306533251000,
        "userId": 24003817,
        "side": "BUY",
        "orderType": 1,
        "status": 0,
        "source": 6,
        "symbol": "btcusdt",
        "showSymbol": "BTC1/USDT4",
        "price": "13021.05263157",
        "volume": "0.0010276",
        "avgPrice": "0",
        "dealMoney": "0",
        "dealVolume": "0",
        "ctime": 1745995454176
      },
      {
        "id": 2690536306533251000,
        "userId": 24003817,
        "side": "BUY",
        "orderType": 1,
        "status": 0,
        "source": 6,
        "symbol": "btcusdt",
        "showSymbol": "BTC1/USDT4",
        "price": "13142.10526315",
        "volume": "0.00101813",
        "avgPrice": "0",
        "dealMoney": "0",
        "dealVolume": "0",
        "ctime": 1745995455005
      },
      {
        "id": 2690536306533251000,
        "userId": 24003817,
        "side": "BUY",
        "orderType": 1,
        "status": 0,
        "source": 6,
        "symbol": "btcusdt",
        "showSymbol": "BTC1/USDT4",
        "price": "13263.15789473",
        "volume": "0.00100884",
        "avgPrice": "0",
        "dealMoney": "0",
        "dealVolume": "0",
        "ctime": 1745995455130
      },
      {
        "id": 2690536306533251000,
        "userId": 24003817,
        "side": "BUY",
        "orderType": 1,
        "status": 0,
        "source": 6,
        "symbol": "btcusdt",
        "showSymbol": "BTC1/USDT4",
        "price": "13384.21052631",
        "volume": "0.00099971",
        "avgPrice": "0",
        "dealMoney": "0",
        "dealVolume": "0",
        "ctime": 1745995455250
      },
      {
        "id": 2690536306533251000,
        "userId": 24003817,
        "side": "BUY",
        "orderType": 1,
        "status": 0,
        "source": 6,
        "symbol": "btcusdt",
        "showSymbol": "BTC1/USDT4",
        "price": "13505.26315789",
        "volume": "0.00099075",
        "avgPrice": "0",
        "dealMoney": "0",
        "dealVolume": "0",
        "ctime": 1745995455395
      },
      {
        "id": 2690536306533251000,
        "userId": 24003817,
        "side": "BUY",
        "orderType": 1,
        "status": 0,
        "source": 6,
        "symbol": "btcusdt",
        "showSymbol": "BTC1/USDT4",
        "price": "13626.31578947",
        "volume": "0.00098195",
        "avgPrice": "0",
        "dealMoney": "0",
        "dealVolume": "0",
        "ctime": 1745995456052
      },
      {
        "id": 2690536306533251000,
        "userId": 24003817,
        "side": "BUY",
        "orderType": 1,
        "status": 0,
        "source": 6,
        "symbol": "btcusdt",
        "showSymbol": "BTC1/USDT4",
        "price": "13747.36842105",
        "volume": "0.0009733",
        "avgPrice": "0",
        "dealMoney": "0",
        "dealVolume": "0",
        "ctime": 1745995456176
      },
      {
        "id": 2690536306533251000,
        "userId": 24003817,
        "side": "BUY",
        "orderType": 1,
        "status": 0,
        "source": 6,
        "symbol": "btcusdt",
        "showSymbol": "BTC1/USDT4",
        "price": "13868.42105263",
        "volume": "0.00096481",
        "avgPrice": "0",
        "dealMoney": "0",
        "dealVolume": "0",
        "ctime": 1745995456259
      },
      {
        "id": 2690536306533251000,
        "userId": 24003817,
        "side": "BUY",
        "orderType": 1,
        "status": 0,
        "source": 6,
        "symbol": "btcusdt",
        "showSymbol": "BTC1/USDT4",
        "price": "13989.47368421",
        "volume": "0.00095646",
        "avgPrice": "0",
        "dealMoney": "0",
        "dealVolume": "0",
        "ctime": 1745995456341
      },
      {
        "id": 2690536306533251000,
        "userId": 24003817,
        "side": "BUY",
        "orderType": 1,
        "status": 0,
        "source": 6,
        "symbol": "btcusdt",
        "showSymbol": "BTC1/USDT4",
        "price": "14110.52631578",
        "volume": "0.00094826",
        "avgPrice": "0",
        "dealMoney": "0",
        "dealVolume": "0",
        "ctime": 1745995457022
      },
      {
        "id": 2690536306533251000,
        "userId": 24003817,
        "side": "BUY",
        "orderType": 1,
        "status": 0,
        "source": 6,
        "symbol": "btcusdt",
        "showSymbol": "BTC1/USDT4",
        "price": "14231.57894736",
        "volume": "0.00094019",
        "avgPrice": "0",
        "dealMoney": "0",
        "dealVolume": "0",
        "ctime": 1745995457104
      },
      {
        "id": 2690536306533251000,
        "userId": 24003817,
        "side": "BUY",
        "orderType": 1,
        "status": 0,
        "source": 6,
        "symbol": "btcusdt",
        "showSymbol": "BTC1/USDT4",
        "price": "14352.63157894",
        "volume": "0.00093226",
        "avgPrice": "0",
        "dealMoney": "0",
        "dealVolume": "0",
        "ctime": 1745995457200
      },
      {
        "id": 2690536306533251000,
        "userId": 24003817,
        "side": "BUY",
        "orderType": 1,
        "status": 0,
        "source": 6,
        "symbol": "btcusdt",
        "showSymbol": "BTC1/USDT4",
        "price": "14473.68421052",
        "volume": "0.00092446",
        "avgPrice": "0",
        "dealMoney": "0",
        "dealVolume": "0",
        "ctime": 1745995457285
      },
      {
        "id": 2690536306533251000,
        "userId": 24003817,
        "side": "BUY",
        "orderType": 1,
        "status": 0,
        "source": 6,
        "symbol": "btcusdt",
        "showSymbol": "BTC1/USDT4",
        "price": "14594.7368421",
        "volume": "0.00091679",
        "avgPrice": "0",
        "dealMoney": "0",
        "dealVolume": "0",
        "ctime": 1745995458042
      },
      {
        "id": 2690536306533251000,
        "userId": 24003817,
        "side": "BUY",
        "orderType": 1,
        "status": 2,
        "source": 6,
        "symbol": "btcusdt",
        "showSymbol": "BTC1/USDT4",
        "price": "14715.78947368",
        "volume": "0.00090925",
        "avgPrice": "14715.78947368",
        "dealMoney": "13.38033157894354",
        "dealVolume": "0.00090925",
        "ctime": 1745995458160
      },
      {
        "id": 2690536306533251000,
        "userId": 24003817,
        "side": "BUY",
        "orderType": 1,
        "status": 2,
        "source": 6,
        "symbol": "btcusdt",
        "showSymbol": "BTC1/USDT4",
        "price": "14836.84210526",
        "volume": "0.00090183",
        "avgPrice": "14836.84210526",
        "dealMoney": "13.3803093157866258",
        "dealVolume": "0.00090183",
        "ctime": 1745995458298
      },
      {
        "id": 2690536306533251000,
        "userId": 24003817,
        "side": "BUY",
        "orderType": 1,
        "status": 2,
        "source": 6,
        "symbol": "btcusdt",
        "showSymbol": "BTC1/USDT4",
        "price": "14957.89473684",
        "volume": "0.00089454",
        "avgPrice": "14942.713796903459",
        "dealMoney": "13.3668551998820208",
        "dealVolume": "0.00089454",
        "ctime": 1745995458980
      }
    ]
  }
}

API access instructions

API documentation

API Description

Request Parameters

Request Example

Response Parameters

Response Example

Body

Response

API access instructions

API documentation

​API Description

​Request Parameters

​Request Example

​Response Parameters

​Response Example

Body

Response

API Description

Request Parameters

Request Example

Response Parameters

Response Example