Account Holders

An account holder is the individual or entity that owns or controls Bitcoin via an account or claim. This is the primary party using Hoseki’s services.

Account holders can manage multiple accounts and establish connections to both digital asset service providers and self-custodial wallets.

An account holder is required to initiate any self-custody or exchange connection.

The account holder — and their associated account_holder_id — serves as your reference to that user. You can use this ID to fetch their connected accounts and claims or to initiate new connections via the Hoseki API.

To create an account holder, use the following request:

Request:

POST v1/account_holders/

Example:

curl https://api.hoseki.app/api/v1/account_holders/ \
  --request POST \
  --header 'Accept: /' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
  "email": "satoshin@gmx.com",
  "name": "Satoshi Nakamoto",
  "reference_id": ""
}'

Response:

{
  "id": "ah_ezwIXuhcaxO749oDQdZef",
  "created_at": 1615766400,
  "updated_at": 1615766400,
  "email": "satoshin@gmx.com",
  "name": "Satoshi Nakamoto",
  "reference_id": ""
}