Skip to main content

List wallet transactions

GET 
/v1/transactions

Returns transactions for a wallet across all domains (card, bank, crypto, internal).

This endpoint:

Use the domain linking fields (parentCardTransactionId, parentBankTransactionId, parentCryptoTransactionId) to group related transactions.

Request​

Query Parameters

    walletId stringrequired

    The ID of the wallet to retrieve transactions for

    cardTransactionId string

    Filter by card transaction ID

    parentCardTransactionId string

    Filter by parent card transaction ID (for grouping)

    bankTransactionId string

    Filter by bank transaction ID

    parentBankTransactionId string

    Filter by parent bank transaction ID (for grouping)

    cryptoTransactionId string

    Filter by crypto transaction ID

    parentCryptoTransactionId string

    Filter by parent crypto transaction ID (for grouping)

    purpose string

    Filter by transaction purpose (e.g., DEBIT_CARD_HOLD, BANK_DEPOSIT_SUCCESS)

    operation string

    Filter by operation (CREDIT, DEBIT)

    balanceType string

    Filter by balance type (AVAILABLE, RESERVED, PENDING, COMMITTED)

    status string

    Filter by transaction status (PENDING, COMPLETED, FAILED, CANCELLED)

    createdAfter string

    Filter transactions created after this date (YYYY-MM-DD)

    createdBefore string

    Filter transactions created before this date (YYYY-MM-DD)

    limit number
    offset number

Responses​

Successfully retrieved wallet transactions.

Schema

    traceId string
    message string

    data

    object[]

  • Array [

    • id stringrequired

    Unique identifier for this transaction

    cardTransactionId string

    ID of the card transaction that created this wallet transaction

    parentCardTransactionId string

    ID of the parent card transaction container (for grouping)

    bankTransactionId string

    ID of the bank transaction that created this wallet transaction

    parentBankTransactionId string

    ID of the parent bank transaction container (for grouping)

    cryptoTransactionId string

    ID of the crypto transaction that created this wallet transaction

    parentCryptoTransactionId string

    ID of the parent crypto transaction container (for grouping)

    walletId stringrequired

    ID of the wallet this transaction affects

    purpose string

    Possible values: [USER_REQUESTED, CRYPTO_WITHDRAWAL_INITIATED, CRYPTO_WITHDRAWAL_SUCCESS, CRYPTO_WITHDRAWAL_FAILURE, CRYPTO_DEPOSIT_INITIATED, CRYPTO_DEPOSIT_SUCCESS, CRYPTO_DEPOSIT_FAILURE, BANK_WITHDRAWAL_INITIATED, BANK_WITHDRAWAL_SUCCESS, BANK_WITHDRAWAL_FAILURE, BANK_DEPOSIT_INITIATED, BANK_DEPOSIT_SUCCESS, BANK_DEPOSIT_FAILURE, COLLATERAL_LOCK_SUCCESS, COLLATERAL_LOCK_FAILURE, COLLATERAL_LOCK, USER_TRADE, TRADE_REVENUE_SETTLEMENT, TRADE_ASSET_CREATION, TRADE_FEE_SETTLEMENT, FEE_ADJUSTMENT, CREDIT_LINE_PAYMENT, LP_SETTLEMENT_ACCOUNT_TRANSFER, WITHDRAWAL_FEE_REVENUE, TRADE_ORDER, TRADE_ORDER_RESERVE_SOURCE_ASSET, TRADE_ORDER_RESERVED_TO_CF_BALANCE, TRADE_ORDER_TRANSFER_EXISTING_TARGET_ASSET, TRADE_ORDER_CREDIT_TARGET_ASSET, TRADE_ORDER_DEBIT_SOURCE_ASSET, TRADE_ORDER_CREDIT_SOURCE_ASSET, TRADE_ORDER_FEE_SETTLEMENT, TRADE_ORDER_REVENUE_SETTLEMENT, VIRTUAL_INTERNAL_TRANSFER, MEMBERSHIP_COMMITMENT, DEBIT_CARD_HOLD, DEBIT_CARD_CAPTURE, DEBIT_CARD_REFUND, CLIENT_FEE_REVENUE_SHARE, CLIENT_FEE_CHARGE]

    Purpose of the transaction (e.g., DEBIT_CARD_HOLD, BANK_DEPOSIT_SUCCESS)

    operation string

    Possible values: [CREDIT, DEBIT]

    Operation type (CREDIT or DEBIT)

    balanceType string

    Possible values: [AVAILABLE, PENDING, RESERVED, COMMITTED, FEE_REVENUE, CF_BALANCE, TRADE_FEE, SPREAD_REVENUE, LOCKED]

    Balance type affected (AVAILABLE, RESERVED, PENDING, COMMITTED)

    amount stringrequired

    Transaction amount

    asset stringrequired

    Asset code (e.g., USD, BTC)

    status stringrequired

    Possible values: [PENDING, COMPLETED, FAILED, CANCELLED, PROCESSED]

    Transaction status

    createdAt date-timerequired

    When the transaction was created

  • ]

    • pagination

    object

    totalResults numberrequired
    hasMoreResults booleanrequired
Loading...