Crypto APIs icon

Crypto APIs

Interact with Crypto APIs REST API

Actions113

Overview

This node operation lists transactions for an HD Wallet (using extended public keys like xPub, yPub, or zPub) on the XRP blockchain network. It is useful for users who want to retrieve detailed transaction history associated with a hierarchical deterministic wallet without exposing private keys. Typical scenarios include auditing wallet activity, tracking incoming and outgoing payments, or integrating wallet transaction data into financial dashboards.

For example, a user managing multiple XRP wallets can use this node to fetch recent transactions by providing the extended public key and specifying pagination parameters such as limit and offset.

Properties

Name Meaning
blockchain The blockchain network to query; here it should be set to "XRP" or relevant XRP network.
extendedPublicKey The extended public key (xPub, yPub, zPub) of the HD Wallet whose transactions are listed.
network The specific XRP network environment (e.g., mainnet, testnet) to target.
context Optional context string to correlate requests or responses, often used for tracing.
derivation The derivation method used for the HD wallet addresses; options: "account", "bip32".
limit Optional number to limit how many transactions to return in one response (pagination).
offset Optional number to skip a certain count of transactions before starting to return results (pagination).

Output

The output is a JSON array where each element represents a transaction related to the specified HD Wallet on the XRP blockchain. Each transaction object typically contains details such as transaction ID, timestamp, amounts, involved addresses, and status.

If binary data were returned (not indicated here), it would represent raw transaction payloads or attachments, but this operation focuses on JSON transaction data only.

Dependencies

  • Requires an API key credential for accessing the Crypto APIs REST API.
  • The node depends on the Crypto APIs service to fetch blockchain data.
  • No additional environment variables are explicitly required beyond the configured API authentication.

Troubleshooting

  • Common issues:

    • Providing an invalid or malformed extended public key will result in errors or empty results.
    • Incorrect blockchain or network values may cause the API to reject the request.
    • Pagination parameters (limit, offset) must be numeric and within allowed ranges; otherwise, the API might return errors or unexpected results.
  • Error messages:

    • "Operation ... not found": Indicates the requested operation identifier does not exist in the API specification; usually a configuration or version mismatch.
    • API errors related to authentication failures suggest missing or invalid API credentials.
    • Network or timeout errors indicate connectivity issues with the Crypto APIs service.

To resolve these, verify all input parameters, ensure valid API credentials are configured, and check network connectivity.

Links and References

Discussion