Business API

Appearance

List address-book entries​

GET
/v1/wallet/crypto/address-book

Requires WITHDRAWALS_READ, granted by TREASURY_READ or TREASURY_WRITE or WITHDRAWALS_WRITE or BANK_ACCOUNTS_WRITE (bundles)

Returns the saved withdrawal addresses in the address book of the account the request acts on (your primary account, or the sub-account selected with X-VALR-SUB-ACCOUNT-ID), oldest first. Send an entry's id as addressBookId to withdraw to it.

Parameters​

Query Parameters

skip

Number of entries to skip, for paging.

Type
integer
Example0
Default
0
limit

Maximum number of entries to return, up to 100.

Type
integer
Example100
Default
100
networkType

Only entries on this network, e.g. Ethereum.

Type
string
Example"Ethereum"

Responses​

OK

application/json
JSON
[
{
"id": "3b8e1f6a-2c4d-4e5f-8a9b-0c1d2e3f4a5b",
"label": "Treasury cold wallet",
"currency": "BTC",
"address": "bc1q4u7h2kz9x8w3n5e6r0t2y7m8c9v3f5g6j8k2l0",
"networkType": "Bitcoin",
"createdAt": "2026-09-14T10:22:31.508Z",
"type": "CURRENCY_SPECIFIC",
"beneficiaryName": "Acme Treasury (Pty) Ltd",
"isCorporate": true,
"isSelfHosted": true
},
{
"id": "9f2a7c3e-4b5d-4e6f-a7b8-c9d0e1f2a3b4",
"label": "Exchange settlement (Ethereum)",
"address": "0x8d3f2b6a91c04e7fa1b2c3d4e5f60718293a4b5c",
"networkType": "Ethereum",
"createdAt": "2026-10-02T13:05:47.219Z",
"type": "UNIVERSAL",
"beneficiaryName": "Acme Treasury (Pty) Ltd",
"isCorporate": true,
"isSelfHosted": false,
"serviceProviderName": "Binance",
"serviceProviderId": "676d1c189ef2fd542e5bbf33"
},
{
"id": "c1d2e3f4-a5b6-4c7d-8e9f-0a1b2c3d4e5f",
"label": "Supplier USDC (Stellar)",
"currency": "USDC",
"address": "GBXK7Q2M4N6P8R0T2V4X6Z8B0D2F4H6J8L0N2P4R6T8V0X2Z4B6D8F",
"networkType": "StellarLumens",
"paymentReference": "INV-20431",
"createdAt": "2026-10-12T07:41:09.880Z",
"type": "CURRENCY_SPECIFIC",
"beneficiaryName": "Northwind Supplies Ltd",
"isCorporate": true,
"isSelfHosted": false,
"serviceProviderName": "Example Custody"
}
]

Samples​

Errors

HTTPErrorWhen
400-11INVALID_REQUESTskip or limit isn't a whole number, limit is more than 100, or networkType is blank.

Plus the errors common to all signed endpoints.