Market
Online Support avatar
Written by Online Support
Updated over a week ago

Market

Security: None

Market section can be accessed freely without requiring any API-key or signatures.

GET

Depth

Market depth data

Parameters

Query

limit

integer

Default 100, Max 100

Contract name

string

Contract Name E.g. E-BTC-USDT

Responses

200

Successfully retrieve market depth data

Response:

name

type

example

description

time

long

1595563624731

Current Timestamp (ms)

bids

list

Look below

Order book purchase info

asks

list

Look below

Order book selling info

The fields bids and asks are lists of order book price level entries, sorted from best to worst.

name

type

example

description

' '

float

131.1

price level

' '

float

2.3

Total order quantity for this price level

GET

24hrs ticker

24 hour price change statistics

Parameters

Query

Contract name

string

Contract name E.g. E-BTC-USDT

Responses

200

Successfully obtain ticker info

Response:

name

type

example

description

time

long

1595563624731

Open time

high

float

9900

Higher price

low

float

8800.34

Lower price

last

float

8900

Newest price

vol

float

4999

Trade volume

rose

string

+0.5

Price variation

GET

Get index/marked price

Parameters

Query

Contract name

string

Contract name E.g. E-BTC-USDT

limit

string

Default 100, Max 100

Responses

200

Response:

name

type

example

Description

indexPrice

float

0.055

Index price

markPrice

float

0.0578

Marked price

contractName

string

E-BTC-USDT

Contract name

lastFundingRate

float

0.123

Current fund rate

GET

Kline/charts data

Parameters

Query

ContractName

string

Contract name E.g. E-BTC-USDT

interval

string

K-line interval, identifies the sent value as: 1min,5min,15min,30min,1h,1day,1week,1month

limit

integer

Default 100, Max 300

Responses

200

1

[

2

{

3

"high": "6228.77",

4

"vol": "111",

5

"low": "6228.77",

6

"idx": 1594640340,

7

"close": "6228.77",

8

"open": "6228.77"

9

},

10

{

11

"high": "6228.77",

12

"vol": "222",

13

"low": "6228.77",

14

"idx": 1587632160,

15

"close": "6228.77",

16

"open": "6228.77"

17

},

18

{

19

"high": "6228.77",

20

"vol": "333",

21

"low": "6228.77",

22

"idx": 1587632100,

23

"close": "6228.77",

24

"open": "6228.77"

25

}

26

]

Copied!

Response:

name

type

example

description

idx

long

1538728740000

Start timestamp (ms)

open

float

36.00000

Open price

close

float

33.00000

Closing price

high

float

36.00000

Max price

low

float

30.00000

Min price

vol

float

2456.111

Trade volume

Trading

Security: TRADE

All interfaces under the transaction require signature and API-key verification​

POST

Order creation

Creation of single new orders

Parameters

Header

X-CH-TS

string

Time stamp

X-CH-APIKEY

string

Your API-key

X-CH-SIGN

string

Signature

Body

volume

number

Order quantity

price

number

Order price

contractName

string

Contract name E.g. E-BTC-USDT

type

string

Order type, LIMIT/MARKET

side

string

trade direction, BUY/SELL

open

string

Open balancing direction, OPEN/CLOSE

positionType

number

Hold-up position, 1 full position, 2 restrictive position

clientOrderId

string

Client order identity, a string with length less than 32 bit

timeInForce

string

IOC, FOK, POST_ONLY

Responses

200

1

{

2

"orderId": 256609229205684228

3

}

Copied!

Response:

name

type

example

description

orderId

String

256609229205684228

Order ID

POST

https://futuresopenapi.xxx.com /fapi/v1/conditionOrder

Condition order creation

Parameters

Header

X-CH-TS

string

Time stamp

X-CH-APIKEY

string

Your API-key

X-CH-SIGN

string

Signature

Body

volume

number

Order quantity

price

number

Order price

contractName

string

Contract name E.g. E-BTC-USDT

type

string

Order type, LIMIT/MARKET

side

string

trade direction, BUY/SELL

open

string

Open balancing direction, OPEN/CLOSE

positionType

number

Hold-up position, 1 full position, 2 restrictive position

triggerPrice

string

trigger price

triggerType

string

trigger type 3UP/4DOWN

Responses

200: OK

1

{

2

"orderId": 256609229205684228

3

}

Copied!

POST

Cancel order

Speed limit rules: 20 times/ 2 seconds

Parameters

Header

X-CH-SIGN

string

Signature

X-CH-APIKEY

string

Your API-key

X-CH-TS

integer

Time stamp

Body

contractName

string

Contract name E.g. E-BTC-USDT

orderId

string

Order ID

Responses

200

1

{

2

"orderId": 256609229205684228

3

}

Copied!

GET

Order details

Parameters

Body

contractName

string

Responses

200

Response:

name

type

example

description

orderId

long

150695552109032492

