---
title: "Put Crypto Destination Addresses"
method: PUT
path: "/transfer/crypto-destination-address"
tags: ["Crypto Withdrawals"]
---

# Put Crypto Destination Addresses

`PUT /transfer/crypto-destination-address`

Updates a specified crypto destination address. If the address does not exist, it will be created

## Request body

- PutCryptoDestinationAddressRequest
  - `id` string — Optional field to specify the crypto destination address to update by its unique id. Specify either `id` or the `(crypto_network, address, identity_id)` tuple, not both.
  - `identity_id` string — The Identity that owns this destination address. Required for 3P integrations. When looking up an existing address to update, `(crypto_network, address, identity_id)` uniquely identifies it; omit for first-party addresses with no identity scope.
  - `crypto_network` 'BITCOIN' | 'ETHEREUM' | 'BITCOIN_CASH' | 'LITECOIN' | 'SOLANA' | 'POLYGON_POS' | 'BASE' | 'ARBITRUM_ONE' | 'STELLAR' | 'INK' | 'XLAYER' | 'AVALANCHE' | 'DOGECOIN' | 'SUI' | 'ROBINHOOD' | 'BNB' — A CryptoNetwork is a blockchain transmitting cryptocurrencies.
  - `address` string — Specify the address of the crypto destination address to create/update. Specify either `id` or the `(crypto_network, address, identity_id)` tuple, not both.
  - `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` PutCryptoDestinationAddressRequestTravelruleMetadata — Travel Rule metadata for the destination address. See the [Travel Rule guide](/guides/travel-rule).
    - `beneficiary` Beneficiary — Beneficiary of the transfer: the party receiving the funds, identified by `person_details` or `institution_details`, or by `self = true` when the destination is the end user's own wallet.
      - `person_details` BeneficiaryPerson — Person details if beneficiary is a person.
        - `first_name` string, required
        - `last_name` string, required
        - `physical_address` GeographicAddress — A geographic (postal) address.
          - `country` string, required — ISO 3166-1 alpha-3 country code (e.g. "USA", "SGP").
          - `address1` string — First line of the street address (e.g. "123 Main St").
          - `address2` string — Optional second line of the street address (e.g. unit, suite, or floor).
          - `city` string — City or town.
          - `province` string — State, province, or region.
          - `zip_code` string — Postal or ZIP code.
      - `institution_details` BeneficiaryInstitution — Institution details if beneficiary is an institution.
        - `name` string, required
        - `physical_address` GeographicAddress — A geographic (postal) address.
          - `country` string, required — ISO 3166-1 alpha-3 country code (e.g. "USA", "SGP").
          - `address1` string — First line of the street address (e.g. "123 Main St").
          - `address2` string — Optional second line of the street address (e.g. unit, suite, or floor).
          - `city` string — City or town.
          - `province` string — State, province, or region.
          - `zip_code` string — Postal or ZIP code.
      - `self` boolean — `true` when the beneficiary is the end user themselves (their own wallet) in which case `person_details` and `institution_details` are omitted and resolved from the end user's Identity.
    - `vasp` PutCryptoDestinationAddressRequestVasp — The receiving VASP, when `custodian_type` is `VASP`. Provide `id` (from ListVasps) for a known VASP, or `custom_vasp_name` + `custom_vasp_website` for a VASP not in the Paxos directory.
      - `id` string — Specify the id of a known VASP (from ListVasps). Specify exactly one of `id` (known VASP) or `custom_vasp_name` + `custom_vasp_website` (other VASP).
      - `custom_vasp_name` string — Specify the name of a VASP that is not in the known list. Specify exactly one of `id` (known VASP) or `custom_vasp_name` + `custom_vasp_website` (other VASP).
      - `custom_vasp_website` string — Website URL of the VASP. Required when `custom_vasp_name` is specified (VASP not in the Paxos directory).
    - `custodian_type` 'VASP' | 'PRIVATE'
    - `transfer_purpose` string — Purpose of the transfer.

## Response `200`

A successful response.

- PutCryptoDestinationAddressResponse
  - `address` CryptoDestinationAddress
    - `id` string, required
    - `identity_id` string — The Identity that owns this destination address. Unset for first-party (non-3P) addresses.
    - `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.
    - `address` string, required
    - `nickname` string
    - `status` 'PENDING' | 'APPROVED' | 'REJECTED'
    - `created_at` string, date-time
    - `bookmarked` boolean
    - `policy_execution_id` string
    - `travelrule_metadata` CryptoDestinationAddressTravelruleMetadata — Travel Rule metadata for the destination address. See the [Travel Rule guide](/guides/travel-rule).
      - `beneficiary` Beneficiary — Beneficiary of the transfer: the party receiving the funds, identified by `person_details` or `institution_details`, or by `self = true` when the destination is the end user's own wallet.
        - `person_details` BeneficiaryPerson — Person details if beneficiary is a person.
          - `first_name` string, required
          - `last_name` string, required
          - `physical_address` GeographicAddress — A geographic (postal) address.
            - `country` string, required — ISO 3166-1 alpha-3 country code (e.g. "USA", "SGP").
            - `address1` string — First line of the street address (e.g. "123 Main St").
            - `address2` string — Optional second line of the street address (e.g. unit, suite, or floor).
            - `city` string — City or town.
            - `province` string — State, province, or region.
            - `zip_code` string — Postal or ZIP code.
        - `institution_details` BeneficiaryInstitution — Institution details if beneficiary is an institution.
          - `name` string, required
          - `physical_address` GeographicAddress — A geographic (postal) address.
            - `country` string, required — ISO 3166-1 alpha-3 country code (e.g. "USA", "SGP").
            - `address1` string — First line of the street address (e.g. "123 Main St").
            - `address2` string — Optional second line of the street address (e.g. unit, suite, or floor).
            - `city` string — City or town.
            - `province` string — State, province, or region.
            - `zip_code` string — Postal or ZIP code.
        - `self` boolean — `true` when the beneficiary is the end user themselves (their own wallet) in which case `person_details` and `institution_details` are omitted and resolved from the end user's Identity.
      - `vasp` CryptoDestinationAddressVasp — The receiving VASP for this destination address, when `custodian_type` is `VASP`.
        - `id` string
        - `name` string
        - `custom_vasp_name` string — Customer-supplied VASP name, used when the "Other" VASP is selected.
        - `custom_vasp_website` string — Customer-supplied VASP website, used when the "Other" VASP is selected.
      - `custodian_type` 'VASP' | 'PRIVATE'
      - `transfer_purpose` string — Purpose of the transfer.

---

[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)