CFTC Futures Positions

GET /api/v1.0/quote/{symbol}/future/position-analysis

CFTC futures positioning. report_type selects the trader category, default TOTAL. Newest report first; page_flag is the next offset. Position sizes are integers; report_time is unix seconds.

Request

Parameter	Type	In	Required	Description
symbol	string	path	yes	Futures symbol (path param), e.g. US.CLmain / US.GCmain
report_type	string	query	no	Report category. TOTAL is default
page_size	int	query	no	Page size, default 20, max 100
page_flag	string	query	no	Page cursor. Omit on the first page; pass back pagination.page_flag

Example

curl -X GET 'https://webapi.futunn.com/api/v1.0/quote/US.AAPL/future/position-analysis?report_type=1&page_size=1&page_flag=1' \
  -H 'Authorization: Bearer <AccessToken>' | jq

Response

Field	Type	Description
data.items	object[]
data.total	integer	Total matching rows
data.items[].report_time	integer	Report date, unix seconds
data.items[].variety	integer	Futures variety name
data.items[].long	integer	Long position
data.items[].short	integer	Short position
data.items[].spread	integer	Spread position
data.items[].net	integer	Net position
data.items[].net_change_weekly	integer	Weekly net-position change
data.items[].open_interest	integer	Total open interest
data.items[].open_interest_change_weekly	integer	Weekly open-interest change
data.items[].open_interest_change_rate_weekly	string	Weekly open-interest change rate percent
pagination.completed	string	True when this is the last page
pagination.page_flag	string	Next offset. Empty when completed is true

Errors

ret_code	error.code	Description
0	—	Success
-3	invalid_parameter	Missing or invalid parameter
-7	invalid_symbol	Unknown symbol
-8	unsupported	Market or product is not supported
-9	permission_denied	Missing permission
-10	no_data	No data
-11	rate_limited	Too many requests

Sample

{
  "ret_code": 0,
  "ret_msg": "success",
  "data": {
    "total": "example",
    "items": [
      {
        "report_time": 0,
        "variety": 0,
        "long": 0,
        "short": 0,
        "spread": 0,
        "net": 0
      }
    ]
  },
  "pagination": {
    "completed": true,
    "page_flag": ""
  }
}