API Reference

Retrieve hot wallet transactions

post
https://api-sdk.lmnl.dev/api/wallet/get-transfer-list

This API is a request to retrieve a paginated list of transactions for a hot wallet. The list will include send, receive, and internal transactions, as applicable.

The following values are sliced to the decimal points:

  • value (8 decimal),
  • baseValue (8 decimal),
  • valueString (8 decimal),
  • baseValueString (8 decimal),
  • feeString (8 decimal), and
  • usd (5 decimal).

Filters:

You can filter the list of transactions based on the following:

  1. The timestampOptions and syncedTimestampOptions cannot be used together in the same request.
  2. Use the timestampOptions filter to filter transactions when they sync on the blockchain in the given date range.
  3. syncedTimestampOptions:
    1. The syncedTimestampOptions works only for successful transactions, i.e., "status": "success".
    2. Use the syncedTimestampOptions to filter transactions when they sync to Liminal Vaults in the given date range.
    3. syncedTimestampOptions cannot be earlier than 2025-07-10 11:18:27.
    4. It records upto a date range of 12 months.
📘

Note

  • The values of the block and blockConfirmations parameters can return either a number or null.
  • The fromDate parameter provided as "2024-05-02" is interpreted as "2024-05-02T00:00:00.000Z", indicating the start of the day.
    Similarly, if the toDate provided as "2024-05-02" is interpreted as "2024-05-02T23:59:59.000Z", indicating the end of the day.
  • For the receive transaction type, the sequenceID is not returned in the response.

While all liminal supported chains support firewall for Mobile MPC Wallets, please refer to the latest supported chains for hot V2 wallets supporting firewall.

Body Params
wallet
object
required
pagination
object
required
timeStampOptions
object

The date range of the transactions. If the dates aren't provided, the API will fetch all the transactions from one year before the current date to the present day. For example, if today’s date is 2024-11-26, the API will fetch transactions from 2023-11-26T00:00:00.000Z to 2024-11-25T23:59:59.999Z.

syncedTimestampOptions
object

The transactions date range when it was recorded in Liminal. It has a maximum date range of 12 months. Transaction must have "success" status. If the dates aren't provided, the API will fetch all the transactions from one year before the current date to the present day. For example, if today’s date is 2024-11-26, the API will fetch transactions from 2023-11-26T00:00:00.000Z to 2024-11-25T23:59:59.999Z.

filter
object
Headers
string
enum
Defaults to application/json; charset=utf-8

Generated from available response content types

Allowed:
Responses

Updated 2 months ago

Language
Credentials
Basic
base64
:
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json; charset=utf-8
application/json

Updated 2 months ago