finance_dev 0.9.0__py3-none-any.whl

finance_dev/models/getconfigwatchlistbyidop.py

@@ -0,0 +1,53 @@
+"""Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT."""
+# @generated-id: 11d4ad6c3315
+
+from __future__ import annotations
+from .httpmetadata import HTTPMetadata, HTTPMetadataTypedDict
+from .watchlist import Watchlist, WatchlistTypedDict
+from finance_dev.types import BaseModel, UNSET_SENTINEL
+from finance_dev.utils import FieldMetadata, PathParamMetadata
+import pydantic
+from pydantic import model_serializer
+from typing import Optional
+from typing_extensions import Annotated, NotRequired, TypedDict
+
+
+class GetConfigWatchlistByIDRequestTypedDict(TypedDict):
+    watchlist_id: int
+    r"""The numeric ID of the watchlist to retrieve. You can get this from a previous list/create/update response (the `id` field in the returned watchlist)."""
+
+
+class GetConfigWatchlistByIDRequest(BaseModel):
+    watchlist_id: Annotated[
+        int, FieldMetadata(path=PathParamMetadata(style="simple", explode=False))
+    ]
+    r"""The numeric ID of the watchlist to retrieve. You can get this from a previous list/create/update response (the `id` field in the returned watchlist)."""
+
+
+class GetConfigWatchlistByIDResponseTypedDict(TypedDict):
+    http_meta: HTTPMetadataTypedDict
+    watchlist: NotRequired[WatchlistTypedDict]
+    r"""The requested watchlist."""
+
+
+class GetConfigWatchlistByIDResponse(BaseModel):
+    http_meta: Annotated[Optional[HTTPMetadata], pydantic.Field(exclude=True)] = None
+
+    watchlist: Optional[Watchlist] = None
+    r"""The requested watchlist."""
+
+    @model_serializer(mode="wrap")
+    def serialize_model(self, handler):
+        optional_fields = set(["Watchlist"])
+        serialized = handler(self)
+        m = {}
+
+        for n, f in type(self).model_fields.items():
+            k = f.alias or n
+            val = serialized.get(k, serialized.get(n))
+
+            if val != UNSET_SENTINEL:
+                if val is not None or k not in optional_fields:
+                    m[k] = val
+
+        return m

finance_dev/models/getconfigwatchlistsop.py

@@ -0,0 +1,40 @@
+"""Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT."""
+# @generated-id: 412df3b371f1
+
+from __future__ import annotations
+from .httpmetadata import HTTPMetadata, HTTPMetadataTypedDict
+from .watchlistresponse import WatchlistResponse, WatchlistResponseTypedDict
+from finance_dev.types import BaseModel, UNSET_SENTINEL
+import pydantic
+from pydantic import model_serializer
+from typing import Optional
+from typing_extensions import Annotated, NotRequired, TypedDict
+
+
+class GetConfigWatchlistsResponseTypedDict(TypedDict):
+    http_meta: HTTPMetadataTypedDict
+    watchlist_response: NotRequired[WatchlistResponseTypedDict]
+    r"""The authenticated user's watchlists."""
+
+
+class GetConfigWatchlistsResponse(BaseModel):
+    http_meta: Annotated[Optional[HTTPMetadata], pydantic.Field(exclude=True)] = None
+
+    watchlist_response: Optional[WatchlistResponse] = None
+    r"""The authenticated user's watchlists."""
+
+    @model_serializer(mode="wrap")
+    def serialize_model(self, handler):
+        optional_fields = set(["WatchlistResponse"])
+        serialized = handler(self)
+        m = {}
+
+        for n, f in type(self).model_fields.items():
+            k = f.alias or n
+            val = serialized.get(k, serialized.get(n))
+
+            if val != UNSET_SENTINEL:
+                if val is not None or k not in optional_fields:
+                    m[k] = val
+
+        return m

finance_dev/models/getcongressionaltradingop.py

