Pearler

Get the customer's trading accounts - type, name, cash balance, and which Pearler products (ASX/US shares, Micro, Self-Directed Super, HomeSoon) are linked to each. Use this before getHoldings or getAutomations to see which accounts exist.

getAccountSummary

Look up one or more assets by their exact ticker - use this when the tickers are already known (e.g. from a customer's holdings or watchlist named earlier in the conversation). For fuzzy/substring search or filtering by sector, category, or sort order, use searchAssets instead.

getAssetsByTickers

Generate a link to the Pearler website that lets the customer set up a new Automate (recurring automated investing or saving), optionally pre-filled with flow, account, amount, frequency, or a scheduled date. Never creates the automation itself - the customer must review and confirm on the website.

getAutomateLink

Get the customer's named Automates (recurring automated investing, deposits, or dividend reinvestment) across all their trading accounts, including type, active/paused state, target portfolio composition where applicable, and a url to view each one on the Pearler website - use it verbatim, never construct or guess one. Use this before getAutomateLink when reinvesting dividends into an existing Automate. Each Automate also has its own dedicated cash balance (cashBalanceCents, in cents) - the cash set aside for that Automate, as shown under Automations on the app's Overview - separate from the account's general AUD cash balance. Funds must land there to invest/deposit. When asked how to fund one, share cashTransferUrl (to transfer existing cash in) or depositDetails (to deposit directly: pay the PayID with the reference, exactly and with nothing else, as the payment description). If payId is null, tell the customer to open the Pearler app to generate one. For BSB and account number, use getDepositDetails with the automationId.

getAutomations

Get the customer's cash balance for each of their trading accounts.

getBalance

Get the PayID used to deposit money into the customer's trading account(s). Only include BSB and account number if the customer explicitly asks for bank transfer details - by default just share the PayID. If payId is null, tell the customer to open the Pearler app to generate one. If the customer wants to deposit into one of their automations, pass its automationId (from getAutomations) to also get the payment reference for it. Always remind the customer to check these details match what the Pearler app shows before transferring money.

getDepositDetails

Check which of the customer's trading accounts are able to trade a given ASX or US asset, by ticker and region. Use this before getOrderLink to pick a valid accountId.

getEligibleTradingAccounts

Get the customer's holdings across all their trading accounts - ASX shares, US shares, and Pearler Micro portfolios, distinguished by `product` (SHARES_ASX, SHARES_US, MICRO) - including quantity, current market value, and cost basis. For Micro holdings, ticker is the portfolio's benchmark ETF - the customer holds Micro units, not that ETF, so don't pass it to getOrderLink.

getHoldings

Generate a link to the Pearler website that lets the customer place a buy or sell order for an ASX or US asset, optionally pre-filled with amount, account, limit price, or a scheduled date.

getOrderLink

Get the customer's historical transactions (cash, orders, transfers, dividends, and super) across their trading accounts, paginated and optionally filtered by date range, type, state, currency, asset, or account - the same filters available on the transaction history page. Distinct from getUpcomingTransaction-style tools, which only cover pending activity.

getTransactions