Sign in

v1

latestOpenAPI 3.1.0Proprietary2026-07-2464170247.4 KB
Transactions

List Transactions

Retrieve a list of transactions for a specific customer.

Transaction Types

  • DEPOSIT: Fiat or crypto deposit
  • WITHDRAWAL: Fiat or crypto withdrawal
  • CONVERSION: Asset conversion (buy/sell/convert)
  • AUTO_CONVERSION: Auto-conversion rule execution
  • TRANSFER: Internal transfer between customers

TRANSFER Response For TRANSFER transactions:

  • Sender sees a TRANSFER transaction with transaction_action: TRANSFER
  • Receiver also sees the transfer in their transaction history
  • Cross-entity transfers are supported

AUTO_CONVERSION Response For AUTO_CONVERSION transactions, the response includes a sub_transactions array containing individual transaction steps, ordered as:

  1. DEPOSIT - Initial fiat/crypto deposit
  2. CONVERSION - Asset conversion (if applicable)
  3. WITHDRAWAL - Final fiat/crypto withdrawal (if applicable)

Note: For SWIFT withdrawals, UETR is populated in the reference field.

Pagination Two query parameter formats are supported:

  • Flat format (recommended): ?page=1&size=10
  • Nested format: ?pagination=page=1&size=10
get/v1/customers/{customer_id}/transactions

Path parameters

customer_idstring required

Customer ID

Query parameters

transaction_action'DEPOSIT' | 'WITHDRAWAL' | 'CONVERSION' | 'AUTO_CONVERSION' | 'TRANSFER' | 'REWARD'

Filter by transaction action

transaction_idstring

Public transaction ID exposed by OpenAPI. Internally this maps to order IDs from the concrete transaction tables.

Example:aac5201f-7f1c-11f0-b018-de09fc637374
assetstring
  • Stablecoin assets: USDC, USDT, PYUSD, RLUSD, USDG, USDP, EURC, MXNB, 1USD(1USD/USDC conversion only, deposit/withdrawal not supported)
  • Digital assets: BTC
  • Fiat currencies: USD
Example:USDC
created_afterstring
Example:2025-08-21T07:56:57.981Z

Start time for transaction creation time range filter (RFC3339/ISO 8601 format)

created_beforestring
Example:2025-08-21T07:56:57.981Z

End time for transaction creation time range filter (RFC3339/ISO 8601 format)

include_subaccountsboolean

Include transactions from all sub-accounts under the same enterprise (default: false)

pageinteger

Page number (starts from 1, default: 1)

sizeinteger

Number of items per page (1-100, default: 10)

{
  "page": 1,
  "size": 10
}

Response

Successfully retrieved transaction list

totalinteger nullable

Example response

{
  "list": [
    {
      "customer_id": "14f20ebd-893b-11f0-b308-2eaa4f6974f2",
      "account_id": "BZ-A2C4-9XPN",
      "recipient_id": "f77a8df1-a2b3-4c5d-9e8f-1234567890ab",
      "transaction_id": "aac5201f-7f1c-11f0-b018-de09fc637374",
      "amount": "500",
      "asset": "USDC",
      "network": "ETHEREUM",
      "transaction_fee": {
        "value": "10.55",
        "asset": "USDC"
      },
      "platform_fee": {
        "value": "10.55",
        "asset": "USDC"
      },
      "partner_fee": {
        "value": "10.55",
        "asset": "USDC"
      },
      "source": {
        "wallet_address": "0x71a6c6be0be5f28ef4ea7541749d90d9c66fec7d",
        "external_account_id": "2e92e758-893e-11f0-b308-2eaa4f6974f2",
        "amount": "500",
        "asset": "USDC",
        "network": "ETHEREUM",
        "bank_name": "HSBC Bank USA, N.A.",
        "bank_account_name": "TechStart Holdings LLC"
      },
      "destination": {
        "wallet_address": "0x71a6c6be0be5f28ef4ea7541749d90d9c66fec7d",
        "external_account_id": "2e92e758-893e-11f0-b308-2eaa4f6974f2",
        "amount": "489.45",
        "asset": "USDC",
        "network": "ETHEREUM",
        "bank_name": "JPMorgan Chase Bank, N.A.",
        "bank_account_name": "TechStart Holdings LLC",
        "reference": "6471f23f-6b54-42e4-a2f3-febef7caac18"
      },
      "memorandum": "first transaction",
      "created_at": "2025-08-21T07:56:57.981Z",
      "modified_at": "2025-08-21T07:56:57.981Z",
      "sub_transactions": [
        {
          "customer_id": "14f20ebd-893b-11f0-b308-2eaa4f6974f2",
          "account_id": "BZ-A2C4-9XPN",
          "recipient_id": "f77a8df1-a2b3-4c5d-9e8f-1234567890ab",
          "transaction_id": "aac5201f-7f1c-11f0-b018-de09fc637374",
          "amount": "500",
          "asset": "USDC",
          "network": "ETHEREUM",
          "transaction_fee": {
            "value": "10.55",
            "asset": "USDC"
          },
          "platform_fee": {
            "value": "10.55",
            "asset": "USDC"
          },
          "partner_fee": {
            "value": "10.55",
            "asset": "USDC"
          },
          "source": {
            "wallet_address": "0x71a6c6be0be5f28ef4ea7541749d90d9c66fec7d",
            "external_account_id": "2e92e758-893e-11f0-b308-2eaa4f6974f2",
            "amount": "500",
            "asset": "USDC",
            "network": "ETHEREUM",
            "bank_name": "HSBC Bank USA, N.A.",
            "bank_account_name": "TechStart Holdings LLC"
          },
          "destination": {
            "wallet_address": "0x71a6c6be0be5f28ef4ea7541749d90d9c66fec7d",
            "external_account_id": "2e92e758-893e-11f0-b308-2eaa4f6974f2",
            "amount": "489.45",
            "asset": "USDC",
            "network": "ETHEREUM",
            "bank_name": "JPMorgan Chase Bank, N.A.",
            "bank_account_name": "TechStart Holdings LLC",
            "reference": "6471f23f-6b54-42e4-a2f3-febef7caac18"
          },
          "memorandum": "first transaction",
          "created_at": "2025-08-21T07:56:57.981Z",
          "modified_at": "2025-08-21T07:56:57.981Z"
        }
      ]
    }
  ],
  "total": 1024
}