PUT
/
transfer
/
crypto-destination-address
Put Crypto Destination Addresses
curl --request PUT \
  --url https://api.paxos.com/v2/transfer/crypto-destination-address \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "id": "<string>",
  "crypto_network": "BITCOIN",
  "address": "<string>",
  "nickname": "<string>",
  "bookmarked_status": true,
  "travelrule_metadata": {
    "beneficiary": {
      "person_details": {
        "first_name": "<string>",
        "last_name": "<string>"
      },
      "institution_details": {
        "name": "<string>"
      }
    },
    "vasp": {
      "id": "<string>"
    },
    "custodian_type": "VASP"
  }
}'
{
  "address": {
    "id": "31f20a34-c1eb-4c86-adad-1e46bc271e1a",
    "crypto_network": "ETHEREUM",
    "address": "0xe4B0aCA9FB669817775274775b20e52118595515",
    "nickname": "my_new_address",
    "status": "APPROVED",
    "created_at": "2024-01-01T00:00:00Z",
    "bookmarked": true
  }
}
OAuth Scope
transfer:write_crypto_destination_address

Authorizations

​
Authorization
string
header
required

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

Token URLs:

Learn more in the API credentials guide →

Body

application/json
​
id
string

Optional field to specify the crypto destination address to update. Only one of (id) or (network, address) must be specified.

​
crypto_network
enum<string>

A CryptoNetwork is a blockchain transmitting cryptocurrencies.

Available options:
BITCOIN,
ETHEREUM,
BITCOIN_CASH,
LITECOIN,
SOLANA,
POLYGON_POS,
BASE,
ARBITRUM_ONE,
INK
​
address
string

Specify the address of the crypto destination address to create/update. Only one of (id) or (network, address) must be specified.

​
nickname
string

Optional field to update the nickname of the crypto destination address. Defaults to an auto-generated nickname if not specified on creation.

​
bookmarked_status
boolean

Optional field to update the bookmarked status of the crypto destination address. Defaults to false if not specified on creation.

​
travelrule_metadata
object

Response

200 - application/json

A successful response.

​
address
object
Example:
{
  "id": "31f20a34-c1eb-4c86-adad-1e46bc271e1a",
  "crypto_network": "ETHEREUM",
  "address": "0xe4B0aCA9FB669817775274775b20e52118595515",
  "nickname": "my_new_address",
  "status": "APPROVED",
  "created_at": "2024-01-01T00:00:00Z",
  "bookmarked": true
}