get
https://api.connex.trade/api/v1/asset/bills
This API will allow you to check the funds in/out history of the sub-portfolio. The history will include deposit, transfer and withdrawal history within the designated portfolio.
Important
Query the funds in / out history for the current ConneX 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 ConneX
You can filter records by currency, bill type, status and time range, and paginate through the result set.
Permission
- Please note that this API only applies to sub-portfolio's API Key so far and can't apply to primary-user's API Key yet.（For checking the deposit/transfer/withdrawal history of primary-user and main portfolio, please use deposit/transfer/withdrawal history API.）
- Permission: READ.
Rate Limit
- To be confirmed
Request
| Field name | Type | Necessary | Remarks |
|---|---|---|---|
| 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 |
| pageSize | Integer | N | Number of results per page, default is 1000 |
Response
| Field name | Type | Remarks |
|---|---|---|
| id | Long | Transfer ID / Deposit ID / Withdraw ID |
| currency | String | Asset symbol, e.g. USDT. |
| clientOrderId | Long | Optional client-defined ID associated with this bill (if applicable). May be null. |
| amount | BigDecimal | Requested transfer amount (nominal amount of this operation), before deducting any network fee. |
| amountReceived | BigDecimal | Actual amount credited to the receiving side after fees. For on-chain operations, typically amount - networkFee. For internal transfers, equals amount. |
| networkFee | BigDecimal | Network fee charged for on-chain deposit / withdrawal. For pure internal transfers, this value is 0. |
| network | String | This field will only take effect in cross-exchange transfers. |
| txId | String | On-chain transaction hash for deposits / withdrawals. null for internal transfers. |
| fromTradeAccountId | Long | Outgoing Trade account ID (obtained through Trade account list) This field is applicable to Exchange account, Funding Account, CL Trading Account and Trading Portfolio's ID. |
| toTradeAccountId | Long | Posting Trade account ID (obtained through Trade account list) This field is applicable to Exchange account, Funding Account, CL Trading Account and Trading Portfolio's ID. |
| fromAccountType | String | - When fromAccount is a Trading Portfolio, this field shows the destination exchange of the portfolio such as Binance, OKX. |
| toAccountType | String | - When toAccount is a Trading Portfolio, this field shows the destination exchange of the portfolio such as Binance, OKX. |
| status | Integer | Bill status: 0 = pending, 1 = succeeded, 2 = failed. Only 1 indicates the balance has been finally updated. |
| type | Integer | 0:deposit 1:transfer 2:withdraw |
| createdAt | Long | Creation time of this bill record. Unix timestamp in milliseconds. |