@@ -0,0 +1,73 @@
+"""Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT."""
+# @generated-id: 37517cca6619
+
+from __future__ import annotations
+from .congressionaltradingresponse import (
+    CongressionalTradingResponse,
+    CongressionalTradingResponseTypedDict,
+)
+from .httpmetadata import HTTPMetadata, HTTPMetadataTypedDict
+from datetime import date
+from finance_dev.types import BaseModel, UNSET_SENTINEL
+from finance_dev.utils import FieldMetadata, QueryParamMetadata
+import pydantic
+from pydantic import model_serializer
+from typing import Optional
+from typing_extensions import Annotated, NotRequired, TypedDict
+
+
+class GetCongressionalTradingRequestTypedDict(TypedDict):
+    symbol: str
+    r"""Stock ticker to query. Send the plain uppercase symbol exactly as you'd type it on a brokerage screen, e.g. `AAPL`, `MSFT`."""
+    from_: date
+    r"""Start of the date window, inclusive. Format: `YYYY-MM-DD` (e.g. `2024-01-01`)."""
+    to: date
+    r"""End of the date window, inclusive. Format: `YYYY-MM-DD` (e.g. `2024-12-31`)."""
+
+
+class GetCongressionalTradingRequest(BaseModel):
+    symbol: Annotated[
+        str, FieldMetadata(query=QueryParamMetadata(style="form", explode=True))
+    ]
+    r"""Stock ticker to query. Send the plain uppercase symbol exactly as you'd type it on a brokerage screen, e.g. `AAPL`, `MSFT`."""
+
+    from_: Annotated[
+        date,
+        pydantic.Field(alias="from"),
+        FieldMetadata(query=QueryParamMetadata(style="form", explode=True)),
+    ]
+    r"""Start of the date window, inclusive. Format: `YYYY-MM-DD` (e.g. `2024-01-01`)."""
+
+    to: Annotated[
+        date, FieldMetadata(query=QueryParamMetadata(style="form", explode=True))
+    ]
+    r"""End of the date window, inclusive. Format: `YYYY-MM-DD` (e.g. `2024-12-31`)."""
+
+
+class GetCongressionalTradingResponseTypedDict(TypedDict):
+    http_meta: HTTPMetadataTypedDict
+    congressional_trading_response: NotRequired[CongressionalTradingResponseTypedDict]
+    r"""Congressional trading data."""
+
+
+class GetCongressionalTradingResponse(BaseModel):
+    http_meta: Annotated[Optional[HTTPMetadata], pydantic.Field(exclude=True)] = None
+
+    congressional_trading_response: Optional[CongressionalTradingResponse] = None
+    r"""Congressional trading data."""
+
+    @model_serializer(mode="wrap")
+    def serialize_model(self, handler):
+        optional_fields = set(["CongressionalTradingResponse"])
+        serialized = handler(self)
+        m = {}
+
+        for n, f in type(self).model_fields.items():
+            k = f.alias or n
+            val = serialized.get(k, serialized.get(n))
+
+            if val != UNSET_SENTINEL:
+                if val is not None or k not in optional_fields:
+                    m[k] = val
+
+        return m

finance_dev/models/getcovid19uscasesop.py

@@ -0,0 +1,43 @@
+"""Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT."""
+# @generated-id: 6776ce12b20b
+
+from __future__ import annotations
+from .covid19uscasesresponse import (
+    Covid19UsCasesResponse,
+    Covid19UsCasesResponseTypedDict,
+)
+from .httpmetadata import HTTPMetadata, HTTPMetadataTypedDict
+from finance_dev.types import BaseModel, UNSET_SENTINEL
+import pydantic
+from pydantic import model_serializer
+from typing import Optional
+from typing_extensions import Annotated, NotRequired, TypedDict
+
+
+class GetCovid19UsCasesResponseTypedDict(TypedDict):
+    http_meta: HTTPMetadataTypedDict
+    covid19_us_cases_response: NotRequired[Covid19UsCasesResponseTypedDict]
+    r"""COVID-19 US data."""
+
+
+class GetCovid19UsCasesResponse(BaseModel):
+    http_meta: Annotated[Optional[HTTPMetadata], pydantic.Field(exclude=True)] = None
+
+    covid19_us_cases_response: Optional[Covid19UsCasesResponse] = None
+    r"""COVID-19 US data."""
+
+    @model_serializer(mode="wrap")
+    def serialize_model(self, handler):
+        optional_fields = set(["Covid19UsCasesResponse"])
+        serialized = handler(self)
+        m = {}
+
+        for n, f in type(self).model_fields.items():
+            k = f.alias or n
+            val = serialized.get(k, serialized.get(n))
+
+            if val != UNSET_SENTINEL:
+                if val is not None or k not in optional_fields:
+                    m[k] = val
+
+        return m

