Contract

Public

Security: None

Endpoints under Public section can be accessed freely without requiring any API-key or signatures

1) Test Connectivity

This endpoint checks connectivity to the host

URL: https://futuresopenapi.koinbay.com/fapi/v1/ping

Method: Get

Parameters: No

Success Response:

{}

2) Check Server Time

URL: https://futuresopenapi.koinbay.com/fapi/v1/time

Method: Get

Parameters: No

Success Response:{

{
   "serverTime":1607702400000,
    "timezone":Chinese standard time
}

name	type	example	description
serverTime	long	1607702400000	server timestamp
timezone	string	China standard time	server time zone

3) Operation Summary

URL: https://futuresopenapi.koinbay.com/fapi/v1/contracts

Method: Get

Parameters: No

Success Response:

[
    {
        "symbol": "H-HT-USDT",
        "pricePrecision": 8,
        "side": 1,
        "maxMarketVolume": 100000,
        "multiplier": 6,
        "minOrderVolume": 1,
        "maxMarketMoney": 10000000,
        "type": "H",
        "maxLimitVolume": 1000000,
        "maxValidOrder": 20,
        "multiplierCoin": "HT",
        "minOrderMoney": 0.001,
        "maxLimitMoney": 1000000,
        "status": 1
    }
]

Parametera	Value Format	Sample response	Description
symbol	number	E-BTC-USDT	Contract Name
status	string	1	status（0：cannot trade，1：can trade
type	number	S	contract type, E: perpetual contract, S: test contract, others are mixed contract
side	number	1	Contract direction(backwards：0，1：forward)
multiplier	string	0.5	Contract face value
multiplierCoin	number	BTC	Contract face value unit
pricePrecision	number	4	Precision of the price
minOrderMoney	number	10	Minimum order volume
minOrderVolume	number	10	Minimum order value
maxMarketVolume	number	100000	Market price order maximum volume
maxMarketMoney	number	100000	Market price order maximum value
macLimitVolume	number	100000	Limit price order maximum volume
maxValidOrder	number	100000	Maximum valid order quantity

Market

Security: None​

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

1) Depth

Market Depth Data

URL: https://futuresopenapi.koinbay.com/fapi/v1/depth

Parameters

Query

Query	Value Format	Value Format	Required/Optional
Limit	Integer	Default 100, Max 100	Required
Contract Name	String	Contract Name E.g. E-BTC-USDT	Required

Success Response:

{
  "bids": [
    [
      "3.90000000",   // price
      "431.00000000"  // quantity
    ],
    [
      "4.00000000",
      "431.00000000"
    ]
  ],
  "asks": [
    [
      "4.00000200",  // price
      "12.00000000"  // quantity
    ],
    [
      "5.10000000",
      "28.00000000"
    ]
  ]
}

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

2) 24 hours ticker

24 hr price change statistics

URL: https://futuresopenapi.koinbay.com/fapi/v1/ticker

Method: Get

Parameters:

Query	Value Format	Value Format	Required/Optional
contract name	string	Contract name E.g. E-BTC-USDT	Optional

Success Response of obtaining ticker info:

{
    "high": "9279.0301",
    "vol": "1302",
    "last": "9200",
    "low": "9279.0301",
    "rose": "0",
    "time": 1595563624731
}

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

3) Get index/marked price

URL: https://futuresopenapi.koinbay.com/fapi/v1/index

Method: Get

Parameters

Query	Value format	Value format	Required/Optional
Contact Name	string	Contract name E.g. E-BTC-USDT	Optional
Limit	string	Default 100, Max 100	Optional

Success Responses:

{
    "markPrice": 581.5,
    "indexPrice": 646.3933333333333,
    "lastFundingRate": 0.001,
    "contractName": "E-ETH-USDT",
    "time": 1608273554063
}

Trading

Publishing Soon

Account

Publishing Soon