Block Trade Orders
Description
Retrieves a list of block trade orders submitted by a given wallet on Loopring DeFi. This includes buy and sell orders placed via the Block Trade product, with full metadata on order size, settlement status, and pricing.
Endpoint
GET /api/v3/btrade/ordersRequest
address
string
(Optional) The wallet's public address. address or accountId is required.
0xbefa...b491
accountId
string
(Optional) The unique ID of the user's Loopring DeFi account. accountId or address is required.
10501
limit
number
(Optional) Maximum number of results to return.
6
offset
number
(Optional) Number of records to skip (used for pagination).
0
⚠️ Either address or accountId must be provided — at least one is required to query block trade orders.
Response
totalNum
number
Total number of block trade transactions returned by the query.
1
transactions
array
A list of block trade transaction records.
[ ... ]
transactions[].hash
string
The transaction hash of the block trade.
"0x0edf...2383"
transactions[].clientOrderId
string
Client order ID used to track the trade.
"0x0edf...2383"
transactions[].side
string
Indicates whether the user was buying or selling (BUY or SELL).
"BUY"
transactions[].market
string
Market identifier in BTRADE-<BASE>-<QUOTE> format.
"BTRADE-ETH-USDC"
transactions[].price
string
Execution price for the trade.
"3709.94"
transactions[].volumes.baseAmount
string
Total base token amount intended to trade (before fill, in base units).
"161727249179761700"
transactions[].volumes.quoteAmount
string
Total quote token amount intended to trade (in base units).
"600000000"
transactions[].volumes.baseFilled
string
Actual base token amount filled (in base units).
"161700000000000000"
transactions[].volumes.quoteFilled
string
Actual quote token amount filled (in base units).
"599179350"
transactions[].volumes.fee
string
Fee paid in quote tokens (in base units).
"485091000000000"
transactions[].validity.start
number
Start timestamp (in seconds) when the order became valid.
1733082920
transactions[].validity.end
number
End timestamp (in seconds) when the order expired.
1735674920
transactions[].orderType
string
Type of order (e.g., LIMIT_ORDER).
"LIMIT_ORDER"
transactions[].tradeChannel
string
Indicates how the trade was executed (e.g., ORDER_BOOK).
"ORDER_BOOK"
transactions[].status
string
Final status of the trade (e.g., processed, cancelled).
"processed"
transactions[].storageInfo.accountId
number
Account ID associated with the trade.
10720
transactions[].storageInfo.tokenId
number
Token ID used in the trade.
3
transactions[].storageInfo.storageId
number
Storage ID used to prevent replay attacks.
0
transactions[].baseSettled
string
Final base token amount settled (after fee deduction or slippage, in base units).
"161503959632770341"
transactions[].quoteSettled
string
Final quote token amount settled (in base units).
"599170000"
💡 All values are returned in base units. Use token decimals to convert to human-readable values.
The decimals value can be retrieved using GET /api/v3/exchange/tokens.
Last updated