Skip to main content

Purchase & Redeem History

HTTP Request

GET /spot/v3/private/record

Request Parameters

ParameterRequiredTypeComments
ltCodefalsestringAbbreviation of the LT.
orderIdfalsestringOrder ID
startTimefalseintegerStart timestamp (ms)
endTimefalseintegerEnd timestamp (ms)
limitfalseintegerLimit for data size. [1, 500]. Default: 100
orderTypefalseintegerOrder type; 1: Purchase; 2: Redeem
serialNofalsestringSerial number

Response Parameters

ParameterTypeComments
amountstringActual purchase quantity of the ETP
excTimenumberLast update time of the order status
feestringTrading fees
ltCodestringAbbreviation of the LT
orderIdstringOrder ID
orderStatusstringOrder status. 1: Completed; 2: In progress; 3: Failed
orderTimenumberOrder time
orderTypeintegerOrder type; 1. Purchase; 2. Redemption
serialNostringSerial number
valuestringFilled value
valueCoinstringQuote asset

Request Example

curl --location --request GET 'https://api-testnet.bybit.com/spot/v3/private/record?ltCode=DOT3L&startTime=1662548400000&endTime=1662549840000' \
--header 'X-BAPI-SIGN-TYPE: 2' \
--header 'X-BAPI-API-KEY: XXXXXXXXX' \
--header 'X-BAPI-TIMESTAMP: 1662608374151' \
--header 'X-BAPI-RECV-WINDOW: 5000' \
--header 'X-BAPI-SIGN: XXXXX'

Response Example

{
"retCode": 0,
"retMsg": "success",
"result": {
"list": [
{
"amount": "",
"excTime": 1662549752000,
"fee": "",
"ltCode": "DOT3L",
"orderId": "2083",
"orderStatus": "3",
"orderTime": 1662549752000,
"orderType": 1,
"serialNo": "x003",
"value": "",
"valueCoin": "USDT"
},
{
"amount": "",
"excTime": 1662549702000,
"fee": "",
"ltCode": "DOT3L",
"orderId": "2082",
"orderStatus": "3",
"orderTime": 1662549702000,
"orderType": 1,
"serialNo": "x002",
"value": "",
"valueCoin": "USDT"
}
]
},
"retExtInfo": {},
"time": 1662608374640
}