Create Transfer - Coinbase Developer Documentation

Create Transfer

curl --request POST \
  --url https://api.prime.coinbase.com/v1/portfolios/{portfolio_id}/wallets/{wallet_id}/transfers \
  --header 'Content-Type: application/json' \
  --data '
{
  "amount": "<string>",
  "destination": "<string>",
  "idempotency_key": "<string>",
  "currency_symbol": "<string>"
}
'

{
  "activity_id": "<string>",
  "approval_url": "<string>",
  "symbol": "<string>",
  "amount": "<string>",
  "fee": "<string>",
  "destination_address": "<string>",
  "destination_type": "<string>",
  "source_address": "<string>",
  "source_type": "<string>",
  "transaction_id": "<string>"
}

POST

portfolios

{portfolio_id}

wallets

{wallet_id}

transfers

Create Transfer

curl --request POST \
  --url https://api.prime.coinbase.com/v1/portfolios/{portfolio_id}/wallets/{wallet_id}/transfers \
  --header 'Content-Type: application/json' \
  --data '
{
  "amount": "<string>",
  "destination": "<string>",
  "idempotency_key": "<string>",
  "currency_symbol": "<string>"
}
'

{
  "activity_id": "<string>",
  "approval_url": "<string>",
  "symbol": "<string>",
  "amount": "<string>",
  "fee": "<string>",
  "destination_address": "<string>",
  "destination_type": "<string>",
  "source_address": "<string>",
  "source_type": "<string>",
  "transaction_id": "<string>"
}

Use the Prime SDK or CLI to test this endpoint by following the quickstart guide and running with the following examples

TransactionsService transactionsService = PrimeServiceFactory.createTransactionsService(client);

CreateTransferRequest request = new CreateTransferRequest.Builder()
    .portfolioId("PORTFOLIO_ID_HERE")
    .walletId("WALLET_ID_HERE")
    .amount("0.001")
    .destination("DESTINATION_WALLET_UUID")
    .idempotencyKey(UUID.randomUUID().toString())
    .currencySymbol("ETH")
    .build();

CreateTransferResponse response = transactionsService.createTransfer(request);

For more information, please visit the Prime Java SDK.

var transactionsService = new TransactionsService(client);

var request = new CreateTransferRequest("PORTFOLIO_ID_HERE", "WALLET_ID_HERE")
{
    Amount = "0.001",
    Destination = "DESTINATION_WALLET_UUID",
    IdempotencyKey = Guid.NewGuid().ToString(),
    CurrencySymbol = "ETH",
};

var response = transactionsService.CreateTransfer(request);

For more information, please visit the Prime .NET SDK.

transactionsService := transactions.NewTransactionsService(client)

request := &transactions.CreateWalletTransferRequest{
    PortfolioId: "PORTFOLIO_ID_HERE",
    WalletId: "WALLET_ID_HERE",
    Amount: "0.001",
    Destination: "DESTINATION_WALLET_UUID",
    IdempotencyKey: uuid.New().String(),
    CurrencySymbol: "ETH",
}

response, err := transactionsService.CreateWalletTransfer(context.Background(), request)

For more information, please visit the Prime Go SDK.

prime_client = PrimeClient(credentials)

request = CreateTransferRequest(
    portfolio_id="PORTFOLIO_ID_HERE",
    wallet_id="WALLET_ID_HERE",
    amount = '0.001',
    destination = 'DESTINATION_WALLET_UUID',
    idempotency_key = str(uuid.uuid4()),
    currency_symbol = 'ETH',
)

response = prime_client.create_transfer(request)

For more information, please visit the Prime Python SDK.

primectl create-transfer --help

For more information, please visit the Prime CLI.

const transactionsService = new TransactionsService(client);

transactionsService.createTransfer({
    portfolioId: 'PORTFOLIO_ID_HERE',
    walletId: 'WALLET_ID_HERE',
    amount: "0.001",
    destination: "DESTINATION_WALLET_UUID",
    idempotencyKey: uuidv4(),
    currencySymbol: "ETH",

}).then(async (response) => {
    console.log('Transfer: ', response);
})

For more information, please visit the Prime TS SDK.

Path Parameters

portfolio_id

string

required

The portfolio ID

wallet_id

string

required

The wallet ID that the transfer will originate from

Body

application/json

amount

string

required

The amount in whole units to send

destination

string

required

The UUID of the destination wallet

idempotency_key

string

required

The idempotency key associated with this transfer

currency_symbol

string

required

The currency symbol to transfer

Response

200 - application/json

A successful response.

activity_id

string

The activity ID for the transfer

approval_url

string

A URL to the activity associated with this transfer for approval

symbol

string

The currency symbol of the transfer

amount

string

The amount of the transfer

fee

string

The network fee associated with the transfer

destination_address

string

The destination address of the transfer

destination_type

string

The destination type of the transfer

source_address

string

The source address used for the transfer

source_type

string

The source type used for the transfer

transaction_id

string

The id of the just created transaction

Create Onchain Transaction

Create Withdrawal

⌘I