finance_dev 0.9.0__py3-none-any.whl

finance_dev/models/gettoplosersop.py

@@ -0,0 +1,78 @@
+"""Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT."""
+# @generated-id: 753a97b98b48
+
+from __future__ import annotations
+from .httpmetadata import HTTPMetadata, HTTPMetadataTypedDict
+from .symboldetails import SymbolDetails, SymbolDetailsTypedDict
+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 GetTopLosersRequestTypedDict(TypedDict):
+    limit: NotRequired[int]
+    r"""Maximum number of results to return. Use smaller values for UI pages and larger values for exports within API limits. (optional, default 10)"""
+    size: NotRequired[int]
+    r"""Alias for limit. Ignored when limit is supplied."""
+
+
+class GetTopLosersRequest(BaseModel):
+    limit: Annotated[
+        Optional[int],
+        FieldMetadata(query=QueryParamMetadata(style="form", explode=True)),
+    ] = 10
+    r"""Maximum number of results to return. Use smaller values for UI pages and larger values for exports within API limits. (optional, default 10)"""
+
+    size: Annotated[
+        Optional[int],
+        FieldMetadata(query=QueryParamMetadata(style="form", explode=True)),
+    ] = 10
+    r"""Alias for limit. Ignored when limit is supplied."""
+
+    @model_serializer(mode="wrap")
+    def serialize_model(self, handler):
+        optional_fields = set(["limit", "size"])
+        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 GetTopLosersResponseTypedDict(TypedDict):
+    http_meta: HTTPMetadataTypedDict
+    symbol_details: NotRequired[List[SymbolDetailsTypedDict]]
+    r"""Top losing stocks retrieved successfully"""
+
+
+class GetTopLosersResponse(BaseModel):
+    http_meta: Annotated[Optional[HTTPMetadata], pydantic.Field(exclude=True)] = None
+
+    symbol_details: Optional[List[SymbolDetails]] = None
+    r"""Top losing stocks retrieved successfully"""
+
+    @model_serializer(mode="wrap")
+    def serialize_model(self, handler):
+        optional_fields = set(["SymbolDetails"])
+        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/gettopmostactiveop.py

@@ -0,0 +1,78 @@
+"""Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT."""
+# @generated-id: 5b0fae8f94a9
+
+from __future__ import annotations
+from .httpmetadata import HTTPMetadata, HTTPMetadataTypedDict
+from .symboldetails import SymbolDetails, SymbolDetailsTypedDict
+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 GetTopMostActiveRequestTypedDict(TypedDict):
+    limit: NotRequired[int]
+    r"""Maximum number of results to return. Use smaller values for UI pages and larger values for exports within API limits. (optional, default 10)"""
+    size: NotRequired[int]
+    r"""Alias for limit. Ignored when limit is supplied."""
+
+
+class GetTopMostActiveRequest(BaseModel):
+    limit: Annotated[
+        Optional[int],
+        FieldMetadata(query=QueryParamMetadata(style="form", explode=True)),
+    ] = 10
+    r"""Maximum number of results to return. Use smaller values for UI pages and larger values for exports within API limits. (optional, default 10)"""
+
+    size: Annotated[
+        Optional[int],
+        FieldMetadata(query=QueryParamMetadata(style="form", explode=True)),
+    ] = 10
+    r"""Alias for limit. Ignored when limit is supplied."""
+
+    @model_serializer(mode="wrap")
+    def serialize_model(self, handler):
+        optional_fields = set(["limit", "size"])
+        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 GetTopMostActiveResponseTypedDict(TypedDict):
+    http_meta: HTTPMetadataTypedDict
+    symbol_details: NotRequired[List[SymbolDetailsTypedDict]]
+    r"""Most active stocks retrieved successfully"""
+
+
+class GetTopMostActiveResponse(BaseModel):
+    http_meta: Annotated[Optional[HTTPMetadata], pydantic.Field(exclude=True)] = None
+
+    symbol_details: Optional[List[SymbolDetails]] = None
+    r"""Most active stocks retrieved successfully"""
+
+    @model_serializer(mode="wrap")
+    def serialize_model(self, handler):
+        optional_fields = set(["SymbolDetails"])
+        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/gettranscriptop.py

