Request parameters.
Redeem one or more settled prediction tokens on-chain to claim winnings. Requires SAS authorization.
Weight(IP): 200
Security Type: TRADE
Request parameters.
Transfer funds from the prediction wallet back to the user's CEX account (SPOT or FUNDING). Requires SAS authorization.
⚠️ SAS Authorization Required: This endpoint enforces SAS (Self-Authorization Service) authorization. If SAS is not enabled for the wallet, the request will be rejected with -31003 SAS authorization required. Enable SAS for your wallet before calling this endpoint.
Weight(IP): 200
Security Type: TRADE
Request parameters.
Transfer funds from the user's CEX account (SPOT or FUNDING) into the prediction wallet. Requires SAS authorization.
Weight(IP): 200
Security Type: TRADE
Request parameters.
Get full details for a specific prediction market topic, including variant data and timeline.
Weight(IP): 200
Request parameters.
Get the authenticated user's prediction portfolio overview including active positions count, aggregated PnL, and full position list.
Weight(IP): 200
Security Type: USER_DATA
Request parameters.
Get the authenticated user's position detail for a specific prediction token.
Weight(IP): 200
Security Type: USER_DATA
Request parameters.
Query the current user's daily trading quota limit and remaining allowance for prediction markets.
Weight(IP): 200
Security Type: USER_DATA
Request parameters.
Get a price quote for a prediction order. The returned quoteId must be used in the subsequent Place Order request.
Weight(IP): 200
Security Type: TRADE
Response Notes:
feeAmount is a string because it is denominated in wei (18 decimals) and may exceed JavaScript's safe integer range. feeDiscountBps is also a string to allow fractional basis-point values in the future. feeRateBps and slippageBps are integers and will never exceed safe integer bounds.MARKET orders, amountIn must be at least approximately 1.5 USDT (in wei: 1500000000000000000). The exact minimum varies by market liquidity. If the amount is too small, the server returns -9000 Your order amount is too small. This limit does not apply to LIMIT orders.Request parameters.
Query the on-chain transaction status of a previously submitted redeem request.
Weight(IP): 200
Security Type: USER_DATA
Response Notes:
| Value | Description |
|---|---|
PENDING |
Transaction submitted, awaiting confirmation |
CONFIRMED |
Transaction confirmed on-chain |
FAILED |
Transaction failed |
NOT_FOUND |
Transaction hash not found |
Request parameters.
Get all available prediction market categories (L1 and L2).
Weight(IP): 200
Get a paginated list of prediction market topics, with optional category and sort filters.
Weight(IP): 200
Request parameters.
Get all prediction wallets registered for the authenticated user.
Weight(IP): 200
Security Type: USER_DATA
Request parameters.
Semantic search for prediction market topics by keyword.
Weight(IP): 200
Request parameters.
Place a prediction order using a previously obtained quote. Requires SAS authorization.
Weight(IP): 200
Security Type: TRADE
Notes:
| orderType | timeInForce | priceLimit |
|---|---|---|
MARKET |
Must be FOK |
Not required |
LIMIT |
Must be GTC |
Required, must be > 0 |
Request parameters.
Get active (open) prediction orders for the authenticated user.
Weight(IP): 200
Security Type: USER_DATA
Request parameters.
Get the most recent trade price for a prediction market.
Weight(IP): 200
Request parameters.
Get the current order book (bids and asks) for a specific prediction market outcome token.
Weight(IP): 200
Request parameters.
Get historical prediction orders (all statuses) for the authenticated user, with optional filters.
Weight(IP): 200
Security Type: USER_DATA
Request parameters.
Get available balances for each payment option that can be used for prediction trading.
Weight(IP): 200
Security Type: USER_DATA
Request parameters.
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.
Weight(IP): 200
Security Type: USER_DATA
Request parameters.
Get the authenticated user's prediction token positions with portfolio summary and tab-based filtering.
Weight(IP): 200
Security Type: USER_DATA
Request parameters.
Get prediction positions filtered by wallet address and/or market topic ID. Both parameters are optional.
Weight(IP): 200
Security Type: USER_DATA
Request parameters.
Get the authenticated user's settled (resolved) prediction position history with optional filters.
Weight(IP): 200
Security Type: USER_DATA
Request parameters.
Get the authenticated user's prediction wallet transfer history within a date range.
Weight(IP): 200
Security Type: USER_DATA
Request parameters.
Query the current status of a prediction wallet transfer by transfer ID.
status values:* Terminal states are COMPLETED and FAILED. Intermediate states are PROCESSING and PENDING. Do not poll for SUCCESS — it is not a valid terminal state.
Weight(IP): 200
Security Type: USER_DATA
Request parameters.
Generic function to send a request.
The API endpoint to call.
HTTP method to use (GET, POST, DELETE, etc.).
Query parameters for the request.
Body parameters for the request.
A promise resolving to the response data object.
Generic function to send a signed request.
The API endpoint to call.
HTTP method to use (GET, POST, DELETE, etc.).
Query parameters for the request.
Body parameters for the request.
A promise resolving to the response data object.
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 (Pythonrequests, JavaHttpURLConnection/URI, Gonet/url, Node.jsurl) automatically percent-encode[→%5Band]→%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):
http.client(stdlib) and hand-build the body string.HttpURLConnectionand write the raw body bytes directly.strings.NewReaderwith a hand-built body instead ofurl.Values.Encode().Weight(IP): 200
Security Type: TRADE
Notes:
cancelInfoList[0].orderId,cancelInfoList[1].orderId, etc.vendordoes not need to be supplied. The server automatically sets the correct vendor (predict_fun) for every item in the batch.