Wallet

Endpoint

Download schema

List Prediction Wallets

Get all prediction wallets registered for the authenticated user.

GET

/sapi/v1/w3w/wallet/prediction/wallet/list

https://api.binance.com

List Prediction Wallets › Authorization

This is a signed endpoint and a signature must be included in the request parameters.

List Prediction Wallets › Request Weight

This endpoint consumes IP-based request weight. Heavier endpoints consume more of your IP rate limit capacity.

IP Weight200

List Prediction Wallets › Headers

X-MBX-APIKEY

string · required

An 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.

Example: API_KEY

List Prediction Wallets › Query Parameters

timestamp

integer · int64 · required

Unix 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.

Example: 1770736694138

recvWindow

integer · int64 · max: 60000

Request validity window in milliseconds

Example: 5000

List Prediction Wallets › Responses

200

List Prediction Wallets

object[]

Get Portfolio

Get the authenticated user's prediction portfolio overview including active positions count, aggregated PnL, and full position list.

GET

/sapi/v1/w3w/wallet/prediction/pnl/portfolio

https://api.binance.com

Get Portfolio › Authorization

This is a signed endpoint and a signature must be included in the request parameters.

Get Portfolio › Request Weight

This endpoint consumes IP-based request weight. Heavier endpoints consume more of your IP rate limit capacity.

IP Weight200

Get Portfolio › Headers

X-MBX-APIKEY

string · required

An 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.

Example: API_KEY

Get Portfolio › Query Parameters

walletAddress

string · required

User's prediction wallet address

Example: 0x12e32db8817e292508c34111cbc4b23340df542c

timestamp

integer · int64 · required

Unix 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.

Example: 1770736694138

tokenId

string

Filter by prediction token ID

Example: 112233

marketId

integer · int64 · min: 1

Filter by market ID. Must be > 0

Example: 5567895

marketTopicId

integer · int64 · min: 1

Filter by market topic ID. Must be > 0

Example: 4229564

activeOnly

boolean

If true, return only active (unresolved) positions

Example: false

recvWindow

integer · int64 · max: 60000

Request validity window in milliseconds

Example: 5000

Get Portfolio › Responses

200

Get Portfolio

chainId

string

Example: 56

walletAddress

string

Example: 0x12e32db8817e292508c34111cbc4b23340df542c

activePositionsCount

integer

Example: 3

totalRealizedPnl

string

Example: 120.50

totalUnrealizedPnl

string

Example: 15.30

totalPnl

string

Example: 135.80

totalCostBasis

string

Example: 450.00

totalCurrentValue

string

Example: 465.30

object[]

GET/sapi/v1/w3w/wallet/prediction/pnl/portfolio

curl --request GET \
  --url 'https://api.binance.com/sapi/v1/w3w/wallet/prediction/pnl/portfolio?walletAddress=%3Cstring%3E&timestamp=%3Cnumber%3E' \
  --header 'X-MBX-APIKEY: <string>'

Example Responses

{
  "chainId": "56",
  "walletAddress": "0x12e32db8817e292508c34111cbc4b23340df542c",
  "activePositionsCount": 3,
  "totalRealizedPnl": "120.50",
  "totalUnrealizedPnl": "15.30",
  "totalPnl": "135.80",
  "totalCostBasis": "450.00",
  "totalCurrentValue": "465.30",
  "positions": [
    {
      "id": 10001,
      "walletAddress": "0x12e32db8817e292508c34111cbc4b23340df542c",
      "marketTopicId": 4229564,
      "marketId": 5567895,
      "tokenId": "112233",
      "vendor": "PREDICT_FUN",
      "currentShares": "1923.07",
      "avgPrice": "0.52",
      "currentPrice": "0.55",
      "realizedPnl": "0.00",
      "unrealizedPnl": "0.06",
      "totalPnl": "0.06",
      "pnlPercentage": "6.00",
      "isResolved": false
    }
  ]
}

json

application/json

Get Quota Status

Query the current user's daily trading quota limit and remaining allowance for prediction markets.

GET

/sapi/v1/w3w/wallet/prediction/quota/limit/status

https://api.binance.com

Get Quota Status › Authorization

This is a signed endpoint and a signature must be included in the request parameters.

Get Quota Status › Request Weight

This endpoint consumes IP-based request weight. Heavier endpoints consume more of your IP rate limit capacity.

IP Weight200

Get Quota Status › Headers

X-MBX-APIKEY

string · required

An 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.

Example: API_KEY

Get Quota Status › Query Parameters

timestamp

integer · int64 · required

Unix 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.

Example: 1770736694138

recvWindow

integer · int64 · max: 60000

Request validity window in milliseconds

Example: 5000

Get Quota Status › Responses

200

Get Quota Status

dailyLimit

string

Example: 10000.00

remainingDailyLimit

string

Example: 8500.00

Query Payment Option Balances

Get available balances for each payment option that can be used for prediction trading.

GET

/sapi/v1/w3w/wallet/prediction/balance/payment-options