finance_dev/models/getdailymarketsummaryop.py

@@ -0,0 +1,92 @@
+"""Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT."""
+# @generated-id: 0817b92a2360
+
+from __future__ import annotations
+from .dailymarketsummaryresponse import (
+    DailyMarketSummaryResponse,
+    DailyMarketSummaryResponseTypedDict,
+)
+from .httpmetadata import HTTPMetadata, HTTPMetadataTypedDict
+from datetime import date
+from finance_dev.types import BaseModel, UNSET_SENTINEL
+from finance_dev.utils import FieldMetadata, QueryParamMetadata
+import pydantic
+from pydantic import model_serializer
+from typing import Optional
+from typing_extensions import Annotated, NotRequired, TypedDict
+
+
+class GetDailyMarketSummaryRequestTypedDict(TypedDict):
+    date_: date
+    r"""Date in YYYY-MM-DD format. Enter the specific calendar date you want to query."""
+    adjusted: NotRequired[bool]
+    r"""Whether to adjust historical prices for stock splits. Use true for normalized charting and false for raw market data."""
+    include_otc: NotRequired[bool]
+    r"""Whether to include over-the-counter securities. Use true only when your product needs OTC market coverage."""
+
+
+class GetDailyMarketSummaryRequest(BaseModel):
+    date_: Annotated[
+        date,
+        pydantic.Field(alias="date"),
+        FieldMetadata(query=QueryParamMetadata(style="form", explode=True)),
+    ]
+    r"""Date in YYYY-MM-DD format. Enter the specific calendar date you want to query."""
+
+    adjusted: Annotated[
+        Optional[bool],
+        FieldMetadata(query=QueryParamMetadata(style="form", explode=True)),
+    ] = None
+    r"""Whether to adjust historical prices for stock splits. Use true for normalized charting and false for raw market data."""
+
+    include_otc: Annotated[
+        Optional[bool],
+        pydantic.Field(alias="includeOtc"),
+        FieldMetadata(query=QueryParamMetadata(style="form", explode=True)),
+    ] = None
+    r"""Whether to include over-the-counter securities. Use true only when your product needs OTC market coverage."""
+
+    @model_serializer(mode="wrap")
+    def serialize_model(self, handler):
+        optional_fields = set(["adjusted", "includeOtc"])
+        serialized = handler(self)
+        m = {}
+
+        for n, f in type(self).model_fields.items():
+            k = f.alias or n
+            val = serialized.get(k, serialized.get(n))
+
+            if val != UNSET_SENTINEL:
+                if val is not None or k not in optional_fields:
+                    m[k] = val
+
+        return m
+
+
+class GetDailyMarketSummaryResponseTypedDict(TypedDict):
+    http_meta: HTTPMetadataTypedDict
+    daily_market_summary_response: NotRequired[DailyMarketSummaryResponseTypedDict]
+    r"""Successful response"""
+
+
+class GetDailyMarketSummaryResponse(BaseModel):
+    http_meta: Annotated[Optional[HTTPMetadata], pydantic.Field(exclude=True)] = None
+
+    daily_market_summary_response: Optional[DailyMarketSummaryResponse] = None
+    r"""Successful response"""
+
+    @model_serializer(mode="wrap")
+    def serialize_model(self, handler):
+        optional_fields = set(["DailyMarketSummaryResponse"])
+        serialized = handler(self)
+        m = {}
+
+        for n, f in type(self).model_fields.items():
+            k = f.alias or n
+            val = serialized.get(k, serialized.get(n))
+
+            if val != UNSET_SENTINEL:
+                if val is not None or k not in optional_fields:
+                    m[k] = val
+
+        return m

