Add Whitelisted Wallet

Testing Env

http://k8s-partnera-partnera-7873f15634-69ebb7c047cac3d1.elb.eu-central-1.amazonaws.com

POST

/v1/partner/whitelisted-wallets

Adds a wallet address to the Partner's withdrawal whitelist. Crypto withdrawals can only be sent to whitelisted addresses.

Recipient details provided here are used for Travel Rule compliance and apply to every withdrawal sent to this address, so they only need to be provided once.

Owner type

SENDER - the address belongs to the Partner. Requires ownershipDeclaration: true. receiverName is not used.

PRIVATE_INDIVIDUAL - the address belongs to a natural person. Requires receiverName.

BUSINESS - the address belongs to a company. Requires receiverName.

Memo

Some networks (e.g. XRP) use a memo (destination tag) to identify the recipient at a shared exchange address. If the recipient provided a memo, it must be included here. The same address with a different memo is treated as a separate recipient.

Request

Authorization

API Key

Add parameter in header

x-api-key

Example:

x-api-key: ********************

Body Params application/jsonRequired

Examples

Responses

🟢201Success

application/json

Wallet address added to the whitelist.

Bodyapplication/json

Request Example

Shell

JavaScript

Java

Swift

cURL

Private individual - BTCBusiness - XRP with memoOwn wallet - DOGE

curl --location 'http://k8s-partnera-partnera-7873f15634-69ebb7c047cac3d1.elb.eu-central-1.amazonaws.com/v1/partner/whitelisted-wallets' \
--header 'x-api-key: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
    "currency": "BTC",
    "network": "BTC",
    "walletAddress": "3KRYKbqH24iNbmp8Vjd2i6WLRmGWLbHTms",
    "walletType": "SELF_CUSTODY",
    "ownerType": "PRIVATE_INDIVIDUAL",
    "receiverName": "John Smith"
}'

Response Example

Private individual - BTC

{
    "id": "5b1e2c9a-7f3d-4e8b-a1c6-9d2f4e7b3a10",
    "currency": "BTC",
    "network": "BTC",
    "walletAddress": "3KRYKbqH24iNbmp8Vjd2i6WLRmGWLbHTms",
    "memo": null,
    "walletType": "SELF_CUSTODY",
    "ownerType": "PRIVATE_INDIVIDUAL",
    "receiverName": "John Smith",
    "createdAt": "2026-10-05T13:24:10.512Z"
}

Crypto Withdrawals

Get Whitelisted Wallets

Add Whitelisted Wallet

Owner type#

Memo#

Request

Responses

Owner type

Memo