Skip to main content

Get Convert Detail

Query the full status and settlement result of a single Convert order by order number or idempotency key. Used for MM reconciliation, status polling and failure diagnosis.

info

This endpoint is only available for Market Maker.

HTTP Request

GET/v5/rwa/stocks/convert/detail

Request Parameters

ParameterRequiredTypeComments
orderNofalsestringConvert order number. Either orderNo or requestId is required
requestIdfalsestringIdempotency key used at submission. Either orderNo or requestId is required

Response Parameters

ParameterTypeComments
orderNostringConvert order number
requestIdstringClient idempotency key
statusstringCurrent order status
convertTypestringDirection
symbolstringUnderlying stock symbol
tokenSymbolstringCorresponding mStocks Token
inputAmountstringInput amount
outputAmountstringActual output amount. Estimated value when not settled
appliedMultiplierstringActually applied conversion ratio
accountTypestringAccount type. Only effective for REDEEM
failReasonstringFailure reason. Non-empty when status=FAILED
submittedAtintegerServer accepted timestamp in milliseconds
updatedAtintegerLast update timestamp in milliseconds

Request Example

GET /v5/rwa/stocks/convert/detail?orderNo=CVT1755590600987654321 HTTP/1.1
Host: api-testnet.bybit.com
X-BAPI-API-KEY: xxxxxxxxxxxxxxxxxx
X-BAPI-TIMESTAMP: 1787657753833
X-BAPI-RECV-WINDOW: 5000
X-BAPI-SIGN: XXXXX

Response Example

{
"retCode": 0,
"retMsg": "ok",
"result": {
"orderNo": "CVT1755590600987654321",
"requestId": "mm-cvt-20260819-0007",
"status": "SUCCESS",
"convertType": "MINT",
"symbol": "AAPL-US",
"tokenSymbol": "AAPLM",
"inputAmount": "5",
"outputAmount": "50",
"appliedMultiplier": "10",
"accountType": null,
"failReason": null,
"submittedAt": 1755590600180,
"updatedAt": 1755590620400
},
"time": 1724534400123
}