@@ -0,0 +1,53 @@
+"""Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT."""
+# @generated-id: cc6c1aac3af7
+
+from __future__ import annotations
+from .httpmetadata import HTTPMetadata, HTTPMetadataTypedDict
+from .transcriptresponse import TranscriptResponse, TranscriptResponseTypedDict
+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 GetTranscriptRequestTypedDict(TypedDict):
+    id: str
+    r"""Unique identifier for an earnings-call transcript. Obtain it from `/v1/stock/transcripts/list` for the symbol you want."""
+
+
+class GetTranscriptRequest(BaseModel):
+    id: Annotated[
+        str, FieldMetadata(query=QueryParamMetadata(style="form", explode=True))
+    ]
+    r"""Unique identifier for an earnings-call transcript. Obtain it from `/v1/stock/transcripts/list` for the symbol you want."""
+
+
+class GetTranscriptResponseTypedDict(TypedDict):
+    http_meta: HTTPMetadataTypedDict
+    transcript_response: NotRequired[TranscriptResponseTypedDict]
+    r"""Transcript content."""
+
+
+class GetTranscriptResponse(BaseModel):
+    http_meta: Annotated[Optional[HTTPMetadata], pydantic.Field(exclude=True)] = None
+
+    transcript_response: Optional[TranscriptResponse] = None
+    r"""Transcript content."""
+
+    @model_serializer(mode="wrap")
+    def serialize_model(self, handler):
+        optional_fields = set(["TranscriptResponse"])
+        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/gettreasuryyieldsop.py

