---
title: "Create Deposit Address"
method: POST
path: "/transfer/deposit-addresses"
tags: ["Deposit Addresses"]
---

# Create Deposit Address

`POST /transfer/deposit-addresses`

Create a deposit address on a blockchain network for depositing to a profile.

**Important for Stellar Network (PYUSD):**

When creating a deposit address for PYUSD on the Stellar network:

- Paxos automatically handles all necessary setup including trustline establishment
- The deposit address is immediately ready to receive PYUSD tokens
- No additional configuration is required by the user
- The PYUSD issuer address on Stellar mainnet is: `GDQE7IXJ4HUHV6RQHIUPRJSEZE4DRS5WY577O2FY6YQ5LVWZ7JZTU2V5`
- The PYUSD asset code is: `PYUSD`

## Request body

- CreateDepositAddressRequest
  - `profile_id` string, required — The target profile for deposit crediting.
  - `crypto_network` 'BITCOIN' | 'ETHEREUM' | 'BITCOIN_CASH' | 'LITECOIN' | 'SOLANA' | 'POLYGON_POS' | 'BASE' | 'ARBITRUM_ONE' | 'STELLAR' | 'INK' | 'XLAYER' | 'AVALANCHE' | 'DOGECOIN' | 'SUI' | 'ROBINHOOD' | 'BNB', required — A CryptoNetwork is a blockchain transmitting cryptocurrencies.
  - `identity_id` string — The Paxos Identity associated with this deposit address.
  - `ref_id` string — Client-specified ID for replay protection and lookup.
  - `metadata` object — Optional client-specified metadata, which will be added to both the deposit address itself and transfers to the created address. Up to 6 key/value pairs may be provided. Each key and value must be less than or equal to 100 characters.
  - `account_id` string — The Paxos Account associated with this deposit address.
  - `conversion_target_asset` 'NO_CONVERSION' | 'USD' — Asset to credit for deposits of Paxos-minted USD stablecoin.

## Response `200`

A successful response.

- DepositAddress
  - `id` string, required — The UUID of the deposit address.
  - `profile_id` string, required — The ID of the profile that will be credited when a deposit arrives with this address.
  - `customer_id` string, required — The Paxos Customer to which the profile belongs.
  - `crypto_network` 'BITCOIN' | 'ETHEREUM' | 'BITCOIN_CASH' | 'LITECOIN' | 'SOLANA' | 'POLYGON_POS' | 'BASE' | 'ARBITRUM_ONE' | 'STELLAR' | 'INK' | 'XLAYER' | 'AVALANCHE' | 'DOGECOIN' | 'SUI' | 'ROBINHOOD' | 'BNB', required — A CryptoNetwork is a blockchain transmitting cryptocurrencies.
  - `identity_id` string — The Identity of the end user who will make deposits to this address.
  - `ref_id` string — Client-specified ID for replay protection and lookup.
  - `metadata` object — Optional client-specified metadata, which is set on deposit address creation. Up to 6 key/value pairs may be returned. Each key and value must be less than or equal to 100 characters.
  - `address` string, required — The crypto address to send to for deposits.
  - `account_id` string — The Account associated to the identity of the user that will be linked to the created address.
  - `conversion_target_asset` 'NO_CONVERSION' | 'USD', required — Asset to credit for deposits of Paxos-minted USD stablecoin.
  - `compatible_crypto_networks` CryptoNetwork[] — List of networks compatible with the created address. Any of these networks can be used to deposit to the address.
  - `created_at` string, date-time, required — The time at which this address was created.

## Other responses

- `409` — Deposit address already exists

---

[API](https://skmtc.net/paxos/apis/paxos-api.md) · [All operations](https://skmtc.net/paxos/apis/paxos-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/paxos/paxos-api/revisions/0687ca8c9a8d/schema)