Transfer funds between portfolios

Transfer assets from one portfolio to another.

POST /api/v1/portfolios/transfer

Transfer funds between portfolios

cURL

curl --request POST \
  --url https://api.international.coinbase.com/api/v1/portfolios/transfer \
  --header 'CB-ACCESS-KEY: <api-key>' \
  --header 'CB-ACCESS-PASSPHRASE: <api-key>' \
  --header 'CB-ACCESS-SIGN: <api-key>' \
  --header 'CB-ACCESS-TIMESTAMP: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "from": "<string>",
  "to": "<string>",
  "asset": "<string>",
  "amount": "<string>"
}
'

200

{
  "success": true
}

API Key Permissions

This endpoint requires an API key with transfer permission.

Java

PortfoliosService portfoliosService = IntxServiceFactory.createPortfoliosService(client);
TransferFundsRequest request = new TransferFundsRequest.Builder()
    .from("portfolio_id_1")
    .to("portfolio_id_2")
    .asset("BTC")
    .amount("1")
    .build();
TransferFundsResponse response = portfoliosService.transferFunds(request);

For more information, please visit the INTX Java SDK.

.NET

var portfoliosService = new PortfoliosService(client);
var request = new TransferFundsRequest(
    From: "portfolio_id_1",
    To: "portfolio_id_2",
    Asset: "BTC",
    Amount: "1",
);
var response = portfoliosService.TransferFunds(request);

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

Go

ordersSvc := orders.NewOrdersService(client)
request := &portfolios.CreatePortfolioTransferRequest{
    From: "portfolio_id_1",
    To: "portfolio_id_2",
    Asset: "BTC",
    Amount: "1",
}
response, err := portfoliosSvc.CreatePortfolioTransfer(context.Background(), request)

For more information, please visit the INTX Go SDK.

Python

client = IntxClient()
request = TransferFundsRequest(
    from="portfolio_id_1",
    to="portfolio_id_2",
    asset="BTC",
    amount="1",
)
response = client.transfer_funds(request)

For more information, please visit the INTX Python SDK.

TS/JS

const portfoliosService = new PortfoliosService(client);

portfoliosService.createTransferFunds({
    from: 'portfolio_id_1',
    to: 'portfolio_id_2',
    asset: 'ETH',
    amount: '1',
}).then(async (response) => {
    console.log('Transfer Created: ', response);
})

For more information, please visit the INTX TS SDK.

CLI

intxctl create-portfolio-transfer --help

For more information, please visit the INTX CLI.

Authorizations

CB-ACCESS-KEY · string · header · required

The Client ID that owns the API Key for the request

CB-ACCESS-PASSPHRASE · string · header · required

The pass phrase affiliated with the API Key

CB-ACCESS-SIGN · string · header · required

A HMAC SHA-256 signature using the API Key secret on the string TIMESTAMP, METHOD, REQUEST_PATH, BODY

CB-ACCESS-TIMESTAMP · string · header · required

The timestamp of when the request is being made

Body

application/json

from · string · required

Identifies the portfolio by UUID (e.g., 892e8c7c-e979-4cad-b61b-55a197932cf1) or portfolio ID (e.g., 5189861793641175) to transfer funds from

to · string · required

Identifies the portfolio by UUID (e.g., 892e8c7c-e979-4cad-b61b-55a197932cf1) or portfolio ID (e.g., 5189861793641175) to transfer funds to

asset · string · required

Identifies the asset by name (e.g., BTC), UUID (e.g., 291efb0f-2396-4d41-ad03-db3b2311cb2c), or asset ID (e.g., 1482439423963469)

amount · string · required

The amount of the asset being transferred

Response

200

application/json

Transfer processed

success · boolean

true if the transfer was successful

Example:

true