@@ -0,0 +1,157 @@
+"""Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT."""
+# @generated-id: a77474b299e0
+
+from __future__ import annotations
+from .httpmetadata import HTTPMetadata, HTTPMetadataTypedDict
+from .treasuryyieldsresponse import (
+    TreasuryYieldsResponse,
+    TreasuryYieldsResponseTypedDict,
+)
+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 Callable, Optional
+from typing_extensions import Annotated, NotRequired, TypedDict
+
+
+class GetTreasuryYieldsRequestTypedDict(TypedDict):
+    date_: NotRequired[date]
+    r"""Exact date in YYYY-MM-DD format. Use this when you want one specific calendar day."""
+    dates: NotRequired[str]
+    r"""Comma-separated list of dates in YYYY-MM-DD format. Use this when you want several specific dates in one request."""
+    date_from: NotRequired[date]
+    r"""Start-date filter. Returns records on or after this date."""
+    date_to: NotRequired[date]
+    r"""End-date filter. Returns records on or before this date."""
+    date_after: NotRequired[date]
+    r"""After-date filter. Returns records after this date, excluding the date itself."""
+    date_before: NotRequired[date]
+    r"""Before-date filter. Returns records before this date, excluding the date itself."""
+    limit: NotRequired[int]
+    r"""Maximum number of results to return. Use smaller values for UI pages and larger values for exports within API limits."""
+    sort: NotRequired[str]
+    r"""A comma-separated list of sort columns. For each column, append `.asc` or `.desc` to specify direction. Massive documents this family with date-based sorting; use provider-supported column names in the text box."""
+    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 GetTreasuryYieldsRequest(BaseModel):
+    date_: Annotated[
+        Optional[date],
+        pydantic.Field(alias="date"),
+        FieldMetadata(query=QueryParamMetadata(style="form", explode=True)),
+    ] = None
+    r"""Exact date in YYYY-MM-DD format. Use this when you want one specific calendar day."""
+
+    dates: Annotated[
+        Optional[str],
+        FieldMetadata(query=QueryParamMetadata(style="form", explode=True)),
+    ] = None
+    r"""Comma-separated list of dates in YYYY-MM-DD format. Use this when you want several specific dates in one request."""
+
+    date_from: Annotated[
+        Optional[date],
+        pydantic.Field(alias="dateFrom"),
+        FieldMetadata(query=QueryParamMetadata(style="form", explode=True)),
+    ] = None
+    r"""Start-date filter. Returns records on or after this date."""
+
+    date_to: Annotated[
+        Optional[date],
+        pydantic.Field(alias="dateTo"),
+        FieldMetadata(query=QueryParamMetadata(style="form", explode=True)),
+    ] = None
+    r"""End-date filter. Returns records on or before this date."""
+
+    date_after: Annotated[
+        Optional[date],
+        pydantic.Field(alias="dateAfter"),
+        FieldMetadata(query=QueryParamMetadata(style="form", explode=True)),
+    ] = None
+    r"""After-date filter. Returns records after this date, excluding the date itself."""
+
+    date_before: Annotated[
+        Optional[date],
+        pydantic.Field(alias="dateBefore"),
+        FieldMetadata(query=QueryParamMetadata(style="form", explode=True)),
+    ] = None
+    r"""Before-date filter. Returns records before this date, excluding the date itself."""
+
+    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."""
+
+    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. Massive documents this family with date-based sorting; use provider-supported column names in the text box."""
+
+    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."""
+
+    @model_serializer(mode="wrap")
+    def serialize_model(self, handler):
+        optional_fields = set(
+            [
+                "date",
+                "dates",
+                "dateFrom",
+                "dateTo",
+                "dateAfter",
+                "dateBefore",
+                "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 GetTreasuryYieldsResponseTypedDict(TypedDict):
+    http_meta: HTTPMetadataTypedDict
+    treasury_yields_response: NotRequired[TreasuryYieldsResponseTypedDict]
+    r"""Successful response"""
+
+
+class GetTreasuryYieldsResponse(BaseModel):
+    next: Callable[[], Optional[GetTreasuryYieldsResponse]]
+
+    http_meta: Annotated[Optional[HTTPMetadata], pydantic.Field(exclude=True)] = None
+
+    treasury_yields_response: Optional[TreasuryYieldsResponse] = None
+    r"""Successful response"""
+
+    @model_serializer(mode="wrap")
+    def serialize_model(self, handler):
+        optional_fields = set(["TreasuryYieldsResponse"])
+        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/getunifiedsnapshotop.py

@@ -0,0 +1,223 @@
+"""Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT."""
+# @generated-id: 74e82d45ca0e
+
+from __future__ import annotations
+from .httpmetadata import HTTPMetadata, HTTPMetadataTypedDict
+from .unifiedsnapshotresponse import (
+    UnifiedSnapshotResponse,
+    UnifiedSnapshotResponseTypedDict,
+)
+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 GetUnifiedSnapshotType(str, Enum, metaclass=utils.OpenEnumMeta):
+    r"""Asset class filter for unified snapshot."""
+
+    STOCKS = "stocks"
+    OPTIONS = "options"
+    FX = "fx"
+    CRYPTO = "crypto"
+    INDICES = "indices"
+
+
+class GetUnifiedSnapshotOrder(str, Enum, metaclass=utils.OpenEnumMeta):
+    r"""Sort order for returned records. Use asc for oldest first or desc for newest first when supported."""
+
+    ASC = "asc"
+    DESC = "desc"
+
+
+class GetUnifiedSnapshotRequestTypedDict(TypedDict):
+    type: NotRequired[GetUnifiedSnapshotType]
+    r"""Which asset class to include in the snapshot. Allowed values:
+    - `stocks` — equities and ETFs.
+    - `options` — option contracts.
+    - `fx` — foreign-exchange currency pairs.
+    - `crypto` — cryptocurrencies.
+    - `indices` — market indices like SPX, NDX, VIX.
+    """
+    ticker: NotRequired[str]
+    r"""Single ticker symbol filter. Enter one ticker such as AAPL to narrow results to one company. In the docs playground, if you enter `ticker`, do not select `type`, because selecting `type` can clear the `ticker` field."""
+    tickers_any_of: NotRequired[str]
+    r"""Comma-separated list of ticker symbols (maximum 250)."""
+    ticker_from: NotRequired[str]
+    r"""Ticker lower-bound filter. Returns symbols alphabetically on or after this ticker."""
+    ticker_after: NotRequired[str]
+    r"""Ticker lower-bound filter. Returns symbols alphabetically after this ticker, excluding the ticker itself."""
+    ticker_to: NotRequired[str]
+    r"""Ticker upper-bound filter. Returns symbols alphabetically on or before this ticker."""
+    ticker_before: NotRequired[str]
+    r"""Ticker upper-bound filter. Returns symbols alphabetically before this ticker, excluding the ticker itself."""
+    order: NotRequired[GetUnifiedSnapshotOrder]
+    r"""Sort order for returned records. Use asc for oldest first or desc for newest first when supported."""
+    limit: NotRequired[int]
+    r"""Maximum number of results to return. Use smaller values for UI pages and larger values for exports within API limits."""
+    sort: NotRequired[str]
+    r"""Sort field used for ordering. Massive documents this separately from `order`, so enter the provider-supported field name in the text box, for example `ticker`."""
+    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 GetUnifiedSnapshotRequest(BaseModel):
+    type: Annotated[
+        Optional[GetUnifiedSnapshotType],
+        FieldMetadata(query=QueryParamMetadata(style="form", explode=True)),
+    ] = None
+    r"""Which asset class to include in the snapshot. Allowed values:
+    - `stocks` — equities and ETFs.
+    - `options` — option contracts.
+    - `fx` — foreign-exchange currency pairs.
+    - `crypto` — cryptocurrencies.
+    - `indices` — market indices like SPX, NDX, VIX.
+    """
+
+    ticker: Annotated[
+        Optional[str],
+        FieldMetadata(query=QueryParamMetadata(style="form", explode=True)),
+    ] = None
+    r"""Single ticker symbol filter. Enter one ticker such as AAPL to narrow results to one company. In the docs playground, if you enter `ticker`, do not select `type`, because selecting `type` can clear the `ticker` field."""
+
+    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 (maximum 250)."""
+
+    ticker_from: Annotated[
+        Optional[str],
+        pydantic.Field(alias="tickerFrom"),
+        FieldMetadata(query=QueryParamMetadata(style="form", explode=True)),
+    ] = None
+    r"""Ticker lower-bound filter. Returns symbols alphabetically on or after this ticker."""
+
+    ticker_after: Annotated[
+        Optional[str],
+        pydantic.Field(alias="tickerAfter"),
+        FieldMetadata(query=QueryParamMetadata(style="form", explode=True)),
+    ] = None
+    r"""Ticker lower-bound filter. Returns symbols alphabetically after this ticker, excluding the ticker itself."""
+
+    ticker_to: Annotated[
+        Optional[str],
+        pydantic.Field(alias="tickerTo"),
+        FieldMetadata(query=QueryParamMetadata(style="form", explode=True)),
+    ] = None
+    r"""Ticker upper-bound filter. Returns symbols alphabetically on or before this ticker."""
+
+    ticker_before: Annotated[
+        Optional[str],
+        pydantic.Field(alias="tickerBefore"),
+        FieldMetadata(query=QueryParamMetadata(style="form", explode=True)),
+    ] = None
+    r"""Ticker upper-bound filter. Returns symbols alphabetically before this ticker, excluding the ticker itself."""
+
+    order: Annotated[
+        Optional[GetUnifiedSnapshotOrder],
+        FieldMetadata(query=QueryParamMetadata(style="form", explode=True)),
+    ] = GetUnifiedSnapshotOrder.ASC
+    r"""Sort order for returned records. Use asc for oldest first or desc for newest first when supported."""
+
+    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."""
+
+    sort: Annotated[
+        Optional[str],
+        FieldMetadata(query=QueryParamMetadata(style="form", explode=True)),
+    ] = None
+    r"""Sort field used for ordering. Massive documents this separately from `order`, so enter the provider-supported field name in the text box, for example `ticker`."""
+
+    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("type")
+    def serialize_type(self, value):
+        if isinstance(value, str):
+            try:
+                return models.GetUnifiedSnapshotType(value)
+            except ValueError:
+                return value
+        return value
+
+    @field_serializer("order")
+    def serialize_order(self, value):
+        if isinstance(value, str):
+            try:
+                return models.GetUnifiedSnapshotOrder(value)
+            except ValueError:
+                return value
+        return value
+
+    @model_serializer(mode="wrap")
+    def serialize_model(self, handler):
+        optional_fields = set(
+            [
+                "type",
+                "ticker",
+                "tickersAnyOf",
+                "tickerFrom",
+                "tickerAfter",
+                "tickerTo",
+                "tickerBefore",
+                "order",
+                "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 GetUnifiedSnapshotResponseTypedDict(TypedDict):
+    http_meta: HTTPMetadataTypedDict
+    unified_snapshot_response: NotRequired[UnifiedSnapshotResponseTypedDict]
+    r"""Successful response"""
+
+
+class GetUnifiedSnapshotResponse(BaseModel):
+    next: Callable[[], Optional[GetUnifiedSnapshotResponse]]
+
+    http_meta: Annotated[Optional[HTTPMetadata], pydantic.Field(exclude=True)] = None
+
+    unified_snapshot_response: Optional[UnifiedSnapshotResponse] = None
+    r"""Successful response"""
+
+    @model_serializer(mode="wrap")
+    def serialize_model(self, handler):
+        optional_fields = set(["UnifiedSnapshotResponse"])
+        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/getupgradesdowngradesop.py

@@ -0,0 +1,91 @@
+"""Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT."""
+# @generated-id: a80eeecf595b
+
+from __future__ import annotations
+from .httpmetadata import HTTPMetadata, HTTPMetadataTypedDict
+from .upgradesdowngradesresponse import (
+    UpgradesDowngradesResponse,
+    UpgradesDowngradesResponseTypedDict,
+)
+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 GetUpgradesDowngradesRequestTypedDict(TypedDict):
+    symbol: NotRequired[str]
+    r"""Stock ticker to filter by. Send the plain uppercase symbol (e.g. `AAPL`). Omit to return data across all symbols."""
+    from_: NotRequired[date]
+    r"""Start of the date window, inclusive. Format: `YYYY-MM-DD` (e.g. `2024-01-01`). Omit to read from the earliest available data."""
+    to: NotRequired[date]
+    r"""End of the date window, inclusive. Format: `YYYY-MM-DD` (e.g. `2024-12-31`). Omit to read up to today."""
+
+
+class GetUpgradesDowngradesRequest(BaseModel):
+    symbol: Annotated[
+        Optional[str],
+        FieldMetadata(query=QueryParamMetadata(style="form", explode=True)),
+    ] = None
+    r"""Stock ticker to filter by. Send the plain uppercase symbol (e.g. `AAPL`). Omit to return data across all symbols."""
+
+    from_: Annotated[
+        Optional[date],
+        pydantic.Field(alias="from"),
+        FieldMetadata(query=QueryParamMetadata(style="form", explode=True)),
+    ] = None
+    r"""Start of the date window, inclusive. Format: `YYYY-MM-DD` (e.g. `2024-01-01`). Omit to read from the earliest available data."""
+
+    to: Annotated[
+        Optional[date],
+        FieldMetadata(query=QueryParamMetadata(style="form", explode=True)),
+    ] = None
+    r"""End of the date window, inclusive. Format: `YYYY-MM-DD` (e.g. `2024-12-31`). Omit to read up to today."""
+
+    @model_serializer(mode="wrap")
+    def serialize_model(self, handler):
+        optional_fields = set(["symbol", "from", "to"])
+        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 GetUpgradesDowngradesResponseTypedDict(TypedDict):
+    http_meta: HTTPMetadataTypedDict
+    upgrades_downgrades_response: NotRequired[UpgradesDowngradesResponseTypedDict]
+    r"""Analyst upgrades and downgrades."""
+
+
+class GetUpgradesDowngradesResponse(BaseModel):
+    http_meta: Annotated[Optional[HTTPMetadata], pydantic.Field(exclude=True)] = None
+
+    upgrades_downgrades_response: Optional[UpgradesDowngradesResponse] = None
+    r"""Analyst upgrades and downgrades."""
+
+    @model_serializer(mode="wrap")
+    def serialize_model(self, handler):
+        optional_fields = set(["UpgradesDowngradesResponse"])
+        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