List address-book entries for a currency

GET

/v1/wallet/crypto/address-book/{currency}

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

Returns the address-book entries of the account the request acts on (your primary account, or the sub-account selected with X-VALR-SUB-ACCOUNT-ID) that you can withdraw this currency to: entries saved for the currency plus universal entries on its networks, oldest first.

Parameters

Path Parameters

currency*

Currency to list entries for, e.g. USDC.

Type

string

Required

Example"USDC"

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

Content-Type

application/json

[

{

"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

HTTP	Error	When
400	-11INVALID_REQUEST	The currency isn't recognised, skip or limit isn't a whole number, limit is more than 100, or networkType is blank.

Plus the errors common to all signed endpoints.