Skip to main content

Namespaces

Interfaces

DepositTravelRuleRequest

Defined in: _vendor/api/resources/transfers/client/requests/DepositTravelRuleRequest.ts:28

Example

Properties

beneficiary?
Defined in: _vendor/api/resources/transfers/client/requests/DepositTravelRuleRequest.ts:40 Beneficiary information for the travel rule submission.
idempotencyKey?
Defined in: _vendor/api/resources/transfers/client/requests/DepositTravelRuleRequest.ts:36 An optional string request header for making requests safely retryable. When included, duplicate requests with the same key will return identical responses. Refer to our Idempotency docs for more information on using idempotency keys.
isSelf?
Defined in: _vendor/api/resources/transfers/client/requests/DepositTravelRuleRequest.ts:42 Indicates whether the user attests that the originating wallet belongs to them.
originator?
Defined in: _vendor/api/resources/transfers/client/requests/DepositTravelRuleRequest.ts:38 Originator information for the travel rule submission.
transferId
Defined in: _vendor/api/resources/transfers/client/requests/DepositTravelRuleRequest.ts:30 The unique identifier of the transfer.

ExecuteFundTransferRequest

Defined in: _vendor/api/resources/transfers/client/requests/ExecuteFundTransferRequest.ts:12

Example

Properties

idempotencyKey?
Defined in: _vendor/api/resources/transfers/client/requests/ExecuteFundTransferRequest.ts:20 An optional string request header for making requests safely retryable. When included, duplicate requests with the same key will return identical responses. Refer to our Idempotency docs for more information on using idempotency keys.
transferId
Defined in: _vendor/api/resources/transfers/client/requests/ExecuteFundTransferRequest.ts:14 The ID of the transfer.

GetTransferByIdRequest

Defined in: _vendor/api/resources/transfers/client/requests/GetTransferByIdRequest.ts:11

Example

Properties

transferId
Defined in: _vendor/api/resources/transfers/client/requests/GetTransferByIdRequest.ts:13 The unique identifier of the transfer.

ListTransfersRequest

Defined in: _vendor/api/resources/transfers/client/requests/ListTransfersRequest.ts:26

Example

Properties

accountId?
Defined in: _vendor/api/resources/transfers/client/requests/ListTransfersRequest.ts:30 Filter transfers by account ID. Returns transfers where the specified account is either the source or target (OR semantics). Cannot be combined with sourceAccountId or targetAccountId.
createdAfter?
Defined in: _vendor/api/resources/transfers/client/requests/ListTransfersRequest.ts:36 Filter transfers to those created at or after this datetime (inclusive). ISO 8601 format.
createdBefore?
Defined in: _vendor/api/resources/transfers/client/requests/ListTransfersRequest.ts:38 Filter transfers to those created at or before this datetime (inclusive). ISO 8601 format.
pageSize?
Defined in: _vendor/api/resources/transfers/client/requests/ListTransfersRequest.ts:56 The number of resources to return per page.
pageToken?
Defined in: _vendor/api/resources/transfers/client/requests/ListTransfersRequest.ts:58 The token for the next page of resources, if any.
sourceAccountId?
Defined in: _vendor/api/resources/transfers/client/requests/ListTransfersRequest.ts:32 Filter transfers by source account ID. Returns only transfers where the specified account is the source. Cannot be combined with accountId.
sourceAddress?
Defined in: _vendor/api/resources/transfers/client/requests/ListTransfersRequest.ts:48 Filter transfers by the on-chain address of the source.
sourceAsset?
Defined in: _vendor/api/resources/transfers/client/requests/ListTransfersRequest.ts:44 Filter transfers by source asset symbol (e.g., usd, usdc).
status?
Defined in: _vendor/api/resources/transfers/client/requests/ListTransfersRequest.ts:28 Filter transfers by status. Useful for building dashboards, monitoring active transfers, or finding transfers needing action.
targetAccountId?
Defined in: _vendor/api/resources/transfers/client/requests/ListTransfersRequest.ts:34 Filter transfers by target account ID. Returns only transfers where the specified account is the target. Cannot be combined with accountId.
targetAddress?
Defined in: _vendor/api/resources/transfers/client/requests/ListTransfersRequest.ts:50 Filter transfers by the on-chain destination address of the target.
targetAsset?
Defined in: _vendor/api/resources/transfers/client/requests/ListTransfersRequest.ts:46 Filter transfers by target asset symbol (e.g., usdc, eth).
targetEmail?
Defined in: _vendor/api/resources/transfers/client/requests/ListTransfersRequest.ts:52 Filter transfers by the email address of the target recipient.
transferId?
Defined in: _vendor/api/resources/transfers/client/requests/ListTransfersRequest.ts:54 Filter to a specific transfer by ID. When provided, returns only the matching transfer and bypasses pagination.
updatedAfter?
Defined in: _vendor/api/resources/transfers/client/requests/ListTransfersRequest.ts:40 Filter transfers to those updated at or after this datetime (inclusive). ISO 8601 format. Useful for incremental sync — poll for transfers that changed state since your last check.
updatedBefore?
Defined in: _vendor/api/resources/transfers/client/requests/ListTransfersRequest.ts:42 Filter transfers to those updated at or before this datetime (inclusive). ISO 8601 format.

