Query Positions
Get the authenticated user's prediction token positions with portfolio summary and tab-based filtering.
Query Positions › Authorization
Query Positions › Request Weight
This endpoint consumes IP-based request weight. Heavier endpoints consume more of your IP rate limit capacity.
Headers
X-MBX-APIKEYAn API Key is required to access this endpoint and must be included in the request headers. To create an API Key, refer to: https://www.binance.com/en/support/faq/detail/360002502072.
Query Parameters
walletAddressUser's prediction wallet address
timestampUnix timestamp in milliseconds used to sign the request. The value must reflect the current client time and is validated by the server for signed endpoints.
tabPosition status tab. Values from PositionQueryType. Default ONGOING
offsetPagination offset. Default 0
limitPage size. Default 20, range 1–100
recvWindowRequest validity window in milliseconds
Query Positions › Responses
Query Positions
Query Positions by Filter
Get prediction positions filtered by wallet address and/or market topic ID. Both parameters are optional.
Query Positions by Filter › Authorization
Query Positions by Filter › Request Weight
This endpoint consumes IP-based request weight. Heavier endpoints consume more of your IP rate limit capacity.
Headers
X-MBX-APIKEYAn API Key is required to access this endpoint and must be included in the request headers. To create an API Key, refer to: https://www.binance.com/en/support/faq/detail/360002502072.
Query Parameters
timestampUnix timestamp in milliseconds used to sign the request. The value must reflect the current client time and is validated by the server for signed endpoints.
walletAddressUser's prediction wallet address
marketTopicIdFilter by market topic ID
recvWindowRequest validity window in milliseconds
Query Positions by Filter › Responses
Query Positions by Filter
Get Position by Token
Get the authenticated user's position detail for a specific prediction token.
Get Position by Token › Authorization
Get Position by Token › Request Weight
This endpoint consumes IP-based request weight. Heavier endpoints consume more of your IP rate limit capacity.
Headers
X-MBX-APIKEYAn API Key is required to access this endpoint and must be included in the request headers. To create an API Key, refer to: https://www.binance.com/en/support/faq/detail/360002502072.
Query Parameters
walletAddressUser's prediction wallet address
tokenIdPrediction outcome token ID
timestampUnix timestamp in milliseconds used to sign the request. The value must reflect the current client time and is validated by the server for signed endpoints.
recvWindowRequest validity window in milliseconds
Get Position by Token › Responses
Get Position by Token
Query PnL
Query profit and loss records for the authenticated user's prediction positions. When tokenId is provided, returns a single record in pnl; otherwise returns a list in pnlList.
Query PnL › Authorization
Query PnL › Request Weight
This endpoint consumes IP-based request weight. Heavier endpoints consume more of your IP rate limit capacity.
Headers
X-MBX-APIKEYAn API Key is required to access this endpoint and must be included in the request headers. To create an API Key, refer to: https://www.binance.com/en/support/faq/detail/360002502072.
Query Parameters
walletAddressUser's prediction wallet address
timestampUnix timestamp in milliseconds used to sign the request. The value must reflect the current client time and is validated by the server for signed endpoints.
tokenIdFilter by prediction token ID
marketIdFilter by market ID. Must be > 0
marketTopicIdFilter by market topic ID. Must be > 0
activeOnlyIf true, return only active (unresolved) positions
recvWindowRequest validity window in milliseconds
Query PnL › Responses
Query PnL
chainIdwalletAddresspnltotalCounttotalRealizedPnltotalUnrealizedPnltotalPnlQuery Settled Position History
Get the authenticated user's settled (resolved) prediction position history with optional filters.
Query Settled Position History › Authorization
Query Settled Position History › Request Weight
This endpoint consumes IP-based request weight. Heavier endpoints consume more of your IP rate limit capacity.
Headers
X-MBX-APIKEYAn API Key is required to access this endpoint and must be included in the request headers. To create an API Key, refer to: https://www.binance.com/en/support/faq/detail/360002502072.
Query Parameters
walletAddressUser's prediction wallet address
timestampUnix timestamp in milliseconds used to sign the request. The value must reflect the current client time and is validated by the server for signed endpoints.
l1CategoryFilter by level-1 category
resultSettlement result filter
startDateStart date. Format: yyyy-MM-dd. Must be ≤ endDate
endDateEnd date. Format: yyyy-MM-dd. Must be ≥ startDate
offsetPagination offset. Default 0
limitPage size. Default 20, range 1–100
recvWindowRequest validity window in milliseconds
Query Settled Position History › Responses
Query Settled Position History
totalCount