gloomberb 0.20.2 → 0.20.3
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +1 -1
- package/README.zh-CN.md +1 -1
- package/package.json +2 -1
- package/src/account/auth-form.tsx +13 -8
- package/src/account/upgrade-dialog.tsx +1 -1
- package/src/api-client/central-bank-rates.ts +5 -0
- package/src/api-client/data.ts +17 -4
- package/src/api-client/debt-maturities.ts +45 -2
- package/src/api-client/earnings.ts +4 -2
- package/src/api-client/errors.ts +21 -11
- package/src/api-client/index.ts +1 -0
- package/src/api-client/paths.ts +9 -1
- package/src/api-client/social-mentions.ts +47 -0
- package/src/api-client/types/econ.ts +4 -0
- package/src/app.tsx +11 -1
- package/src/cli/command-options.ts +2 -1
- package/src/cli/commands/market.ts +111 -29
- package/src/cli/commands/options-chain.ts +23 -6
- package/src/cli/commands/overview.ts +13 -5
- package/src/cli/commands/plugins.ts +49 -18
- package/src/cli/commands/search.ts +25 -6
- package/src/cli/commands/ticker.ts +4 -2
- package/src/cli/fx-quote-rate.ts +49 -1
- package/src/cli/glossary.ts +95 -15
- package/src/cli/history-rows.ts +9 -25
- package/src/cli/index.ts +6 -38
- package/src/cli/known-gaps.ts +3 -3
- package/src/cli/listing-arg.ts +78 -18
- package/src/cli/name-entries.ts +3 -2
- package/src/cli/not-a-ticker.ts +6 -2
- package/src/cli/pane-functions/capabilities.ts +12 -1
- package/src/cli/pane-functions/function-help.ts +23 -11
- package/src/cli/pane-functions/headless.ts +3 -1
- package/src/cli/pane-functions/index.ts +32 -4
- package/src/cli/pane-functions/market-session.ts +8 -3
- package/src/cli/pane-functions/resolver.ts +18 -11
- package/src/cli/pane-functions/screenshot-payload.ts +36 -6
- package/src/cli/pane-functions/screenshot-render.ts +4 -0
- package/src/cli/quote-answer.ts +10 -0
- package/src/cli/report-tables.ts +22 -2
- package/src/cli/result.ts +7 -3
- package/src/cli/spreadsheet-hint.ts +43 -0
- package/src/cli/symbol-list.ts +58 -4
- package/src/cli/symbol-rows.ts +49 -2
- package/src/cli/ticker-resolution.ts +98 -5
- package/src/cli/unknown-command.ts +88 -0
- package/src/components/command-bar/assist/model.ts +6 -1
- package/src/components/command-bar/commands/direct/index.ts +9 -1
- package/src/components/command-bar/commands/registry.ts +18 -0
- package/src/components/command-bar/pane-actions.ts +30 -13
- package/src/components/command-bar/panel/index.tsx +6 -3
- package/src/components/command-bar/panel/prompt-binding.ts +4 -0
- package/src/components/command-bar/panel/types.ts +3 -0
- package/src/components/command-bar/routes/header-market.ts +108 -0
- package/src/components/command-bar/routes/root/command-items.ts +5 -0
- package/src/components/command-bar/routes/root/provider-search.ts +190 -32
- package/src/components/command-bar/routes/root/results.ts +3 -0
- package/src/components/command-bar/routes/root/runtime.ts +28 -5
- package/src/components/command-bar/routes/ticker-search/results.ts +53 -6
- package/src/components/command-bar/routing/list-state.ts +38 -0
- package/src/components/command-bar/selection-hint.ts +28 -0
- package/src/components/command-bar/surface/index.tsx +41 -3
- package/src/components/command-bar/view-model.ts +15 -0
- package/src/components/command-bar/workflow/tickers.ts +3 -2
- package/src/components/company-logo.tsx +20 -2
- package/src/components/data-table/export.ts +13 -8
- package/src/components/feedback-dialog.tsx +2 -1
- package/src/components/form-modal/field-row.tsx +2 -1
- package/src/components/input-search-bar.tsx +2 -2
- package/src/components/layout/double-escape-close.ts +8 -5
- package/src/components/layout/header.tsx +75 -44
- package/src/components/layout/market-summary.ts +322 -116
- package/src/components/layout/pane/footer/index.tsx +26 -8
- package/src/components/layout/pane/footer/model.ts +46 -20
- package/src/components/layout/pane/header.tsx +3 -2
- package/src/components/layout/shell/chrome.ts +15 -15
- package/src/components/layout/status-bar.tsx +8 -7
- package/src/components/layout/status-widget-space.ts +8 -0
- package/src/components/markdown-editor.tsx +2 -2
- package/src/components/onboarding/account-step/form-panel.tsx +0 -3
- package/src/components/onboarding/onboarding-keyboard.ts +15 -6
- package/src/components/onboarding/onboarding-wizard.tsx +61 -11
- package/src/components/onboarding/portfolio-step/broker-fields-panel.tsx +0 -1
- package/src/components/onboarding/portfolio-step/positions-panel.tsx +0 -2
- package/src/components/price-sparkline/model.ts +26 -10
- package/src/components/ticker/list-table-view.tsx +29 -4
- package/src/components/ui/button.tsx +13 -2
- package/src/components/ui/column-grid.tsx +18 -9
- package/src/components/ui/data-table/index.tsx +1 -1
- package/src/components/ui/data-table/opentui/index.tsx +2 -1
- package/src/components/ui/data-table/types.ts +18 -0
- package/src/components/ui/delayed-mark.tsx +3 -2
- package/src/components/ui/field-grid.tsx +0 -2
- package/src/components/ui/fields.tsx +7 -4
- package/src/components/ui/inline-quick-add.tsx +2 -2
- package/src/components/ui/key-hint-words.ts +153 -0
- package/src/components/ui/key-hints.tsx +73 -0
- package/src/components/ui/menu.tsx +3 -1
- package/src/components/ui/message-composer.tsx +2 -2
- package/src/components/ui/shortcut-hint.tsx +28 -3
- package/src/components/ui/tabs.tsx +7 -0
- package/src/components/ui/text-prompt-dialog.tsx +2 -1
- package/src/core/state/app/command-bar-launch.ts +3 -0
- package/src/data/config/store/normalize.ts +6 -0
- package/src/docs/snapshot.json +120 -69
- package/src/i18n/es.ts +24 -1
- package/src/i18n/ja.ts +24 -1
- package/src/i18n/ko.ts +24 -1
- package/src/i18n/zh-cn.ts +24 -1
- package/src/i18n/zh-tw.ts +24 -1
- package/src/layout/pane-manager/gridlock.ts +11 -0
- package/src/market-data/bars-per-year.ts +27 -9
- package/src/market-data/coordinator/quotes.ts +22 -3
- package/src/market-data/futures-board.ts +80 -0
- package/src/market-data/futures-contract.ts +9 -3
- package/src/market-data/market/change-basis.ts +2 -2
- package/src/market-data/market/dated-previous-close.ts +163 -47
- package/src/market-data/market/format.ts +14 -3
- package/src/market-data/market/freshness.ts +24 -7
- package/src/market-data/market/header-market.ts +154 -0
- package/src/market-data/market/index-level.ts +29 -0
- package/src/market-data/market/index-session-venues.ts +44 -0
- package/src/market-data/market/status.ts +7 -2
- package/src/market-data/market/venue-session.ts +72 -0
- package/src/market-data/model-dividend-yield.ts +23 -8
- package/src/market-data/options-alternatives.ts +39 -4
- package/src/market-data/published-apac-sessions.ts +40 -2
- package/src/market-data/quotes/export-identity.ts +76 -0
- package/src/market-data/quotes/freshness.ts +22 -0
- package/src/market-data/quotes/time.ts +42 -1
- package/src/market-data/realized-volatility.ts +11 -7
- package/src/market-data/tax-equivalent.ts +145 -27
- package/src/plugins/builtin/account-management/pane.tsx +2 -2
- package/src/plugins/builtin/alerts/alert-engine.ts +12 -6
- package/src/plugins/builtin/alerts/alert-log.ts +6 -2
- package/src/plugins/builtin/alerts/calendar-events.ts +74 -12
- package/src/plugins/builtin/alerts/cli-forms.ts +11 -1
- package/src/plugins/builtin/alerts/cli-move.ts +234 -0
- package/src/plugins/builtin/alerts/cli.ts +224 -33
- package/src/plugins/builtin/alerts/command.ts +33 -6
- package/src/plugins/builtin/alerts/event-rows.ts +18 -4
- package/src/plugins/builtin/alerts/events-pane.tsx +6 -2
- package/src/plugins/builtin/alerts/events.ts +9 -0
- package/src/plugins/builtin/alerts/format.ts +40 -15
- package/src/plugins/builtin/alerts/headless.ts +31 -18
- package/src/plugins/builtin/alerts/history.ts +1 -0
- package/src/plugins/builtin/alerts/index.tsx +86 -12
- package/src/plugins/builtin/alerts/live.ts +2 -1
- package/src/plugins/builtin/alerts/move-checks.ts +155 -0
- package/src/plugins/builtin/alerts/move.ts +160 -0
- package/src/plugins/builtin/alerts/pane.tsx +52 -22
- package/src/plugins/builtin/alerts/price-text.ts +62 -0
- package/src/plugins/builtin/alerts/price.ts +17 -0
- package/src/plugins/builtin/alerts/quotes.ts +84 -3
- package/src/plugins/builtin/alerts/scheduled-check.ts +7 -1
- package/src/plugins/builtin/alerts/storage.ts +20 -7
- package/src/plugins/builtin/alerts/types.ts +13 -0
- package/src/plugins/builtin/analytics/risk-client.ts +60 -39
- package/src/plugins/builtin/analytics/risk-episodes.ts +18 -0
- package/src/plugins/builtin/analytics/risk-headless.ts +20 -4
- package/src/plugins/builtin/analytics/risk-model.ts +68 -1
- package/src/plugins/builtin/analytics/risk-pane.tsx +15 -3
- package/src/plugins/builtin/backtest/engine.ts +4 -2
- package/src/plugins/builtin/backtest/window.ts +3 -1
- package/src/plugins/builtin/broker-manager/sign-in-end.ts +1 -1
- package/src/plugins/builtin/central-bank-rates/client.ts +4 -0
- package/src/plugins/builtin/central-bank-rates/headless.ts +1 -1
- package/src/plugins/builtin/central-bank-rates/model.ts +18 -8
- package/src/plugins/builtin/central-bank-rates/pane.tsx +6 -3
- package/src/plugins/builtin/chart-composer/cli-options.ts +5 -0
- package/src/plugins/builtin/chart-composer/headless-schema.ts +17 -1
- package/src/plugins/builtin/chart-composer/headless.ts +2 -0
- package/src/plugins/builtin/cloud/upgrade-status-widget.tsx +9 -2
- package/src/plugins/builtin/crypto-board/headless.ts +82 -17
- package/src/plugins/builtin/crypto-board/index.tsx +24 -2
- package/src/plugins/builtin/crypto-board/model.ts +5 -2
- package/src/plugins/builtin/crypto-board/pane.tsx +4 -1
- package/src/plugins/builtin/debt-maturities/client.ts +111 -6
- package/src/plugins/builtin/debt-maturities/headless.ts +84 -1
- package/src/plugins/builtin/debt-maturities/model.ts +97 -14
- package/src/plugins/builtin/debt-maturities/pane.tsx +165 -15
- package/src/plugins/builtin/debt-maturities/series.ts +3 -1
- package/src/plugins/builtin/dividend-yield/client.ts +22 -6
- package/src/plugins/builtin/dividend-yield/headless.ts +113 -46
- package/src/plugins/builtin/dividend-yield/model.ts +5 -2
- package/src/plugins/builtin/dividend-yield/pane.tsx +6 -3
- package/src/plugins/builtin/dividend-yield/ranking-reads.ts +11 -4
- package/src/plugins/builtin/dividend-yield/ranking.ts +113 -18
- package/src/plugins/builtin/dividend-yield/types.ts +2 -0
- package/src/plugins/builtin/dividend-yield/view.ts +3 -0
- package/src/plugins/builtin/econ/calendar-model.ts +21 -3
- package/src/plugins/builtin/econ/detail-view.tsx +5 -3
- package/src/plugins/builtin/econ/figures.ts +13 -0
- package/src/plugins/builtin/econ/fred-catalog.ts +6 -3
- package/src/plugins/builtin/econ/index.tsx +5 -3
- package/src/plugins/builtin/econ/types.ts +5 -0
- package/src/plugins/builtin/equity-screener/footer.ts +45 -0
- package/src/plugins/builtin/equity-screener/pane.tsx +4 -18
- package/src/plugins/builtin/equity-screener/ticker-check.tsx +2 -1
- package/src/plugins/builtin/fixed-income/model.ts +1 -0
- package/src/plugins/builtin/futures/table.tsx +1 -1
- package/src/plugins/builtin/futures-curve/model.ts +3 -10
- package/src/plugins/builtin/help/function-card.tsx +2 -1
- package/src/plugins/builtin/help/function-index.ts +1 -0
- package/src/plugins/builtin/insider/client.ts +31 -14
- package/src/plugins/builtin/insider/signals-model.ts +2 -7
- package/src/plugins/builtin/iv-history/headless.ts +1 -2
- package/src/plugins/builtin/iv-history/model.ts +33 -23
- package/src/plugins/builtin/iv-history/screen-pane.tsx +0 -3
- package/src/plugins/builtin/kelly-sizer/headless.ts +64 -16
- package/src/plugins/builtin/kelly-sizer/history.ts +37 -28
- package/src/plugins/builtin/kelly-sizer/pane.tsx +43 -10
- package/src/plugins/builtin/kelly-sizer/sections.tsx +7 -2
- package/src/plugins/builtin/kelly-sizer/units.ts +29 -0
- package/src/plugins/builtin/news/index.tsx +7 -13
- package/src/plugins/builtin/news/overview-headlines.tsx +117 -0
- package/src/plugins/builtin/news/ticker-news.ts +35 -0
- package/src/plugins/builtin/news/wire/news/detail-view.tsx +8 -6
- package/src/plugins/builtin/news/wire/news/row.ts +49 -0
- package/src/plugins/builtin/news/wire/news/table.tsx +9 -20
- package/src/plugins/builtin/options/analytics.ts +7 -2
- package/src/plugins/builtin/options/live-quotes.ts +6 -1
- package/src/plugins/builtin/options/table.ts +3 -2
- package/src/plugins/builtin/options/view.tsx +11 -9
- package/src/plugins/builtin/options-scenario/client.ts +3 -0
- package/src/plugins/builtin/options-scenario/headless.ts +1 -1
- package/src/plugins/builtin/perps/client.ts +5 -4
- package/src/plugins/builtin/perps/headless.ts +134 -124
- package/src/plugins/builtin/perps/markets-section.tsx +2 -2
- package/src/plugins/builtin/perps/model.ts +8 -4
- package/src/plugins/builtin/perps/open-market.ts +4 -4
- package/src/plugins/builtin/perps/venue-markets.ts +3 -6
- package/src/plugins/builtin/portfolio-list/cell-version.ts +1 -0
- package/src/plugins/builtin/portfolio-list/cli/bulk-symbols.ts +34 -10
- package/src/plugins/builtin/portfolio-list/cli/period-report.ts +28 -2
- package/src/plugins/builtin/portfolio-list/cli/portfolio-command.ts +7 -3
- package/src/plugins/builtin/portfolio-list/cli/render.ts +66 -22
- package/src/plugins/builtin/portfolio-list/grid.tsx +5 -3
- package/src/plugins/builtin/portfolio-list/pane/data.ts +34 -1
- package/src/plugins/builtin/portfolio-list/pane/index.tsx +6 -0
- package/src/plugins/builtin/portfolio-list/pane/streaming.ts +15 -6
- package/src/plugins/builtin/portfolio-list/quick-add/resolution.ts +19 -7
- package/src/plugins/builtin/portfolio-list/table.tsx +30 -4
- package/src/plugins/builtin/realized-vol/evidence.ts +33 -6
- package/src/plugins/builtin/realized-vol/fx-proxy.ts +135 -0
- package/src/plugins/builtin/realized-vol/headless.ts +44 -8
- package/src/plugins/builtin/realized-vol/model.ts +9 -5
- package/src/plugins/builtin/realized-vol/pane.tsx +49 -15
- package/src/plugins/builtin/sec/headless.ts +48 -6
- package/src/plugins/builtin/sec/index.tsx +6 -4
- package/src/plugins/builtin/sec/model.ts +4 -1
- package/src/plugins/builtin/shared/earnings-calendar.ts +2 -0
- package/src/plugins/builtin/shared/market-cap-bands.ts +12 -0
- package/src/plugins/builtin/shared/report-freshness.ts +3 -1
- package/src/plugins/builtin/shared/use-quote-board.ts +5 -3
- package/src/plugins/builtin/shared/volatility/options.ts +63 -2
- package/src/plugins/builtin/social-mentions/headless.ts +72 -3
- package/src/plugins/builtin/social-mentions/index.tsx +8 -4
- package/src/plugins/builtin/social-mentions/lock-note.ts +6 -2
- package/src/plugins/builtin/social-mentions/outliers-client.ts +101 -0
- package/src/plugins/builtin/social-mentions/outliers-model.ts +162 -0
- package/src/plugins/builtin/social-mentions/outliers-names.ts +51 -0
- package/src/plugins/builtin/social-mentions/outliers.tsx +276 -0
- package/src/plugins/builtin/social-mentions/pane.tsx +32 -3
- package/src/plugins/builtin/supply-chain/graph-pane.tsx +2 -2
- package/src/plugins/builtin/thirteenf/api.ts +36 -2
- package/src/plugins/builtin/thirteenf/data.ts +4 -1
- package/src/plugins/builtin/thirteenf/headless.ts +14 -6
- package/src/plugins/builtin/thirteenf/model.ts +56 -1
- package/src/plugins/builtin/thirteenf/pane.tsx +8 -8
- package/src/plugins/builtin/thirteenf/report-notes.ts +11 -0
- package/src/plugins/builtin/thirteenf/table.ts +2 -1
- package/src/plugins/builtin/thirteenf/types.ts +6 -0
- package/src/plugins/builtin/ticker-detail/data-panes/historical-prices.tsx +23 -3
- package/src/plugins/builtin/ticker-detail/financials/model.ts +5 -0
- package/src/plugins/builtin/ticker-detail/headless-schema.ts +2 -1
- package/src/plugins/builtin/ticker-detail/headless.ts +21 -66
- package/src/plugins/builtin/ticker-detail/index.tsx +5 -0
- package/src/plugins/builtin/ticker-detail/overview/components.tsx +13 -1
- package/src/plugins/builtin/ticker-detail/overview/model.ts +6 -4
- package/src/plugins/builtin/ticker-detail/overview/pane.tsx +15 -0
- package/src/plugins/builtin/ticker-detail/overview/tax-equivalent.ts +69 -0
- package/src/plugins/builtin/ticker-detail/overview-tab.tsx +41 -6
- package/src/plugins/builtin/ticker-detail/quote-monitor/card.tsx +47 -24
- package/src/plugins/builtin/ticker-detail/quote-monitor/export.ts +46 -0
- package/src/plugins/builtin/ticker-detail/quote-monitor/index.tsx +20 -1
- package/src/plugins/builtin/ticker-detail/quote-monitor/rows.ts +120 -0
- package/src/plugins/builtin/ticker-detail/research-tabs.ts +1 -5
- package/src/plugins/builtin/ticker-detail/settings.ts +6 -6
- package/src/plugins/builtin/treasury-auctions/cache.ts +85 -19
- package/src/plugins/builtin/treasury-auctions/index.tsx +22 -11
- package/src/plugins/builtin/treasury-auctions/model.ts +23 -0
- package/src/plugins/builtin/treasury-auctions/treasury-direct.ts +128 -0
- package/src/plugins/builtin/world-indices/client.ts +2 -0
- package/src/plugins/compat.ts +15 -0
- package/src/plugins/host-link.ts +6 -1
- package/src/plugins/installer.ts +8 -3
- package/src/portfolio/column-values.ts +14 -4
- package/src/portfolio/listed-symbol.ts +78 -0
- package/src/portfolio/real-return.ts +172 -0
- package/src/public/__snapshots__/public-api.test.ts.snap +1 -0
- package/src/renderers/browser/config-host.ts +56 -15
- package/src/renderers/browser/main.tsx +3 -1
- package/src/renderers/browser/ui-host.tsx +1 -0
- package/src/renderers/cloudflare/http-proxy.ts +1 -0
- package/src/renderers/dom/boot-frame.ts +2 -2
- package/src/renderers/dom/data-table/row.tsx +4 -1
- package/src/renderers/dom/desktop/controls.tsx +4 -4
- package/src/renderers/dom/desktop/dialog-actions.tsx +60 -41
- package/src/renderers/dom/dom-ui-host.tsx +3 -1
- package/src/renderers/dom/host/input.tsx +4 -1
- package/src/renderers/dom/host/tabs.tsx +10 -1
- package/src/renderers/dom/styles.css +33 -13
- package/src/renderers/electrobun/bun/desktop/app-name.ts +1 -1
- package/src/renderers/opentui/host.tsx +2 -1
- package/src/sources/gloomberb-cloud/fred-series.ts +12 -0
- package/src/sources/gloomberb-cloud/index.ts +31 -2
- package/src/sources/gloomberb-cloud/normalizers.ts +29 -3
- package/src/sources/provider-router/cached-routes.ts +19 -7
- package/src/state/pane-table-export-registry.ts +19 -6
- package/src/test-support/preload.ts +5 -1
- package/src/theme/colors.ts +9 -1
- package/src/theme/themes.ts +62 -15
- package/src/theme/tone-contrast.ts +40 -0
- package/src/theme/ui-tokens.ts +23 -3
- package/src/tickers/batched-lookups.ts +57 -8
- package/src/tickers/company-name-listing.ts +156 -14
- package/src/tickers/company-name.ts +30 -6
- package/src/tickers/list.ts +7 -0
- package/src/tickers/search/home-listing.ts +31 -9
- package/src/tickers/search/index.ts +13 -3
- package/src/tickers/search/listing-index.ts +558 -0
- package/src/tickers/search/major-listings.chunk.ts +10 -0
- package/src/tickers/search/major-listings.json +3346 -0
- package/src/tickers/search/ranking.ts +68 -1
- package/src/tickers/search/types.ts +4 -0
- package/src/tickers/terminal-codes.ts +26 -1
- package/src/time-series/calendar-month-returns.ts +47 -0
- package/src/time-series/currency-conversion.ts +130 -0
- package/src/time-series/hooks.ts +2 -0
- package/src/time-series/price-comparison.ts +34 -11
- package/src/time-series/resolve-context.ts +3 -0
- package/src/time-series/resolve.ts +14 -2
- package/src/time-series/spec.ts +1 -0
- package/src/time-series/studies/indicators.ts +4 -1
- package/src/time-series/types.ts +8 -0
- package/src/types/config.ts +8 -0
- package/src/types/data-provider.ts +28 -0
- package/src/types/financials.ts +20 -2
- package/src/types/headless.ts +12 -0
- package/src/ui/host.tsx +8 -0
- package/src/utils/datetime-format.ts +17 -3
- package/src/utils/display-number.ts +15 -0
- package/src/utils/double-escape-close.ts +61 -16
- package/src/utils/float32-price.ts +24 -0
- package/src/utils/forward-dividend.ts +81 -16
- package/src/utils/fx-market-hours.ts +11 -0
- package/src/utils/plugin-proxy-hosts.json +2 -1
- package/src/utils/price-history.ts +7 -6
- package/src/utils/report-timing.ts +62 -0
- package/src/utils/sec-filings.ts +32 -0
- package/src/utils/utc-time.ts +5 -0
|
@@ -2,8 +2,8 @@ import type { HeadlessPaneDefinition, HeadlessPaneRow } from "../../../types/hea
|
|
|
2
2
|
import { resolveHeadlessInstrument } from "../shared/headless-market-data";
|
|
3
3
|
import { MarketDataCoordinator, resolveEntryValue } from "../../../market-data/coordinator";
|
|
4
4
|
import { parseHedgeAmount } from "../options-scenario/hedge";
|
|
5
|
-
import {
|
|
6
|
-
import {
|
|
5
|
+
import { convertCurrency, formatNumber } from "../../../utils/format";
|
|
6
|
+
import { fxRateCurrencies } from "../../../utils/currency-units";
|
|
7
7
|
import { buildBinaryOutcomes, solveKellyFraction } from "./model";
|
|
8
8
|
import {
|
|
9
9
|
clampKellyHistoryYears,
|
|
@@ -11,12 +11,15 @@ import {
|
|
|
11
11
|
KELLY_HISTORY_DEFAULT_YEARS,
|
|
12
12
|
KELLY_HISTORY_MAX_YEARS,
|
|
13
13
|
KELLY_HISTORY_MIN_PERIODS,
|
|
14
|
-
kellyHistoryRange,
|
|
15
14
|
kellyHistoryRequest,
|
|
15
|
+
kellyTrailingHistoryRequest,
|
|
16
16
|
type KellyHistoryInputs,
|
|
17
17
|
} from "./history";
|
|
18
|
+
import { historyReadUnanswered } from "../../../time-series/calendar-month-returns";
|
|
18
19
|
import { formatPct, formatSignedPct } from "./view";
|
|
19
20
|
import { logFailure } from "../../../utils/log-failure";
|
|
21
|
+
import { loadFuturesContractTerms } from "../../../market-data/futures-contract";
|
|
22
|
+
import { kellyCount, kellyCountMultiplier, type KellyCount } from "./units";
|
|
20
23
|
|
|
21
24
|
/** The fractions of full Kelly a report sizes, largest first. */
|
|
22
25
|
const KELLY_FRACTIONS = [
|
|
@@ -40,6 +43,25 @@ function inputEntries(inputs: KellyHistoryInputs, edge: number) {
|
|
|
40
43
|
];
|
|
41
44
|
}
|
|
42
45
|
|
|
46
|
+
const COUNT_HEADER: Record<KellyCount, string> = { shares: "Shares", units: "Units", contracts: "Contracts" };
|
|
47
|
+
|
|
48
|
+
/**
|
|
49
|
+
* `price` in the base currency at the rates the portfolio values holdings at
|
|
50
|
+
* (USD per unit, from the same FX store); null when either rate is missing.
|
|
51
|
+
*/
|
|
52
|
+
async function priceInBase(price: number, currency: string | undefined, baseCurrency: string, coordinator: MarketDataCoordinator): Promise<number | null> {
|
|
53
|
+
if (!currency) return null;
|
|
54
|
+
if (currency === baseCurrency) return price;
|
|
55
|
+
const rates = new Map([["USD", 1]]);
|
|
56
|
+
await Promise.all(fxRateCurrencies([currency, baseCurrency]).filter((code) => code !== "USD").map(async (code) => {
|
|
57
|
+
const entry = await coordinator.loadFxRate(code).catch(logFailure("kelly-sizer.headless", "Load the exchange rate for Kelly units failed", null));
|
|
58
|
+
const rate = entry ? resolveEntryValue(entry) : null;
|
|
59
|
+
if (rate != null) rates.set(code, rate);
|
|
60
|
+
}));
|
|
61
|
+
const converted = convertCurrency(price, currency, baseCurrency, rates);
|
|
62
|
+
return Number.isFinite(converted) && converted > 0 ? converted : null;
|
|
63
|
+
}
|
|
64
|
+
|
|
43
65
|
export const kellyHeadless: HeadlessPaneDefinition<"bundle"> = {
|
|
44
66
|
shape: "bundle",
|
|
45
67
|
argument: { kind: "ticker", description: "Ticker to size" },
|
|
@@ -47,8 +69,8 @@ export const kellyHeadless: HeadlessPaneDefinition<"bundle"> = {
|
|
|
47
69
|
description: "Kelly sizing for a ticker from its own monthly returns: win rate, payoff ratio and edge over a lookback, then full, half and quarter Kelly as a share of a bankroll.",
|
|
48
70
|
describe: (args) => `Kelly sizing | ${args.symbols[0] ?? ""}`,
|
|
49
71
|
discovery: {
|
|
50
|
-
dataRequirements: ["Gloom Cloud daily closes over the lookback,
|
|
51
|
-
limitations: ["Win rate, gain and loss are the ticker's own
|
|
72
|
+
dataRequirements: ["Gloom Cloud daily closes over the lookback, the latest quote for share or unit counts, and the exchange rate to the base currency"],
|
|
73
|
+
limitations: ["Win rate, gain and loss are the ticker's own calendar-month returns, month-end close to month-end close; past months are not a forecast."],
|
|
52
74
|
},
|
|
53
75
|
options: [
|
|
54
76
|
{
|
|
@@ -73,16 +95,23 @@ export const kellyHeadless: HeadlessPaneDefinition<"bundle"> = {
|
|
|
73
95
|
async load(args, ctx) {
|
|
74
96
|
const { symbol, exchange = "" } = await resolveHeadlessInstrument(ctx, args.symbols[0]!);
|
|
75
97
|
const years = clampKellyHistoryYears(args.options.years);
|
|
76
|
-
const range = kellyHistoryRange(years);
|
|
77
98
|
// The quote and the one history window the lookback needs load together, through the
|
|
78
99
|
// coordinator every chart reads daily closes from (the History tab's request, cache included).
|
|
100
|
+
const coordinator = new MarketDataCoordinator(ctx.marketData);
|
|
101
|
+
const loadHistory = async () => {
|
|
102
|
+
const dated = await coordinator.loadChart(kellyHistoryRequest({ symbol, exchange }, years), { forceRefresh: ctx.refresh });
|
|
103
|
+
// A source with no dated history answers from its trailing range, as the History tab does.
|
|
104
|
+
return historyReadUnanswered(dated)
|
|
105
|
+
? coordinator.loadChart(kellyTrailingHistoryRequest({ symbol, exchange }, years), { forceRefresh: ctx.refresh })
|
|
106
|
+
: dated;
|
|
107
|
+
};
|
|
79
108
|
const [entry, quote] = await Promise.all([
|
|
80
|
-
|
|
109
|
+
loadHistory(),
|
|
81
110
|
ctx.marketData.getQuote(symbol, exchange, ctx.refresh ? { cacheMode: "refresh" } : undefined).catch(logFailure("kelly-sizer.headless", "Load Kelly sizing quote failed", null)),
|
|
82
111
|
]);
|
|
83
|
-
const history =
|
|
112
|
+
const history = resolveEntryValue(entry) ?? [];
|
|
84
113
|
ctx.signal.throwIfAborted();
|
|
85
|
-
const inputs = estimateKellyHistoryInputs(history, years);
|
|
114
|
+
const inputs = estimateKellyHistoryInputs(history, years, { exchange });
|
|
86
115
|
if (!inputs) {
|
|
87
116
|
return {
|
|
88
117
|
complete: false,
|
|
@@ -96,17 +125,27 @@ export const kellyHeadless: HeadlessPaneDefinition<"bundle"> = {
|
|
|
96
125
|
const bankroll = typeof bankrollValue === "number" && bankrollValue > 0 ? bankrollValue : null;
|
|
97
126
|
const baseCurrency = ctx.config.baseCurrency || "USD";
|
|
98
127
|
const price = quote && quote.price > 0 && Number.isFinite(quote.price) ? quote.price : null;
|
|
99
|
-
//
|
|
100
|
-
const
|
|
128
|
+
// A future is counted in contracts, each its price times the contract's multiplier.
|
|
129
|
+
const count = kellyCount(symbol, exchange, quote?.instrumentType);
|
|
130
|
+
const [multiplier, basePrice] = bankroll == null || price == null ? [null, null] : await Promise.all([
|
|
131
|
+
kellyCountMultiplier(symbol, count, (key) => loadFuturesContractTerms(key, ctx.apiClient)),
|
|
132
|
+
// The price in the bankroll's currency, at the rate the portfolio values holdings at; null without one.
|
|
133
|
+
priceInBase(price, quote?.currency, baseCurrency, coordinator),
|
|
134
|
+
]);
|
|
135
|
+
const unitPrice = basePrice == null || multiplier == null ? null : basePrice * multiplier;
|
|
136
|
+
// A coin is divisible and sized to a hundredth; shares and contracts whole.
|
|
137
|
+
const coin = count === "units";
|
|
138
|
+
const units = COUNT_HEADER[count];
|
|
101
139
|
const rows: HeadlessPaneRow[] = KELLY_FRACTIONS.map(({ id, label, fraction }) => {
|
|
102
140
|
const share = solve.fraction * fraction;
|
|
103
141
|
const position = bankroll == null ? null : share * bankroll;
|
|
142
|
+
const held = position != null && unitPrice != null ? position / unitPrice : null;
|
|
104
143
|
return {
|
|
105
144
|
id,
|
|
106
145
|
kelly: label,
|
|
107
146
|
fraction: share,
|
|
108
147
|
position,
|
|
109
|
-
shares:
|
|
148
|
+
shares: held == null ? null : coin ? Math.floor(held * 100) / 100 : Math.floor(held),
|
|
110
149
|
};
|
|
111
150
|
});
|
|
112
151
|
// A fraction over the whole bankroll is a levered position.
|
|
@@ -117,10 +156,16 @@ export const kellyHeadless: HeadlessPaneDefinition<"bundle"> = {
|
|
|
117
156
|
...(levered.length ? [`Over 100% of bankroll means leverage, borrowing or margin beyond what you hold: ${levered.join(", ")}.`] : []),
|
|
118
157
|
...(solve.fraction === 0 ? ["No positive edge over this window: every Kelly fraction sizes nothing."] : []),
|
|
119
158
|
...(bankroll == null ? [`Add --bankroll <amount> to size each fraction in ${baseCurrency}.`] : []),
|
|
159
|
+
...(bankroll != null && price != null && multiplier == null
|
|
160
|
+
? [`No contract size for ${symbol} to count contracts in: each position is in ${baseCurrency} only.`]
|
|
161
|
+
: bankroll != null && price != null && basePrice == null
|
|
162
|
+
? [`No ${quote?.currency || "quote"} to ${baseCurrency} rate to count ${count} in: each position is in ${baseCurrency} only.`]
|
|
163
|
+
: []),
|
|
120
164
|
];
|
|
121
165
|
return {
|
|
122
166
|
complete: true,
|
|
123
|
-
|
|
167
|
+
// Dated by the newest close read: the months stop at the last one that has ended.
|
|
168
|
+
freshness: { asOf: inputs.latest },
|
|
124
169
|
notes,
|
|
125
170
|
sections: [
|
|
126
171
|
{ title: "Inputs", entries: inputEntries(inputs, solve.expectedReturn) },
|
|
@@ -132,8 +177,8 @@ export const kellyHeadless: HeadlessPaneDefinition<"bundle"> = {
|
|
|
132
177
|
...(bankroll == null ? [] : [
|
|
133
178
|
{ key: "position", header: `Position ${baseCurrency}`, align: "right" as const,
|
|
134
179
|
format: (value: unknown) => typeof value === "number" ? formatNumber(value, 0) : "--" },
|
|
135
|
-
...(
|
|
136
|
-
format: (value: unknown) => typeof value === "number" ? formatNumber(value, 0) : "--" }]),
|
|
180
|
+
...(unitPrice == null ? [] : [{ key: "shares", header: units, align: "right" as const,
|
|
181
|
+
format: (value: unknown) => typeof value === "number" ? formatNumber(value, coin ? 2 : 0) : "--" }]),
|
|
137
182
|
]),
|
|
138
183
|
],
|
|
139
184
|
rows,
|
|
@@ -147,7 +192,10 @@ export const kellyHeadless: HeadlessPaneDefinition<"bundle"> = {
|
|
|
147
192
|
bankroll,
|
|
148
193
|
currency: baseCurrency,
|
|
149
194
|
price: price == null ? null : { value: price, currency: quote?.currency ?? null, asOf: quote?.lastUpdated ?? null },
|
|
150
|
-
|
|
195
|
+
...(basePrice != null && quote?.currency !== baseCurrency ? { priceInBase: { value: basePrice, currency: baseCurrency } } : {}),
|
|
196
|
+
...(count === "contracts" && multiplier != null ? { contractMultiplier: multiplier } : {}),
|
|
197
|
+
units: count,
|
|
198
|
+
method: "Binary Kelly on calendar-month returns, month-end close to month-end close: win rate, mean gain and mean loss.",
|
|
151
199
|
},
|
|
152
200
|
};
|
|
153
201
|
},
|
|
@@ -1,17 +1,13 @@
|
|
|
1
1
|
import type { PricePoint } from "../../../types/financials";
|
|
2
|
-
import type { TimeRange } from "../../../time-series/range";
|
|
3
2
|
import type { ChartRequest, InstrumentRef } from "../../../market-data/request-types";
|
|
4
|
-
import { getPricePointTimestamp } from "../../../utils/price-history";
|
|
3
|
+
import { dailyBarDate, getPricePointTimestamp } from "../../../utils/price-history";
|
|
4
|
+
import { calendarMonthReturnsRequest, trailingDailyClosesRequest, venueMonth } from "../../../time-series/calendar-month-returns";
|
|
5
5
|
|
|
6
|
-
/** Sessions in one holding period: a month of trading days. */
|
|
7
|
-
export const KELLY_HISTORY_PERIOD_SESSIONS = 21;
|
|
8
6
|
export const KELLY_HISTORY_DEFAULT_YEARS = 5;
|
|
9
7
|
export const KELLY_HISTORY_MAX_YEARS = 5;
|
|
10
8
|
/** Fewer monthly returns than this say too little about a win rate to size on. */
|
|
11
9
|
export const KELLY_HISTORY_MIN_PERIODS = 6;
|
|
12
10
|
|
|
13
|
-
const YEAR_MS = 365.25 * 24 * 60 * 60_000;
|
|
14
|
-
|
|
15
11
|
/** The binary inputs a ticker's own monthly returns imply over a lookback window. */
|
|
16
12
|
export interface KellyHistoryInputs {
|
|
17
13
|
winProbability: number;
|
|
@@ -22,9 +18,11 @@ export interface KellyHistoryInputs {
|
|
|
22
18
|
/** Up months over all months. */
|
|
23
19
|
wins: number;
|
|
24
20
|
periods: number;
|
|
25
|
-
/**
|
|
21
|
+
/** The month-end close the first return starts from, and the one the last return ends on, as YYYY-MM-DD. */
|
|
26
22
|
start: string;
|
|
27
23
|
end: string;
|
|
24
|
+
/** The newest daily close read, which a month in progress may follow, as YYYY-MM-DD. */
|
|
25
|
+
latest: string;
|
|
28
26
|
years: number;
|
|
29
27
|
}
|
|
30
28
|
|
|
@@ -33,36 +31,46 @@ export function clampKellyHistoryYears(value: unknown): number {
|
|
|
33
31
|
return Number.isFinite(years) ? Math.min(KELLY_HISTORY_MAX_YEARS, Math.max(1, years)) : KELLY_HISTORY_DEFAULT_YEARS;
|
|
34
32
|
}
|
|
35
33
|
|
|
36
|
-
/**
|
|
37
|
-
export function
|
|
38
|
-
return clampKellyHistoryYears(years)
|
|
34
|
+
/** KELLY's dated daily closes (`calendarMonthReturnsRequest`) over a lookback clamped to its one to five years. */
|
|
35
|
+
export function kellyHistoryRequest(instrument: InstrumentRef, years: number, now = Date.now()): ChartRequest {
|
|
36
|
+
return calendarMonthReturnsRequest(instrument, clampKellyHistoryYears(years), now);
|
|
39
37
|
}
|
|
40
38
|
|
|
41
|
-
/** The
|
|
42
|
-
export function
|
|
43
|
-
return
|
|
39
|
+
/** The trailing range the History tab and the KELLY report both fall back to without dated closes. */
|
|
40
|
+
export function kellyTrailingHistoryRequest(instrument: InstrumentRef, years: number): ChartRequest {
|
|
41
|
+
return trailingDailyClosesRequest(instrument, clampKellyHistoryYears(years));
|
|
44
42
|
}
|
|
45
43
|
|
|
46
|
-
const dateKey = (time: number) => new Date(time).toISOString().slice(0, 10);
|
|
47
|
-
|
|
48
44
|
/**
|
|
49
|
-
* Win rate, mean gain and mean loss of
|
|
50
|
-
*
|
|
51
|
-
*
|
|
52
|
-
*
|
|
45
|
+
* Win rate, mean gain and mean loss of calendar-month returns: each month's
|
|
46
|
+
* last close against the month before's, for every asset, so a coin that
|
|
47
|
+
* trades every day and a stock that trades on weekdays are sized on the same
|
|
48
|
+
* months. A month counts once it has ended (`now` is in a later month), so a
|
|
49
|
+
* month in progress is never a return; the newest `years` × 12 complete
|
|
50
|
+
* months are used. Days and the month now are the venue's (`exchange`), a
|
|
51
|
+
* coin's UTC, so a month that has ended in Tokyo counts before it has in UTC. Null
|
|
52
|
+
* when that leaves fewer than `KELLY_HISTORY_MIN_PERIODS` returns, or every
|
|
53
|
+
* one of them is a gain, or every one of them is a loss.
|
|
53
54
|
*/
|
|
54
|
-
export function estimateKellyHistoryInputs(
|
|
55
|
+
export function estimateKellyHistoryInputs(
|
|
56
|
+
points: readonly PricePoint[],
|
|
57
|
+
yearsInput: number,
|
|
58
|
+
options: { exchange?: string; now?: number } = {},
|
|
59
|
+
): KellyHistoryInputs | null {
|
|
55
60
|
const years = clampKellyHistoryYears(yearsInput);
|
|
61
|
+
const now = venueMonth(options.now ?? Date.now(), options.exchange ?? "");
|
|
62
|
+
const thisMonth = `${now.year}-${String(now.month).padStart(2, "0")}`;
|
|
63
|
+
const monthEnds = new Map<string, { day: string; close: number }>();
|
|
56
64
|
const closes = points
|
|
57
65
|
.map((point) => ({ time: getPricePointTimestamp(point), close: point.close }))
|
|
58
66
|
.filter((point) => Number.isFinite(point.time) && Number.isFinite(point.close) && point.close > 0)
|
|
59
67
|
.sort((left, right) => left.time - right.time);
|
|
60
|
-
const
|
|
61
|
-
|
|
62
|
-
|
|
63
|
-
|
|
64
|
-
|
|
65
|
-
|
|
68
|
+
for (const point of closes) {
|
|
69
|
+
const day = dailyBarDate(point.time, options.exchange ?? "");
|
|
70
|
+
// Sorted oldest first, so each month keeps its last close.
|
|
71
|
+
if (day.slice(0, 7) < thisMonth) monthEnds.set(day.slice(0, 7), { day, close: point.close });
|
|
72
|
+
}
|
|
73
|
+
const picks = [...monthEnds.values()].slice(-(years * 12 + 1));
|
|
66
74
|
const returns = picks.slice(1).map((point, index) => point.close / picks[index]!.close - 1);
|
|
67
75
|
if (returns.length < KELLY_HISTORY_MIN_PERIODS) return null;
|
|
68
76
|
const gains = returns.filter((value) => value > 0);
|
|
@@ -75,8 +83,9 @@ export function estimateKellyHistoryInputs(points: readonly PricePoint[], yearsI
|
|
|
75
83
|
downsideReturn: mean(losses),
|
|
76
84
|
wins: gains.length,
|
|
77
85
|
periods: returns.length,
|
|
78
|
-
start:
|
|
79
|
-
end:
|
|
86
|
+
start: picks[0]!.day,
|
|
87
|
+
end: picks.at(-1)!.day,
|
|
88
|
+
latest: dailyBarDate(closes.at(-1)!.time, options.exchange ?? ""),
|
|
80
89
|
years,
|
|
81
90
|
};
|
|
82
91
|
}
|
|
@@ -20,7 +20,6 @@ import {
|
|
|
20
20
|
import type { PaneProps } from "../../../types/plugin";
|
|
21
21
|
import { useChartQueries, useFxRatesMap, useResolvedEntryValue } from "../../../market-data/hooks";
|
|
22
22
|
import { buildChartKey } from "../../../market-data/selectors";
|
|
23
|
-
import { clipPriceHistoryToRange } from "../../../time-series/history-window";
|
|
24
23
|
import { useLiveTickerFinancials, useLiveTickerFinancialsMap } from "../../../state/hooks/live-ticker-financials";
|
|
25
24
|
import { buildPortfolioFinancialsMap } from "../../../market-data/portfolio-financials";
|
|
26
25
|
import { convertCurrency, formatCurrency } from "../../../utils/format";
|
|
@@ -66,9 +65,11 @@ import {
|
|
|
66
65
|
estimateKellyHistoryInputs,
|
|
67
66
|
KELLY_HISTORY_DEFAULT_YEARS,
|
|
68
67
|
KELLY_HISTORY_MIN_PERIODS,
|
|
69
|
-
kellyHistoryRange,
|
|
70
68
|
kellyHistoryRequest,
|
|
69
|
+
kellyTrailingHistoryRequest,
|
|
71
70
|
} from "./history";
|
|
71
|
+
import { historyReadUnanswered } from "../../../time-series/calendar-month-returns";
|
|
72
|
+
import { kellyCount, kellyCountMultiplier } from "./units";
|
|
72
73
|
import { KELLY_PANE_ID } from "./constants";
|
|
73
74
|
import {
|
|
74
75
|
buildKellyCurveXAxisLabels,
|
|
@@ -240,9 +241,11 @@ export function KellySizerPane({ focused, width, height }: PaneProps) {
|
|
|
240
241
|
const { accountState } = usePortfolioAccountState(activePortfolio, { brokerAccounts, config });
|
|
241
242
|
// Cash entered by hand counts toward a manual portfolio's bankroll; a broker's is in its Net Liq.
|
|
242
243
|
const manualCash = accountState ? null : resolvePortfolioCash(activePortfolio, null);
|
|
244
|
+
// The sized ticker's own currency too: its units are counted at the base currency's rate to it.
|
|
245
|
+
const sizedCurrency = financials?.quote?.currency || ticker?.metadata.currency || null;
|
|
243
246
|
const trackedCurrencies = useMemo(
|
|
244
|
-
() => buildTrackedCurrencies(portfolioTickers, portfolioFinancials, accountState, config.baseCurrency, manualCash?.currency),
|
|
245
|
-
[accountState, config.baseCurrency, manualCash?.currency, portfolioFinancials, portfolioTickers],
|
|
247
|
+
() => [...buildTrackedCurrencies(portfolioTickers, portfolioFinancials, accountState, config.baseCurrency, manualCash?.currency), sizedCurrency],
|
|
248
|
+
[accountState, config.baseCurrency, manualCash?.currency, portfolioFinancials, portfolioTickers, sizedCurrency],
|
|
246
249
|
);
|
|
247
250
|
const exchangeRates = useFxRatesMap(trackedCurrencies);
|
|
248
251
|
const portfolioSummary = useMemo(
|
|
@@ -279,6 +282,25 @@ export function KellySizerPane({ focused, width, height }: PaneProps) {
|
|
|
279
282
|
const bankroll = bankrollOverride ?? sourceBankroll;
|
|
280
283
|
const currentValue = currentValueOverride ?? sourceCurrentValue;
|
|
281
284
|
const price = positionFinancials?.quote?.price ?? null;
|
|
285
|
+
const priceCurrency = positionFinancials?.quote?.currency || ticker?.metadata.currency || config.baseCurrency;
|
|
286
|
+
// A future is counted in contracts, each worth its price times the contract's multiplier from its terms.
|
|
287
|
+
const count = ticker
|
|
288
|
+
? kellyCount(ticker.metadata.ticker, ticker.metadata.exchange ?? "", positionFinancials?.quote?.instrumentType ?? ticker.metadata.assetCategory)
|
|
289
|
+
: "shares";
|
|
290
|
+
const [contractMultiplier, setContractMultiplier] = useState<{ symbol: string; value: number | null } | null>(null);
|
|
291
|
+
const tickerSymbol = ticker?.metadata.ticker ?? null;
|
|
292
|
+
useEffect(() => {
|
|
293
|
+
if (count !== "contracts" || !tickerSymbol) return;
|
|
294
|
+
let cancelled = false;
|
|
295
|
+
void kellyCountMultiplier(tickerSymbol, count).then((value) => {
|
|
296
|
+
if (!cancelled) setContractMultiplier({ symbol: tickerSymbol, value });
|
|
297
|
+
});
|
|
298
|
+
return () => { cancelled = true; };
|
|
299
|
+
}, [count, tickerSymbol]);
|
|
300
|
+
const multiplier = count !== "contracts" ? 1 : contractMultiplier?.symbol === tickerSymbol ? contractMultiplier.value : null;
|
|
301
|
+
// Counts divide a base-currency size by one count's value in that currency, at the rate the portfolio values holdings at.
|
|
302
|
+
const basePrice = price == null || multiplier == null ? null : convertCurrency(price, priceCurrency, config.baseCurrency, exchangeRates) * multiplier;
|
|
303
|
+
const unitPrice = basePrice != null && Number.isFinite(basePrice) && basePrice > 0 ? basePrice : null;
|
|
282
304
|
// The same daily closes, through the same request, as the KELLY report reads.
|
|
283
305
|
const historyRequest = useMemo(
|
|
284
306
|
() => mode === "history" && ticker
|
|
@@ -287,13 +309,23 @@ export function KellySizerPane({ focused, width, height }: PaneProps) {
|
|
|
287
309
|
[historyYears, mode, ticker?.metadata.exchange, ticker?.metadata.ticker],
|
|
288
310
|
);
|
|
289
311
|
const historyEntries = useChartQueries(historyRequest ? [historyRequest] : []);
|
|
290
|
-
const
|
|
312
|
+
const datedEntry = historyRequest ? historyEntries.get(buildChartKey(historyRequest)) ?? null : null;
|
|
313
|
+
// A source with no dated history answers from its trailing range, as the KELLY report does.
|
|
314
|
+
const datedUnanswered = historyReadUnanswered(datedEntry);
|
|
315
|
+
const trailingRequest = useMemo(
|
|
316
|
+
() => datedUnanswered && ticker
|
|
317
|
+
? kellyTrailingHistoryRequest({ symbol: ticker.metadata.ticker, exchange: ticker.metadata.exchange ?? "" }, historyYears)
|
|
318
|
+
: null,
|
|
319
|
+
[datedUnanswered, historyYears, ticker?.metadata.exchange, ticker?.metadata.ticker],
|
|
320
|
+
);
|
|
321
|
+
const trailingEntries = useChartQueries(trailingRequest ? [trailingRequest] : []);
|
|
322
|
+
const historyEntry = trailingRequest ? trailingEntries.get(buildChartKey(trailingRequest)) ?? null : datedEntry;
|
|
291
323
|
const historyPoints = useResolvedEntryValue(historyEntry);
|
|
292
324
|
const historyInputs = useMemo(
|
|
293
325
|
() => historyPoints
|
|
294
|
-
? estimateKellyHistoryInputs(
|
|
326
|
+
? estimateKellyHistoryInputs(historyPoints, historyYears, { exchange: ticker?.metadata.exchange ?? "" })
|
|
295
327
|
: null,
|
|
296
|
-
[historyPoints, historyYears],
|
|
328
|
+
[historyPoints, historyYears, ticker?.metadata.exchange],
|
|
297
329
|
);
|
|
298
330
|
const rawActiveDraft = drafts[sizingMode] ?? DEFAULT_KELLY_DRAFTS[sizingMode];
|
|
299
331
|
const { commonAssumptions, updateCommon } = useKellyCommonAssumptions(rawActiveDraft);
|
|
@@ -365,9 +397,9 @@ export function KellySizerPane({ focused, width, height }: PaneProps) {
|
|
|
365
397
|
draft: activeDraft,
|
|
366
398
|
bankroll,
|
|
367
399
|
currentValue,
|
|
368
|
-
price,
|
|
400
|
+
price: unitPrice,
|
|
369
401
|
}),
|
|
370
|
-
[activeDraft, bankroll, currentValue,
|
|
402
|
+
[activeDraft, bankroll, currentValue, unitPrice, sizingMode],
|
|
371
403
|
);
|
|
372
404
|
const sensitivity = useMemo(() => buildSensitivityGrid(sizingMode, activeDraft), [activeDraft, sizingMode]);
|
|
373
405
|
const curveMaxFraction = useMemo(
|
|
@@ -467,7 +499,7 @@ export function KellySizerPane({ focused, width, height }: PaneProps) {
|
|
|
467
499
|
useRemoteUiNode(mode === "history" && historyInputs ? {
|
|
468
500
|
role: "report-freshness",
|
|
469
501
|
label: "History freshness",
|
|
470
|
-
getMetadata: () => ({ asOf: historyInputs.
|
|
502
|
+
getMetadata: () => ({ asOf: historyInputs.latest }),
|
|
471
503
|
} : null);
|
|
472
504
|
// History mode says what it is waiting for, or why it has no inputs, before any sizing warning.
|
|
473
505
|
const historyStatus = mode !== "history" || historyInputs ? null
|
|
@@ -514,6 +546,7 @@ export function KellySizerPane({ focused, width, height }: PaneProps) {
|
|
|
514
546
|
...(mode === "history" && historyInputs ? buildKellyHistoryItems(historyInputs) : []),
|
|
515
547
|
...buildKellyResultItems({
|
|
516
548
|
result,
|
|
549
|
+
count,
|
|
517
550
|
baseCurrency: config.baseCurrency,
|
|
518
551
|
currentGrowth,
|
|
519
552
|
targetGrowth,
|
|
@@ -14,6 +14,7 @@ import { Box } from "../../../ui";
|
|
|
14
14
|
import { displayWidth, formatCurrency, formatNumber, MISSING_VALUE } from "../../../utils/format";
|
|
15
15
|
import type { KellySizingResult, SensitivityGrid } from "./types";
|
|
16
16
|
import type { KellyHistoryInputs } from "./history";
|
|
17
|
+
import type { KellyCount } from "./units";
|
|
17
18
|
import { formatPct, formatSignedPct } from "./view";
|
|
18
19
|
|
|
19
20
|
/** The longest result label ("Full growth"), which sets the band's label column. */
|
|
@@ -34,6 +35,7 @@ export function buildKellyHistoryItems(inputs: KellyHistoryInputs): StatItem[] {
|
|
|
34
35
|
|
|
35
36
|
/** What the first money figure says while there is no bankroll to size in. */
|
|
36
37
|
const BANKROLL_HINT = "Set a bankroll";
|
|
38
|
+
const COUNT_LABEL: Record<KellyCount, string> = { shares: "Shares", units: "Units", contracts: "Contracts" };
|
|
37
39
|
|
|
38
40
|
/**
|
|
39
41
|
* The sizing result as one band under the inputs, laid out in the FieldGrid's
|
|
@@ -44,6 +46,7 @@ const BANKROLL_HINT = "Set a bankroll";
|
|
|
44
46
|
*/
|
|
45
47
|
export function buildKellyResultItems({
|
|
46
48
|
result,
|
|
49
|
+
count = "units",
|
|
47
50
|
baseCurrency,
|
|
48
51
|
currentGrowth,
|
|
49
52
|
targetGrowth,
|
|
@@ -51,6 +54,8 @@ export function buildKellyResultItems({
|
|
|
51
54
|
columns,
|
|
52
55
|
}: {
|
|
53
56
|
result: KellySizingResult;
|
|
57
|
+
/** What the add or trim is counted in: a future's contracts, a coin's units, a stock's shares. */
|
|
58
|
+
count?: KellyCount;
|
|
54
59
|
baseCurrency: string;
|
|
55
60
|
/** Null when the holding is not a share of any bankroll. */
|
|
56
61
|
currentGrowth: number | null;
|
|
@@ -59,7 +64,7 @@ export function buildKellyResultItems({
|
|
|
59
64
|
columns: number;
|
|
60
65
|
}): StatItem[] {
|
|
61
66
|
const addTrim = result.addTrimValue == null ? MISSING_VALUE : formatCurrency(result.addTrimValue, baseCurrency);
|
|
62
|
-
const units = result.estimatedUnits == null ? null : `${formatNumber(result.estimatedUnits, 1)}
|
|
67
|
+
const units = result.estimatedUnits == null ? null : `${formatNumber(result.estimatedUnits, 1)} ${count}`;
|
|
63
68
|
// The units ride beside the amount when the column has room for label,
|
|
64
69
|
// amount and units (plus the cell inset and gaps); otherwise they take a
|
|
65
70
|
// cell of their own rather than being cut off at the column edge.
|
|
@@ -86,7 +91,7 @@ export function buildKellyResultItems({
|
|
|
86
91
|
color: result.addTrimValue == null ? undefined : priceColor(result.addTrimValue),
|
|
87
92
|
},
|
|
88
93
|
...(units != null && !unitsInline
|
|
89
|
-
? [{ id: "units", label:
|
|
94
|
+
? [{ id: "units", label: COUNT_LABEL[count], value: formatNumber(result.estimatedUnits!, 1) }]
|
|
90
95
|
: []),
|
|
91
96
|
{
|
|
92
97
|
id: "risk",
|
|
@@ -0,0 +1,29 @@
|
|
|
1
|
+
import type { FuturesContractTermsPayload } from "../../../api-client/futures-curve";
|
|
2
|
+
import { isFuturesInstrument, loadFuturesContractTermsCached } from "../../../market-data/futures-contract";
|
|
3
|
+
import { futuresContractSize } from "../../../portfolio/futures-positions";
|
|
4
|
+
import { isRoundTheClockCoin } from "../../../utils/crypto-pair";
|
|
5
|
+
import { logFailure } from "../../../utils/log-failure";
|
|
6
|
+
|
|
7
|
+
/** What a Kelly position is counted in: shares of a stock or fund, units of a coin, contracts of a future. */
|
|
8
|
+
export type KellyCount = "shares" | "units" | "contracts";
|
|
9
|
+
|
|
10
|
+
export function kellyCount(symbol: string, exchange: string, instrumentType: string | null | undefined): KellyCount {
|
|
11
|
+
if (isFuturesInstrument(symbol, instrumentType)) return "contracts";
|
|
12
|
+
return isRoundTheClockCoin(symbol, exchange) ? "units" : "shares";
|
|
13
|
+
}
|
|
14
|
+
|
|
15
|
+
/**
|
|
16
|
+
* What one of the count is worth per unit of price: a future's contract
|
|
17
|
+
* multiplier from the exchange's terms (ES's $50 a point, ZC's 5,000 bushels
|
|
18
|
+
* on a price in cents), 1 for a share or a coin. Null for a future whose terms
|
|
19
|
+
* cannot be read, so a position is never counted in price points.
|
|
20
|
+
*/
|
|
21
|
+
export async function kellyCountMultiplier(
|
|
22
|
+
symbol: string,
|
|
23
|
+
count: KellyCount,
|
|
24
|
+
load: (symbol: string) => Promise<FuturesContractTermsPayload | null> = loadFuturesContractTermsCached,
|
|
25
|
+
): Promise<number | null> {
|
|
26
|
+
if (count !== "contracts") return 1;
|
|
27
|
+
const terms = await load(symbol).catch(logFailure("kelly-sizer.units", "Read futures contract terms failed", null));
|
|
28
|
+
return futuresContractSize(terms?.spec)?.multiplier ?? null;
|
|
29
|
+
}
|
|
@@ -25,15 +25,16 @@ import { useNewsReadState } from "./wire/read-state";
|
|
|
25
25
|
import { createTickerSurfacePaneTemplate } from "../shared/ticker-surface";
|
|
26
26
|
import { tickerNewsHeadless } from "./headless";
|
|
27
27
|
import { usePaneTickerIdentity } from "../../../state/hooks/pane-ticker";
|
|
28
|
+
import { TICKER_NEWS_TAB_ID, TICKER_NEWS_TEMPLATE_ID, tickerNewsQuery, tickerNewsStateKeys } from "./ticker-news";
|
|
28
29
|
|
|
29
|
-
const NEWS_ITEM_LIMIT = 50;
|
|
30
30
|
const DEFAULT_SORT: NewsSortPreference = { columnId: "time", direction: "desc" };
|
|
31
31
|
|
|
32
32
|
function TickerNewsView({ width, height, focused }: { width: number; height: number; focused: boolean }) {
|
|
33
33
|
const { ticker } = usePaneTickerIdentity();
|
|
34
34
|
const symbol = ticker?.metadata.ticker ?? "none";
|
|
35
|
+
const stateKeys = tickerNewsStateKeys(symbol);
|
|
35
36
|
const [selectedArticleId, setSelectedArticleId] = useDebouncedPluginPaneState<string | null>(
|
|
36
|
-
|
|
37
|
+
stateKeys.selectedArticleId,
|
|
37
38
|
null,
|
|
38
39
|
);
|
|
39
40
|
const [sortPreference, setSortPreference] = usePluginPaneState<NewsSortPreference>(
|
|
@@ -41,14 +42,7 @@ function TickerNewsView({ width, height, focused }: { width: number; height: num
|
|
|
41
42
|
DEFAULT_SORT,
|
|
42
43
|
);
|
|
43
44
|
const instrument = instrumentFromTicker(ticker, ticker?.metadata.ticker ?? null);
|
|
44
|
-
const newsQuery =
|
|
45
|
-
feed: "ticker" as const,
|
|
46
|
-
ticker: instrument.symbol,
|
|
47
|
-
exchange: instrument.exchange,
|
|
48
|
-
tickerTier: "primary" as const,
|
|
49
|
-
limit: NEWS_ITEM_LIMIT,
|
|
50
|
-
...(ticker?.metadata.name ? { listingName: ticker.metadata.name } : {}),
|
|
51
|
-
} : null;
|
|
45
|
+
const newsQuery = tickerNewsQuery(ticker);
|
|
52
46
|
const newsState = useNewsArticles(newsQuery);
|
|
53
47
|
const loaded = usePersistedNewsArticles(
|
|
54
48
|
`articles:${instrument?.symbol ?? "none"}:${instrument?.exchange ?? ""}`,
|
|
@@ -64,7 +58,7 @@ function TickerNewsView({ width, height, focused }: { width: number; height: num
|
|
|
64
58
|
const { detailArticle, detailLoading, detailError, openArticle, closeDetail } = useNewsArticleDetail(
|
|
65
59
|
visibleArticles,
|
|
66
60
|
loadNewsStory,
|
|
67
|
-
|
|
61
|
+
stateKeys.openArticleId,
|
|
68
62
|
);
|
|
69
63
|
const popOutArticle = usePopOutNewsArticle(closeDetail);
|
|
70
64
|
const openListedArticle = useCallback((article: typeof visibleArticles[number]) => {
|
|
@@ -209,7 +203,7 @@ export const tickerNewsModule: PluginModule = {
|
|
|
209
203
|
paneTemplates: [
|
|
210
204
|
{
|
|
211
205
|
...createTickerSurfacePaneTemplate({
|
|
212
|
-
id:
|
|
206
|
+
id: TICKER_NEWS_TEMPLATE_ID,
|
|
213
207
|
paneId: "ticker-news",
|
|
214
208
|
label: "Ticker News",
|
|
215
209
|
description: "Company news for the selected ticker.",
|
|
@@ -223,7 +217,7 @@ export const tickerNewsModule: PluginModule = {
|
|
|
223
217
|
|
|
224
218
|
setup(ctx) {
|
|
225
219
|
ctx.registerTickerResearchTab({
|
|
226
|
-
id:
|
|
220
|
+
id: TICKER_NEWS_TAB_ID,
|
|
227
221
|
name: "News",
|
|
228
222
|
order: 40,
|
|
229
223
|
component: TickerNewsView,
|