Get Quote (TRADE)
Get a price quote for a prediction order. The returned quoteId must be used in the subsequent Place Order request.
Get Quote (TRADE) › Authorization
Get Quote (TRADE) › 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.
Get Quote (TRADE) › Request Body
walletAddressUser's prediction wallet address
tokenIdPrediction outcome token ID
sideTrade direction. Enum: BUY, SELL
amountInInput amount in wei (18 decimals). Must be > 0. For MARKET orders, minimum is approximately 1.5 USDT (varies by market depth). Example: 1000000000000000000 = 1 USDT
orderTypeOrder type. Enum: MARKET, LIMIT
slippageBpsSlippage tolerance in basis points. Range 1–10000
priceLimitLimit price. Required when orderType=LIMIT. Must be > 0
chainIdChain ID. Default 56 (BSC)
feeRateBpsFee rate in basis points. Default 200, range 1–10000
fundingSourceFunding source. Enum: MPC, CEX. Default MPC
fundTransferAmountAuto-transfer amount before order (wei). Must be > 0 if provided
Get Quote (TRADE) › Responses
Get Quote
quoteIdtokenIdchancevendormarketTitlemarketExtIdsideamountInamountOutisMinAmountOutfeeAmountfeeDiscountBpsaveragePricelastPricepriceImpacttimestampchainIduserIdwalletAddressorderTypeslippageBpsfeeRateBpsminReceiveexpireAtpriceLimitPlace Order (TRADE)
Place a prediction order using a previously obtained quote. Requires SAS authorization.
Place Order (TRADE) › Authorization
Place Order (TRADE) › 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.
Place Order (TRADE) › Request Body
walletAddressUser's prediction wallet address
walletIdWallet ID
quoteIdQuote ID obtained from Get Quote
timeInForceMust match orderType: FOK for MARKET, GTC for LIMIT
accountTypePayment account type. Enum: SPOT, FUNDING
orderTypeOrder type. Enum: MARKET, LIMIT
slippageBpsSlippage tolerance in basis points. Range 1–10000
priceLimitLimit price. Required when orderType=LIMIT. Must be > 0
fundingSourceFunding source. Enum: MPC, CEX. Default MPC
fundTransferAmountAuto-transfer amount before order (wei). Must be > 0 if provided
Place Order (TRADE) › Responses
Place Order
orderIdBatch Cancel Orders (TRADE)
Cancel one or more active prediction orders in a single request. Requires SAS authorization.
Known Issue — Bracket Encoding Incompatibility:
This endpoint uses indexed bracket notation (cancelInfoList[0].orderId). Binance SAPI signature verification runs over the raw, unencoded canonical string. However, mainstream HTTP libraries (Python requests, Java HttpURLConnection/URI, Go net/url, Node.js url) automatically percent-encode [ → %5B and ] → %5D, producing a signature mismatch with error -1022 Signature for this request is not valid. Postman is unaffected because it does not encode keys.
Workarounds (use low-level HTTP APIs that do not normalize URLs):
- Python: use
http.client(stdlib) and hand-build the body string. - Java: use
HttpURLConnectionand write the raw body bytes directly. - Go: use
strings.NewReaderwith a hand-built body instead ofurl.Values.Encode().
Batch Cancel Orders (TRADE) › Authorization
Batch Cancel Orders (TRADE) › 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.
Batch Cancel Orders (TRADE) › Request Body
walletAddressUser's prediction wallet address
walletIdWallet ID
List of orders to cancel (index i starts from 0)
orderIdInternal order ID to cancel
Batch Cancel Orders (TRADE) › Responses
Batch Cancel Orders
canceledorderIdreasonQuery Active Orders (USER_DATA)
Get active (open) prediction orders for the authenticated user.
Query Active Orders (USER_DATA) › Authorization
Query Active Orders (USER_DATA) › 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.
tradeSideFilter by trade side. Enum: BUY, SELL
l1CategoryFilter by level-1 category
marketIdFilter by market ID
offsetPagination offset. Default 0
limitPage size. Default 20, range 1–100
recvWindowRequest validity window in milliseconds
Query Active Orders (USER_DATA) › Responses
Query Active Orders
totaloffsetlimitorderIdvendorOrderIdvendormarketTopicIdslugmarketTopicTitlemarketIdmarketTitleoutcomeoutcomeIndexstatussideorderTypecreateTimemodifyTimemakerUsdtAmountfilledUsdtAmountfillPercentagepricemarketProviderFeenetworkFeeQuery Order History (USER_DATA)
Get historical prediction orders (all statuses) for the authenticated user, with optional filters.
Query Order History (USER_DATA) › Authorization
Query Order History (USER_DATA) › 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
orderTypeFilter by order type. Enum: MARKET, LIMIT
statusFilter by order status
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 Order History (USER_DATA) › Responses
Query Order History
totaloffsetlimitorderIdvendorOrderIdvendormarketTopicIdslugmarketTopicTitlemarketIdmarketTitleoutcomeoutcomeIndexstatussideorderTypecreateTimemodifyTimeterminalTimemakerUsdtAmountfilledUsdtAmountfillPercentagepricemarketProviderFeenetworkFee