fidelity-helper 0.1.0__tar.gz

fidelity_helper-0.1.0/.gitignore

@@ -0,0 +1,2 @@
+*.pyc
+dist/

fidelity_helper-0.1.0/LICENSE

@@ -0,0 +1,7 @@
+Copyright 2025 Theodore H. Romer
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the “Software”), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

fidelity_helper-0.1.0/PKG-INFO

@@ -0,0 +1,45 @@
+Metadata-Version: 2.4
+Name: fidelity-helper
+Version: 0.1.0
+Summary: Fetch Fidelity transactions
+Project-URL: Homepage, https://github.com/righteffort/finance-helper/tree/main/python/fidelity-helper
+Project-URL: Source, https://github.com/righteffort/finance-helper.git
+Project-URL: Documentation, https://righteffort.github.io/finance-helper/python/fidelity-helper
+Project-URL: Issues, https://github.com/righteffort/finance-helper/issues
+Author-email: Ted Romer <tromer@gmail.com>
+License-Expression: MIT
+License-File: LICENSE
+Keywords: banking,fidelity,finance
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Requires-Python: >=3.10
+Requires-Dist: pydantic>=2.12.5
+Requires-Dist: pystache>=0.6.8
+Description-Content-Type: text/markdown
+
+# fidelity-helper
+
+Retrieve Fidelity transaction data via fetch calls to fidelity.com in the context of a browser.
+
+[API documentation](https://righteffort.github.io/finance-helper/python/fidelity-helper)
+
+## Usage
+
+```python
+from datetime import date
+from fidelity_helper import Fidelity
+
+# In this example the callback assumes page.evaluate is provided by your browser
+# automation framework.
+fidelity = Fidelity(lambda expr: page.evaluate(expr, await_promise=True))
+
+# Get transactions for specific accounts and date range
+transactions = await fidelity.get_transactions(
+    accounts=["123456789", "987654321"], start=date(2024, 1, 1), end=date(2024, 1, 31)
+)
+
+for t in transactions:
+    print(f"{t.date}\t${t.amount}\t{t.description}")
+```
+
+See [fidelity_example.py](https://github.com/righteffort/finance-helper/tree/main/python/fidelity-example/fidelity_example.py) for a working example.

fidelity_helper-0.1.0/README.md

@@ -0,0 +1,26 @@
+# fidelity-helper
+
+Retrieve Fidelity transaction data via fetch calls to fidelity.com in the context of a browser.
+
+[API documentation](https://righteffort.github.io/finance-helper/python/fidelity-helper)
+
+## Usage
+
+```python
+from datetime import date
+from fidelity_helper import Fidelity
+
+# In this example the callback assumes page.evaluate is provided by your browser
+# automation framework.
+fidelity = Fidelity(lambda expr: page.evaluate(expr, await_promise=True))
+
+# Get transactions for specific accounts and date range
+transactions = await fidelity.get_transactions(
+    accounts=["123456789", "987654321"], start=date(2024, 1, 1), end=date(2024, 1, 31)
+)
+
+for t in transactions:
+    print(f"{t.date}\t${t.amount}\t{t.description}")
+```
+
+See [fidelity_example.py](https://github.com/righteffort/finance-helper/tree/main/python/fidelity-example/fidelity_example.py) for a working example.

fidelity_helper-0.1.0/fidelity_helper/fidelity-templates/getAccountsOptions.json

@@ -0,0 +1,22 @@
+{
+  "headers": {
+    "accept": "*/*",
+    "accept-language": "en-US,en;q=0.9",
+    "apollographql-client-version": "0.0.0",
+    "cache-control": "no-cache",
+    "content-type": "application/json",
+    "pragma": "no-cache",
+    "priority": "u=1, i",
+    "sec-ch-ua": "\"Chromium\";v=\"142\", \"Google Chrome\";v=\"142\", \"Not_A Brand\";v=\"99\"",
+    "sec-ch-ua-mobile": "?0",
+    "sec-ch-ua-platform": "\"Chrome OS\"",
+    "sec-fetch-dest": "empty",
+    "sec-fetch-mode": "cors",
+    "sec-fetch-site": "same-origin"
+  },
+  "referrer": "https://digital.fidelity.com/ftgw/digital/portfolio/summary",
+  "body": "{\"operationName\":\"GetContext\",\"variables\":{},\"query\":\"query GetContext {\\n  getContext {\\n    sysStatus {\\n      backend {\\n        account\\n        __typename\\n      }\\n      __typename\\n    }\\n    person {\\n      assets {\\n        acctNum\\n        acctType\\n        preferenceDetail {\\n          name\\n          __typename\\n        }\\n        __typename\\n      }\\n      __typename\\n    }\\n    __typename\\n  }\\n}\\n\"}",
+  "method": "POST",
+  "mode": "cors",
+  "credentials": "include"
+}

fidelity_helper-0.1.0/fidelity_helper/fidelity-templates/getTransactionsBody.json.mustache

@@ -0,0 +1,27 @@
+{
+  "operationName": "getTransactions",
+  "variables": {
+      "isNewOrderApi": true,
+    "isSupportCrypto": true,
+    "hideDCOrders": false,
+    "acctIdList": "{{#accounts}}{{number}}{{^last}},{{/last}}{{/accounts}}",
+    "acctDetailList": [{{#accounts}}
+      {
+        "acctNum": "{{number}}",
+        "acctType": "Brokerage",
+        "name": "{{name}}"
+      }{{^last}},{{/last}}{{/accounts}}
+    ],
+    "searchCriteriaDetail": {
+      "timePeriod": 30,
+      "txnCat": null,
+      "viewType": "NON_CORE",
+      "histSortDir": "D",
+      "acctHistSort": "DATE",
+      "hasBasketName": true,
+      "txnFromDate": "{{start}}",
+      "txnToDate": "{{end}}"
+    }
+  },
+  "query": "query getTransactions($acctIdList: String, $acctDetailList: [AcctDetailList], $searchCriteriaDetail: SearchCriteriaDetail, $isNewOrderApi: Boolean! = false, $isSupportCrypto: Boolean! = false, $hideDCOrders: Boolean! = true) {\n  getTransactions(\n    acctIdList: $acctIdList\n    acctDetailList: $acctDetailList\n    searchCriteriaDetail: $searchCriteriaDetail\n    isNewOrderApi: $isNewOrderApi\n    isSupportCrypto: $isSupportCrypto\n    hideDCOrders: $hideDCOrders\n  ) {\n    backendStatus {\n      history\n      __typename\n    }\n    historys {\n      acctNum\n      orderNumber\n      intradayInd\n      description\n      date\n      amount\n      txnTypeCode\n      txnCatCode\n      txnCatDesc\n      txnSubCatCode\n      cashBalance\n      __typename\n    }\n    __typename\n  }\n}"
+}

fidelity_helper-0.1.0/fidelity_helper/fidelity-templates/getTransactionsOptions.json.mustache

@@ -0,0 +1,23 @@
+{
+  "headers": {
+    "accept": "*/*",
+    "accept-language": "en-US,en;q=0.9",
+    "apollographql-client-name": "activity",
+    "apollographql-client-version": "0.0.1",
+    "cache-control": "no-cache",
+    "content-type": "application/json",
+    "pragma": "no-cache",
+    "priority": "u=1, i",
+    "sec-ch-ua": "\"Chromium\";v=\"142\", \"Google Chrome\";v=\"142\", \"Not_A Brand\";v=\"99\"",
+    "sec-ch-ua-mobile": "?0",
+    "sec-ch-ua-platform": "\"Chrome OS\"",
+    "sec-fetch-dest": "empty",
+    "sec-fetch-mode": "cors",
+    "sec-fetch-site": "same-origin"
+  },
+  "referrer": "https://digital.fidelity.com/ftgw/digital/portfolio/activity",
+  "body": {{{body}}},
+  "method": "POST",
+  "mode": "cors",
+  "credentials": "include"
+}

fidelity_helper-0.1.0/pyproject.toml

@@ -0,0 +1,98 @@
+[project]
+name = "fidelity-helper"
+version = "0.1.0"
+description = "Fetch Fidelity transactions"
+license = "MIT"
+license-files = ["LICENSE"]
+readme = "README.md"
+authors = [
+  { name = "Ted Romer", email = "tromer@gmail.com" }
+]
+keywords = [ "banking", "fidelity", "finance"]
+requires-python = ">=3.10"
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "Operating System :: OS Independent",
+]
+
+dependencies = [
+  "pydantic>=2.12.5",
+  "pystache>=0.6.8",
+]
+
+[project.urls]
+Homepage = "https://github.com/righteffort/finance-helper/tree/main/python/fidelity-helper"
+Source = "https://github.com/righteffort/finance-helper.git"
+Documentation = "https://righteffort.github.io/finance-helper/python/fidelity-helper"
+Issues = "https://github.com/righteffort/finance-helper/issues"
+
+[dependency-groups]
+dev = [
+  "aiofiles>=25.1.0",
+  "basedpyright>0",
+  "pdoc>=16.0.0",
+  "pytest>0",
+  "pytest-asyncio>=1.3.0",
+  "ruff>0",
+]
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/fidelity_helper"]
+exclude = ["fidelity-templates"]
+
+[tool.hatch.build.targets.sdist]
+include = [
+  "/src",
+]
+exclude = [
+  "/src/fidelity_helper/fidelity-templates"
+]
+
+[tool.hatch.build.targets.wheel.force-include]
+"../../fidelity-templates" = "fidelity_helper/fidelity-templates"
+
+[tool.hatch.build.targets.sdist.force-include]
+"../../fidelity-templates" = "fidelity_helper/fidelity-templates"
+
+[tool.pytest.ini_options]
+addopts = [
+  "--import-mode=importlib",
+  "--strict-markers",
+]
+
+[tool.pyright]
+typeCheckingMode = "recommended"
+reportUnannotatedClassAttribute = false
+
+[tool.ruff.lint]
+
+select = [
+  "ALL",
+]
+
+ignore = [
+  "COM812", # missing-trailing-comma -- let the formatter deal with it
+  "D203",   # incorrect-blank-line-before-class
+  "D213",   # multi-line-summary-second-line
+  "DTZ007", # Naive datetime constructed using `datetime.datetime.strptime()` without %z
+  "FIX002", # line-contains-todo
+  "SLF001", # Private member accessed -- handled by basedpyright
+  "TC006",  # runtime-cast-value
+  "TD002",  # missing-todo-author
+  "TD003",  # missing-todo-link
+]
+
+[tool.ruff.lint.extend-per-file-ignores]
+"tests/**/*.py" = ["D", "PLR2004", "S101"]
+
+[tool.ruff.format]
+docstring-code-format = true
+skip-magic-trailing-comma = true
+
+[tool.ruff.lint.isort]
+split-on-trailing-comma = false
+lines-after-imports = 2

fidelity_helper-0.1.0/src/fidelity_helper/__init__.py

@@ -0,0 +1,27 @@
+r"""Retrieve Fidelity transaction data via fetch calls to fidelity.com.
+
+## Usage
+
+```python
+from datetime import date
+from fidelity_helper import Fidelity
+
+# In this example the callback assumes page.evaluate is provided by your browser
+# automation framework.
+fidelity = Fidelity(lambda expr: page.evaluate(expr, await_promise=True))
+
+# Get transactions for specific accounts and date range
+transactions = await fidelity.get_transactions(
+    accounts=["123456789", "987654321"], start=date(2024, 1, 1), end=date(2024, 1, 31)
+)
+
+for t in transactions:
+    print(f"{t.date}\t${t.amount}\t{t.description}")
+```
+See [fidelity_example.py](https://github.com/righteffort/finance-helper/python/fidelity-example/fidelity_example.py) for a working example.
+"""  # noqa: E501
+
+from .fidelity import Account, Fidelity, FidelityError, Transaction
+
+
+__all__ = ["Transaction", "Account", "Fidelity", "FidelityError"]  # noqa: RUF022

fidelity_helper-0.1.0/src/fidelity_helper/fidelity.py

@@ -0,0 +1,340 @@
+"""Retrieve transactions from fidelity.com via browswer fetch calls."""
+
+from __future__ import annotations
+
+import base64
+import json
+import re
+from dataclasses import dataclass
+from datetime import date, datetime
+from http import HTTPStatus
+from importlib.resources import files
+from typing import TYPE_CHECKING, Any, TypedDict, cast
+from zoneinfo import ZoneInfo
+
+from .fidelity_models import (
+    GetAccountsRespModel,
+    GetTransactionsReqModel,
+    GetTransactionsRespHistoryModel,
+    GetTransactionsRespModel,
+)
+
+
+if TYPE_CHECKING:
+    from collections.abc import Callable
+    from types import CoroutineType
+
+import pystache  # pyright: ignore[reportMissingTypeStubs]
+from pydantic import ValidationError
+
+
+class FidelityError(Exception):
+    """Raised on any error specific to `Fidelity` class."""
+
+
+@dataclass
+class Account:
+    """Fidelity account."""
+
+    number: str
+    """Fidelity account number."""
+    name: str
+    """Fidelity account name selected by the account owner."""
+
+
+@dataclass
+class Transaction:
+    """Fidelity transaction."""
+
+    acct_num: str
+    """Fidelity account number."""
+    date: date
+    """Transaction date. Should be interpreted as midnight America/New_York."""
+    description: str
+    """Transaction description."""
+    amount: float
+    """Transaction amount in dollars."""
+    order_number: str | None
+    """Transaction identifier. Unique for this account. `None` only if pending."""
+    pending: bool
+    """True iff transaction is pending."""
+
+
+class Fidelity:
+    """Retrieve transactions from fidelity.com via browser fetch calls."""
+
+    def __init__(
+        self,
+        evaluator: Callable[[str], CoroutineType[Any, Any, Any]],  # pyright: ignore[reportExplicitAny]
+    ) -> None:
+        """Initialize new instance.
+
+        Args:
+            evaluator: async callback that calls evaluate in context of the browser.
+
+        """
+        self._accounts: dict[str, Account] | None = None
+        self._evaluator = evaluator
+
+    async def get_transactions(
+        self, accounts: list[str], start: date, end: date
+    ) -> list[Transaction]:
+        """Retrieve transactions for the logged in user.
+
+        Args:
+            accounts: list of Fidelity account numbers to retrieve.
+            start: start date, inclusive. Treated as midnight America/New_York.
+            end: end date, inclusive. Treated as midnight America/New_York.
+
+        Returns:
+            Transactions for accounts between [start, end].
+
+        Raises:
+            FidelityError: if there is any error retrieving the transactions.
+
+        """
+        acct_dict = {a: await self._get_account(a) for a in accounts}
+        missing = [a for a, acct in acct_dict.items() if acct is None]
+        if missing:
+            msg = f"Account(s) not found: {', '.join(missing)}"
+            raise FidelityError(msg)
+        accts = [a for a in acct_dict.values() if a is not None]
+
+        resp_json = await self._fetch(
+            "https://digital.fidelity.com/ftgw/digital/webactivity/api/graphql?ref_at=activity",
+            json.dumps(Fidelity.get_transactions_options(accts, start, end)),
+        )
+        try:
+            historys = GetTransactionsRespModel.model_validate(
+                resp_json
+            ).data.getTransactions.historys
+        except ValidationError as e:
+            msg = "Failed to parse get_transactions response"
+            raise FidelityError(msg) from e
+        return [Fidelity._history_entry_to_transaction(h) for h in historys]
+
+    async def get_accounts(self) -> list[Account]:
+        """Retrieve accounts for the logged in user.
+
+        Returns:
+            User's accounts.
+
+        Raises:
+            FidelityError: if there is any error retrieving the transactions.
+
+        """
+        return list((await self._get_accounts()).values())
+
+    @staticmethod
+    def get_transactions_options(
+        accounts: list[Account], start: date, end: date
+    ) -> dict[str, object]:
+        """Return the [options](https://developer.mozilla.org/en-US/docs/Web/API/Window/fetch#options) argument for calling fetch to get transactions.
+
+        Args:
+            accounts: list of Fidelity accounts to retrieve.
+            start: start date, inclusive. Treated as midnight America/New_York.
+            end: end date, inclusive. Treated as midnight America/New_York.
+
+        Returns:
+           JSON-compatible object options argument for fetch call.
+
+        """  # noqa: E501
+        context = {
+            "body": json.dumps(
+                Fidelity._get_transactions_body(accounts, start, end).model_dump_json()
+            )
+        }
+        return cast(
+            dict[str, object],
+            json.loads(
+                cast(
+                    str,
+                    pystache.render(  # pyright: ignore[reportUnknownMemberType]
+                        Fidelity._get_transactions_options_template(), context
+                    ),
+                )
+            ),
+        )
+
+    @staticmethod
+    def get_accounts_options() -> dict[str, object]:
+        """Return the <a href="https://developer.mozilla.org/en-US/docs/Web/API/Window/fetch#options" target="_blank">options</a> argument for calling fetch to get accounts.
+
+        Returns:
+           JSON-compatible object options argument for fetch call.
+
+        """  # noqa: E501
+        return cast(
+            dict[str, object],
+            json.loads(
+                files("fidelity_helper")
+                .joinpath("fidelity-templates/getAccountsOptions.json")
+                .read_text()
+            ),
+        )
+
+    _FIDELITY_ZONE = ZoneInfo("America/New_York")
+
+    @staticmethod
+    def fidelity_date(d: date) -> int:
+        """Convert date to epoch seconds in Fidelity time zone (America/New_York).
+
+        Arguments:
+            d(date): date to convert.
+
+        Returns:
+            Epoch seconds for d interpreted as America/New_York at midnight.
+
+        """
+        return int(
+            datetime.combine(
+                d, datetime.min.time(), Fidelity._FIDELITY_ZONE
+            ).timestamp()
+        )
+
+    @staticmethod
+    def encode_account_name(name: str) -> str:
+        """Encode name for use in Fidelity get transactions.
+
+        Args:
+            name: the plain-text name.
+
+        Returns:
+            The encoded name.
+
+        """
+        return base64.b64encode(name.encode("utf-8")).decode("ascii")
+
+    @staticmethod
+    def print_get_transactions_options(options: dict[str, object]) -> str:
+        """Human-friendly rendering of options used to get transactions.
+
+        Args:
+            options: JSON-compatible object for fetch options arg.
+
+        Returns:
+            Printable string with embedded JSON strings parsed into objects.
+
+        """
+        options_minus_body = cast(dict[str, object], json.loads(json.dumps(options)))
+        del options_minus_body["body"]
+        body = cast(dict[str, object], json.loads(cast(str, options["body"])))
+        body_minus_query = cast(dict[str, object], json.loads(json.dumps(body)))
+        del body_minus_query["query"]
+        query = cast(str, body["query"])
+        return "\n".join(
+            [
+                f"options_minus_body={json.dumps(options_minus_body, indent=2)}",
+                f"body_minus_query={json.dumps(body_minus_query, indent=2)}",
+                "query=" + query,
+            ]
+        )
+
+    async def _fetch(self, url: str, options_str: str) -> dict[str, object]:
+        fetch = f'fetch("{url}", {options_str})'
+        script = f"""
+        (async () => {{
+             const r = await {fetch};
+             if (!r.ok) {{
+                 return {{ status: r.status, text: await r.text() }}
+             }}
+             const json = await r.json()
+             return {{ status: r.status, json: json }};
+        }})()
+        """
+        resp = cast(_FetchResp, await self._evaluator(script))
+        if resp["status"] != HTTPStatus.OK:
+            msg = (
+                "get_transactions fetch failed, code: ",
+                f"{resp['status']}, text: {resp.get('text')}",
+            )
+            raise FidelityError(msg)
+        return resp["json"]
+
+    async def _get_account(self, account: str) -> Account | None:
+        return (await self._get_accounts()).get(account, None)
+
+    async def _get_accounts(self) -> dict[str, Account]:
+        if self._accounts is not None:
+            return self._accounts
+        self._accounts = await self._fetch_accounts()
+        return self._accounts
+
+    async def _fetch_accounts(self) -> dict[str, Account]:
+        resp_json = await self._fetch(
+            "https://digital.fidelity.com/ftgw/digital/portfolio/api/graphql?ref_at=portsum",
+            json.dumps(Fidelity.get_accounts_options()),
+        )
+        try:
+            resp = GetAccountsRespModel.model_validate(resp_json).data.getContext
+        except ValidationError as e:
+            msg = "Failed to parse get_accounts response"
+            raise FidelityError(msg) from e
+        status = resp.sysStatus.backend.account
+        if status.lower() != "ok":
+            msg = f"Fidelity backend not ok {status}"
+            raise FidelityError(msg)
+        accounts = [
+            Account(number=a.acctNum, name=a.preferenceDetail.name)
+            for a in resp.person.assets
+        ]
+        return {a.number: a for a in accounts}
+
+    @staticmethod
+    def _get_transactions_body(
+        accounts: list[Account], start: date, end: date
+    ) -> GetTransactionsReqModel:
+        account_dicts: list[dict[str, str | bool]] = [
+            {
+                "number": a.number,
+                "name": Fidelity.encode_account_name(a.name),
+                "last": i == len(accounts) - 1,
+            }
+            for i, a in enumerate(accounts)
+        ]
+        context = {
+            "accounts": account_dicts,
+            "start": str(Fidelity.fidelity_date(start)),
+            "end": str(Fidelity.fidelity_date(end)),
+        }
+        body = cast(
+            str,
+            pystache.render(Fidelity._get_transactions_body_template(), context),  # pyright: ignore[reportUnknownMemberType]
+        )
+        return GetTransactionsReqModel.model_validate_json(body)
+
+    @staticmethod
+    def _get_transactions_body_template() -> str:
+        return (
+            files("fidelity_helper")
+            .joinpath("fidelity-templates/getTransactionsBody.json.mustache")
+            .read_text()
+        )
+
+    @staticmethod
+    def _get_transactions_options_template() -> str:
+        return (
+            files("fidelity_helper")
+            .joinpath("fidelity-templates/getTransactionsOptions.json.mustache")
+            .read_text()
+        )
+
+    @staticmethod
+    def _history_entry_to_transaction(
+        h: GetTransactionsRespHistoryModel,
+    ) -> Transaction:
+        return Transaction(
+            acct_num=h.acctNum,
+            date=datetime.strptime(h.date, "%b-%d-%Y").date(),
+            description=h.description,
+            amount=round(float(re.sub(r"[,$]", r"", h.amount)), 2),
+            order_number=h.orderNumber,
+            pending=bool(h.intradayInd),
+        )
+
+
+class _FetchResp(TypedDict):
+    status: int
+    text: str
+    json: dict[str, Any]  # pyright: ignore[reportExplicitAny]

fidelity_helper-0.1.0/src/fidelity_helper/fidelity_models.py

@@ -0,0 +1,104 @@
+"""Fidelity request and response objects. Use with caution."""
+
+# ruff: noqa: N815  # mixed-case-variable-in-class-scope
+# ruff: noqa: D101  # Missing docstring in public class
+
+from pydantic import BaseModel, ConfigDict
+
+
+class AcctDetailModel(BaseModel):
+    acctNum: str
+    acctType: str
+    name: str
+
+
+class SearchCriteriaDetailModel(BaseModel):
+    timePeriod: int
+    txnCat: None
+    viewType: str
+    histSortDir: str
+    acctHistSort: str
+    hasBasketName: bool
+    txnFromDate: str
+    txnToDate: str
+
+
+class GetTransactionsReqVarsModel(BaseModel):
+    model_config = ConfigDict(extra="forbid", strict=True)
+    isNewOrderApi: bool
+    isSupportCrypto: bool
+    hideDCOrders: bool
+    acctIdList: str
+    acctDetailList: list[AcctDetailModel]
+    searchCriteriaDetail: SearchCriteriaDetailModel
+
+
+class GetTransactionsReqModel(BaseModel):
+    """Fidelity get_transactions request."""
+
+    model_config = ConfigDict(extra="forbid", strict=True)
+    operationName: str
+    variables: GetTransactionsReqVarsModel
+    query: str
+
+
+class GetTransactionsRespHistoryModel(BaseModel):
+    """Single transaction in Fidelity response to get_transactions."""
+
+    acctNum: str
+    amount: str
+    date: str
+    description: str
+    intradayInd: bool
+    orderNumber: str | None
+
+
+class GetTransactionsRespTransactionsModel(BaseModel):
+    historys: list[GetTransactionsRespHistoryModel]
+
+
+class GetTransactionsRespDataModel(BaseModel):
+    getTransactions: GetTransactionsRespTransactionsModel
+
+
+class GetTransactionsRespModel(BaseModel):
+    """Fidelity response to get_transactions."""
+
+    data: GetTransactionsRespDataModel
+
+
+class BackendStatusModel(BaseModel):
+    account: str
+
+
+class SysStatusModel(BaseModel):
+    backend: BackendStatusModel
+
+
+class PreferenceDetailModel(BaseModel):
+    name: str
+
+
+class GetAccountsRespAcctDetailModel(BaseModel):
+    acctNum: str
+    acctType: str
+    preferenceDetail: PreferenceDetailModel
+
+
+class PersonModel(BaseModel):
+    assets: list[GetAccountsRespAcctDetailModel]
+
+
+class GetAccountsContextModel(BaseModel):
+    sysStatus: SysStatusModel
+    person: PersonModel
+
+
+class GetAccountsRespDataModel(BaseModel):
+    getContext: GetAccountsContextModel
+
+
+class GetAccountsRespModel(BaseModel):
+    """Fidelity response to get_accounts."""
+
+    data: GetAccountsRespDataModel