ListTransfersResponse

Defined in: _vendor/api/resources/transfers/types/ListTransfersResponse.ts:5

Properties

nextPageToken?
Defined in: _vendor/api/resources/transfers/types/ListTransfersResponse.ts:9 The token for the next page of items, if any.
transfers
Defined in: _vendor/api/resources/transfers/types/ListTransfersResponse.ts:7 The list of transfers.

TransferRequest

Defined in: _vendor/api/resources/transfers/client/requests/TransferRequest.ts:62

Example

Properties

amount
Defined in: _vendor/api/resources/transfers/client/requests/TransferRequest.ts:72 The amount of the transfer, as a decimal string in standard unit denomination of the asset specified by asset (e.g., “100.00” for 100 USD, “0.05” for 0.05 ETH).
amountType?
Defined in: _vendor/api/resources/transfers/client/requests/TransferRequest.ts:81 Specifies whether the given amount is to be received by the target or taken from the source.
  • target: The transfer target receives the exact value specified in amount. Fees are added to the amount taken from the transfer source.
  • source: The transfer target receives the value specified in amount, minus any fees.
asset
Defined in: _vendor/api/resources/transfers/client/requests/TransferRequest.ts:74 The symbol of the asset for the amount. This must be one of the assets of the source or target.
execute
Defined in: _vendor/api/resources/transfers/client/requests/TransferRequest.ts:85 Whether to immediately execute the transfer. If false, the transfer will be created in quoted status and must be executed manually via the /execute endpoint.
idempotencyKey?
Defined in: _vendor/api/resources/transfers/client/requests/TransferRequest.ts:68 An optional string request header for making requests safely retryable. When included, duplicate requests with the same key will return identical responses. Refer to our Idempotency docs for more information on using idempotency keys.
metadata?
Defined in: _vendor/api/resources/transfers/client/requests/TransferRequest.ts:86
source
Defined in: _vendor/api/resources/transfers/client/requests/TransferRequest.ts:69
target
Defined in: _vendor/api/resources/transfers/client/requests/TransferRequest.ts:70
travelRule?
Defined in: _vendor/api/resources/transfers/client/requests/TransferRequest.ts:88 Travel Rule compliance information for this transfer. Required for transfers to external wallets above regulatory thresholds. Fields required differ by region and Coinbase contracting entity.
validateOnly?
Defined in: _vendor/api/resources/transfers/client/requests/TransferRequest.ts:83 If true, validates the transfer without initiating it. If the request is valid, a 2xx will be returned. If the request is invalid, a 4xx error will be returned. The response will include an errorType, for e.g. invalid_target if the specified target cannot receive funds.

Namespaces

Interfaces

DateOfBirth

