get
https://api.liquiditytech.com/api/v1/asset/bills
Description
Query the funds in / out history for the current RapidX sub-portfolio bound to the API key.
This API returns all asset bills of the portfolio, including:
- Deposits (on-chain transfers into the portfolio)
- Withdrawals (on-chain transfers out of the portfolio)
- Internal transfers between different trade accounts / account types within LTP
You can filter records by currency, bill type, status and time range, and paginate through the result set.
Permission
RapidX API key with read-only permission is sufficient. No trading / write permission is required.
Request
| Field | Type | Necessary | Description |
|---|---|---|---|
| currency | String | N | Filter by currency symbol (e.g. USDT). If omitted, bills for all currencies are returned. |
| type | Integer | N | Filter by bill type: 0 = deposit, 1 = internal transfer, 2 = withdrawal. If omitted, all types are included. |
| status | Integer | N | Filter by bill status: 0 = pending, 1 = succeeded, 2 = failed. If omitted, all statuses are included. |
| startTime | Long | N | Start of the time range (inclusive), as a Unix timestamp in milliseconds. |
| endTime | Long | N | End of the time range (inclusive), as a Unix timestamp in milliseconds. |
| page | Integer | N | Page number for pagination, starting from 1. Default is 1. |
| pageSize | Integer | N | Number of records per page. Default is 1000. |
Response
| Field | Type | Description |
|---|---|---|
| id | Long | Unique identifier of this bill record. |
| currency | String | Asset symbol, e.g. USDT. |
| clientOrderId | String | Optional client-defined ID associated with this bill (if applicable). May be null. |
| amount | Number | Requested transfer amount (nominal amount of this operation), before deducting any network fee. |
| amountReceived | Number | Actual amount credited to the receiving side after fees. For on-chain operations, typically amount - networkFee. For internal transfers, equals amount. |
| networkFee | Number | Network fee charged for on-chain deposit / withdrawal. For pure internal transfers, this value is 0. |
| network | String | Network name, e.g. BSC, TRC20, ERC20. Empty string for internal transfers where no blockchain network is involved. |
| txId | String | On-chain transaction hash for deposits / withdrawals. null for internal transfers. |
| fromTradeAccountId | Long | Account ID that the funds are transferred from. null when the source is an external wallet or non-account source. |
| toTradeAccountId | Long | Account ID that the funds are transferred to. null when the destination is an external wallet. |
| fromAccountType | String | Source account type or venue label, for example Binance, Funding, etc. May be null if the operation originates from an external address. |
| toAccountType | String | Destination account type or venue label. For example Binance, Funding, etc. May be null if the destination is an external address. |
| status | Integer | Bill status: 0 = pending, 1 = succeeded, 2 = failed. Only 1 indicates the balance has been finally updated. |
| type | Integer | Bill type: 0 = deposit (funds flow into the portfolio), 1 = internal transfer (between LTP accounts / account types), 2 = withdrawal (funds flow out). |
| createdAt | Long | Creation time of this bill record. Unix timestamp in milliseconds. |