Get the open position of a trading pair

Type: GET

Description: /future/market/v1/public/contract/open-interest

Limit Flow Rules

1/s/ip

Note：

This method does not require a signature.

Parameters

Name	Type	Mandatory	Default	Description	Ranges
symbol	string	true	N/A	Trading pair

Request Example

Request

{
  curl -G "https://fapi.xt.com/future/market/v1/public/contract/open-interest" \
      -H "validate-appkey: $APPKEY" \  # required
      -H "validate-timestamp: $TIMESTAMP" \  # required
      -H "validate-singature: $SINGATURE" \  # required
      -H "Content-Type: application/x-www-form-urlencoded" \  # required
      -d "symbol=eth_usdt"  # required
}

Response Example

Response

{
"error": {
  "code": "",
  "msg": ""
},
"msgInfo": "",
"result": {
  "symbol": "",          // Trading pair
  "openInterest": "",    // Open position
  "openInterestUsd": 0,  // Open value
  "time": ""             // Time
},
"returnCode": 0
}

Error Code

Error Code	Desc
invalid_symbol	Symbol does not exist