Get Contract Ticker
Get contract ticker
(Authentication type: NONE, See Interface Permission)
Request Format
GET https://api-cloud.bitmart.com/contract/v1/ifcontract/tickers
Request Limit
Request Parameter
Field | Type | Required? | Description |
---|---|---|---|
contractID | long | No | Contract ID, if the contract ID parameter is empty, it means to get all contracts |
Instruction
If the contract ID does not exist, tickers will return empty.
Request example
curl https://api-cloud.bitmart.com/contract/v1/ifcontract/tickers?contractID=1
Response Data
Field | Type | Description |
---|---|---|
last_price | string | Last trade price |
open | string | Opening price of the day |
close | string | Closing price of the day |
low | string | Lowest price of the day |
high | string | Highest price of the day |
avg_price | string | Average price |
volume | string | The last trade volume, number of contracts. If you want to display the btc trade volume, you need to multiply the volume by the size of the contract |
total_volume | string | 24-hour total volume, number of contracts |
base_coin_volume | string | Volume in base coin (base coin is the first coin in the trading pair) |
quote_coin_volume | string | Volume in quote coin (quote coin is the second coin in the trading pair) |
timestamp | long | Timestamp |
rise_fall_rate | string | Price change ratio |
rise_fall_value | string | Price change value |
contract_id | long | Contract id |
position_size | string | Open position size |
volume_day | string | Trading volume of the day |
amount24 | string | 24-hour trading amount |
index_price | string | Index price |
fair_basis | string | Basis rate |
fair_value | string | Basis |
fair_price | string | Marked price |
quote_rate | string | Funding rate of quote coin |
base_rate | string | Funding rate of base coin |
interest_rate | string | Interest rate |
premium_index | string | Premium index |
funding_rate | string | Current funding rate |
next_funding_rate | string | Next estimated funding rate |
next_funding_at | string | Next settlement time (UTC) |
Instruction
Return a list of contract tickers
Example of returned data format
{
"code": 1000,
"trace":"886fb6ae-456b-4654-b4e0-d681ac05cea1",
"message": "OK",
"data": {
"tickers": [
{
"last_price": "6277.5",
"open": "6074.5",
"close": "6277.5",
"low": "6261.3",
"high": "6279",
"avg_price": "6274.67",
"volume": "20000",
"total_volume": "45462",
"base_coin_volume": "163.9",
"quote_coin_volume": "34555.38199999999999998882",
"timestamp": 1534315695,
"rise_fall_rate": "0.033",
"rise_fall_value": "203",
"contract_id": 1,
"position_size": "374266",
"volume_day": "45270",
"amount24": "28520.77363",
"index_price": "6406.53",
"fair_basis": "0.000000690",
"fair_value": "0.00442673",
"fair_price": "6406.5344267",
"rate": {
"quote_rate": "0.0003",
"base_rate": "0.0006",
"interest_rate": "-0.00009999"
},
"premium_index": "-0.0309530479798782534",
"funding_rate": "0.0001",
"next_funding_rate": "-0.0304530",
"next_funding_at": "2018-08-15T08:00:01Z"
}
]
}
}