Create Conversion

Create 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"
}
'

import requests

url = "https://api.prime.coinbase.com/v1/portfolios/{portfolio_id}/wallets/{wallet_id}/conversion"

payload = {
    "amount": "50.50",
    "destination": "e84255eb-2e21-439e-a1d0-f5dd1e1292b9",
    "idempotency_key": "e84255eb-2e21-439e-a1d0-f5dd1e1292b9",
    "source_symbol": "USD",
    "destination_symbol": "USDC"
}
headers = {"Content-Type": "application/json"}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'Content-Type': 'application/json'},
  body: JSON.stringify({
    amount: '50.50',
    destination: 'e84255eb-2e21-439e-a1d0-f5dd1e1292b9',
    idempotency_key: 'e84255eb-2e21-439e-a1d0-f5dd1e1292b9',
    source_symbol: 'USD',
    destination_symbol: 'USDC'
  })
};

fetch('https://api.prime.coinbase.com/v1/portfolios/{portfolio_id}/wallets/{wallet_id}/conversion', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.prime.coinbase.com/v1/portfolios/{portfolio_id}/wallets/{wallet_id}/conversion",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'amount' => '50.50',
    'destination' => 'e84255eb-2e21-439e-a1d0-f5dd1e1292b9',
    'idempotency_key' => 'e84255eb-2e21-439e-a1d0-f5dd1e1292b9',
    'source_symbol' => 'USD',
    'destination_symbol' => 'USDC'
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.prime.coinbase.com/v1/portfolios/{portfolio_id}/wallets/{wallet_id}/conversion"

	payload := strings.NewReader("{\n  \"amount\": \"50.50\",\n  \"destination\": \"e84255eb-2e21-439e-a1d0-f5dd1e1292b9\",\n  \"idempotency_key\": \"e84255eb-2e21-439e-a1d0-f5dd1e1292b9\",\n  \"source_symbol\": \"USD\",\n  \"destination_symbol\": \"USDC\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.prime.coinbase.com/v1/portfolios/{portfolio_id}/wallets/{wallet_id}/conversion")
  .header("Content-Type", "application/json")
  .body("{\n  \"amount\": \"50.50\",\n  \"destination\": \"e84255eb-2e21-439e-a1d0-f5dd1e1292b9\",\n  \"idempotency_key\": \"e84255eb-2e21-439e-a1d0-f5dd1e1292b9\",\n  \"source_symbol\": \"USD\",\n  \"destination_symbol\": \"USDC\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.prime.coinbase.com/v1/portfolios/{portfolio_id}/wallets/{wallet_id}/conversion")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n  \"amount\": \"50.50\",\n  \"destination\": \"e84255eb-2e21-439e-a1d0-f5dd1e1292b9\",\n  \"idempotency_key\": \"e84255eb-2e21-439e-a1d0-f5dd1e1292b9\",\n  \"source_symbol\": \"USD\",\n  \"destination_symbol\": \"USDC\"\n}"

response = http.request(request)
puts response.read_body

{
  "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"
}

POST

portfolios

{portfolio_id}

wallets

{wallet_id}

conversion

Create 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"
}
'

import requests

url = "https://api.prime.coinbase.com/v1/portfolios/{portfolio_id}/wallets/{wallet_id}/conversion"

payload = {
    "amount": "50.50",
    "destination": "e84255eb-2e21-439e-a1d0-f5dd1e1292b9",
    "idempotency_key": "e84255eb-2e21-439e-a1d0-f5dd1e1292b9",
    "source_symbol": "USD",
    "destination_symbol": "USDC"
}
headers = {"Content-Type": "application/json"}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'Content-Type': 'application/json'},
  body: JSON.stringify({
    amount: '50.50',
    destination: 'e84255eb-2e21-439e-a1d0-f5dd1e1292b9',
    idempotency_key: 'e84255eb-2e21-439e-a1d0-f5dd1e1292b9',
    source_symbol: 'USD',
    destination_symbol: 'USDC'
  })
};

fetch('https://api.prime.coinbase.com/v1/portfolios/{portfolio_id}/wallets/{wallet_id}/conversion', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.prime.coinbase.com/v1/portfolios/{portfolio_id}/wallets/{wallet_id}/conversion",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'amount' => '50.50',
    'destination' => 'e84255eb-2e21-439e-a1d0-f5dd1e1292b9',
    'idempotency_key' => 'e84255eb-2e21-439e-a1d0-f5dd1e1292b9',
    'source_symbol' => 'USD',
    'destination_symbol' => 'USDC'
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.prime.coinbase.com/v1/portfolios/{portfolio_id}/wallets/{wallet_id}/conversion"

	payload := strings.NewReader("{\n  \"amount\": \"50.50\",\n  \"destination\": \"e84255eb-2e21-439e-a1d0-f5dd1e1292b9\",\n  \"idempotency_key\": \"e84255eb-2e21-439e-a1d0-f5dd1e1292b9\",\n  \"source_symbol\": \"USD\",\n  \"destination_symbol\": \"USDC\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.prime.coinbase.com/v1/portfolios/{portfolio_id}/wallets/{wallet_id}/conversion")
  .header("Content-Type", "application/json")
  .body("{\n  \"amount\": \"50.50\",\n  \"destination\": \"e84255eb-2e21-439e-a1d0-f5dd1e1292b9\",\n  \"idempotency_key\": \"e84255eb-2e21-439e-a1d0-f5dd1e1292b9\",\n  \"source_symbol\": \"USD\",\n  \"destination_symbol\": \"USDC\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.prime.coinbase.com/v1/portfolios/{portfolio_id}/wallets/{wallet_id}/conversion")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n  \"amount\": \"50.50\",\n  \"destination\": \"e84255eb-2e21-439e-a1d0-f5dd1e1292b9\",\n  \"idempotency_key\": \"e84255eb-2e21-439e-a1d0-f5dd1e1292b9\",\n  \"source_symbol\": \"USD\",\n  \"destination_symbol\": \"USDC\"\n}"

response = http.request(request)
puts response.read_body

{
  "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 SwapsThis 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.

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

amount

string

required

The amount in whole units to convert

Example:

"50.50"

destination

string

required

The UUID of the destination wallet

Example:

"e84255eb-2e21-439e-a1d0-f5dd1e1292b9"

idempotency_key

string

required

The idempotency key associated with this conversion

Example:

"e84255eb-2e21-439e-a1d0-f5dd1e1292b9"

source_symbol

string

required

The currency symbol to convert from

Example:

"USD"

destination_symbol

string

required

The currency symbol to convert to

Example:

"USDC"

Response

200 - application/json

A successful response.

activity_id

string

The activity ID for the conversion

Example:

"e84255eb-2e21-439e-a1d0-f5dd1e1292b9"

source_symbol

string

The currency symbol to convert from

Example:

"USD"

destination_symbol

string

The currency symbol to convert to

Example:

"USDC"

amount

string

The amount in whole units to convert

Example:

"50.50"

destination

string

The UUID of the destination wallet

Example:

"e84255eb-2e21-439e-a1d0-f5dd1e1292b9"

source

string

The UUID of the source wallet

Example:

"e84255eb-2e21-439e-a1d0-f5dd1e1292b9"

transaction_id

string

The UUID of the conversion transaction

Example:

"e84255eb-2e21-439e-a1d0-f5dd1e1292b9"

⌘I

REST API

Websocket Feed

FIX 4.2 API

FIX 5.0 API

Path Parameters

Body

Response