合约行情 | API文档-StarEx

# 合约行情

# 查询资金费率

GET /v1/contract/market/funding-rate

所属模块	所属类型	资源隔离类型	速率限制
合约行情(CONTRACT_MARKET)	查询(QUERY)	币对(SYMBOL)	5

参数

名称	类型	必填	描述
symbol	String	是	交易对

响应参数

名称	类型	描述
symbol	String	交易对
fundingRate	BigDecimal	资金费率
fundingTime	Long	资金费时间

请求示例

GET /v1/contract/market/funding-rate?symbol=BTC/USDT

响应示例

{
	"code": "200",
	"message": "OK",
	"timestamp": "1704799591872",
	"data": {
		"symbol": "BTC/USDT",
		"fundingRate": "0.0001",
		"fundingTime": "1704799590638"
	}
}

# 查询资金费率历史

GET /v1/contract/market/funding-rate/history

所属模块	所属类型	资源隔离类型	速率限制
合约行情(CONTRACT_MARKET)	查询(QUERY)	币对(SYMBOL)	5

参数

名称	类型	必填	描述
symbol	String	是	交易对
startTime	Date	否	开始时间，格式：yyyy-MM-dd HH:mm:ss
endTime	Date	否	结束时间，格式：yyyy-MM-dd HH:mm:ss
limit	Integer	否	返回的数量，默认100，最大值500

响应参数

名称	类型	描述
symbol	String	交易对
fundingRate	BigDecimal	资金费率
fundingTime	Long	资金费时间

请求示例

GET /v1/contract/market/funding-rate/history?symbol=BTC/USDT

响应示例

{
	"code": "200",
	"message": "OK",
	"timestamp": "1704873662671",
	"data": [
		{
            "symbol": "BTC/USDT",
            "fundingRate": "0.0001",
            "fundingTime": "1704844800000"
		},
		{
            "symbol": "BTC/USDT",
            "fundingRate": "0.0001",
            "fundingTime": "1704816000000"
		}
	]
}

# 查询最近成交

GET /v1/contract/market/trades

所属模块	所属类型	资源隔离类型	速率限制
合约行情(CONTRACT_MARKET)	查询(QUERY)	币对(SYMBOL)	5

参数

名称	类型	必填	描述
symbol	String	是	交易对
limit	Integer	否	返回的数量，默认500，最大500

响应参数

名称	类型	描述
symbol	String	交易对
price	BigDecimal	成交价格
amount	BigDecimal	成交量
direction	String	交易方向：BUY 买，SELL 卖
timestamp	Long	时间

请求示例

GET /v1/contract/market/trades?symbol=BTC/USDT

响应示例

{
	"code": "200",
	"message": "OK",
	"timestamp": "1705890036357",
	"data": [
		{
            "symbol": "BTC/USDT",
            "price": "45672.7",
            "amount": "40",
            "direction": "BUY",
            "timestamp": "1705874641022"
		},
		{
            "symbol": "BTC/USDT",
            "price": "45695.9",
            "amount": "360",
            "direction": "SELL",
            "timestamp": "1705874641022"
		}
	]
}

# 查询交易对

GET /v1/contract/market/symbols

所属模块	所属类型	资源隔离类型	速率限制
合约行情(CONTRACT_MARKET)	查询(QUERY)		1

参数

NONE

响应参数

名称	类型	描述
base	String	标的币种
quote	String	标价币种
contractType	String	合约类型：E 永续合约
multiplier	BigDecimal	合约面值
status	Integer	交易状态：0 不可交易，1 可交易
showStatus	Integer	上下架状态：0 下架，1 上架
sysBidHoldMax	Long	平台多头最大净持仓
sysAskHoldMax	Long	平台空头最大净持仓
bidOrderMax	Integer	单笔多头最大下单数
bidOrderMin	Integer	单笔多头最小下单数
askOrderMax	Integer	单笔空头最大下单数
askOrderMin	Integer	单笔空头最小下单数
bidEntrustMax	Long	用户多头最大委托订单数
askEntrustMax	Long	用户空头最大委托订单数
entrustMax	Long	用户最大委托订单总数
leverMax	Integer	最大杠杆
leverMin	Integer	最小杠杆
priceChangeMin	BigDecimal	合约最小变动价格
feePrecision	BigDecimal	手续费精度
fundingAdjustRate	BigDecimal	资金费率调整值
liquidateRate	BigDecimal	强平清算费率
limitOrderBidPirceUpLimit	BigDecimal	限价买入下单价格上限
limitOrderAskPirceDownLimit	BigDecimal	限价卖出下单价格下限
maxOrderPrice	BigDecimal	用户限价下单时最大下单价格
minOrderPrice	BigDecimal	用户限价下单时最小下单价格
marketPriceThreshold	BigDecimal	市价保护阈值
openMakerFee	BigDecimal	开仓maker手续费
openTakerFee	BigDecimal	开仓taker手续费
closeMakerFee	BigDecimal	平仓maker手续费
closeTakerFee	BigDecimal	平仓taker手续费

