Convert

Overview

Orchestrations enable seamless conversions between different stablecoins and currencies. These can be triggered through ad-hoc orchestrations from profiles or rule-based orchestrations from external deposits, and then routed to any supported destination.

Conversion Flow Options

Creating Conversions

Example 1: PYUSD → USDG (Ad-hoc, Profile to Profile)

Use the Create Orchestration endpoint to convert PYUSD to USDG between Paxos profiles:

Show Request

curl -X POST 'https://api.paxos.com/v2/orchestration/orchestrations' \
  -H 'Authorization: Bearer {access_token}' \
  -H 'Content-Type: application/json' \
  -d '{
    "ref_id": "convert_pyusd_usdg_profile",
    "profile_id": "{profile_id}",
    "source_asset": "PYUSD",
    "source_amount": "100",
    "destination_asset": "USDG",
    "source": {
      "profile": {
        "profile_id": "{profile_id}"
      }
    },
    "destination": {
      "profile": {
        "profile_id": "{profile_id}"
      }
    }
  }'

Show Response

{
  "orchestration": {
    "id": "orch_123abc",
    "ref_id": "convert_pyusd_usdg_profile",
    "profile_id": "{profile_id}",
    "source_asset": "PYUSD",
    "source_amount": "100",
    "destination_asset": "USDG",
    "destination_amount": "100",
    "source": {
      "profile": {
        "profile_id": "{profile_id}"
      }
    },
    "destination": {
      "profile": {
        "profile_id": "{profile_id}"
      }
    },
    "status": "PROCESSING",
    "created_at": "2024-01-15T10:00:00Z"
  }
}

Example 2: USDG → USDC (Rule-based, External to External)

Use the Create Orchestration Rule endpoint to automatically convert external USDG deposits to USDC and send to an external address. First register the destination address to get a crypto_address_id:

Show Request

curl -X POST 'https://api.paxos.com/v2/orchestration/rules' \
  -H 'Authorization: Bearer {access_token}' \
  -H 'Content-Type: application/json' \
  -d '{
    "ref_id": "convert_usdg_usdc_rule",
    "nickname": "Auto Convert USDG to USDC",
    "profile_id": "{profile_id}",
    "source_asset": "USDG",
    "destination_asset": "USDC",
    "source": {
      "crypto": {
        "network": "ETHEREUM"
      }
    },
    "destination": {
      "crypto": {
        "crypto_address_id": "crypto_addr_456def"
      }
    }
  }'

Show Response

{
  "rule": {
    "id": "rule_456def",
    "ref_id": "convert_usdg_usdc_rule",
    "nickname": "Auto Convert USDG to USDC",
    "profile_id": "{profile_id}",
    "source_asset": "USDG",
    "destination_asset": "USDC",
    "source": {
      "crypto": {
        "address_id": "addr_789xyz",
        "address": "0x8B3D70c8F55e9C7E5b0bC2A9b0e7d1fF2c3d4E5F",
        "network": "ETHEREUM"
      }
    },
    "destination": {
      "crypto": {
        "crypto_address_id": "crypto_addr_456def"
      }
    },
    "status": "ACTIVE",
    "created_at": "2024-01-15T10:00:00Z"
  }
}

How It Works

Ad-hoc Conversions

Call the API: Create an orchestration specifying source and destination assets
Validation: Paxos validates the request and available balance
Conversion: Assets are converted
Delivery: Converted assets are deposited to the specified profile
Monitor Status: Track your orchestration progress using webhooks or API polling

Rule-based Conversions

Create the Rule: Set up an orchestration rule for automatic conversion
Get Deposit Address: Use the address returned in the rule’s source.crypto.address field
Receive Deposit: External USDG arrives at your Paxos crypto address
Automatic Trigger: The rule detects the deposit and initiates conversion
Conversion: USDG is converted to USDC
Delivery: USDC is sent to the specified external address
Monitor Status: Track your orchestration progress using webhooks or API polling

Next Steps

Learn about minting stablecoins from USD deposits
Explore redeeming stablecoins back to USD

Get Started

Identity

Stablecoin Orchestration

Stablecoin Operations

Fiat Transfers

Stablecoin Payments

Settlements

Crypto Brokerage

Webhooks

Additional Guides

Versioning

Overview

Conversion Flow Options

Creating Conversions

Example 1: PYUSD → USDG (Ad-hoc, Profile to Profile)

Example 2: USDG → USDC (Rule-based, External to External)

How It Works

Ad-hoc Conversions

Rule-based Conversions

Next Steps

Get Started

Identity

Stablecoin Orchestration

Stablecoin Operations

Fiat Transfers

Stablecoin Payments

Settlements

Crypto Brokerage

Webhooks

Additional Guides

Versioning

​Overview

​Conversion Flow Options

​Creating Conversions

​Example 1: PYUSD → USDG (Ad-hoc, Profile to Profile)

​Example 2: USDG → USDC (Rule-based, External to External)

​How It Works

​Ad-hoc Conversions

​Rule-based Conversions

​Next Steps

Overview

Conversion Flow Options

Creating Conversions

Example 1: PYUSD → USDG (Ad-hoc, Profile to Profile)

Example 2: USDG → USDC (Rule-based, External to External)

How It Works

Ad-hoc Conversions

Rule-based Conversions

Next Steps