@stable_sea/sdk 0.2.10 → 0.2.11

package/dist/gen/schema.d.ts

@@ -73,7 +73,9 @@ export interface paths {
         };
         /**
          * Read balance history
-         * @description Returns daily settled and pending balances for the authenticated business, grouped by asset, for the last 30 days, 90 days, or the current UTC year. Each series contains at most 367 samples.
+         * @description Returns settled balance history for your business, grouped by asset. Choose a trailing window of 24h, 7d, 30d, 90d or 1y, or ytd for the current UTC year. Each series contains at most 367 samples.
+         *
+         *     The default daily sampling includes pending amounts. Use sampling=chart for the same intervals and aggregate labels as Terminal’s balance chart; chart sampling excludes pending amounts and does not support ytd. The timezone parameter accepts an IANA timezone and defaults to UTC. It controls chart labels; daily and ytd boundaries remain UTC. Inspect start_ts, end_ts and interval_seconds for the exact sample range.
          *
          *     Pending amounts include unfinished internal movements only. ACH, wire and on-chain deposits and withdrawals appear after settlement. Completed legs enter settled history even while other legs remain pending, so these amounts can differ from `/v1/balances`.
          *
@@ -596,6 +598,28 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/v1/portfolio": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Read the portfolio
+         * @description Returns Terminal’s portfolio figures for the authenticated business. Requires `money:read`. Balances retain each asset’s rail partition; `asset_summary` includes every partition and is not a per-destination spending limit. Null USD amounts mean unavailable valuations. Totals include only priced holdings, so inspect `unpriced_assets` before treating them as complete.
+         *
+         *     Balance changes include transfers. `daily_return` reports the price return on crypto holdings (currently BTC), adjusted for intraday investment flows. It excludes cash, fund NAV changes and fund income. It has its own observation timestamp. The calendar day uses the requested IANA timezone, defaulting to UTC. The reads are not one atomic ledger snapshot. `details` adds native BTC cost basis and performance, fund income and yield summaries, and the thirty-day WTGXX principal/dividend chart. The worker refreshes these components about once a minute; missing or older-than-two-minutes details are null while base holdings remain available. Individual unavailable components are also null. Yield dates are the issuer’s own as-of dates. Distribution dates use the requested calendar day; pending income is not a promise of payment on that date. The WTGXX chart is measured in fund shares. BTC performance uses UTC day boundaries and Terminal’s existing cost-basis valuation. Computed observations are reported to at most eighteen decimal places; recorded balances retain native precision.
+         */
+        get: operations["portfolio.snapshot"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/v1/price_history": {
         parameters: {
             query?: never;
@@ -1154,24 +1178,30 @@ export interface components {
             data: components["schemas"]["BalanceHistorySeries"][];
             /** Format: date-time */
             end_ts: string;
+            interval_seconds: number;
             livemode: boolean;
             /** @enum {string} */
             object: "balance_history";
             /** Format: date-time */
             observed_ts: string;
+            /** @enum {string} */
+            sampling: "daily" | "chart";
             /** Format: date-time */
             start_ts: string;
+            timezone: string;
             /** @description Assets with a nonzero native balance and no USD valuation in at least one sample. Their native balances remain available. */
             unpriced_assets: string[];
         };
         BalanceHistoryTotal: {
             /** @description Sum of the priced settled balances at this timestamp. Inspect unpriced_assets before treating it as a complete valuation. */
             balance_usd: string;
+            /** @description The native chart label in the requested timezone; present with chart sampling. */
+            label?: string;
             /** Format: date-time */
             sampled_ts: string;
         };
         /** @enum {string} */
-        BalanceHistoryWindow: "30d" | "90d" | "ytd";
+        BalanceHistoryWindow: "24h" | "7d" | "30d" | "90d" | "1y" | "ytd";
         BalanceList: {
             data: components["schemas"]["Balance"][];
             has_more: boolean;
@@ -1801,6 +1831,152 @@ export interface components {
         };
         /** @enum {string} */
         PolicyWindowKind: "calendar_day" | "calendar_week" | "rolling_24h" | "rolling_72h";
+        PortfolioAmounts: {
+            available_native: string;
+            available_usd: string | null;
+            balance_native: string;
+            balance_usd: string | null;
+            pending_incoming_native: string;
+            pending_incoming_usd: string | null;
+            pending_outgoing_native: string;
+            pending_outgoing_usd: string | null;
+        };
+        PortfolioAssetReturn: {
+            asset: string;
+            balance_native: string;
+            balance_usd: string;
+            return_percent: string;
+            return_usd: string;
+        };
+        PortfolioBTCPerformance: {
+            average_cost_basis_usd: string | null;
+            gain_loss_percent: string | null;
+            gain_loss_usd: string | null;
+            invested_usd: string | null;
+            last_price_usd: string | null;
+            /** @description Native daily balance samples over thirty days. BTC daily changes use UTC, independently of the portfolio timezone. */
+            series: components["schemas"]["PortfolioBTCPoint"][];
+            thirty_day_change_percent: string | null;
+            thirty_day_change_usd: string | null;
+            today_change_percent: string | null;
+            today_change_usd: string | null;
+        } | null;
+        PortfolioBTCPoint: {
+            balance_native: string;
+            balance_usd: string;
+            /** Format: date-time */
+            sampled_ts: string;
+        };
+        PortfolioDailyReturn: {
+            data: components["schemas"]["PortfolioAssetReturn"][];
+            /** Format: date-time */
+            observed_ts: string;
+            return_percent: string | null;
+            return_usd: string | null;
+            /** Format: date-time */
+            start_ts: string;
+            /** @description Held assets missing a current or opening valuation. Headline return values are null while this list is nonempty; priced per-asset rows remain available. */
+            unpriced_assets: string[];
+        };
+        PortfolioDetails: {
+            btc: components["schemas"]["PortfolioBTCPerformance"];
+            fund_income: components["schemas"]["PortfolioFundIncome"][];
+            funds: components["schemas"]["PortfolioFundSummary"];
+            /** Format: date-time */
+            observed_ts: string;
+            wtgxx_chart: components["schemas"]["PortfolioPrincipalChart"];
+        } | null;
+        PortfolioFundIncome: {
+            asset: string;
+            available: boolean;
+            daily_yield: components["schemas"]["PortfolioYield"];
+            dividends_paid_usd: string | null;
+            /** @description Only WTGXX declares daily accrued income. Variable-NAV funds have no open daily accrual. */
+            pending_dividend_usd: string | null;
+            seven_day_yield: components["schemas"]["PortfolioYield"];
+            /** Format: int64 */
+            unpriced_dividend_count: number;
+        };
+        PortfolioFundPosition: {
+            asset: string;
+            asset_class: string;
+            balance_native: string;
+            balance_usd: string | null;
+            money_market: boolean;
+            /** Format: date */
+            next_distribution_date: string | null;
+            yield: components["schemas"]["PortfolioYield"];
+        };
+        PortfolioFundSummary: {
+            daily_yield: components["schemas"]["PortfolioYield"];
+            /** @description Whether WTGXX's New York calendar is currently on a published payable date. */
+            distribution_day: boolean;
+            /** @description Lifetime dividends across registered funds, including redeemed positions. Null when a payout could not be valued. */
+            dividends_paid_usd: string | null;
+            /** Format: date */
+            next_distribution_date: string | null;
+            /** @description Authoritative open WTGXX accrual; null when unavailable. This is not a promise that the amount will be paid on the next scheduled date. */
+            pending_dividend_usd: string | null;
+            positions: components["schemas"]["PortfolioFundPosition"][];
+            unpriced_dividend_count: number;
+        } | null;
+        PortfolioHolding: {
+            asset: string;
+            asset_summary: components["schemas"]["PortfolioAmounts"];
+            available_native: string;
+            available_usd: string | null;
+            /** @description Balance change since the requested local day began, including transfers. Null when the comparison cannot be valued. */
+            balance_change_usd: string | null;
+            balance_native: string;
+            balance_usd: string | null;
+            /** @description Completed dividends during the requested local day, valued in USD. Null for unsupported assets or unavailable valuations. */
+            dividends_paid_usd: string | null;
+            /** @enum {string} */
+            object: "portfolio_holding";
+            pending_incoming_native: string;
+            pending_incoming_usd: string | null;
+            pending_outgoing_native: string;
+            pending_outgoing_usd: string | null;
+            /** @description Price change since the requested local day began, excluding transfers. Null when a required price is unavailable. */
+            price_change_percent: string | null;
+            segregated_rail: string;
+        };
+        PortfolioPrincipalChart: {
+            /** @enum {string} */
+            asset: "WTGXX";
+            points: components["schemas"]["PortfolioPrincipalPoint"][];
+            /** @enum {string} */
+            window: "30d";
+        } | null;
+        PortfolioPrincipalPoint: {
+            dividends_native: string;
+            principal_native: string;
+            /** Format: date-time */
+            sampled_ts: string;
+        };
+        PortfolioSnapshot: {
+            /** @description Balance change since the local day began, including transfers. Null when a held position lacks a current or opening valuation. */
+            balance_change_usd: string | null;
+            balance_usd: string;
+            daily_return: components["schemas"]["PortfolioDailyReturn"];
+            data: components["schemas"]["PortfolioHolding"][];
+            /** Format: date-time */
+            day_start_ts: string;
+            details: components["schemas"]["PortfolioDetails"];
+            livemode: boolean;
+            /** @enum {string} */
+            object: "portfolio";
+            /** Format: date-time */
+            observed_ts: string;
+            timezone: string;
+            unpriced_assets: string[];
+        };
+        PortfolioYield: {
+            /** Format: date */
+            as_of: string;
+            label: string;
+            percent: string;
+        } | null;
         PriceHistorySnapshot: {
             data: components["schemas"]["MarketPriceSeries"][];
             /** Format: date-time */
@@ -1812,8 +1988,10 @@ export interface components {
             observed_ts: string;
             /** Format: date-time */
             start_ts: string;
-            window: components["schemas"]["BalanceHistoryWindow"];
+            window: components["schemas"]["PriceHistoryWindow"];
         };
+        /** @enum {string} */
+        PriceHistoryWindow: "30d" | "90d" | "ytd";
         Quote: {
             amount_usd: string;
             /** @enum {string} */
@@ -2374,13 +2552,13 @@ export interface components {
         TransactionSide: {
             amount: string;
             asset: string;
-            /** @description Your bank-account resource, omitted after removal. Retrieve it with accounts:read for account details. */
+            /** @description Your bank-account resource, omitted after removal. Retrieve it with money:read for account details. */
             bank_account_id?: string;
             /** @description Blockchain used by this ledger leg, when it names one. Internal conversions and bank legs have no chain. */
             chain?: string;
             /** @description Whether this figure can still change. False also covers terminal failure and a fund-trade amount fixed at placement; it does not prove settlement. */
             estimated: boolean;
-            /** @description Your external-wallet resource, omitted after removal. Retrieve it with accounts:read for wallet details. */
+            /** @description Your external-wallet resource, omitted after removal. Retrieve it with money:read for wallet details. */
             external_wallet_id?: string;
             quoted?: components["schemas"]["TransactionValue"];
         };
@@ -2713,8 +2891,12 @@ export interface operations {
     "balance_history.snapshot": {
         parameters: {
             query?: {
-                /** @description Thirty days, ninety days, or the current UTC year to date. */
+                /** @description IANA timezone for the calendar day and chart labels, such as America/Los_Angeles. Defaults to UTC. */
+                timezone?: string;
+                /** @description A trailing window, or the current UTC year to date. */
                 window?: components["schemas"]["BalanceHistoryWindow"];
+                /** @description Daily account history or Terminal chart intervals. Chart sampling excludes pending amounts and does not support ytd. */
+                sampling?: "daily" | "chart";
             };
             header?: never;
             path?: never;
@@ -3804,11 +3986,50 @@ export interface operations {
             };
         };
     };
+    "portfolio.snapshot": {
+        parameters: {
+            query?: {
+                /** @description IANA timezone for the calendar day and chart labels, such as America/Los_Angeles. Defaults to UTC. */
+                timezone?: string;
+            };
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description OK */
+            200: {
+                headers: {
+                    "X-RateLimit-Limit": components["headers"]["X-RateLimit-Limit"];
+                    "X-RateLimit-Remaining": components["headers"]["X-RateLimit-Remaining"];
+                    "X-RateLimit-Reset": components["headers"]["X-RateLimit-Reset"];
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["PortfolioSnapshot"];
+                };
+            };
+            400: components["responses"]["Error400"];
+            401: components["responses"]["Error401"];
+            403: components["responses"]["Error403"];
+            429: components["responses"]["Error429"];
+            /** @description Error response. */
+            default: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+        };
+    };
     "price_history.snapshot": {
         parameters: {
             query?: {
                 /** @description Thirty days, ninety days, or the current UTC year to date. */
-                window?: components["schemas"]["BalanceHistoryWindow"];
+                window?: components["schemas"]["PriceHistoryWindow"];
             };
             header?: never;
             path?: never;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stable_sea/sdk",
-  "version": "0.2.10",
+  "version": "0.2.11",
   "type": "module",
   "sideEffects": false,
   "files": [