Skip to main content

Get Order List

Query the authenticated user's prediction market order history. Use this after placing a buy or sell order to check the final execution status. FOK orders will show as FILLED or CANCELLED.

HTTP Request

POST/v5/alpha/prediction/order-list

Request Parameters

ParameterRequiredTypeComments
statusfalseintegerFilter by order status. Refer to predictionOrderStatus
tokenIdfalsestringFilter by outcome token ID
eventIdfalsestringFilter by event ID
sidefalseintegerFilter by trade direction. Refer to predictionSide
daysfalseintegerLook back N days. Max: 90
limitfalseintegerNumber of records per page
pageIndexfalseintegerPage number starting from 1

Response Parameters

ParameterTypeComments
ordersarrayOrder records
> orderNostringOrder number
> tokenIdstringOutcome token ID
> eventIdstringEvent ID
> sideintegerTrade direction. Refer to predictionSide
> orderTypeintegerOrder type. Refer to predictionOrderType
> orderAmountstringBUY: USDC invested. SELL: shares sold
> filledSizestringFilled shares (BUY) or shares sold (SELL)
> filledPricestringAverage execution price
> totalFeestringTotal platform fee charged (USDC)
> statusintegerOrder status. Refer to predictionOrderStatus
> createdAtintegerOrder creation timestamp (UTC milliseconds)
> updatedAtintegerLast update timestamp (UTC milliseconds)
totalintegerTotal matching records
pageIndexintegerCurrent page number

Request Example

POST /v5/alpha/prediction/order-list HTTP/1.1
Host: api.bybit.com
X-BAPI-SIGN: XXXXXX
X-BAPI-API-KEY: xxxxxxxxxxxxxxxxxx
X-BAPI-TIMESTAMP: 1704067200000
X-BAPI-RECV-WINDOW: 5000
Content-Type: application/json

{
"limit": 20,
"pageIndex": 1,
"days": 7
}

Response Example

{
"retCode": 0,
"retMsg": "OK",
"result": {
"orders": [
{
"orderNo": "ord_buy_20240101_001",
"tokenId": "token_yes_123",
"eventId": "event_123",
"side": 1,
"orderType": 1,
"orderAmount": "100",
"filledSize": "153.84",
"filledPrice": "0.65",
"totalFee": "1.00",
"status": 2,
"createdAt": 1704067200000,
"updatedAt": 1704067205000
}
],
"total": 1,
"pageIndex": 1
},
"retExtInfo": {},
"time": 1704067200000
}