Multiple Tenant Accounts
Release Details
Release Date: December 3, 2025
Summary
zerohash now supports a formal Customer Accounts model, enabling platforms to create and manage multi-participant CLOB trading accounts, including custodial (UTMA), trust, joint (JTIC / JTWROS), and accounts with an added financial advisor.
New customer-account identifiers use the ZRN schema zrn:zh:<geo>:accounts:customer:<id>
Legacy unqualified IDs continue to be supported for full backward compatibility.
Multi-tenant accounts now include configurable tenant roles (primary / secondary participants) and authorization levels (full-trading, limited-trading, or view-only). Platforms may also attach a financial advisor with controlled access.
No Action for Platforms
No mandatory migration. Existing integrations keep working. But you may now support joint, custodial, or trust-based accounts by adopting the new account-type schema when calling POST /accounts.
Related Endpoints
- Create customer account: POST /accounts
- Get account details: GET /accounts/{zrn}/details
- Update customer account: PATCH /accounts/{zrn}
- Add tenant to customer account: POST /accounts/{zrn}/tenants
- Remove tenant from customer account: DELETE /accounts/{zrn}/tenants/{tenant}
- Add advisor to customer account: POST /accounts/{zrn}/advisors
- Remove advisor from customer account: DELETE /accounts/{zrn}/advisors
For more information and example use cases, see our Customer Accounts Guide