Order ID(system generated

contractName

string

E-BTC-USDT

Contract name

price

float

10.5

Order price

origQty

float

10.5

Order quantity

executedQty

float

20

Order quantity

avgPrice

float

10.5

Average transaction price

symbol

string

BHTUSDT

Coin pair name

status

string

NEW

Order status. Possible values are:NEW(new order,not filled)、PARTIALLY_FILLED(partially filled)、FILLED(fully filled)、CANCELLED(already cancelled)andREJECTED(order rejected)

side

string

NEW

Order direction. Possible values can only be:BUY(buy long)and SELL(sell short)

action

string

OPEN

OPEN/CLOSE

transactTime

long

1607702400000

Order creation time

GET

https://futuresopenapi.xxx.com /fapi/v1/openOrders

Open order

Response:

name

type

example

description

orderId

long

150695552109032492

Order ID(system generated)

contractName

string

E-BTC-USDT

Contract name

price

float

4765.29

Order price

origQty

float

1.01

Order quantity

executedQty

float

1.01

Filled orders quantity

avgPrice

float

4754.24

Filled orders average price

type

string

LIMIT

Order type. Possible values can only be:LIMIT(limit price) andMARKET(market price)

side

string

BUY

Order direction. Possible values can only be:BUY(buy long)and SELL(sell short)

status

string

NEW

Order status. Possible values are:NEW(new order,not filled)、PARTIALLY_FILLED(partially filled)、FILLED(fully filled)、CANCELLED(already cancelled)andREJECTED(order rejected)

action

string

OPEN

OPEN/CLOSE

transactTime

long

1607702400000

Order creation time,

GET

Order record

Speed limit rules: 20 times/ 2s

Parameters

Query

contractName

string

Contract name E.g. E-BTC-USDT

limit

string

Lines per page, default 100, max 1000

fromId

integer

Start retrieving from this tradeId

Header

X-CH-SIGN

string

signature

X-CH-APIKEY

string

Your API-key

X-CH-TS

integer

time stamp

Responses

200

Response:

name

type

example

description

symbol

string

ETHBTC

Coin name(trade pair)

tradeId

number

28457

Trade ID

bidId

long

150695552109032492

Buyer order ID

askId

long

150695552109032493

Seller order ID

bidUserId

integer

10024

Buyer user ID

askUserId

integer

10025

Seller user ID

price

float

4.01

Filled price

qty

float

12

Trade quantity

amount

float

5.38

Filled amount

time

number

1499865549590

Trade time stamp

fee

number

0.001

Trading fees

side

string

buy

Current order direction BUY purchase, SELL selling

contractName

string

E-BTC-USDT

Contract name

isMaker

boolean

true

is it maker?

isBuyer

boolean

true

is it buyer?

Account

Security: USER_DATA

All interfaces under the account require signature and API-key verification​

GET

Account info

Speed limit rules: 20 times/2s

Parameters

Header

X-CH-SIGN

string

Signature

X-CH-APIKEY

string

Your API-key

X-CH-TS

integer

time stamp

Responses

200

Response:

name

type

description

account

[]

Balance collection

account field:

name

type

example

description

marginCoin

string

USDT

Margin coin

accountNormal

float

10.05

Balance account

accountLock

float

10.07

Margin frozen account

partPositionNormal

float

10.07

Restricted position margin balance

totalPositionNormal

float

10.07

Full position initial margin

achievedAmount

float

10.07

Profit and losses occurred

unrealizedAmount

float

10.05

Unfilled profit and losses

totalMarginRate

float

10.05

Full position margin rate

totalEquity

float

10.07

Full position equity

partEquity

float

10.07

Restricted position equity

totalCost

float

10.07

Full position costs

sumMarginRate

float

10.07

All accounts margin rate

positionVos

[ ]

Position contract record

positionVos field:

name

type

example

description

contractId

integer

2

Contract id

contractName

string

E-BTC-USDT

Contract name

contractSymbol

string

BTC-USDT

Contract coin pair

positions

[ ]

Position details

positions field:

name

type

example

description

id

integer

2

Position id

uid

integer

10023

User ID

positionType

integer

1

Hold position type(1 full,2 restrictive)

side

string

SELL

Hold position direction SELL sell long, BUY buy short

volume

float

1.05

Hold quantity

openPrice

float

1.05

Open position price

avgPrice

float

1.05

Hold average price

closePrice

float

1.05

Balancing average price

leverageLevel

float

1.05

Leverage multiple

holdAmount

float

1.05

Hold position margin

closeVolume

float

1.05

Balanced quantity

pendingCloseVolume

float

1.05

The number of pending closing orders

realizedAmount

float

1.05

Profit and losses occurred

historyRealizedAmount

float

1.05

Historic accumulated profit and losses

tradeFee

float

1.05

Trading fees

capitalFee

float

1.05

Capital costs

closeProfit

float

1.05

Balancing profit and loss

shareAmount

float

1.05

Amount to share

freezeLock

integer

0

Position freeze status: 0 normal, 1 liquidation freeze, 2 delivery freeze

status

integer

0

Position effectiveness,0 ineffective 1 effective

ctime

time

Creation time

mtime

time

Update time

brokerId

integer

1023

Client id

lockTime

time

liquidation lock time

marginRate

float

1.05

Margin rate

reducePrice

float

1.05

Price reduction

returnRate

float

1.05

Return rate (profit rate)

unRealizedAmount

float

1.05

Unfilled profit and losses

openRealizedAmount

float

1.05

Open position unfilled profit and losses

positionBalance

float

1.05

Position value

indexPrice

float

1.05

Newest marked price

keepRate

float

1.05

Scaled minimum kept margin rate

maxFeeRate

float

1.05

Balancing maximum fees rate

Did this answer your question?