Create OTC Blocktrade (PREDICTION_TRADE)
Create an OTC blocktrade as the maker (BID to buy outcome shares with USDT, or ASK to sell outcome shares for USDT). The maker wallet is resolved server-side by userId; signing is done server-side via SAS typedDataSign. Returns orderId and a one-time secretToken to share out-of-band with the intended taker.
Create OTC Blocktrade (PREDICTION_TRADE) › Authorization
Create OTC Blocktrade (PREDICTION_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.
Create OTC Blocktrade (PREDICTION_TRADE) › Request Body
marketIdPredictFun market id
tokenIdERC-1155 outcome token id
sideTrade side. Enum: BUY (BID), SELL (ASK)
makerAmountMaker amount in wei. BID:USDT; ASK:shares
takerAmountTaker amount in wei. BID:shares; ASK:USDT
expirationExpiration timestamp in seconds (GTD order)
Create OTC Blocktrade (PREDICTION_TRADE) › Responses
Create OTC Blocktrade
orderIdsecretTokenList OTC Blocktrades (PREDICTION_TRADE)
List the maker's own blocktrades with optional status filter and cursor pagination.
List OTC Blocktrades (PREDICTION_TRADE) › Authorization
List OTC Blocktrades (PREDICTION_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.
List OTC Blocktrades (PREDICTION_TRADE) › Request Body
firstPage size
afterPagination cursor (from previous response)
statusFilter by status. Enum: OPEN, FULFILLED, MATCHED, CANCELLED, EXPIRED, FAILED
List OTC Blocktrades (PREDICTION_TRADE) › Responses
List OTC Blocktrades
cursorstatusmarketIdtokenIdside0 = BUY (Bid), 1 = SELL (Ask) — see Create OTC Blocktrade for the side/quoteType mapping
makermakerAmounttakerAmountpricequoteTypecreatedAtsecretTokenGet OTC Blocktrade Detail (PREDICTION_TRADE)
Query the maker's own blocktrade by orderId. Returns full order data including status and secretToken.
Get OTC Blocktrade Detail (PREDICTION_TRADE) › Authorization
Get OTC Blocktrade Detail (PREDICTION_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 OTC Blocktrade Detail (PREDICTION_TRADE) › Request Body
orderIdMaker order id (returned by create)
Get OTC Blocktrade Detail (PREDICTION_TRADE) › Responses
Get OTC Blocktrade Detail
orderIdstatusstatusmarketIdtokenIdside0 = BUY (Bid), 1 = SELL (Ask) — see Create OTC Blocktrade for the side/quoteType mapping
makertakermakerAmounttakerAmountpriceorderTypetimeInForceexpirationfilledAmountquoteTypecreatedAtisNegRiskisYieldBearingsecretTokenGet OTC Blocktrade Events (PREDICTION_TRADE)
Paginated feed of blocktrade lifecycle and settlement events (CREATE, FULFIL, MATCH_SUBMIT, MATCH_SUCCESS, EXPIRE, FAILED, etc.).
Get OTC Blocktrade Events (PREDICTION_TRADE) › Authorization
Get OTC Blocktrade Events (PREDICTION_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 OTC Blocktrade Events (PREDICTION_TRADE) › Request Body
firstPage size
afterPagination cursor
eventTypesFilter by event types (e.g. ["MATCH_SUCCESS","EXPIRE"])
marketIdFilter by market id
Get OTC Blocktrade Events (PREDICTION_TRADE) › Responses
Get OTC Blocktrade Events
cursoreventblocktradeIdorderIdmarketIdamountfeeeffectiveFeepricetransactionHashreasonisMakertimestampPreview OTC Blocktrade (PREDICTION_TRADE)
Inspect an open blocktrade by secretToken (no orderId needed). Taker uses this to preview the maker order before fulfilling. Returns the same shape as Get Blocktrade Detail, but orderId is null and secretToken is never returned from this endpoint.
Preview OTC Blocktrade (PREDICTION_TRADE) › Authorization
Preview OTC Blocktrade (PREDICTION_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.
Preview OTC Blocktrade (PREDICTION_TRADE) › Request Body
secretTokenOne-time fulfilment token the maker shared out-of-band
Preview OTC Blocktrade (PREDICTION_TRADE) › Responses
Preview OTC Blocktrade
orderIdstatusstatusmarketIdtokenIdside0 = BUY (Bid), 1 = SELL (Ask) — see Create OTC Blocktrade for the side/quoteType mapping
makertakermakerAmounttakerAmountpriceorderTypetimeInForceexpirationfilledAmountquoteTypecreatedAtisNegRiskisYieldBearingFulfil OTC Blocktrade (PREDICTION_TRADE)
Fulfil an open maker blocktrade as the taker, using the secretToken the maker shared out-of-band. All-or-nothing fill (no partial fill); the taker order is the server-derived symmetric inverse of the maker order.
Fulfil OTC Blocktrade (PREDICTION_TRADE) › Authorization
Fulfil OTC Blocktrade (PREDICTION_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.
Fulfil OTC Blocktrade (PREDICTION_TRADE) › Request Body
orderIdMaker order id (returned by maker create)
secretTokenOne-time fulfilment token the maker shared out-of-band
Fulfil OTC Blocktrade (PREDICTION_TRADE) › Responses
Fulfil OTC Blocktrade
orderIdRemove OTC Blocktrades (PREDICTION_TRADE)
Cancel open or fulfilled-but-unsettled blocktrades. Terminal orders (already MATCHED/CANCELLED/EXPIRED/FAILED) are returned in noop instead of removed.
Remove OTC Blocktrades (PREDICTION_TRADE) › Authorization
Remove OTC Blocktrades (PREDICTION_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.
Remove OTC Blocktrades (PREDICTION_TRADE) › Request Body
orderIdsOrder ids to remove (max 100). Must be the orderId returned by Create OTC Blocktrade
Remove OTC Blocktrades (PREDICTION_TRADE) › Responses
Remove OTC Blocktrades
removednoopGet OTC Reserved Balances (PREDICTION_TRADE)
Query PredictFun reserved balances for the caller's bound wallet — these are funds locked by the caller's open OTC blocktrade orders (maker BID locks USDT, maker ASK locks shares). Not tied to a specific blocktrade id; the path nesting under otc/blocktrade reflects the cause of the lock, not a per-order query. Returns one entry per requested asset, aligned with the request order. Pass {type:"USDT"} for reserved USDT, or {type:"SHARE", tokenId:"..."} for a specific outcome token's reserved shares.
Get OTC Reserved Balances (PREDICTION_TRADE) › Authorization
Get OTC Reserved Balances (PREDICTION_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 OTC Reserved Balances (PREDICTION_TRADE) › Request Body
Assets to query (max 50)
typetokenIdGet OTC Reserved Balances (PREDICTION_TRADE) › Responses
Get OTC Reserved Balances
typetokenIdamount