finance_dev/models/getdividendsop.py

@@ -0,0 +1,294 @@
+"""Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT."""
+# @generated-id: a96540b0eca8
+
+from __future__ import annotations
+from .dividendsresponse import DividendsResponse, DividendsResponseTypedDict
+from .httpmetadata import HTTPMetadata, HTTPMetadataTypedDict
+from datetime import date
+from enum import Enum
+from finance_dev import models, utils
+from finance_dev.types import BaseModel, UNSET_SENTINEL
+from finance_dev.utils import FieldMetadata, QueryParamMetadata
+import pydantic
+from pydantic import field_serializer, model_serializer
+from typing import Callable, Optional
+from typing_extensions import Annotated, NotRequired, TypedDict
+
+
+class DistributionType(str, Enum, metaclass=utils.OpenEnumMeta):
+    r"""Exact type: recurring, special, supplemental, irregular, unknown"""
+
+    RECURRING = "recurring"
+    SPECIAL = "special"
+    SUPPLEMENTAL = "supplemental"
+    IRREGULAR = "irregular"
+    UNKNOWN = "unknown"
+
+
+class GetDividendsRequestTypedDict(TypedDict):
+    ticker: NotRequired[str]
+    r"""Single ticker symbol only, such as AAPL. Do not send a comma-separated list here; if you need multiple symbols, use `tickersAnyOf` instead."""
+    tickers_any_of: NotRequired[str]
+    r"""Comma-separated list of ticker symbols."""
+    ticker_from: NotRequired[str]
+    r"""Filter tickers >= this value (inclusive)"""
+    ticker_after: NotRequired[str]
+    r"""Filter tickers > this value (exclusive)"""
+    ticker_to: NotRequired[str]
+    r"""Filter tickers <= this value (inclusive)"""
+    ticker_before: NotRequired[str]
+    r"""Filter tickers < this value (exclusive)"""
+    ex_dividend_date: NotRequired[date]
+    r"""Exact ex-dividend date in YYYY-MM-DD format"""
+    ex_dividend_date_from: NotRequired[date]
+    r"""Ex-dividend start-date filter. Returns dividends with ex-dividend dates on or after this date."""
+    ex_dividend_date_after: NotRequired[date]
+    r"""Ex-dividend after-date filter. Returns dividends after this date, excluding the date itself."""
+    ex_dividend_date_to: NotRequired[date]
+    r"""Ex-dividend end-date filter. Returns dividends with ex-dividend dates on or before this date."""
+    ex_dividend_date_before: NotRequired[date]
+    r"""Ex-dividend before-date filter. Returns dividends before this date, excluding the date itself."""
+    frequency: NotRequired[int]
+    r"""Exact frequency (0=irregular, 1=annual, 4=quarterly, 12=monthly)"""
+    frequency_min: NotRequired[int]
+    r"""Dividend frequency lower-bound filter. Returns records with frequency greater than or equal to this value."""
+    frequency_above: NotRequired[int]
+    r"""Dividend frequency lower-bound filter. Returns records above this value, excluding the value itself."""
+    frequency_max: NotRequired[int]
+    r"""Dividend frequency upper-bound filter. Returns records with frequency less than or equal to this value."""
+    frequency_below: NotRequired[int]
+    r"""Dividend frequency upper-bound filter. Returns records below this value, excluding the value itself."""
+    distribution_type: NotRequired[DistributionType]
+    r"""Exact type: recurring, special, supplemental, irregular, unknown"""
+    distribution_types: NotRequired[str]
+    r"""Comma-separated list of distribution types"""
+    limit: NotRequired[int]
+    r"""Maximum number of results to return. Use smaller values for UI pages and larger values for exports within API limits. (1-5000)"""
+    sort: NotRequired[str]
+    r"""A comma-separated list of sort columns. For each column, append `.asc` or `.desc` to specify direction. Defaults to `ticker.asc` when not specified. Examples: `ticker.asc`, `ex_dividend_date.desc`, or `ticker.asc,ex_dividend_date.desc`."""
+    next: NotRequired[str]
+    r"""Pagination cursor from the previous response. Omit it on the first request, then send the returned cursor to fetch the next page."""
+
+
+class GetDividendsRequest(BaseModel):
+    ticker: Annotated[
+        Optional[str],
+        FieldMetadata(query=QueryParamMetadata(style="form", explode=True)),
+    ] = None
+    r"""Single ticker symbol only, such as AAPL. Do not send a comma-separated list here; if you need multiple symbols, use `tickersAnyOf` instead."""
+
+    tickers_any_of: Annotated[
+        Optional[str],
+        pydantic.Field(alias="tickersAnyOf"),
+        FieldMetadata(query=QueryParamMetadata(style="form", explode=True)),
+    ] = None
+    r"""Comma-separated list of ticker symbols."""
+
+    ticker_from: Annotated[
+        Optional[str],
+        pydantic.Field(alias="tickerFrom"),
+        FieldMetadata(query=QueryParamMetadata(style="form", explode=True)),
+    ] = None
+    r"""Filter tickers >= this value (inclusive)"""
+
+    ticker_after: Annotated[
+        Optional[str],
+        pydantic.Field(alias="tickerAfter"),
+        FieldMetadata(query=QueryParamMetadata(style="form", explode=True)),
+    ] = None
+    r"""Filter tickers > this value (exclusive)"""
+
+    ticker_to: Annotated[
+        Optional[str],
+        pydantic.Field(alias="tickerTo"),
+        FieldMetadata(query=QueryParamMetadata(style="form", explode=True)),
+    ] = None
+    r"""Filter tickers <= this value (inclusive)"""
+
+    ticker_before: Annotated[
+        Optional[str],
+        pydantic.Field(alias="tickerBefore"),
+        FieldMetadata(query=QueryParamMetadata(style="form", explode=True)),
+    ] = None
+    r"""Filter tickers < this value (exclusive)"""
+
+    ex_dividend_date: Annotated[
+        Optional[date],
+        pydantic.Field(alias="exDividendDate"),
+        FieldMetadata(query=QueryParamMetadata(style="form", explode=True)),
+    ] = None
+    r"""Exact ex-dividend date in YYYY-MM-DD format"""
+
+    ex_dividend_date_from: Annotated[
+        Optional[date],
+        pydantic.Field(alias="exDividendDateFrom"),
+        FieldMetadata(query=QueryParamMetadata(style="form", explode=True)),
+    ] = None
+    r"""Ex-dividend start-date filter. Returns dividends with ex-dividend dates on or after this date."""
+
+    ex_dividend_date_after: Annotated[
+        Optional[date],
+        pydantic.Field(alias="exDividendDateAfter"),
+        FieldMetadata(query=QueryParamMetadata(style="form", explode=True)),
+    ] = None
+    r"""Ex-dividend after-date filter. Returns dividends after this date, excluding the date itself."""
+
+    ex_dividend_date_to: Annotated[
+        Optional[date],
+        pydantic.Field(alias="exDividendDateTo"),
+        FieldMetadata(query=QueryParamMetadata(style="form", explode=True)),
+    ] = None
+    r"""Ex-dividend end-date filter. Returns dividends with ex-dividend dates on or before this date."""
+
+    ex_dividend_date_before: Annotated[
+        Optional[date],
+        pydantic.Field(alias="exDividendDateBefore"),
+        FieldMetadata(query=QueryParamMetadata(style="form", explode=True)),
+    ] = None
+    r"""Ex-dividend before-date filter. Returns dividends before this date, excluding the date itself."""
+
+    frequency: Annotated[
+        Optional[int],
+        FieldMetadata(query=QueryParamMetadata(style="form", explode=True)),
+    ] = None
+    r"""Exact frequency (0=irregular, 1=annual, 4=quarterly, 12=monthly)"""
+
+    frequency_min: Annotated[
+        Optional[int],
+        pydantic.Field(alias="frequencyMin"),
+        FieldMetadata(query=QueryParamMetadata(style="form", explode=True)),
+    ] = None
+    r"""Dividend frequency lower-bound filter. Returns records with frequency greater than or equal to this value."""
+
+    frequency_above: Annotated[
+        Optional[int],
+        pydantic.Field(alias="frequencyAbove"),
+        FieldMetadata(query=QueryParamMetadata(style="form", explode=True)),
+    ] = None
+    r"""Dividend frequency lower-bound filter. Returns records above this value, excluding the value itself."""
+
+    frequency_max: Annotated[
+        Optional[int],
+        pydantic.Field(alias="frequencyMax"),
+        FieldMetadata(query=QueryParamMetadata(style="form", explode=True)),
+    ] = None
+    r"""Dividend frequency upper-bound filter. Returns records with frequency less than or equal to this value."""
+
+    frequency_below: Annotated[
+        Optional[int],
+        pydantic.Field(alias="frequencyBelow"),
+        FieldMetadata(query=QueryParamMetadata(style="form", explode=True)),
+    ] = None
+    r"""Dividend frequency upper-bound filter. Returns records below this value, excluding the value itself."""
+
+    distribution_type: Annotated[
+        Optional[DistributionType],
+        pydantic.Field(alias="distributionType"),
+        FieldMetadata(query=QueryParamMetadata(style="form", explode=True)),
+    ] = None
+    r"""Exact type: recurring, special, supplemental, irregular, unknown"""
+
+    distribution_types: Annotated[
+        Optional[str],
+        pydantic.Field(alias="distributionTypes"),
+        FieldMetadata(query=QueryParamMetadata(style="form", explode=True)),
+    ] = None
+    r"""Comma-separated list of distribution types"""
+
+    limit: Annotated[
+        Optional[int],
+        FieldMetadata(query=QueryParamMetadata(style="form", explode=True)),
+    ] = None
+    r"""Maximum number of results to return. Use smaller values for UI pages and larger values for exports within API limits. (1-5000)"""
+
+    sort: Annotated[
+        Optional[str],
+        FieldMetadata(query=QueryParamMetadata(style="form", explode=True)),
+    ] = None
+    r"""A comma-separated list of sort columns. For each column, append `.asc` or `.desc` to specify direction. Defaults to `ticker.asc` when not specified. Examples: `ticker.asc`, `ex_dividend_date.desc`, or `ticker.asc,ex_dividend_date.desc`."""
+
+    next: Annotated[
+        Optional[str],
+        FieldMetadata(query=QueryParamMetadata(style="form", explode=True)),
+    ] = None
+    r"""Pagination cursor from the previous response. Omit it on the first request, then send the returned cursor to fetch the next page."""
+
+    @field_serializer("distribution_type")
+    def serialize_distribution_type(self, value):
+        if isinstance(value, str):
+            try:
+                return models.DistributionType(value)
+            except ValueError:
+                return value
+        return value
+
+    @model_serializer(mode="wrap")
+    def serialize_model(self, handler):
+        optional_fields = set(
+            [
+                "ticker",
+                "tickersAnyOf",
+                "tickerFrom",
+                "tickerAfter",
+                "tickerTo",
+                "tickerBefore",
+                "exDividendDate",
+                "exDividendDateFrom",
+                "exDividendDateAfter",
+                "exDividendDateTo",
+                "exDividendDateBefore",
+                "frequency",
+                "frequencyMin",
+                "frequencyAbove",
+                "frequencyMax",
+                "frequencyBelow",
+                "distributionType",
+                "distributionTypes",
+                "limit",
+                "sort",
+                "next",
+            ]
+        )
+        serialized = handler(self)
+        m = {}
+
+        for n, f in type(self).model_fields.items():
+            k = f.alias or n
+            val = serialized.get(k, serialized.get(n))
+
+            if val != UNSET_SENTINEL:
+                if val is not None or k not in optional_fields:
+                    m[k] = val
+
+        return m
+
+
+class GetDividendsResponseTypedDict(TypedDict):
+    http_meta: HTTPMetadataTypedDict
+    dividends_response: NotRequired[DividendsResponseTypedDict]
+    r"""Dividends data."""
+
+
+class GetDividendsResponse(BaseModel):
+    next: Callable[[], Optional[GetDividendsResponse]]
+
+    http_meta: Annotated[Optional[HTTPMetadata], pydantic.Field(exclude=True)] = None
+
+    dividends_response: Optional[DividendsResponse] = None
+    r"""Dividends data."""
+
+    @model_serializer(mode="wrap")
+    def serialize_model(self, handler):
+        optional_fields = set(["DividendsResponse"])
+        serialized = handler(self)
+        m = {}
+
+        for n, f in type(self).model_fields.items():
+            k = f.alias or n
+            val = serialized.get(k, serialized.get(n))
+
+            if val != UNSET_SENTINEL:
+                if val is not None or k not in optional_fields:
+                    m[k] = val
+
+        return m

