Create Orchestration Rule

Creates a persistent orchestration rule that automatically triggers orchestrations when matching deposits are received.

The rule will:

1. Generate deposit instructions associated with the rule.
2. Continuously monitor incoming deposits to those instructions.
3. Automatically execute orchestrations to the specified destination.

Supported Sources:

• Crypto deposit
• Fiat deposit

Supported Destinations:

• Crypto address on a supported network
• Bank account
• Profile ID

Error conditions:

• Already Exists: Returned if a rule with the same ref_id already exists.

POST /orchestration/rules

Create Orchestration Rule

cURL

curl --request POST \
  --url https://api.paxos.com/v2/orchestration/rules \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "ref_id": "my-rule-001",
  "nickname": "USDC to USDG conversion",
  "profile_id": "e8ea8b1c-4e8d-4c59-9e7a-c985194ba2e8",
  "source_asset": "USDC",
  "destination_asset": "USDG",
  "source": {
    "crypto": {
      "network": "ETHEREUM"
    }
  },
  "destination": {
    "profile": {
      "profile_id": "e8ea8b1c-4e8d-4c59-9e7a-c985194ba2e8"
    }
  }
}
'

200

{
  "rule": {
    "id": "<string>",
    "ref_id": "<string>",
    "nickname": "<string>",
    "profile_id": "<string>",
    "identity_id": "<string>",
    "account_id": "<string>",
    "source_asset": "<string>",
    "destination_asset": "<string>",
    "source": {
      "crypto": {
        "address_id": "<string>",
        "address": "<string>",
        "network": "<string>"
      },
      "fiat": {
        "deposit_instructions_id": "<string>",
        "network": "<string>",
        "account_type": "<string>",
        "memo_id": "<string>"
      },
      "profile": {
        "profile_id": "<string>"
      }
    },
    "destination": {
      "crypto": {
        "address": "<string>",
        "network": "<string>"
      },
      "fiat": {
        "fiat_account_id": "<string>",
        "memo": "<string>"
      },
      "profile": {
        "profile_id": "<string>"
      }
    },
    "created_at": "2023-11-07T05:31:56Z"
  }
}

OAuth Scope

orchestration:write_orchestration_rule

Authorizations

Authorization · string · header · required

Paxos APIs use OAuth 2 with the client credentials grant flow.

Token URLs:

• Production: https://oauth.paxos.com/oauth2/token
• Sandbox: https://oauth.sandbox.paxos.com/oauth2/token

Learn more in the API credentials guide →

Body

application/json

ref_id · string · required

Client-provided unique reference ID for the rule.

profile_id · string · required

Profile ID of the account owner.

source_asset · string · required

Asset being converted from.

Valid values: USDG, PYUSD, USDP, USDC, USD

destination_asset · string · required

Asset being converted to.

Valid values: USDG, PYUSD, USDP, USDC, USD

source · object · required

Show child attributes

nickname · string

Optional human-readable nickname for the rule.

identity_id · string

Identity ID of the account owner.

account_id · string

Account ID where the rule applies.

destination · object

Show child attributes

Response

200 - application/json

A successful response.

rule · object

Show child attributes