Create Crypto Withdrawal

Withdraw a cryptocurrency asset to a specified destination address.

Important for Stellar Network (PYUSD):

When withdrawing PYUSD on the Stellar network, the destination address must have an established trustline with the PYUSD issuer:

• PYUSD Issuer: GDQE7IXJ4HUHV6RQHIUPRJSEZE4DRS5WY577O2FY6YQ5LVWZ7JZTU2V5 (mainnet)
• Asset Code: PYUSD

How to Establish a Trustline:

The recipient must use a Stellar wallet or the Stellar SDK to:

1. Ensure their account has minimum XLM balance (at least 1 XLM recommended)
2. Create a trustline to the PYUSD issuer for the PYUSD asset
3. Confirm the trustline is active before requesting withdrawal

Verifying Trustline Status:

You can verify if an address has the required trustline by:

• Using Stellar blockchain explorers (e.g., stellar.expert)
• Querying the Stellar Horizon API
• Using the Stellar SDK to check account balances

POST /transfer/crypto-withdrawals

Create Crypto Withdrawal

cURL

curl --request POST \
  --url https://api.paxos.com/v2/transfer/crypto-withdrawals \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "profile_id": "<string>",
  "destination_address": "<string>",
  "asset": "<string>",
  "ref_id": "<string>",
  "identity_id": "<string>",
  "account_id": "<string>",
  "balance_asset": "<string>",
  "amount": "<string>",
  "total": "<string>",
  "fee_id": "<string>",
  "memo": "<string>",
  "metadata": {},
  "beneficiary": {
    "self": true
  }
}
'

200

{
  "id": "<string>",
  "status": "<string>"
}

OAuth Scope

transfer:write_crypto_withdrawal

Authorizations

Authorization · string · header · required

The access token received from the authorization server in the OAuth 2.0 flow.

Body

application/json

profile_id · string · required

destination_address · string · required

crypto_network · enum<string> · required

A CryptoNetwork is a blockchain transmitting cryptocurrencies.

Available options: BITCOIN, ETHEREUM, BITCOIN_CASH, LITECOIN, SOLANA, POLYGON_POS, BASE, ARBITRUM_ONE, STELLAR, INK, XLAYER

asset · string · required

ref_id · string

Client-specified idempotency ID. Retries must reuse the same ref_id.

identity_id · string

The identity of the end user making the withdrawal. Required in 3P flows so Paxos can resolve the associated CryptoDestinationAddress and its Travel Rule metadata.

account_id · string

balance_asset · string

amount · string

The amount to withdraw. Specify exactly one of amount or total.

Pattern: ^[0-9]*\.?[0-9]+$

total · string

Total amount to withdraw, including fees. Specify exactly one of amount or total.

Pattern: ^[0-9]*\.?[0-9]+$

fee_id · string

memo · string

metadata · object

Show child attributes

beneficiary · object

Deprecated. Persist Travel Rule metadata on the destination address via PutCryptoDestinationAddress instead. Retained for backwards compatibility; inline beneficiary data is not recommended for new integrations.

Show child attributes

Response

200

application/json

The created withdrawal.

id · string

status · string