Create withdrawal address

This endpoint is designed to create a beneficiary address within our Address Book, enabling the sender to initiate secure withdrawals. By registering this address, Bitpanda ensures complete beneficiary information is available, meeting both Travel Rule and MiCAR compliance requirements.

This process helps maintain a safe, regulated environment for crypto transactions, ensuring transparency and adherence to legal standards for all parties involved.

SecuritybearerAuth
Request
header Parameters
bp-user-id
required
string <uuid>
Example: 12312312-2be6-4522-977e-ea4d92c45e86
Request Body schema: application/json

The address to be created.

coin_network_id
required
string <uuid>

The unique identifier representing the specific coin and network for which the address will be created.

address
required
string

The generated address hash on the specified network, used for sending cryptocurrency transactions.

destination_tag
string

An additional identifier used with certain cryptocurrencies (e.g., XRP, Stellar) to specify the recipient’s unique identifier within a wallet address, ensuring the transaction reaches the correct account.

host_type
required
string

Host Type - Specifies the type of wallet or entity hosting the crypto address. The possible values are:

  • KNOWN_VASP: A verified Virtual Asset Service Provider (VASP) such as a licensed exchange.
  • UNKNOWN_VASP: An unverified or unrecognized Virtual Asset Service Provider.
  • SELF_HOSTED: A self-custodied wallet, such as MetaMask, where the user has direct control over their private keys.
Enum: "KNOWN_VASP" "UNKNOWN_VASP" "SELF_HOSTED"
host_name
required
string

The name of the platform or wallet provider associated with the crypto address, represented as a string (e.g., “Binance,” “Coinbase,” etc.).

user_owned
required
boolean

A boolean indicating ownership of the address. true if the address belongs to the user making the request; false if it belongs to another user.

owner_legal_name
string

The legal name of the address beneficiary, required only if user_owned is false. This specifies the full name of the person or entity that owns the address when it does not belong to the requesting user.

Responses
200

Success Response

400

Bad request

401

Unauthorized

403

Forbidden

404

Not Found

422

Validation Error

500

Internal Error

503

Service unavailable

post/v1/crypto-transfers/addresses/withdrawals
Request samples
application/json
{
  • "coin_network_id": "1ed83487-f684-62a2-a155-fe633f0db292",
  • "address": "raDnEe3yGzkqK6nBUerb5s9wqszZDLYTbz",
  • "destination_tag": "6363869576905874",
  • "host_type": "KNOWN_VASP",
  • "host_name": "Bitpanda",
  • "user_owned": false,
  • "owner_legal_name": "John Doe"
}
Response samples
application/json
{
  • "data": {
    }
}