Defined in: _vendor/api/types/DateOfBirth.ts:6 Date of birth.

Properties

day?
Defined in: _vendor/api/types/DateOfBirth.ts:8 Day of birth (01-31).
month?
Defined in: _vendor/api/types/DateOfBirth.ts:10 Month of birth (01-12).
year?
Defined in: _vendor/api/types/DateOfBirth.ts:12 Year of birth (four digits).

OnchainAddress

Defined in: _vendor/api/types/OnchainAddress.ts:8 The target of the payment is an onchain address.

Properties

address
Defined in: _vendor/api/types/OnchainAddress.ts:17 The onchain crypto address of the recipient. Examples:
  • EVM address: 0xabc1234567890abcdef1234567890abcdef123456
  • Solana address: HpabPRRCFbBKSuJr5PdkVvQc85FyxyTWkFM2obBRSvHT
  • XRP address: rhccc5p23aKiCGFcEqqnjEfLRZ6xEvfy3s
asset
Defined in: _vendor/api/types/OnchainAddress.ts:32 Asset symbol of the payment received by the recipient.
destinationTag?
Defined in: _vendor/api/types/OnchainAddress.ts:30 The destination tag of the onchain address. Destination tags are used by certain networks (primarily XRP/Ripple) to identify specific recipients when multiple users share a single address. The tag ensures funds are credited to the correct account within the shared address. Examples by network:
  • XRP/Ripple: Numeric values like “1234567890” or “123456”
  • Stellar (XLM): Memos which can be text, ID, or hash format
Note: Most networks (Ethereum, Bitcoin, Solana) do not use destination tags.
network
Defined in: _vendor/api/types/OnchainAddress.ts:18

PhysicalAddress

Defined in: _vendor/api/types/PhysicalAddress.ts:6 A physical address with standard address components including street, city, state/province, postal code, and country.

Properties

city?
Defined in: _vendor/api/types/PhysicalAddress.ts:12 City or locality.
countryCode?
Defined in: _vendor/api/types/PhysicalAddress.ts:18 ISO 3166-1 alpha-2 country code (2 characters). See https://en.wikipedia.org/wiki/List_of_ISO_3166_country_codes.
line1?
Defined in: _vendor/api/types/PhysicalAddress.ts:8 Primary street address.
line2?
Defined in: _vendor/api/types/PhysicalAddress.ts:10 Secondary address information.
postCode?
Defined in: _vendor/api/types/PhysicalAddress.ts:16 Postal or ZIP code.
state?
Defined in: _vendor/api/types/PhysicalAddress.ts:14 State, province, or region.

Transfer

Defined in: _vendor/api/types/Transfer.ts:8 A Transfer represents all the information needed to execute a transfer and tracks the lifecycle of a transfer from initiation through completion or failure.

Properties

