com.coinbase.cdp.resources.transfers
Constructor Details
AsyncTransfersClient
clientOptions - ClientOptions
Method Details
withRawResponse
listTransfers
Overload 1
?status=processing - Monitor active transfers. ?status=quoted - Find transfers awaiting execution. ?status=failed - Review failed transfers for troubleshooting. ?status=completed - Find completed transfers.
Account Filtering: Filter by account ID to find transfers involving a specific account:
?accountId=<ID> - All transfers where the account is either source or target (OR semantics). ?sourceAccountId=<ID> - Only transfers where the account is the source (outbound). ?targetAccountId=<ID> - Only transfers where the account is the target (inbound). Providing accountId together with sourceAccountId or targetAccountId is a validation error and returns HTTP 400.
Date Range Filtering: Filter by creation or last-updated time for reconciliation:
?createdAfter=2026-01-01T00:00:00Z&createdBefore=2026-01-31T23:59:59Z - Transfers created within a date range. ?updatedAfter=2026-01-01T00:00:00Z - Transfers updated since a given time. Useful for incremental sync.
Asset Filtering: Filter by source or target asset symbol:
?sourceAsset=usd - Transfers funded from a USD account. ?targetAsset=usdc - Transfers delivering USDC to the target. Supported asset symbols include usdc, eurc, usd, and eur.
Other Filters:
?sourceAddress=0x... - Transfers from a specific on-chain source address. ?targetAddress=0x... - Transfers to a specific on-chain destination address. ?targetEmail=user@example.com - Transfers to a specific email recipient. ?transferId=transfer_... - Look up a single transfer by ID; bypasses pagination.
Returns:
CompletableFuture<ListTransfersResponse>
Overload 2
?status=processing - Monitor active transfers. ?status=quoted - Find transfers awaiting execution. ?status=failed - Review failed transfers for troubleshooting. ?status=completed - Find completed transfers.
Account Filtering: Filter by account ID to find transfers involving a specific account:
?accountId=<ID> - All transfers where the account is either source or target (OR semantics). ?sourceAccountId=<ID> - Only transfers where the account is the source (outbound). ?targetAccountId=<ID> - Only transfers where the account is the target (inbound). Providing accountId together with sourceAccountId or targetAccountId is a validation error and returns HTTP 400.
Date Range Filtering: Filter by creation or last-updated time for reconciliation:
?createdAfter=2026-01-01T00:00:00Z&createdBefore=2026-01-31T23:59:59Z - Transfers created within a date range. ?updatedAfter=2026-01-01T00:00:00Z - Transfers updated since a given time. Useful for incremental sync.
Asset Filtering: Filter by source or target asset symbol:
?sourceAsset=usd - Transfers funded from a USD account. ?targetAsset=usdc - Transfers delivering USDC to the target. Supported asset symbols include usdc, eurc, usd, and eur.
Other Filters:
?sourceAddress=0x... - Transfers from a specific on-chain source address. ?targetAddress=0x... - Transfers to a specific on-chain destination address. ?targetEmail=user@example.com - Transfers to a specific email recipient. ?transferId=transfer_... - Look up a single transfer by ID; bypasses pagination.
Parameters:
request - ListTransfersRequest
Returns:
CompletableFuture<ListTransfersResponse>
Overload 3
?status=processing - Monitor active transfers. ?status=quoted - Find transfers awaiting execution. ?status=failed - Review failed transfers for troubleshooting. ?status=completed - Find completed transfers.
Account Filtering: Filter by account ID to find transfers involving a specific account:
?accountId=<ID> - All transfers where the account is either source or target (OR semantics). ?sourceAccountId=<ID> - Only transfers where the account is the source (outbound). ?targetAccountId=<ID> - Only transfers where the account is the target (inbound). Providing accountId together with sourceAccountId or targetAccountId is a validation error and returns HTTP 400.
Date Range Filtering: Filter by creation or last-updated time for reconciliation:
?createdAfter=2026-01-01T00:00:00Z&createdBefore=2026-01-31T23:59:59Z - Transfers created within a date range. ?updatedAfter=2026-01-01T00:00:00Z - Transfers updated since a given time. Useful for incremental sync.
Asset Filtering: Filter by source or target asset symbol:
?sourceAsset=usd - Transfers funded from a USD account. ?targetAsset=usdc - Transfers delivering USDC to the target. Supported asset symbols include usdc, eurc, usd, and eur.
Other Filters:
?sourceAddress=0x... - Transfers from a specific on-chain source address. ?targetAddress=0x... - Transfers to a specific on-chain destination address. ?targetEmail=user@example.com - Transfers to a specific email recipient. ?transferId=transfer_... - Look up a single transfer by ID; bypasses pagination.
Parameters:
requestOptions - RequestOptions
Returns:
CompletableFuture<ListTransfersResponse>
Overload 4
?status=processing - Monitor active transfers. ?status=quoted - Find transfers awaiting execution. ?status=failed - Review failed transfers for troubleshooting. ?status=completed - Find completed transfers.
Account Filtering: Filter by account ID to find transfers involving a specific account:
?accountId=<ID> - All transfers where the account is either source or target (OR semantics). ?sourceAccountId=<ID> - Only transfers where the account is the source (outbound). ?targetAccountId=<ID> - Only transfers where the account is the target (inbound). Providing accountId together with sourceAccountId or targetAccountId is a validation error and returns HTTP 400.
Date Range Filtering: Filter by creation or last-updated time for reconciliation:
?createdAfter=2026-01-01T00:00:00Z&createdBefore=2026-01-31T23:59:59Z - Transfers created within a date range. ?updatedAfter=2026-01-01T00:00:00Z - Transfers updated since a given time. Useful for incremental sync.
Asset Filtering: Filter by source or target asset symbol:
?sourceAsset=usd - Transfers funded from a USD account. ?targetAsset=usdc - Transfers delivering USDC to the target. Supported asset symbols include usdc, eurc, usd, and eur.
Other Filters:
?sourceAddress=0x... - Transfers from a specific on-chain source address. ?targetAddress=0x... - Transfers to a specific on-chain destination address. ?targetEmail=user@example.com - Transfers to a specific email recipient. ?transferId=transfer_... - Look up a single transfer by ID; bypasses pagination.
Parameters:
request - ListTransfersRequest
requestOptions - RequestOptions
Returns:
CompletableFuture<ListTransfersResponse>
createTransfer
Overload 1
quoted. If execute: false, the transfer stays quoted until you call /v2/transfers/{transferId}/execute. If execute: true, quoted status emits momentarily before the transfer moves to processing, where execution proceeds. Subscribe to the transfers webhook to follow progress in real time instead of polling.
Parameters:
request - TransferRequest
Returns:
CompletableFuture<Transfer>
Overload 2
quoted. If execute: false, the transfer stays quoted until you call /v2/transfers/{transferId}/execute. If execute: true, quoted status emits momentarily before the transfer moves to processing, where execution proceeds. Subscribe to the transfers webhook to follow progress in real time instead of polling.
Parameters:
request - TransferRequest
requestOptions - RequestOptions
Returns:
CompletableFuture<Transfer>
getTransferById
Overload 1
transferId - String
Returns:
CompletableFuture<Transfer>
Overload 2
transferId - String
request - GetTransferByIdRequest
Returns:
CompletableFuture<Transfer>
Overload 3
transferId - String
requestOptions - RequestOptions
Returns:
CompletableFuture<Transfer>
Overload 4
transferId - String
request - GetTransferByIdRequest
requestOptions - RequestOptions
Returns:
CompletableFuture<Transfer>
executeFundTransfer
Overload 1
transferId - String
Returns:
CompletableFuture<Transfer>
Overload 2
transferId - String
request - ExecuteFundTransferRequest
Returns:
CompletableFuture<Transfer>
Overload 3
transferId - String
requestOptions - RequestOptions
Returns:
CompletableFuture<Transfer>
Overload 4
transferId - String
request - ExecuteFundTransferRequest
requestOptions - RequestOptions
Returns:
CompletableFuture<Transfer>
submitDepositTravelRule
Overload 1
status will be completed and the transfer will proceed. Otherwise, status will be incomplete and missingFields will indicate which fields still need to be provided.
Parameters:
transferId - String
Returns:
CompletableFuture<DepositTravelRuleResponse>
Overload 2
status will be completed and the transfer will proceed. Otherwise, status will be incomplete and missingFields will indicate which fields still need to be provided.
Parameters:
transferId - String
request - DepositTravelRuleRequest
Returns:
CompletableFuture<DepositTravelRuleResponse>
Overload 3
status will be completed and the transfer will proceed. Otherwise, status will be incomplete and missingFields will indicate which fields still need to be provided.
Parameters:
transferId - String
requestOptions - RequestOptions
Returns:
CompletableFuture<DepositTravelRuleResponse>
Overload 4
status will be completed and the transfer will proceed. Otherwise, status will be incomplete and missingFields will indicate which fields still need to be provided.
Parameters:
transferId - String
request - DepositTravelRuleRequest
requestOptions - RequestOptions
Returns:
CompletableFuture<DepositTravelRuleResponse>