Sign in

v2

latestOpenAPI 3.0.02026-07-311824171.4 MB
Wallet
Private

Updates beneficiary information for an address in the address book. This method allows you to add or modify beneficiary details required for compliance purposes when making withdrawals to certain addresses.

📖 Related Article: Managing Withdrawals

Scope: wallet:read_write

Try in API console

get/private/update_in_address_book

Query parameters

currency'BTC' | 'ETH' | 'STETH' | 'ETHW' | 'USDC' | 'USDT' | 'EURR' | 'SOL' | 'XRP' | 'USYC' | 'PAXG' | 'BNB' | 'USDE' required

Currency, i.e "BTC", "ETH", "USDC"

The currency symbol

type'transfer' | 'withdrawal' | 'deposit_source' required

Address book type

Address book type

addressstring required

Address in currency format, it must be in address book

beneficiary_vasp_namestring required

Name of beneficiary VASP

Example:Money's Gone

Name of beneficiary VASP

beneficiary_vasp_didstring required

DID of beneficiary VASP

Example:did:example:123456789abcdefghi

DID of beneficiary VASP

beneficiary_vasp_websitestring

Website of the beneficiary VASP

Website of the beneficiary VASP. Required if the address book entry is associated with a VASP that is not included in the list of known VASPs

beneficiary_first_namestring

First name of the beneficiary (if beneficiary is a person)

Example:John

First name of beneficiary (if beneficiary is a person)

beneficiary_last_namestring

Last name of the beneficiary (if beneficiary is a person)

Example:Doe

First name of beneficiary (if beneficiary is a person)

beneficiary_company_namestring

Company name of the beneficiary (if beneficiary is a company)

Example:Company Name

Beneficiary company name (if beneficiary is a company)

beneficiary_addressstring required

Geographical address of the beneficiary

Example:NL, Amsterdam, Street, 1

Geographical address of the beneficiary

agreedboolean required

Indicates that the user agreed to shared provided information with 3rd parties

Example:true

Indicates that the user agreed to shared provided information with 3rd parties

personalboolean required

The user confirms that he provided address belongs to him and he has access to it via an un-hosted wallet software

Example:true

The user confirms that he provided address belongs to him and he has access to it via an un-hosted wallet software

labelstring required

Label of the address book entry

Example:Main address

Label of the address book entry

Response

Success response

jsonrpc'2.0' required

The JSON-RPC version (2.0)

idinteger

The id that was sent in the request

resultstring required

ok

Example response

{
  "result": "ok"
}