finance_dev/models/getearningscalendarop.py

@@ -0,0 +1,87 @@
+"""Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT."""
+# @generated-id: 00625a320be1
+
+from __future__ import annotations
+from .earningrelease import EarningRelease, EarningReleaseTypedDict
+from .httpmetadata import HTTPMetadata, HTTPMetadataTypedDict
+from datetime import date
+from finance_dev.types import BaseModel, UNSET_SENTINEL
+from finance_dev.utils import FieldMetadata, QueryParamMetadata
+import pydantic
+from pydantic import model_serializer
+from typing import List, Optional
+from typing_extensions import Annotated, NotRequired, TypedDict
+
+
+class GetEarningsCalendarRequestTypedDict(TypedDict):
+    from_: date
+    r"""Start date in YYYY-MM-DD format. Enter the first date to include in the research window."""
+    to: date
+    r"""End date in YYYY-MM-DD format. Enter the last date to include in the research window."""
+    symbol: NotRequired[str]
+    r"""Optional stock symbol to filter results. If not provided, returns earnings for all symbols."""
+
+
+class GetEarningsCalendarRequest(BaseModel):
+    from_: Annotated[
+        date,
+        pydantic.Field(alias="from"),
+        FieldMetadata(query=QueryParamMetadata(style="form", explode=True)),
+    ]
+    r"""Start date in YYYY-MM-DD format. Enter the first date to include in the research window."""
+
+    to: Annotated[
+        date, FieldMetadata(query=QueryParamMetadata(style="form", explode=True))
+    ]
+    r"""End date in YYYY-MM-DD format. Enter the last date to include in the research window."""
+
+    symbol: Annotated[
+        Optional[str],
+        FieldMetadata(query=QueryParamMetadata(style="form", explode=True)),
+    ] = None
+    r"""Optional stock symbol to filter results. If not provided, returns earnings for all symbols."""
+
+    @model_serializer(mode="wrap")
+    def serialize_model(self, handler):
+        optional_fields = set(["symbol"])
+        serialized = handler(self)
+        m = {}
+
+        for n, f in type(self).model_fields.items():
+            k = f.alias or n
+            val = serialized.get(k, serialized.get(n))
+
+            if val != UNSET_SENTINEL:
+                if val is not None or k not in optional_fields:
+                    m[k] = val
+
+        return m
+
+
+class GetEarningsCalendarResponseTypedDict(TypedDict):
+    http_meta: HTTPMetadataTypedDict
+    get_earnings_calendar_response: NotRequired[List[EarningReleaseTypedDict]]
+    r"""Earnings calendar data retrieved successfully"""
+
+
+class GetEarningsCalendarResponse(BaseModel):
+    http_meta: Annotated[Optional[HTTPMetadata], pydantic.Field(exclude=True)] = None
+
+    get_earnings_calendar_response: Optional[List[EarningRelease]] = None
+    r"""Earnings calendar data retrieved successfully"""
+
+    @model_serializer(mode="wrap")
+    def serialize_model(self, handler):
+        optional_fields = set(["GetEarningsCalendarResponse"])
+        serialized = handler(self)
+        m = {}
+
+        for n, f in type(self).model_fields.items():
+            k = f.alias or n
+            val = serialized.get(k, serialized.get(n))
+
+            if val != UNSET_SENTINEL:
+                if val is not None or k not in optional_fields:
+                    m[k] = val
+
+        return m