Mint

Overview

Orchestrations enable you to automatically convert USD into stablecoins. This powerful feature enables seamless fiat-to-crypto conversions through rule-based orchestrations that trigger upon receiving bank transfers. You can also mint straight from profile USD funds by issuing an ad-hoc conversion.

Mint Flow Options

The following diagram shows two example mint flows:

Creating Mint Orchestration Rules

Use the Create Orchestration Rule endpoint to set up the rule-based minting:

Example 1: USD → USDC (Bank to Profile)

Create a rule that automatically converts USD deposits to USDC and stores in your profile:

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": "mint_usd_to_usdc_profile",
    "nickname": "Auto Mint USDC to Profile",
    "profile_id": "{profile_id}",
    "source_asset": "USD",
    "destination_asset": "USDC",
    "source": {
      "fiat": {
        "network": "WIRE",
        "account_type": "SWIFT"
      }
    },
    "destination": {
      "profile": {
        "profile_id": "{profile_id}"
      }
    }
  }'

Show Response

{
  "rule": {
    "id": "rule_abc123",
    "ref_id": "mint_usd_to_usdc_profile",
    "nickname": "Auto Mint USDC to Profile",
    "profile_id": "{profile_id}",
    "source_asset": "USD",
    "destination_asset": "USDC",
    "source": {
      "fiat": {
        "deposit_instructions_id": "fiat_instr_123",
        "network": "WIRE",
        "account_type": "SWIFT",
        "memo_id": "PAXOS123456"
      }
    },
    "destination": {
      "profile": {
        "profile_id": "{profile_id}"
      }
    },
    "status": "ACTIVE",
    "created_at": "2024-01-15T10:00:00Z"
  }
}

Example 2: USD → USDG (Bank to External Crypto Address)

Create a rule that automatically converts USD deposits to USDG and sends 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": "mint_usd_to_usdg_external",
    "nickname": "Auto Mint USDG to External",
    "profile_id": "{profile_id}",
    "source_asset": "USD",
    "destination_asset": "USDG",
    "source": {
      "fiat": {
        "network": "WIRE",
        "account_type": "SWIFT"
      }
    },
    "destination": {
      "crypto": {
        "crypto_address_id": "crypto_addr_789xyz"
      }
    }
  }'

Show Response

{
  "rule": {
    "id": "rule_xyz789",
    "ref_id": "mint_usd_to_usdg_external",
    "nickname": "Auto Mint USDG to External",
    "profile_id": "{profile_id}",
    "source_asset": "USD",
    "destination_asset": "USDG",
    "source": {
      "fiat": {
        "deposit_instructions_id": "fiat_instr_456",
        "network": "WIRE",
        "account_type": "SWIFT",
        "memo_id": "PAXOS789012"
      }
    },
    "destination": {
      "crypto": {
        "crypto_address_id": "crypto_addr_789xyz"
      }
    },
    "status": "ACTIVE",
    "created_at": "2024-01-15T10:00:00Z"
  }
}

How It Works

Create the Rule: Use the API to create an orchestration rule specifying source (bank deposit) and destination (profile or external address)
Get Deposit Instructions: Use the deposit_instructions_id and memo_id from the response to retrieve full banking details via Get Fiat Deposit Instructions
Send Wire Transfer: Send USD to the Paxos bank account using the provided instructions and memo ID
- For sandbox testing, see how to simulate fiat deposits
Automatic Trigger: The rule detects the deposit and initiates the orchestration
Conversion: USD is converted to your specified stablecoin (USDC, USDG, etc.)
Delivery: Stablecoins are either:
- Deposited to your Paxos profile (Flow 1)
- Sent to the external crypto address (Flow 2)
Monitor Status: Track your orchestration progress using webhooks or API polling

Next Steps

Learn about redeeming stablecoins back to USD
Explore conversions between different stablecoins

Get Started

Identity

Stablecoin Orchestration

Stablecoin Operations

Fiat Transfers

Stablecoin Payments

Settlements

Crypto Brokerage

Webhooks

Additional Guides

Versioning

Overview

Mint Flow Options

Creating Mint Orchestration Rules

Example 1: USD → USDC (Bank to Profile)

Example 2: USD → USDG (Bank to External Crypto Address)

How It Works

Next Steps

Get Started

Identity

Stablecoin Orchestration

Stablecoin Operations

Fiat Transfers

Stablecoin Payments

Settlements

Crypto Brokerage

Webhooks

Additional Guides

Versioning

​Overview

​Mint Flow Options

​Creating Mint Orchestration Rules

​Example 1: USD → USDC (Bank to Profile)

​Example 2: USD → USDG (Bank to External Crypto Address)

​How It Works

​Next Steps

Overview

Mint Flow Options

Creating Mint Orchestration Rules

Example 1: USD → USDC (Bank to Profile)

Example 2: USD → USDG (Bank to External Crypto Address)

How It Works

Next Steps