https://api.binance.com

Query Payment Option Balances › Authorization

This is a signed endpoint and a signature must be included in the request parameters.

Query Payment Option Balances › Request Weight

This endpoint consumes IP-based request weight. Heavier endpoints consume more of your IP rate limit capacity.

IP Weight200

Query Payment Option Balances › Headers

X-MBX-APIKEY

string · required

An 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.

Example: API_KEY

Query Payment Option Balances › Query Parameters

timestamp

integer · int64 · required

Unix 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.

Example: 1770736694138

recvWindow

integer · int64 · max: 60000

Request validity window in milliseconds

Example: 5000

Query Payment Option Balances › Responses

200

Query Payment Option Balances

object[]

List Prediction Wallets

Get all prediction wallets registered for the authenticated user.

GET

/sapi/v1/w3w/wallet/prediction/wallet/list

https://api.binance.com

List Prediction Wallets › Authorization

This is a signed endpoint and a signature must be included in the request parameters.

List Prediction Wallets › Request Weight

This endpoint consumes IP-based request weight. Heavier endpoints consume more of your IP rate limit capacity.

IP Weight200

List Prediction Wallets › Headers

X-MBX-APIKEY

string · required

An 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.

Example: API_KEY

List Prediction Wallets › Query Parameters

timestamp

integer · int64 · required

Unix 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.

Example: 1770736694138

recvWindow

integer · int64 · max: 60000

Request validity window in milliseconds

Example: 5000

List Prediction Wallets › Responses

200

List Prediction Wallets

object[]

Get Portfolio

Get the authenticated user's prediction portfolio overview including active positions count, aggregated PnL, and full position list.

GET

/sapi/v1/w3w/wallet/prediction/pnl/portfolio

https://api.binance.com

Get Portfolio › Authorization

This is a signed endpoint and a signature must be included in the request parameters.

Get Portfolio › Request Weight

This endpoint consumes IP-based request weight. Heavier endpoints consume more of your IP rate limit capacity.

IP Weight200

Get Portfolio › Headers

X-MBX-APIKEY

string · required

An 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.

Example: API_KEY

Get Portfolio › Query Parameters

walletAddress

string · required

User's prediction wallet address

Example: 0x12e32db8817e292508c34111cbc4b23340df542c

timestamp

integer · int64 · required

Unix 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.

Example: 1770736694138

tokenId

string

Filter by prediction token ID

Example: 112233

marketId

integer · int64 · min: 1

Filter by market ID. Must be > 0

Example: 5567895

marketTopicId

integer · int64 · min: 1

Filter by market topic ID. Must be > 0

Example: 4229564

activeOnly

boolean

If true, return only active (unresolved) positions

Example: false

recvWindow

integer · int64 · max: 60000

Request validity window in milliseconds

Example: 5000

Get Portfolio › Responses

200

Get Portfolio

chainId

string

Example: 56

walletAddress

string

Example: 0x12e32db8817e292508c34111cbc4b23340df542c

activePositionsCount

integer

Example: 3

totalRealizedPnl

string

Example: 120.50

totalUnrealizedPnl

string

Example: 15.30

totalPnl

string

Example: 135.80

totalCostBasis

string

Example: 450.00

totalCurrentValue

string

Example: 465.30

object[]

Get Quota Status

Query the current user's daily trading quota limit and remaining allowance for prediction markets.

GET

/sapi/v1/w3w/wallet/prediction/quota/limit/status

https://api.binance.com

Get Quota Status › Authorization

This is a signed endpoint and a signature must be included in the request parameters.

Get Quota Status › Request Weight

This endpoint consumes IP-based request weight. Heavier endpoints consume more of your IP rate limit capacity.

IP Weight200

Get Quota Status › Headers

X-MBX-APIKEY

string · required

An 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.

Example: API_KEY

Get Quota Status › Query Parameters

timestamp

integer · int64 · required

Unix 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.

Example: 1770736694138

recvWindow

integer · int64 · max: 60000

Request validity window in milliseconds

Example: 5000

Get Quota Status › Responses

200

Get Quota Status

dailyLimit

string

Example: 10000.00

remainingDailyLimit

string

Example: 8500.00

Query Payment Option Balances

Get available balances for each payment option that can be used for prediction trading.

GET

/sapi/v1/w3w/wallet/prediction/balance/payment-options

https://api.binance.com

Query Payment Option Balances › Authorization

This is a signed endpoint and a signature must be included in the request parameters.

Query Payment Option Balances › Request Weight

This endpoint consumes IP-based request weight. Heavier endpoints consume more of your IP rate limit capacity.

IP Weight200

Query Payment Option Balances › Headers

X-MBX-APIKEY

string · required

An 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.

Example: API_KEY

Query Payment Option Balances › Query Parameters

timestamp

integer · int64 · required

Unix 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.

Example: 1770736694138

recvWindow

integer · int64 · max: 60000

Request validity window in milliseconds

Example: 5000

Query Payment Option Balances › Responses

200

Query Payment Option Balances

object[]