请求示例

GET /v1/contract/market/symbols

响应示例

{
	"code": "200",
	"message": "OK",
	"timestamp": "1704963409455",
	"data": [
		{
            askEntrustMax: "9999999999"
            askOrderMax: 100000000
            askOrderMin: 10
            base: "BTC"
            bidEntrustMax: "9999999999"
            bidOrderMax: 100000000
            bidOrderMin: 10
            closeMakerFee: "0.02"
            closeTakerFee: "0.06"
            contractType: "E"
            entrustMax: "50"
            feePrecision: "0.001"
            fundingAdjustRate: "0"
            leverMax: 200
            leverMin: 1
            limitOrderAskPirceDownLimit: "10"
            limitOrderBidPirceUpLimit: "10"
            liquidateRate: "1.25"
            marketPriceThreshold: "5"
            maxOrderPrice: "50000"
            minOrderPrice: "0.1"
            multiplier: "0.0001"
            openMakerFee: "0.02"
            openTakerFee: "0.06"
            priceChangeMin: "0.1"
            quote: "USDT"
            showStatus: 1
            status: 1
            sysAskHoldMax: "999999999999"
            sysBidHoldMax: "999999999999"
		}
	]
}

# 查询深度数据

GET /v1/contract/market/depth

所属模块	所属类型	资源隔离类型	速率限制
合约行情(CONTRACT_MARKET)	查询(QUERY)		1

参数

名称	类型	必填	描述
symbol	String	是	交易对
limit	Integer	否	默认 100; 可选值:[5, 10, 20, 50, 100, 500]

响应参数

名称	类型	描述
bids	array	买单[price, size, size]
asks	array	卖单[price, size, size]
timestamp	Long	撮合引擎时间

请求示例

GET /v1/contract/market/depth?symbol=BTC/USDT&limit=5

响应示例

{
	"code": "200",
	"message": "OK",
	"timestamp": "1705042807484",
	"data": {
		"bids": [
			[
				"46153.8",
				"0",
				"477"
			],
			[
				"46153.6",
				"0",
				"435"
			],
			[
				"46153.3",
				"0",
				"393"
			],
			[
				"46153.1",
				"0",
				"394"
			],
			[
				"46152.9",
				"0",
				"399"
			]
		],
		"asks": [
			[
				"46154.2",
				"0",
				"364"
			],
			[
				"46154.4",
				"0",
				"375"
			],
			[
				"46154.6",
				"0",
				"476"
			],
			[
				"46154.8",
				"0",
				"498"
			],
			[
				"46155.0",
				"0",
				"484"
			]
		],
		"timestamp": "1705042807484"
	}
}

# 查询k线数据

GET /v1/contract/market/klines

所属模块	所属类型	资源隔离类型	速率限制
合约行情(CONTRACT_MARKET)	查询(QUERY)		5

参数

名称	类型	必填	描述
symbol	String	是	交易对
period	String	是	返回数据时间粒度，也就是每根蜡烛的时间区间，可选值: [1min,5min,15min,30min,60min,4hour,1day,1week,1mon]
limit	Integer	否	返回K线数据条数，可选值范围[1,1000],默认100

响应参数

名称	类型	描述
id	Long	UTC时间的时间戳，单位秒，并以此作为此K线柱的id
symbol	String	交易对
period	String	时间粒度
open	BigDecimal	开盘价
close	BigDecimal	收盘价
low	BigDecimal	最低价
high	BigDecimal	最高价
vol	BigDecimal	成交量
amount	BigDecimal	成交额
count	Integer	成交笔数
time	Long	时间

请求示例

GET /v1/contract/market/klines?limit=1&period=1min&symbol=BTC/USDT

响应示例

{
	"code": "200",
	"message": "OK",
	"timestamp": "1704876793004",
	"data": [
		{
              "id": "1705264980000",
              "symbol": "btcusdt",
              "period": "1min",
              "high": "42957.6",
              "open": "42955.1",
              "low": "42946.9",
              "close": "42955.1",
              "amount": "41697.143690",
              "vol": "0.97080",
              "count": "88",
              "time": "1705264980000"
		}
	]
}

← 账户合约订单 →