Accounts¶
Account types, allocations, ownership, and creation.
get_allowed_asset_classes_for_account¶
Get the asset classes allowed for a specific account type.
| Parameter | Type | Default | Description |
|---|---|---|---|
account_type |
string | required | Account type (e.g., 'taxable_brokerage', 'hsa') |
Returns: account_type, allowed_asset_classes, is_cash_only, and supports_equities.
get_account_limits¶
Get default limits and restrictions for an account type.
| Parameter | Type | Default | Description |
|---|---|---|---|
account_type |
string | required | Account type |
Returns non-tax-related limits like FDIC insurance, RMD requirements, etc.
create_account¶
Create a financial account with balance, ownership, and allocation.
| Parameter | Type | Default | Description |
|---|---|---|---|
account_type |
string | required | Account type |
balance_cents |
int | required | Current account balance in cents |
ownership_json |
object | required | Ownership structure as JSON. Must include: ownership_type ('individual', 'joint', or 'beneficiary'), owner_ids (list of person IDs), and optionally beneficiary_id (required for beneficiary type). Example: |
allocation_json |
object | null | Optional asset allocation as JSON. Must include: stocks_pct, bonds_pct, and cash_pct (all integers 0-100 that sum to 100). Example: {"stocks_pct": 60, "bonds_pct": 30, "cash_pct": 10}. If omitted, defaults to 100% cash allocation. |
tax_treatment |
string | null | Tax treatment for the account. Options: pre_tax, post_tax_deferred, taxable, or tax_advantaged |
name |
string | null | Human-readable account name |
institution |
string | null | Financial institution name |
account_number_last4 |
string | null | Last 4 digits of account number |
is_current_employer |
bool | null | For 401k accounts, whether this is current employer's plan |
Returns the created account as JSON including auto-generated ID.