---
title: "Get transfers between two addresses"
method: GET
path: "/v2/connections/transfers"
tags: ["Connections Information"]
---

# Get transfers between two addresses

`GET /v2/connections/transfers`

Returns a list of transfers between two specified addresses on their respective networks.

## Query parameters

- `network_a` string, required
- `address_a` string, required
- `network_b` string, required
- `address_b` string, required
- `size` number
- `start_time` string
- `end_time` string
- `types` string
- `cursor` string

## Response `200`

List of transfers between the two specified addresses.

- SearchTransfersResponseDto
  - `items` TransferDto[], required
    - `id` string, required
    - `time` string, required
    - `status` 'SUCCEEDED' | 'PENDING' | 'ERROR_ON_DESTINATION' | 'TIMEOUT', required — Current status of the transfer
    - `type` string, required — Type of transfer (e.g., ibc, cctp, etc.)
    - `sender` AccountDto, required
      - `id` string, required
      - `name` string, required
      - `type` 'eoa' | 'multisig' | 'contract' | 'custodian' | 'exchange' | 'bank' | 'defi', required
      - `network` string
      - `address` string
      - `provider` string, required
      - `groups` object[], required
        - `id` string
        - `name` string
      - `status` 'active' | 'updating', required
      - `balances` AccountBalance[], required
        - `asset` string, required
        - `amount` string, required — Raw quantity reported by the provider, in asset units.
        - `usd` string, nullable — USD equivalent of `amount`. `null` when no USD price is available. For fiat accounts, equals `amount`.
        - `updated_at` string, required
      - `balances_usd` string, nullable — Total USD value across all of the account balances. `null` when no asset has a known price.
      - `balances_updated_at` string
      - `details` union
        - WalletDetails
          - `network` string, required
          - `address` string, required
          - `funded_by` object
            - `sender` string, required
            - `tx_hash` string, required
            - `tx_time` string, required
        - ContractDetails
          - `network` string
          - `address` string
          - `cosmos_contract` object
            - `admin` string, nullable, required
            - `code_id` number, required
            - `creator` string, required
          - `solana_contract` object
            - `owner` string, required
            - `is_on_curve` boolean, required
            - `space` number, required
            - `executable_data` string, required
            - `upgradeable` boolean, required
            - `upgrade_authority` string, nullable, required
            - `upgrade_authority_type` string, required
            - `last_deployed_slot` number
            - `last_deployed_at` string
            - `last_deployed_by` string
            - `last_deployed_tx` string
            - `verified` boolean, required
            - `repo_url` string
            - `security_txt_included` boolean, required
        - AccountConnectionDetails
          - `connection_provider` string, required
          - `connection_id` string — Account-connection holding this account
          - `connection_object_id` string, required
        - SquadsConnectionDetails
          - `connection_provider` string, required
          - `connection_id` string — Account-connection holding this account
          - `connection_object_id` string, required
          - `multisig` AccountConnectionSquadsPublicDataDto, required
            - `multisig_address` string, required
            - `resolved_from_address` string, required — Original address provided by the customer (may be a vault)
            - `resolved_vault_index` number — Vault index if input was a vault address
            - `threshold` number, required
            - `version` 'v3' | 'v4', required
            - `program_id` string, required
            - `create_key` string, required
            - `config_authority` string, nullable — V4 only
            - `time_lock` number — V4 only — seconds
            - `members` object[], required
              - …
            - `pending_proposals` AccountConnectionSquadsPendingProposalDto[], required
              - …
            - `vaults` object[], required
              - …
        - AltitudeConnectionDetails
          - `connection_provider` string, required
          - `connection_id` string — Account-connection holding this account
          - `connection_object_id` string, required
          - `altitude` AccountConnectionAltitudePublicDataDto, required
            - `settings_address` string, required — Settings account of the smart account (the canonical config PDA)
            - `resolved_from_address` string, required — Original address provided by the customer (may be a smart-account deposit address)
            - `resolved_account_index` number — Smart-account index if the input was a smart-account (deposit) address
            - `is_altitude` boolean, required — Whether the smart account is Altitude-managed (Altitude's operational key fee-pays its transactions) vs a generic smart account.
            - `program_id` string, required
            - `settings_seed` string, required — u128 global-counter seed of the Settings PDA
            - `settings_authority` string, nullable — null = autonomous (settings changes go through signers)
            - `threshold` number, required
            - `time_lock` number, required — Seconds
            - `transaction_index` number, required
            - `stale_transaction_index` number, required
            - `signers` object[], required
              - …
            - `policies` AccountConnectionAltitudePolicyDto[], required
              - …
            - `policies_truncated` boolean — Present (true) only in the edge case where the account has cycled through more than 2048 policies over its lifetime (the scan cap) — policies with seeds above 2048 are then missing from the list.
            - `pending_proposals` AccountConnectionSquadsPendingProposalDto[], required
              - …
            - `smart_accounts` AccountConnectionAltitudeSmartAccountDto[], required
              - …
        - RealmsConnectionDetails
          - `connection_provider` string, required
          - `connection_id` string — Account-connection holding this account
          - `connection_object_id` string, required
          - `realms` AccountConnectionRealmsPublicDataDto, required
            - `realm_address` string, required
            - `resolved_from_address` string, required
            - `program_id` string, required
            - `version` 'v2', required
            - `realm_name` string, required
            - `community_mint` string, required
            - `council_mint` string, nullable
            - `authority` string, nullable
            - `min_community_weight_to_create_governance` string, required
            - `council_members` object[], required
              - …
            - `community_members_count` number, required
            - `governances` object[], required
              - …
            - `treasuries` AccountConnectionRealmsTreasuryDto[], required
              - …
            - `latest_active_proposal` AccountConnectionRealmsLatestActiveProposalDto
              - …
        - SafeConnectionDetails
          - `connection_provider` string, required
          - `connection_id` string — Account-connection holding this account
          - `connection_object_id` string, required
          - `safe` AccountConnectionSafePublicDataDto, required
            - `safe_address` string, required — EIP-55 checksummed Safe address
            - `network` 'ethereum' | 'arbitrum' | 'base' | 'optimism' | 'polygon' | 'bnb', required
            - `version` string, required — Safe contract version (e.g. 1.3.0, 1.4.1)
            - `threshold` number, required
            - `nonce` number, required
            - `owners` string[], required
            - `pending_proposals` AccountConnectionSafePendingProposalDto[], required
              - …
        - PrivyConnectionDetails
          - `connection_provider` string, required
          - `connection_id` string — Account-connection holding this account
          - `connection_object_id` string, required
          - `privy_custody` 'app' | 'embedded' | 'external', required — Custody origin of the wallet: app/server-controlled, Privy-managed embedded, or user self-custody (external).
        - DfnsConnectionDetails
          - `connection_provider` string, required
          - `connection_id` string — Account-connection holding this account
          - `connection_object_id` string, required
          - `dfns_custody` 'organization' | 'end_user', required — Custody of the Dfns wallet: owned by the organization (custodial) or delegated to an end user (non-custodial).
      - `notes` string
      - `role` string
    - `receiver` AccountDto, required
      - `id` string, required
      - `name` string, required
      - `type` 'eoa' | 'multisig' | 'contract' | 'custodian' | 'exchange' | 'bank' | 'defi', required
      - `network` string
      - `address` string
      - `provider` string, required
      - `groups` object[], required
        - `id` string
        - `name` string
      - `status` 'active' | 'updating', required
      - `balances` AccountBalance[], required
        - `asset` string, required
        - `amount` string, required — Raw quantity reported by the provider, in asset units.
        - `usd` string, nullable — USD equivalent of `amount`. `null` when no USD price is available. For fiat accounts, equals `amount`.
        - `updated_at` string, required
      - `balances_usd` string, nullable — Total USD value across all of the account balances. `null` when no asset has a known price.
      - `balances_updated_at` string
      - `details` union
        - WalletDetails
          - `network` string, required
          - `address` string, required
          - `funded_by` object
            - `sender` string, required
            - `tx_hash` string, required
            - `tx_time` string, required
        - ContractDetails
          - `network` string
          - `address` string
          - `cosmos_contract` object
            - `admin` string, nullable, required
            - `code_id` number, required
            - `creator` string, required
          - `solana_contract` object
            - `owner` string, required
            - `is_on_curve` boolean, required
            - `space` number, required
            - `executable_data` string, required
            - `upgradeable` boolean, required
            - `upgrade_authority` string, nullable, required
            - `upgrade_authority_type` string, required
            - `last_deployed_slot` number
            - `last_deployed_at` string
            - `last_deployed_by` string
            - `last_deployed_tx` string
            - `verified` boolean, required
            - `repo_url` string
            - `security_txt_included` boolean, required
        - AccountConnectionDetails
          - `connection_provider` string, required
          - `connection_id` string — Account-connection holding this account
          - `connection_object_id` string, required
        - SquadsConnectionDetails
          - `connection_provider` string, required
          - `connection_id` string — Account-connection holding this account
          - `connection_object_id` string, required
          - `multisig` AccountConnectionSquadsPublicDataDto, required
            - `multisig_address` string, required
            - `resolved_from_address` string, required — Original address provided by the customer (may be a vault)
            - `resolved_vault_index` number — Vault index if input was a vault address
            - `threshold` number, required
            - `version` 'v3' | 'v4', required
            - `program_id` string, required
            - `create_key` string, required
            - `config_authority` string, nullable — V4 only
            - `time_lock` number — V4 only — seconds
            - `members` object[], required
              - …
            - `pending_proposals` AccountConnectionSquadsPendingProposalDto[], required
              - …
            - `vaults` object[], required
              - …
        - AltitudeConnectionDetails
          - `connection_provider` string, required
          - `connection_id` string — Account-connection holding this account
          - `connection_object_id` string, required
          - `altitude` AccountConnectionAltitudePublicDataDto, required
            - `settings_address` string, required — Settings account of the smart account (the canonical config PDA)
            - `resolved_from_address` string, required — Original address provided by the customer (may be a smart-account deposit address)
            - `resolved_account_index` number — Smart-account index if the input was a smart-account (deposit) address
            - `is_altitude` boolean, required — Whether the smart account is Altitude-managed (Altitude's operational key fee-pays its transactions) vs a generic smart account.
            - `program_id` string, required
            - `settings_seed` string, required — u128 global-counter seed of the Settings PDA
            - `settings_authority` string, nullable — null = autonomous (settings changes go through signers)
            - `threshold` number, required
            - `time_lock` number, required — Seconds
            - `transaction_index` number, required
            - `stale_transaction_index` number, required
            - `signers` object[], required
              - …
            - `policies` AccountConnectionAltitudePolicyDto[], required
              - …
            - `policies_truncated` boolean — Present (true) only in the edge case where the account has cycled through more than 2048 policies over its lifetime (the scan cap) — policies with seeds above 2048 are then missing from the list.
            - `pending_proposals` AccountConnectionSquadsPendingProposalDto[], required
              - …
            - `smart_accounts` AccountConnectionAltitudeSmartAccountDto[], required
              - …
        - RealmsConnectionDetails
          - `connection_provider` string, required
          - `connection_id` string — Account-connection holding this account
          - `connection_object_id` string, required
          - `realms` AccountConnectionRealmsPublicDataDto, required
            - `realm_address` string, required
            - `resolved_from_address` string, required
            - `program_id` string, required
            - `version` 'v2', required
            - `realm_name` string, required
            - `community_mint` string, required
            - `council_mint` string, nullable
            - `authority` string, nullable
            - `min_community_weight_to_create_governance` string, required
            - `council_members` object[], required
              - …
            - `community_members_count` number, required
            - `governances` object[], required
              - …
            - `treasuries` AccountConnectionRealmsTreasuryDto[], required
              - …
            - `latest_active_proposal` AccountConnectionRealmsLatestActiveProposalDto
              - …
        - SafeConnectionDetails
          - `connection_provider` string, required
          - `connection_id` string — Account-connection holding this account
          - `connection_object_id` string, required
          - `safe` AccountConnectionSafePublicDataDto, required
            - `safe_address` string, required — EIP-55 checksummed Safe address
            - `network` 'ethereum' | 'arbitrum' | 'base' | 'optimism' | 'polygon' | 'bnb', required
            - `version` string, required — Safe contract version (e.g. 1.3.0, 1.4.1)
            - `threshold` number, required
            - `nonce` number, required
            - `owners` string[], required
            - `pending_proposals` AccountConnectionSafePendingProposalDto[], required
              - …
        - PrivyConnectionDetails
          - `connection_provider` string, required
          - `connection_id` string — Account-connection holding this account
          - `connection_object_id` string, required
          - `privy_custody` 'app' | 'embedded' | 'external', required — Custody origin of the wallet: app/server-controlled, Privy-managed embedded, or user self-custody (external).
        - DfnsConnectionDetails
          - `connection_provider` string, required
          - `connection_id` string — Account-connection holding this account
          - `connection_object_id` string, required
          - `dfns_custody` 'organization' | 'end_user', required — Custody of the Dfns wallet: owned by the organization (custodial) or delegated to an end user (non-custodial).
      - `notes` string
      - `role` string
    - `sender_tx_hash` string
    - `receiver_tx_hash` string
    - `note` string — Workspace note for this transfer
    - `category` string — Workspace category for this transfer
  - `meta` CursorMetaDto, required
    - `next_cursor` string, nullable — Opaque string cursor pointing to the next page of results. null if there is no next page.
    - `previous_cursor` string, nullable — Opaque string cursor pointing to the previous page of results. null if there is no previous page.
    - `first_page_cursor` string — Opaque string cursor pointing to the very first page in the entire dataset with respect to the current filter.
    - `last_page_cursor` string, nullable — Opaque string cursor pointing to the very last page in the entire dataset with respect to the current filter.
    - `total_count` number, nullable — Total number of results.
    - `page_number` number — Current page number.

---

[API](https://skmtc.net/range/apis/range-platform-api.md) · [All operations](https://skmtc.net/range/apis/range-platform-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/range/range-platform-api/revisions/9926df2e476d/schema)
