> ## Documentation Index
> Fetch the complete documentation index at: https://docs.deribit.com/llms.txt
> Use this file to discover all available pages before exploring further.
# private/list_address_beneficiaries
> Lists address beneficiaries with optional filtering and pagination. Returns all saved beneficiary information for addresses, with support for filtering by currency, address, wallet type, VASP details, and date ranges.
**📖 Related Article:** [Managing Withdrawals](https://docs.deribit.com/articles/managing-withdrawals-api)
**Scope:** `wallet:read`
[Try in API console](https://test.deribit.com/api_console?method=%2Fprivate%2Flist_address_beneficiaries)
## OpenAPI
````yaml /specifications/deribit_openapi.json get /private/list_address_beneficiaries
openapi: 3.0.0
info:
title: Deribit API
version: 2.1.1
servers:
- url: https://test.deribit.com/api/v2
security: []
tags:
- name: WebSocket Only
description: Can only be used over websockets.
- name: Public
description: Public methods can be used without authentication.
- name: Private
description: >-
Private methods require authentication. All requests must include a
valid OAuth2 token.
A token can be requested using the /public/auth method.
When using the websockets protocol, the token must be included as a
parameter access_token in the message. When using REST (HTTP
GET), the token may also be passed in the Authorization
header.
- name: Authentication
- name: Session Management
- name: Subscription Management
description: >-
Subscription works as [notifications](#notifications), so users will
automatically (after subscribing) receive messages from the server.
Overview for each channel response format is described in
[subscriptions](#subscriptions) section.
- name: Account Management
- name: Trading
- name: Market Data
- name: Wallet
- name: Chat
paths:
/private/list_address_beneficiaries:
get:
tags:
- Wallet
- Private
description: >+
Lists address beneficiaries with optional filtering and pagination.
Returns all saved beneficiary information for addresses, with support
for filtering by currency, address, wallet type, VASP details, and date
ranges.
**📖 Related Article:** [Managing
Withdrawals](https://docs.deribit.com/articles/managing-withdrawals-api)
**Scope:** `wallet:read`
[Try in API
console](https://test.deribit.com/api_console?method=%2Fprivate%2Flist_address_beneficiaries)
parameters:
- name: currency
required: false
in: query
schema:
$ref: '#/components/schemas/wallet_currency'
description: The currency symbol
- name: address
in: query
schema:
type: string
required: false
description: Address in currency format
- name: tag
in: query
schema:
type: string
required: false
description: Tag for XRP addresses
- name: created_before
in: query
schema:
$ref: '#/components/schemas/timestamp'
required: false
description: Filter by creation timestamp (before)
- name: created_after
in: query
schema:
$ref: '#/components/schemas/timestamp'
required: false
description: Filter by creation timestamp (after)
- name: updated_before
in: query
schema:
$ref: '#/components/schemas/timestamp'
required: false
description: Filter by update timestamp (before)
- name: updated_after
in: query
schema:
$ref: '#/components/schemas/timestamp'
required: false
description: Filter by update timestamp (after)
- name: personal
in: query
schema:
type: boolean
required: false
description: Filter by personal wallet flag
- name: unhosted
in: query
schema:
type: boolean
required: false
description: Filter by unhosted wallet flag
- name: beneficiary_vasp_name
in: query
schema:
$ref: '#/components/schemas/beneficiary_vasp_name'
required: false
description: Filter by beneficiary VASP name
- name: beneficiary_vasp_did
in: query
schema:
$ref: '#/components/schemas/beneficiary_vasp_did'
required: false
description: Filter by beneficiary VASP DID
- name: beneficiary_vasp_website
in: query
schema:
$ref: '#/components/schemas/beneficiary_vasp_website'
required: false
description: >-
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
- name: limit
in: query
schema:
type: integer
minimum: 1
maximum: 1000
default: 100
required: false
description: Maximum number of results to return
- name: continuation
in: query
required: false
schema:
type: string
example: xY7T6cutS3t2B9YtaDkE6TS379oKnkzTvmEDUnEUP2Msa9xKWNNaT
description: Continuation token for pagination
requestBody:
content:
application/json:
examples:
request:
value:
jsonrpc: '2.0'
id: 42
method: private/list_address_beneficiaries
params:
currency: BTC
limit: 10
description: JSON-RPC Request Example
description: JSON-RPC request body
responses:
'200':
$ref: '#/components/responses/PrivateListAddressBeneficiariesResponse'
components:
schemas:
wallet_currency:
enum:
- BTC
- ETH
- STETH
- ETHW
- USDC
- USDT
- EURR
- SOL
- XRP
- USYC
- PAXG
- BNB
- USDE
type: string
description: Currency, i.e `"BTC"`, `"ETH"`, `"USDC"`
timestamp:
example: 1536569522277
type: integer
description: The timestamp (milliseconds since the Unix epoch)
beneficiary_vasp_name:
example: Money's Gone
type: string
description: Name of beneficiary VASP
beneficiary_vasp_did:
example: did:example:123456789abcdefghi
type: string
description: DID of beneficiary VASP
beneficiary_vasp_website:
type: string
description: Website of the beneficiary VASP
PrivateListAddressBeneficiariesResponse:
properties:
jsonrpc:
type: string
enum:
- '2.0'
description: The JSON-RPC version (2.0)
id:
type: integer
description: The id that was sent in the request
result:
type: object
properties:
data:
type: array
items:
$ref: '#/components/schemas/address_beneficiary_item'
continuation:
$ref: '#/components/schemas/continuation'
count:
type: integer
example: 42
description: Total number of results available
required:
- jsonrpc
- result
type: object
address_beneficiary_item:
properties:
currency:
$ref: '#/components/schemas/currency'
address:
$ref: '#/components/schemas/currency_address'
tag:
type: string
nullable: true
description: Tag for XRP addresses (optional)
user_id:
$ref: '#/components/schemas/user_id'
agreed:
$ref: '#/components/schemas/agree_to_share_with_3rd_party'
personal:
$ref: '#/components/schemas/personal_wallet'
unhosted:
$ref: '#/components/schemas/unhosted_wallet'
beneficiary_vasp_name:
$ref: '#/components/schemas/beneficiary_vasp_name'
beneficiary_vasp_did:
$ref: '#/components/schemas/beneficiary_vasp_did'
beneficiary_vasp_website:
$ref: '#/components/schemas/beneficiary_vasp_website'
beneficiary_first_name:
$ref: '#/components/schemas/beneficiary_first_name'
beneficiary_last_name:
$ref: '#/components/schemas/beneficiary_last_name'
beneficiary_company_name:
$ref: '#/components/schemas/beneficiary_company_name'
beneficiary_address:
$ref: '#/components/schemas/beneficiary_address'
created:
$ref: '#/components/schemas/timestamp'
updated:
$ref: '#/components/schemas/timestamp'
required:
- currency
- address
- user_id
- agreed
- personal
- unhosted
- beneficiary_vasp_name
- beneficiary_vasp_did
- beneficiary_address
- created
- updated
type: object
continuation:
example: xY7T6cutS3t2B9YtaDkE6TS379oKnkzTvmEDUnEUP2Msa9xKWNNaT
type: string
description: Continuation token for pagination.
currency:
enum:
- BTC
- ETH
- USDC
- USDT
- EURR
type: string
description: Currency, i.e `"BTC"`, `"ETH"`, `"USDC"`
currency_address:
example: 1A1zP1eP5QGefi2DMPTfTL5SLmv7DivfNa
type: string
description: Address in proper format for currency
user_id:
example: 57874
type: integer
description: Unique user identifier
agree_to_share_with_3rd_party:
example: true
type: boolean
description: >-
Indicates that the user agreed to shared provided information with 3rd
parties
personal_wallet:
example: true
type: boolean
description: >-
The user confirms that he provided address belongs to him and he has
access to it via an un-hosted wallet software
unhosted_wallet:
example: false
type: boolean
description: Indicates if the address belongs to an unhosted wallet
beneficiary_first_name:
example: John
type: string
description: First name of the beneficiary (if beneficiary is a person)
beneficiary_last_name:
example: Doe
type: string
description: Last name of the beneficiary (if beneficiary is a person)
beneficiary_company_name:
example: Company Name
type: string
description: Company name of the beneficiary (if beneficiary is a company)
beneficiary_address:
example: NL, Amsterdam, Street, 1
type: string
description: Geographical address of the beneficiary
responses:
PrivateListAddressBeneficiariesResponse:
content:
application/json:
schema:
$ref: '#/components/schemas/PrivateListAddressBeneficiariesResponse'
examples:
response:
value:
jsonrpc: '2.0'
id: 42
result:
data:
- currency: BTC
address: bc1qar0srrr7xfkvy5l643lydnw9re59gtzzwf0uyj
user_id: 1026
agreed: true
personal: false
unhosted: false
beneficiary_vasp_name: Money's Gone
beneficiary_vasp_did: did:example:123456789abcdefghi
beneficiary_vasp_website: https://example.com
beneficiary_first_name: John
beneficiary_last_name: Doe
beneficiary_company_name: Example Corp
beneficiary_address: NL, Amsterdam, Street, 1
created: 1536569522277
updated: 1536569522277
continuation: xY7T6cutS3t2B9YtaDkE6TS379oKnkzTvmEDUnEUP2Msa9xKWNNaT
count: 1
description: Response example
description: Success response
````