Create Conversion

POST

portfolios

{portfolio_id}

wallets

{wallet_id}

conversion

curl --request POST \
  --url https://api.prime.coinbase.com/v1/portfolios/{portfolio_id}/wallets/{wallet_id}/conversion \
  --header 'Content-Type: application/json' \
  --data '{
  "amount": "50.50",
  "destination": "e84255eb-2e21-439e-a1d0-f5dd1e1292b9",
  "idempotency_key": "e84255eb-2e21-439e-a1d0-f5dd1e1292b9",
  "source_symbol": "USD",
  "destination_symbol": "USDC"
}'

{
  "activity_id": "e84255eb-2e21-439e-a1d0-f5dd1e1292b9",
  "source_symbol": "USD",
  "destination_symbol": "USDC",
  "amount": "50.50",
  "destination": "e84255eb-2e21-439e-a1d0-f5dd1e1292b9",
  "source": "e84255eb-2e21-439e-a1d0-f5dd1e1292b9",
  "transaction_id": "e84255eb-2e21-439e-a1d0-f5dd1e1292b9"
}

Supported Swaps

This endpoint supports the following conversions: USD <> USDC and USD <> PYUSD.

For more assistance on how to create and track conversions, visit the stablecoins concepts page.

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);

CreateConversionRequest request = new CreateConversionRequest.Builder()
    .portfolioId("PORTFOLIO_ID_HERE")
    .walletId("WALLET_ID_HERE")
    .amount("1")
    .destination("DESTINATION_WALLET_UUID")
    .idempotencyKey(UUID.randomUUID().toString())
    .sourceSymbol("USD")
    .destinationSymbol("USDC")
    .build();

CreateConversionResponse response = transactionsService.createConversion(request);

For more information, please visit the Prime Java SDK.

TransactionsService transactionsService = PrimeServiceFactory.createTransactionsService(client);

CreateConversionRequest request = new CreateConversionRequest.Builder()
    .portfolioId("PORTFOLIO_ID_HERE")
    .walletId("WALLET_ID_HERE")
    .amount("1")
    .destination("DESTINATION_WALLET_UUID")
    .idempotencyKey(UUID.randomUUID().toString())
    .sourceSymbol("USD")
    .destinationSymbol("USDC")
    .build();

CreateConversionResponse response = transactionsService.createConversion(request);

For more information, please visit the Prime Java SDK.

var transactionsService = new TransactionsService(client);

var request = new CreateConversionRequest("PORTFOLIO_ID_HERE", "WALLET_ID_HERE")
{
    Amount = "1",
    Destination = "DESTINATION_WALLET_UUID",
    IdempotencyKey = Guid.NewGuid().ToString(),
    SourceSymbol = "USD",
    DestinationSymbol = "USDC",
};

var response = transactionsService.CreateConversion(request);

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

transactionsService := transactions.NewTransactionsService(client)

request := &transactions.CreateConversionRequest{
    PortfolioId: "PORTFOLIO_ID_HERE",
    WalletId: "WALLET_ID_HERE",
    Amount: "1",
    Destination: "DESTINATION_WALLET_UUID",
    IdempotencyKey: uuid.New().String(),
    SourceSymbol: "USD",
    DestinationSymbol: "USDC",
}

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

For more information, please visit the Prime Go SDK.

prime_client = PrimeClient(credentials)

request = CreateConversionRequest(
    portfolio_id="PORTFOLIO_ID_HERE",
    wallet_id="WALLET_ID_HERE",
    amount = '1',
    destination = 'DESTINATION_WALLET_UUID',
    idempotency_key = str(uuid.uuid4()),
    source_symbol = 'USD',
    destination_symbol = 'USDC',
)

response = prime_client.create_conversion(request)

For more information, please visit the Prime Python SDK.

primectl create-conversion --help

For more information, please visit the Prime CLI.

const transactionsService = new TransactionsService(client);

transactionsService.createConversion({
    portfolioId: 'PORTFOLIO_ID_HERE',
    walletId: 'WALLET_ID_HERE',
    amount: "1",
    destination: "DESTINATION_WALLET_UUID",
    idempotencyKey: uuidv4(),
    sourceSymbol: "USD",
    destinationSymbol: "USDC",

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

For more information, please visit the Prime TS SDK.

Path Parameters

portfolio_id

string

required

The ID of the portfolio

wallet_id

string

required

The wallet ID that the conversion will originate from

Body

application/json

Response

200

application/json

A successful response.

The response is of type object.

Request to unstake a wallet

Create Onchain Transaction

curl --request POST \
  --url https://api.prime.coinbase.com/v1/portfolios/{portfolio_id}/wallets/{wallet_id}/conversion \
  --header 'Content-Type: application/json' \
  --data '{
  "amount": "50.50",
  "destination": "e84255eb-2e21-439e-a1d0-f5dd1e1292b9",
  "idempotency_key": "e84255eb-2e21-439e-a1d0-f5dd1e1292b9",
  "source_symbol": "USD",
  "destination_symbol": "USDC"
}'

{
  "activity_id": "e84255eb-2e21-439e-a1d0-f5dd1e1292b9",
  "source_symbol": "USD",
  "destination_symbol": "USDC",
  "amount": "50.50",
  "destination": "e84255eb-2e21-439e-a1d0-f5dd1e1292b9",
  "source": "e84255eb-2e21-439e-a1d0-f5dd1e1292b9",
  "transaction_id": "e84255eb-2e21-439e-a1d0-f5dd1e1292b9"
}

REST API

FIX API

Websocket Feed

Create Conversion

Path Parameters

Body

Response