completedAt?
Defined in: _vendor/api/types/Transfer.ts:28 The date and time the transfer was completed.
createdAt?
Defined in: _vendor/api/types/Transfer.ts:36 The date and time the transfer was created. Required when validateOnly is false.
details?
Defined in: _vendor/api/types/Transfer.ts:40
estimate?
Defined in: _vendor/api/types/Transfer.ts:26
exchangeRate?
Defined in: _vendor/api/types/Transfer.ts:23 Exchange rate information for currency conversion. The rate indicates how much of the target asset is equivalent to one unit of the source asset. May be omitted in the quoted state if the rate cannot be guaranteed; see estimate.exchangeRate for the expected rate. Populated with the actual executed rate once the transfer completes.
executedAt?
Defined in: _vendor/api/types/Transfer.ts:34 The date and time the transfer was executed and moved to processing. Only present when status has progressed beyond quoted.
expiresAt?
Defined in: _vendor/api/types/Transfer.ts:32 The date and time when this transfer will expire if not executed. Only present for quoted status. A new transfer must be created to obtain an updated quote after expiration. Required when validateOnly is false.
failureReason?
Defined in: _vendor/api/types/Transfer.ts:30 The reason for failure, if the transfer failed. Only present when status is failed.
fees?
Defined in: _vendor/api/types/Transfer.ts:25 The fees associated with this transfer. Different transfer types have different fee structures. May be omitted in the quoted state if the fees cannot be guaranteed; see estimate.fees for the expected fees. Populated with the actual fees once the transfer completes.
metadata?
Defined in: _vendor/api/types/Transfer.ts:39
source
Defined in: _vendor/api/types/Transfer.ts:12
sourceAmount?
Defined in: _vendor/api/types/Transfer.ts:15 The amount of the source asset that will be transferred out, as a decimal string in standard unit denomination.
sourceAsset?
Defined in: _vendor/api/types/Transfer.ts:17 The asset symbol of the source amount.
status?
Defined in: _vendor/api/types/Transfer.ts:11
target
Defined in: _vendor/api/types/Transfer.ts:13
targetAmount?
Defined in: _vendor/api/types/Transfer.ts:19 The amount of the target asset received, as a decimal string in standard unit denomination. May be omitted in the quoted state if the value cannot be guaranteed; see estimate.targetAmount for the expected value. Populated with the actual executed amount once the transfer completes.
targetAsset?
Defined in: _vendor/api/types/Transfer.ts:21 The asset symbol of the target amount.
transferId?
Defined in: _vendor/api/types/Transfer.ts:10 The ID of the transfer. Required when validateOnly is false.
updatedAt?
Defined in: _vendor/api/types/Transfer.ts:38 The date and time the transfer was last updated. Required when validateOnly is false.

TransferDetails

Defined in: _vendor/api/types/TransferDetails.ts:8 Additional details about the transfer. For example, if the transfer was sent to a deposit destination, the information about that destination will be included in this field.

Properties

depositDestination?
Defined in: _vendor/api/types/TransferDetails.ts:9
onchainTransactions?
Defined in: _vendor/api/types/TransferDetails.ts:11 The onchain transactions associated with the transfer.
travelRule?
Defined in: _vendor/api/types/TransferDetails.ts:13 Travel rule compliance status for deposit transfers. Present when the transfer requires travel rule information.

TransferEstimate

Defined in: _vendor/api/types/TransferEstimate.ts:12 Captures estimated values for transfers where amounts can’t be guaranteed (e.g., USDC -> EURC). The values in estimate are not modified after a transfer is executed. They are preserved as an immutable record of the original pre-execution snapshot. The actual executed values are populated in the transfer resource post-execution.

Properties

estimatedAt
Defined in: _vendor/api/types/TransferEstimate.ts:22 The date and time when this estimate was captured.
exchangeRate?
Defined in: _vendor/api/types/TransferEstimate.ts:14 The estimated exchange rate at the time this estimate was captured.
fees?
Defined in: _vendor/api/types/TransferEstimate.ts:20 The estimated fees at the time this estimate was captured.
targetAmount?
Defined in: _vendor/api/types/TransferEstimate.ts:16 Estimated amount of the target asset that will be received, as a decimal string in standard unit denomination.
targetAsset?
Defined in: _vendor/api/types/TransferEstimate.ts:18 The asset symbol of the estimated target amount.

TransferExchangeRate

Defined in: _vendor/api/types/TransferExchangeRate.ts:8 Exchange rate information for currency conversion. The rate indicates how much of the target asset is equivalent to one unit of the source asset.

Properties

rate
Defined in: _vendor/api/types/TransferExchangeRate.ts:14 The exchange rate value as a decimal string. Indicates how many units of the target asset equal one unit of the source asset.
sourceAsset
Defined in: _vendor/api/types/TransferExchangeRate.ts:10 The asset being converted from.
targetAsset
Defined in: _vendor/api/types/TransferExchangeRate.ts:12 The asset being converted to.

TransferFee

Defined in: _vendor/api/types/TransferFee.ts:8 A single fee for a transfer.

Properties

amount
Defined in: _vendor/api/types/TransferFee.ts:12 The amount of the fee in units of the asset specified by asset.
asset
Defined in: _vendor/api/types/TransferFee.ts:14 The asset symbol.
type
Defined in: _vendor/api/types/TransferFee.ts:10 The type of the fee, indicating its purpose.

TransfersAccount

Defined in: _vendor/api/types/TransfersAccount.ts:8 The Account specific details for the transfer.

Properties

accountId
Defined in: _vendor/api/types/TransfersAccount.ts:10 The ID of the Account.
asset
Defined in: _vendor/api/types/TransfersAccount.ts:11

TravelRule

Defined in: _vendor/api/types/TravelRule.ts:8 Required Travel Rule fields differ by region. These requirements are determined based on which Coinbase entity the customer has signed the service agreement for.

Properties

beneficiary?
Defined in: _vendor/api/types/TravelRule.ts:38
isIntermediary?
Defined in: _vendor/api/types/TravelRule.ts:36 Indicates whether Coinbase is being used as an intermediary Virtual Asset Service Provider (VASP) to send crypto on behalf of your customer. Background: The Travel Rule (FATF Recommendation 16) requires VASPs to share originator and beneficiary information for virtual asset transfers. When Coinbase acts as an intermediary, additional Travel Rule data must be provided to satisfy compliance requirements. Set to true when:
  • Your organization is a VASP using Coinbase to send crypto on behalf of your end customer
  • In this scenario, Coinbase acts as an intermediary in the transfer chain and handles Travel Rule data exchange with the beneficiary VASP
Set to false (or omit) when:
  • You are transferring funds directly from your own Coinbase account, where Coinbase is your primary VASP rather than an intermediary for another institution
Impact on required fields: When isIntermediary is true, you must provide the originator object with details about the original sender, including:
  • Originator name
  • Originator address
  • Your VASP information (virtualAssetServiceProvider object with name, address, and identifier)
For jurisdictions that require them (such as Coinbase Luxembourg), personalIdentification and dateOfBirth must also reflect the original sender’s identity — not the intermediary’s. These fields will not be auto-populated from any internal KYC data when isIntermediary is true.
isSelf?
Defined in: _vendor/api/types/TravelRule.ts:10 Indicates whether the user attests that the receiving wallet belongs to them.
originator?
Defined in: _vendor/api/types/TravelRule.ts:37

TravelRuleBeneficiary

Defined in: _vendor/api/types/TravelRuleBeneficiary.ts:8 Beneficiary (receiver) party.

Properties

address?
Defined in: _vendor/api/types/TravelRuleBeneficiary.ts:13
financialInstitution?
Defined in: _vendor/api/types/TravelRuleBeneficiary.ts:10 Name of the financial institution.
name?
Defined in: _vendor/api/types/TravelRuleBeneficiary.ts:12 Full name of the party.
walletType?
Defined in: _vendor/api/types/TravelRuleBeneficiary.ts:15 The type of the beneficiary’s wallet.

TravelRuleOriginator

Defined in: _vendor/api/types/TravelRuleOriginator.ts:8 Originator (sender) party.

Properties

address?
Defined in: _vendor/api/types/TravelRuleOriginator.ts:13
dateOfBirth?
Defined in: _vendor/api/types/TravelRuleOriginator.ts:19 Date of birth of the originator. Required by certain jurisdictions (such as Coinbase Luxembourg) to satisfy Travel Rule reporting obligations.
financialInstitution?
Defined in: _vendor/api/types/TravelRuleOriginator.ts:10 Name of the financial institution.
name?
Defined in: _vendor/api/types/TravelRuleOriginator.ts:12 Full name of the party.
personalId?
Defined in: _vendor/api/types/TravelRuleOriginator.ts:17 Personal identifier for travel rule compliance. For individuals: passport number, national ID, or driver’s license. For institutions: LEI (Legal Entity Identifier).
virtualAssetServiceProvider?
Defined in: _vendor/api/types/TravelRuleOriginator.ts:15 Information about the originating Virtual Asset Service Provider (VASP) that handles cryptocurrency or other virtual assets on behalf of customers.

Type Aliases

Variables