gloomberb 0.20.2 → 0.20.4
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-dialog.tsx +17 -0
- 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 +23 -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/fx-interventions.ts +64 -0
- package/src/api-client/index.ts +2 -0
- package/src/api-client/paths.ts +9 -1
- package/src/api-client/release-summaries.ts +21 -0
- package/src/api-client/social-mentions.ts +47 -0
- package/src/api-client/types/econ.ts +4 -0
- package/src/app/keybindings/actions.ts +2 -2
- package/src/app/pane-runtime/ticker-open-runtime.ts +245 -66
- package/src/app.tsx +11 -1
- package/src/cli/command-options.ts +2 -1
- package/src/cli/commands/market.ts +188 -30
- package/src/cli/commands/news-search.ts +1 -3
- package/src/cli/commands/options-chain.ts +23 -6
- package/src/cli/commands/overview.ts +13 -5
- package/src/cli/commands/plugins.ts +76 -23
- package/src/cli/commands/search.ts +25 -6
- package/src/cli/commands/system.ts +19 -3
- package/src/cli/commands/ticker.ts +64 -21
- 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 +14 -46
- 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 +26 -14
- 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 +40 -8
- package/src/cli/result.ts +21 -9
- 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/types.ts +2 -0
- package/src/cli/unknown-command.ts +88 -0
- package/src/components/chart/composite/axis-overlays.tsx +22 -0
- package/src/components/chart/composite/composite-chart.tsx +54 -13
- package/src/components/chart/composite/event-captions.ts +109 -0
- package/src/components/chart/composite/event-guides.ts +74 -0
- package/src/components/chart/composite/rasterizer.ts +2 -0
- package/src/components/chart/composite/text-renderer.ts +2 -0
- package/src/components/chart/composite/types.ts +31 -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/layout-items/focused-pane.ts +5 -5
- 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 +192 -33
- 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 +104 -6
- package/src/components/command-bar/routes/ticker-search/route.ts +3 -2
- 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/detached-pane-shell.tsx +1 -1
- package/src/components/layout/double-escape-close.ts +8 -5
- package/src/components/layout/floating-pane.tsx +5 -1
- 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 +44 -19
- package/src/components/layout/pane/footer/model.ts +52 -20
- package/src/components/layout/pane/header.tsx +3 -2
- package/src/components/layout/shell/action-menu-overlay.tsx +10 -5
- package/src/components/layout/shell/active-drag.ts +149 -105
- package/src/components/layout/shell/chrome.ts +15 -15
- package/src/components/layout/shell/drag/drop-zones.ts +162 -0
- package/src/components/layout/shell/drag/index.ts +47 -218
- package/src/components/layout/shell/drag/live.ts +10 -3
- package/src/components/layout/shell/drag/overlays.tsx +182 -5
- package/src/components/layout/shell/drag/runtime.ts +29 -6
- package/src/components/layout/shell/drag/shared-edges.ts +156 -0
- package/src/components/layout/shell/index.tsx +11 -6
- package/src/components/layout/shell/menu.ts +11 -2
- package/src/components/layout/shell/native/pointer-runtime.ts +25 -0
- package/src/components/layout/shell/native/window-state.ts +2 -2
- package/src/components/layout/shell/pane/layers.tsx +71 -7
- package/src/components/layout/shell/terminal-pointer-runtime.ts +18 -9
- package/src/components/layout/shell/window-mode/index.ts +8 -10
- package/src/components/layout/status-bar.tsx +8 -7
- package/src/components/layout/status-widget-space.ts +8 -0
- package/src/components/layout/window-edit/mode.ts +39 -7
- package/src/components/layout/window-edit/presentation.ts +1 -1
- 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 +19 -6
- package/src/components/onboarding/onboarding-wizard.tsx +69 -14
- 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 +15 -2
- package/src/components/ui/choice-dialog.tsx +1 -0
- package/src/components/ui/column-grid.tsx +18 -9
- package/src/components/ui/data-table/index.tsx +5 -4
- 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/list-view.tsx +7 -12
- package/src/components/ui/loading.tsx +10 -3
- package/src/components/ui/menu.tsx +9 -3
- package/src/components/ui/message-composer.tsx +2 -2
- package/src/components/ui/quote.ts +14 -1
- 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/layout.ts +5 -2
- package/src/data/config/store/normalize.ts +6 -0
- package/src/docs/snapshot.json +149 -74
- package/src/i18n/es.ts +33 -9
- package/src/i18n/ja.ts +33 -9
- package/src/i18n/ko.ts +33 -9
- package/src/i18n/zh-cn.ts +33 -9
- package/src/i18n/zh-tw.ts +33 -9
- package/src/layout/pane-manager/floating-actions.ts +17 -0
- package/src/layout/pane-manager/floating-stack.ts +187 -0
- package/src/layout/pane-manager/floating.ts +4 -2
- package/src/layout/pane-manager/gridlock.ts +16 -1
- package/src/layout/pane-manager/index.ts +11 -0
- package/src/layout/pane-manager/layout-state.ts +10 -3
- 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 +126 -1
- package/src/market-data/futures-contract.ts +21 -6
- package/src/market-data/fx-interventions.ts +270 -0
- 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/news/news-model.ts +44 -2
- 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 +223 -32
- 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 +39 -15
- package/src/plugins/builtin/alerts/headless.ts +30 -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 +161 -0
- package/src/plugins/builtin/alerts/move.ts +181 -0
- package/src/plugins/builtin/alerts/pane.tsx +50 -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 +22 -7
- package/src/plugins/builtin/alerts/types.ts +25 -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/changelog/index.tsx +292 -101
- package/src/plugins/builtin/changelog/versions.ts +293 -0
- 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/chart-composer/intervention-events.ts +105 -0
- package/src/plugins/builtin/chart-composer/pane.tsx +21 -7
- package/src/plugins/builtin/chat/message/render-state.ts +2 -5
- package/src/plugins/builtin/cloud/askg/attached-pane.tsx +10 -5
- package/src/plugins/builtin/cloud/askg/controller.ts +141 -5
- package/src/plugins/builtin/cloud/askg/executor.ts +113 -4
- package/src/plugins/builtin/cloud/askg/manifest.ts +28 -13
- package/src/plugins/builtin/cloud/askg/model.ts +14 -4
- package/src/plugins/builtin/cloud/askg/pane.tsx +70 -46
- package/src/plugins/builtin/cloud/askg/turn-parts.tsx +70 -0
- package/src/plugins/builtin/cloud/terminal-relay/engine.ts +50 -130
- package/src/plugins/builtin/cloud/terminal-relay/policy.ts +327 -7
- package/src/plugins/builtin/cloud/terminal-relay/prompts.tsx +2 -1
- package/src/plugins/builtin/cloud/terminal-relay/redact.ts +47 -6
- package/src/plugins/builtin/cloud/upgrade-status-widget.tsx +9 -2
- package/src/plugins/builtin/commodities-energy/index.tsx +1 -3
- package/src/plugins/builtin/commodities-energy/view-state.ts +3 -0
- package/src/plugins/builtin/cot/headless.ts +14 -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/earnings/index.tsx +2 -2
- 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/index.tsx +25 -4
- package/src/plugins/builtin/futures/model.ts +28 -32
- package/src/plugins/builtin/futures/series.ts +4 -3
- package/src/plugins/builtin/futures/table.tsx +17 -10
- package/src/plugins/builtin/futures/use-board-terms.ts +3 -3
- 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/help/index.tsx +3 -3
- package/src/plugins/builtin/help/keybindings-editor.tsx +18 -4
- 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/layout-manager/index.tsx +8 -8
- package/src/plugins/builtin/news/headless.ts +2 -2
- package/src/plugins/builtin/news/index.tsx +10 -16
- 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 +7 -4
- 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/plugin-marketplace/pane.tsx +11 -11
- 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/summary/index.tsx +3 -1
- 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/research/event-model.ts +9 -1
- package/src/plugins/builtin/research/event-sources.ts +22 -0
- package/src/plugins/builtin/research/headless.ts +3 -3
- 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/cloud-upgrade.ts +27 -3
- 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 +67 -6
- 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 +69 -19
- package/src/plugins/builtin/ticker-detail/pane.tsx +7 -2
- 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 +53 -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/remote/resources.ts +12 -1
- package/src/remote/schema.ts +1 -0
- package/src/remote/semantic-helpers.ts +29 -1
- package/src/remote/semantic-tree.tsx +32 -15
- 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/cloudflare/worker.ts +16 -1
- 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 +73 -19
- package/src/renderers/electrobun/bun/desktop/app-name.ts +1 -1
- package/src/renderers/opentui/host.tsx +2 -1
- package/src/renderers/share/layout-view.tsx +1 -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/news.ts +35 -12
- package/src/sources/gloomberb-cloud/normalizers.ts +29 -3
- package/src/sources/provider-router/cached-routes.ts +19 -7
- package/src/state/opening-ticker-panes.ts +47 -0
- package/src/state/pane-table-export-registry.ts +19 -6
- package/src/test-support/cli-context.ts +2 -0
- package/src/test-support/preload.ts +8 -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/instrument-kind.ts +23 -3
- 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 +13 -0
- package/src/types/context-menu.ts +2 -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/types/plugin-commands.ts +140 -0
- package/src/types/plugin-context.ts +125 -0
- package/src/types/plugin-contributions.ts +55 -0
- package/src/types/plugin-definition.ts +234 -0
- package/src/types/plugin-notifications.ts +38 -0
- package/src/types/plugin-pane-settings.ts +114 -0
- package/src/types/plugin-pane-templates.ts +160 -0
- package/src/types/plugin-panes.ts +221 -0
- package/src/types/plugin-reports.ts +35 -0
- package/src/types/plugin-shared.ts +14 -0
- package/src/types/plugin-state.ts +71 -0
- package/src/types/plugin.ts +14 -1169
- package/src/ui/host.tsx +8 -0
- package/src/ui/index.tsx +14 -3
- package/src/updater/github-releases.ts +23 -0
- package/src/utils/cli-output.ts +22 -9
- 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
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
import { useCallback, useEffect, useMemo, useRef, type ReactNode, type RefObject } from "react";
|
|
2
|
-
import {
|
|
2
|
+
import type { ScrollBoxRenderable } from "../../../../../ui";
|
|
3
3
|
import {
|
|
4
4
|
DataTableStackView,
|
|
5
5
|
TickerBadgeList,
|
|
@@ -14,12 +14,12 @@ import type { MarketNewsItem } from "../../../../../types/news-source";
|
|
|
14
14
|
import { colors } from "../../../../../theme/colors";
|
|
15
15
|
import { collectNewsDisplayTickers } from "../../../../../news/ticker-symbols";
|
|
16
16
|
import { useLoadNewsStory } from "../../../../../news/hooks";
|
|
17
|
-
import { formatFeedTime } from "../../../../../utils/datetime-format";
|
|
18
17
|
import { logFailure } from "../../../../../utils/log-failure";
|
|
19
18
|
import { nextHeaderSort } from "../../../../../utils/sort-values";
|
|
20
19
|
import { formatNewsCategoryForColumn } from "../categories";
|
|
21
20
|
import { useOpenTickerChoice } from "../../../shared/ticker-choice";
|
|
22
21
|
import { usePinnedMoment } from "../../../../../components/use-pinned-moment";
|
|
22
|
+
import { MIN_HEADLINE_WIDTH, NEWS_SOURCE_WIDTH, NEWS_TIME_WIDTH, newsHeadlineCell, newsSourceCell, newsTimeCell } from "./row";
|
|
23
23
|
|
|
24
24
|
export type NewsColumnId =
|
|
25
25
|
| "rank"
|
|
@@ -114,10 +114,8 @@ function sortNewsArticles(
|
|
|
114
114
|
|
|
115
115
|
const FIXED_COLUMN_WIDTHS: Record<Exclude<NewsColumnId, "title">, number> = {
|
|
116
116
|
rank: 4,
|
|
117
|
-
|
|
118
|
-
|
|
119
|
-
// Publishers and X handles: "GlobeNewswire", "@unusual_whales".
|
|
120
|
-
source: 15,
|
|
117
|
+
time: NEWS_TIME_WIDTH,
|
|
118
|
+
source: NEWS_SOURCE_WIDTH,
|
|
121
119
|
tickers: 18,
|
|
122
120
|
categories: 10,
|
|
123
121
|
sentiment: 4,
|
|
@@ -147,9 +145,6 @@ const SPELLED_SENTIMENT_MIN_HEADLINE_WIDTH = 60;
|
|
|
147
145
|
const columnAlign = (id: NewsColumnId): "left" | "right" =>
|
|
148
146
|
id === "rank" || id === "importance" ? "right" : "left";
|
|
149
147
|
|
|
150
|
-
/** Below this the headline takes room back from the other columns. */
|
|
151
|
-
const MIN_HEADLINE_WIDTH = 40;
|
|
152
|
-
|
|
153
148
|
/**
|
|
154
149
|
* What a narrowing pane gives up, in order, to keep the headline readable: a
|
|
155
150
|
* step with a width shrinks that column, one without drops it. Time and rank
|
|
@@ -330,19 +325,13 @@ export function NewsArticleStackView({
|
|
|
330
325
|
case "rank":
|
|
331
326
|
return { text: String(index + 1), color: tone(colors.textDim) };
|
|
332
327
|
case "time":
|
|
333
|
-
return {
|
|
328
|
+
return { ...newsTimeCell(item, { later }), value: item.publishedAt };
|
|
334
329
|
case "source":
|
|
335
|
-
return
|
|
330
|
+
return newsSourceCell(item);
|
|
336
331
|
case "title":
|
|
337
|
-
|
|
338
|
-
|
|
339
|
-
|
|
340
|
-
text: titleForArticle?.(item) ?? item.title,
|
|
341
|
-
color: tone(colors.text),
|
|
342
|
-
attributes: later || readArticleIds?.has(item.id)
|
|
343
|
-
? TextAttributes.NONE
|
|
344
|
-
: TextAttributes.BOLD,
|
|
345
|
-
};
|
|
332
|
+
// Unclipped: the table fits it to the width the column really gets,
|
|
333
|
+
// which on desktop is wider than the width it was laid out at.
|
|
334
|
+
return newsHeadlineCell(item, { later, read: readArticleIds?.has(item.id), title: titleForArticle?.(item) });
|
|
346
335
|
case "tickers": {
|
|
347
336
|
const tickers = fitTickerSymbols(collectNewsDisplayTickers(item.tickers), column.width);
|
|
348
337
|
return {
|
|
@@ -5,10 +5,12 @@ import {
|
|
|
5
5
|
extractImpliedForward,
|
|
6
6
|
forwardFromCarry,
|
|
7
7
|
optionMid,
|
|
8
|
+
quoteUnderIntrinsic,
|
|
8
9
|
realizedVolatilityCadenceIssue,
|
|
9
10
|
realizedVolatilityResult,
|
|
10
11
|
solveImpliedVolatility,
|
|
11
12
|
valueOption,
|
|
13
|
+
withQuotesUnderIntrinsicMarked,
|
|
12
14
|
type OptionSide,
|
|
13
15
|
type OptionValuation,
|
|
14
16
|
} from "../shared/volatility";
|
|
@@ -110,6 +112,8 @@ export function solveChainVolatilities(
|
|
|
110
112
|
return { valuationTime, byStrike, filled };
|
|
111
113
|
}
|
|
112
114
|
if (!positive(spot)) return { valuationTime, byStrike, filled };
|
|
115
|
+
// A quote under intrinsic is no market: no midpoint, forward or IV is read from it.
|
|
116
|
+
chain = withQuotesUnderIntrinsicMarked(chain, spot);
|
|
113
117
|
const rate = optionChainRate(chain);
|
|
114
118
|
const carry = Number.isFinite(dividendYield) ? dividendYield! : 0;
|
|
115
119
|
const expirations = new Set([...chain.calls, ...chain.puts].map((contract) => contract.expiration));
|
|
@@ -242,8 +246,9 @@ export function calculateOptionGreeks(
|
|
|
242
246
|
return { price, delta, gamma, thetaPerDay: theta, vegaPerPoint: vega, rhoPerPoint: 0 };
|
|
243
247
|
}
|
|
244
248
|
const volatility = contract ? volatilities.byStrike.get(contract.strike) : undefined;
|
|
245
|
-
// A side nobody bids has no market to measure sensitivity against.
|
|
246
|
-
if (!contract || optionMid(contract) == null ||
|
|
249
|
+
// A side nobody bids, or a stale quote, has no market to measure sensitivity against.
|
|
250
|
+
if (!contract || optionMid(contract) == null || quoteUnderIntrinsic(contract, side, spot) || !positive(spot) || !positive(contract.strike)
|
|
251
|
+
|| volatility == null || !(volatility >= 0)) {
|
|
247
252
|
return undefined;
|
|
248
253
|
}
|
|
249
254
|
return valueOption({
|
|
@@ -155,8 +155,13 @@ export function overlayOptionContractQuote(
|
|
|
155
155
|
const volume = isFiniteNumber(quote.volume) && quote.volume >= 0
|
|
156
156
|
&& (contract.volume == null || !Number.isFinite(contract.volume) || quote.volume >= contract.volume)
|
|
157
157
|
? quote.volume : contract.volume;
|
|
158
|
+
// A streamed bid and ask newer than the snapshot are a market now: the snapshot's stale mark (quoted before the
|
|
159
|
+
// session, or under intrinsic) no longer applies. The pane checks the new quote against intrinsic again.
|
|
160
|
+
const { quoteStale, ...snapshot } = contract;
|
|
161
|
+
const freshBook = isFiniteNumber(quote.bid) && isFiniteNumber(quote.ask);
|
|
158
162
|
return {
|
|
159
|
-
...
|
|
163
|
+
...snapshot,
|
|
164
|
+
...(quoteStale && !freshBook ? { quoteStale } : {}),
|
|
160
165
|
// Generic quote.price may itself be a midpoint. LAST must remain an
|
|
161
166
|
// executed trade, with its own timestamp, even while the bid/ask updates.
|
|
162
167
|
lastPrice: hasNewTrade ? quote.lastTradePrice! : contract.lastPrice,
|
|
@@ -308,7 +308,8 @@ function formatOptionContractCell(
|
|
|
308
308
|
case "openInterest":
|
|
309
309
|
return formatCompact(contract.openInterest, { fixedDecimals: true });
|
|
310
310
|
case "iv":
|
|
311
|
-
|
|
311
|
+
// A stale quote (from before the session, or under intrinsic) is shown, but no IV or greek is read from it.
|
|
312
|
+
return contract.quoteStale ? "stale" : formatIv(row.impliedVolatility, row.impliedVolatilityFilled);
|
|
312
313
|
case "delta":
|
|
313
314
|
return formatGreek(greeks?.delta);
|
|
314
315
|
case "gamma":
|
|
@@ -358,7 +359,7 @@ export function renderOptionCell(
|
|
|
358
359
|
const surface = backgroundColor ?? rowSurface;
|
|
359
360
|
return {
|
|
360
361
|
text: formatOptionContractCell(row, contract, column),
|
|
361
|
-
color: contract ? optionRoleColor(optionColumnRole(column), surface) : optionMutedColor(surface),
|
|
362
|
+
color: contract && !contract.quoteStale ? optionRoleColor(optionColumnRole(column), surface) : optionMutedColor(surface),
|
|
362
363
|
keepColorWhenSelected: otherHalf,
|
|
363
364
|
backgroundColor,
|
|
364
365
|
};
|
|
@@ -72,7 +72,7 @@ import { signedPositionDirection } from "../../../portfolio/position-metrics";
|
|
|
72
72
|
import { optionMarketReference } from "./market-reference";
|
|
73
73
|
import { useOptionsEnrichment } from "./enrichment";
|
|
74
74
|
import type { OptionsEnrichmentSnapshot } from "./enrichment-model";
|
|
75
|
-
import { optionMid, type OptionSide } from "../shared/volatility";
|
|
75
|
+
import { optionMid, withQuotesUnderIntrinsicMarked, type OptionSide } from "../shared/volatility";
|
|
76
76
|
import type { TickerRecord } from "../../../types/ticker";
|
|
77
77
|
import type { TickerFinancials } from "../../../types/financials";
|
|
78
78
|
import type { IvStats } from "../iv-history/client";
|
|
@@ -551,14 +551,6 @@ export function OptionsView({ width, height, focused, nestedInTabs = false, ivRa
|
|
|
551
551
|
() => strikeChain ? overlayOptionChainQuotes(strikeChain, optionQuoteEntries, optionQuoteFreshness, optionQuoteBroker).chain : null,
|
|
552
552
|
[optionQuoteEntries, optionQuoteFreshness, strikeChain, optionQuoteBroker],
|
|
553
553
|
);
|
|
554
|
-
const callsByStrike = useMemo(
|
|
555
|
-
() => new Map(liveChain?.calls.map((c) => [c.strike, c]) ?? []),
|
|
556
|
-
[liveChain],
|
|
557
|
-
);
|
|
558
|
-
const putsByStrike = useMemo(
|
|
559
|
-
() => new Map(liveChain?.puts.map((p) => [p.strike, p]) ?? []),
|
|
560
|
-
[liveChain],
|
|
561
|
-
);
|
|
562
554
|
// IV and the Greeks are valued at one spot and instant, which the footer
|
|
563
555
|
// names: the close a chain from the close was quoted against, else the
|
|
564
556
|
// latest price (docs/research-data.md#greeks-spot-and-time).
|
|
@@ -566,6 +558,16 @@ export function OptionsView({ width, height, focused, nestedInTabs = false, ivRa
|
|
|
566
558
|
const modelSpot = useMemo(() => liveChain ? optionModelSpot(underlyingQuote, liveChain, Date.now(), effectiveExchange) : null,
|
|
567
559
|
[liveChain, underlyingQuote, effectiveExchange]);
|
|
568
560
|
const greeksSpot = modelSpot?.price;
|
|
561
|
+
// A quote under intrinsic at that spot is shown stale, as the server marks one from before the session.
|
|
562
|
+
const pricedChain = useMemo(() => liveChain ? withQuotesUnderIntrinsicMarked(liveChain, greeksSpot) : null, [greeksSpot, liveChain]);
|
|
563
|
+
const callsByStrike = useMemo(
|
|
564
|
+
() => new Map(pricedChain?.calls.map((c) => [c.strike, c]) ?? []),
|
|
565
|
+
[pricedChain],
|
|
566
|
+
);
|
|
567
|
+
const putsByStrike = useMemo(
|
|
568
|
+
() => new Map(pricedChain?.puts.map((p) => [p.strike, p]) ?? []),
|
|
569
|
+
[pricedChain],
|
|
570
|
+
);
|
|
569
571
|
// One solve per applied batch: a streamed contract's IV comes from its live
|
|
570
572
|
// midpoint, the rest from the snapshot, all against the same forward.
|
|
571
573
|
const volatilities = useMemo(
|
|
@@ -34,6 +34,8 @@ export interface ScenarioMarketSnapshot {
|
|
|
34
34
|
dividendYieldBasis?: ModelDividendYield["basis"] | null;
|
|
35
35
|
/** The last distribution's ex-date of a dividend that stopped (basis `stopped`). */
|
|
36
36
|
dividendLastPaid?: string | null;
|
|
37
|
+
/** The last ex-date of a monthly payer's history that ends there, beside a stated yield (ModelDividendYield.historyEnds). */
|
|
38
|
+
dividendHistoryEnds?: string | null;
|
|
37
39
|
source: string | null;
|
|
38
40
|
underlyingQuote: Quote | null;
|
|
39
41
|
rateAsOf: string[];
|
|
@@ -180,6 +182,7 @@ export async function loadScenarioMarket(
|
|
|
180
182
|
asOf: quoteCurrent && positive(quote!.lastUpdated) ? quote!.lastUpdated : now,
|
|
181
183
|
chain, expirationDates, rate: rate.rate, dividendYield: dividend?.value ?? null, dividendYieldBasis: dividend?.basis ?? null,
|
|
182
184
|
...(dividend?.basis === "stopped" ? { dividendLastPaid: dividend.lastPaid ?? null } : {}),
|
|
185
|
+
...(dividend?.historyEnds ? { dividendHistoryEnds: dividend.historyEnds } : {}),
|
|
183
186
|
source: quoteCurrent ? quoteEntry?.source ?? quote!.providerId ?? null : null,
|
|
184
187
|
underlyingQuote: quoteCurrent ? quote : null, rateAsOf: rate.asOf, warnings: [...new Set(warnings)],
|
|
185
188
|
...(missingExpiry ? { missingExpiry } : {}),
|
|
@@ -141,7 +141,7 @@ export const optionsScenarioHeadless: HeadlessPaneDefinition<"bundle"> = {
|
|
|
141
141
|
? scenarioSpotBasis({}, { spot: market.spot!, legs: [] }, market) : null;
|
|
142
142
|
const currency = position ? currencyLabel(position.currency) : null;
|
|
143
143
|
const dividendNote = supplied(settings.dividendYield) ? null
|
|
144
|
-
: modelDividendYieldNote({ basis: market.dividendYieldBasis ?? "stated", lastPaid: market.dividendLastPaid });
|
|
144
|
+
: modelDividendYieldNote({ basis: market.dividendYieldBasis ?? "stated", lastPaid: market.dividendLastPaid, historyEnds: market.dividendHistoryEnds });
|
|
145
145
|
// Value, P&L, risk and the grid add every contract; entry prices and spot are per share.
|
|
146
146
|
const valueUnit = position ? scenarioValueUnit(position) : null;
|
|
147
147
|
const per = `${currency} ${valueUnit}`;
|
|
@@ -211,8 +211,9 @@ function validatePerpsMarket<T extends PerpMarketPayload>(data: T): T {
|
|
|
211
211
|
const fetchPerpsMarket = async (marketId: string, client: Pick<typeof apiClient, "getCloudPerpsMarket"> = apiClient) => validatePerpsMarket(await client.getCloudPerpsMarket(marketId));
|
|
212
212
|
|
|
213
213
|
/**
|
|
214
|
-
* The Market column
|
|
215
|
-
*
|
|
214
|
+
* The label the Market column wrote for a market on a Hyperliquid builder dex before it wrote Hyperliquid's own name
|
|
215
|
+
* (`SP500 · XYZ`), read back as that name, `xyz:SP500`, so a market typed or saved that way still opens; anything
|
|
216
|
+
* else is returned as typed.
|
|
216
217
|
*/
|
|
217
218
|
export const marketQuery = (input: string) => {
|
|
218
219
|
const label = /^([^\s·]+)\s*·\s*([^\s·]+)$/.exec(input.trim());
|
|
@@ -246,7 +247,7 @@ const QUOTE_WORDS = new Set(["USD", "USDT", "USDC", "PERP", "SWAP"]);
|
|
|
246
247
|
|
|
247
248
|
/**
|
|
248
249
|
* The board names nearest an input nothing matched: markets whose symbol, base asset or name carry a word of it
|
|
249
|
-
* (or all but its last letters), the biggest first, written as the Market column writes them (`BZ`, `BRENTOIL
|
|
250
|
+
* (or all but its last letters), the biggest first, written as the Market column writes them (`BZ`, `xyz:BRENTOIL`). Free text with several
|
|
250
251
|
* words is no market name and gets none. A board that cannot be read leaves the caller its own examples.
|
|
251
252
|
*/
|
|
252
253
|
export async function nearestPerpMarkets(input: string, client: Pick<typeof apiClient, "getCloudPerpsBoard"> = apiClient): Promise<string[]> {
|
|
@@ -270,7 +271,7 @@ export async function nearestPerpMarkets(input: string, client: Pick<typeof apiC
|
|
|
270
271
|
}
|
|
271
272
|
|
|
272
273
|
/**
|
|
273
|
-
* One market by base asset, underlying, symbol, canonical identity or the Market column's label (`SP500
|
|
274
|
+
* One market by base asset, underlying, symbol, canonical identity or the Market column's label (`xyz:SP500`), or by
|
|
274
275
|
* a name the board does not spell: a pair (BTC-USD, BTC/USD, BTCUSD) or a plain name (bitcoin, brent), read as the
|
|
275
276
|
* base asset it stands for once the input names no market as typed. An input that names none comes back with no
|
|
276
277
|
* rows and the board names nearest to it.
|
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
import type { PerpBoardPayload, PerpBoardRow, PerpDepthRow, PerpLiquidationMarket, PerpLiquidationPrint, PerpLiquidationsPayload } from "../../../api-client/perps";
|
|
2
|
-
import type { HeadlessBundleSection, HeadlessPaneColumn, HeadlessPaneLoadArgs, HeadlessPaneRow } from "../../../types/headless";
|
|
2
|
+
import type { HeadlessBundleResult, HeadlessBundleSection, HeadlessPaneColumn, HeadlessPaneContext, HeadlessPaneLoadArgs, HeadlessPaneRow } from "../../../types/headless";
|
|
3
3
|
import type { HeadlessPaneDefinition } from "../../../types/plugin";
|
|
4
4
|
import { DEPTH_COLUMN_IDS, depthBandTotals, depthCellText, depthColumnLabel, depthFreshness, depthStaleNote, downStreams, LIQUIDATION_COLUMN_IDS, liquidationCellText, liquidationColumnLabel, liquidationFreshness,
|
|
5
5
|
PRINT_COLUMN_IDS, printCellText, printColumnLabel, type DepthColumnId, type LiquidationColumnId, type PrintColumnId } from "./cascade";
|
|
@@ -8,6 +8,7 @@ import { perpFreshness } from "./freshness";
|
|
|
8
8
|
import { aprFootnote, ASSET_FILTERS, BOARD_COLUMNS, BOARD_SORTS, collectedVenueCount, COMPARE_COLUMNS, compact, fundingSpread, HISTORY_METRICS, label, marketLabel, observed, openingTab, PERP_TABS, perpCellText,
|
|
9
9
|
perpColumnLabel, percent, perpHistoryProText, positioningFields, price, RANKING_COLUMNS, rankingRows, RANKINGS, ratioText, share, time, uncoveredVenueNote, VENUES, venueName, venuesOf, IDENTITY_VENUES, type PerpColumnId } from "./model";
|
|
10
10
|
import { freePreviewNote } from "../shared/free-preview";
|
|
11
|
+
import { REPORT_ROWS } from "../shared/headless-options";
|
|
11
12
|
import { basisSpotSymbol } from "../futures-curve/model";
|
|
12
13
|
|
|
13
14
|
// Text columns only: the text report shows these, JSON keeps every field of every row. Rates, premiums and
|
|
@@ -183,7 +184,7 @@ const listMetadata = (data: Pick<PerpBoardPayload, "asOf" | "access" | "status">
|
|
|
183
184
|
|
|
184
185
|
export const perpsHeadless: HeadlessPaneDefinition<"bundle"> = {
|
|
185
186
|
shape: "bundle", argument: { kind: "free-text", optional: true, placeholder: "market",
|
|
186
|
-
description: "A base asset, underlying, canonical market identity or Market column label, such as BTC, hyperliquid:xyz:TSLA or
|
|
187
|
+
description: "A base asset, underlying, canonical market identity or Market column label, such as BTC, hyperliquid:xyz:TSLA or xyz:TSLA. Opens its history; with --tab board it searches the board, with --tab compare, liquidations or depth it is the base asset. Without one, the board." },
|
|
187
188
|
options: [
|
|
188
189
|
{ key: "tab", type: "enum", settingKey: "tab", values: PERP_TABS.map((value) => ({ value })), description: "Board, rankings, compare, liquidations, depth, history or evidence. Board without a market, history with one." },
|
|
189
190
|
{ key: "asset-class", type: "enum", settingKey: "assetClass", values: ASSET_FILTERS.map((value) => ({ value })), defaultValue: "all", description: "Board asset class." },
|
|
@@ -192,6 +193,7 @@ export const perpsHeadless: HeadlessPaneDefinition<"bundle"> = {
|
|
|
192
193
|
{ key: "sort", type: "enum", settingKey: "sort", values: BOARD_SORTS.map((value) => ({ value })), defaultValue: "oi", description: "Board order: open interest, funding, open-interest change, premium or long share of accounts." },
|
|
193
194
|
{ key: "days", type: "enum", settingKey: "days", values: ["1", "7", "30", "90", "365"].map((value) => ({ value })), defaultValue: "7", description: "History lookback in days." },
|
|
194
195
|
{ key: "metric", type: "enum", settingKey: "metric", values: HISTORY_METRICS.map((value) => ({ value })), defaultValue: "funding", description: "Displayed history chart; JSON retains every series." },
|
|
196
|
+
{ key: "limit", type: "integer", shot: REPORT_ROWS, minimum: 1, maximum: 5000, description: "Rows to list in each table, in its order: every row unless given.", example: "--limit 10" },
|
|
195
197
|
],
|
|
196
198
|
discovery: { aliases: ["PERP"], dataRequirements: ["Perpetual market observations"], limitations: ["Free accounts see a fixed preview of the board, rankings and comparisons, and latest values for one market.", "Pro unlocks every market, full rankings and history.", "Rankings list up to ten markets each.", "Rates, premiums and changes are fractions in JSON.", "Open-interest history begins at first collection.", "Funding APR is a simple annualization, not a forecast.",
|
|
197
199
|
"Long/short account shares: venue definitions differ; history begins at first collection.",
|
|
@@ -199,127 +201,135 @@ export const perpsHeadless: HeadlessPaneDefinition<"bundle"> = {
|
|
|
199
201
|
"Order book depth is read hourly for each venue's 50 largest markets; a band wider than the book a venue returns is a floor (≥). Free shows the latest; Pro the week's history."] },
|
|
200
202
|
describe: (args) => TITLES[tabOf(args)],
|
|
201
203
|
async load(args, ctx) {
|
|
202
|
-
const
|
|
203
|
-
|
|
204
|
-
|
|
205
|
-
|
|
206
|
-
const board = await fetchPerpsBoard({ ...(assetClass !== "all" ? { assetClass } : {}), ...(venue !== "all" ? { venue } : {}),
|
|
207
|
-
...(requested ? { search: boardSearchText(requested) } : {}), sort }, ctx.apiClient);
|
|
208
|
-
// The server answers a venue with its own markets; a server that does not filter by venue answers every venue's.
|
|
209
|
-
const rows = venue === "all" ? board.rows : board.rows.filter((row) => row.venue === venue);
|
|
210
|
-
const lock = venue === "all" ? more(board.locked, "markets") : venuePreviewLine(venue, rows, board.rows);
|
|
211
|
-
return { sections: [{ ...marketSection("Markets", BOARD_TEXT_COLUMNS, rows), ...lockedTable(board.locked && !rows.length) }], complete: !board.locked && board.status === "ok",
|
|
212
|
-
errors: board.locked ? [lock] : [], ...aprNote(rows), freshness: perpFreshness(rows, { funding: rows, venue }),
|
|
213
|
-
metadata: { ...listMetadata(board), total: board.total, assetClass, venue, sort, ...(requested ? { search: requested } : {}) } };
|
|
214
|
-
}
|
|
215
|
-
if (tab === "rankings") {
|
|
216
|
-
const rankings = await fetchPerpsRankings(ctx.apiClient);
|
|
217
|
-
// A ranking the free view leaves empty is locked, left out and said on the Pro line; one that has none to rank says so.
|
|
218
|
-
const sections: HeadlessBundleSection[] = RANKINGS.map((ranking) => {
|
|
219
|
-
const rows = rankingRows(rankings, ranking.key);
|
|
220
|
-
return { ...marketSection(ranking.label, rankingTextColumns(ranking), rows), ...lockedTable(rankings.locked && !rows.length) };
|
|
221
|
-
});
|
|
222
|
-
const notices = venueUnused(String(args.options.venue ?? "all"), "rankings");
|
|
223
|
-
// Only the funding lists show funding.
|
|
224
|
-
const funding = RANKINGS.filter((ranking) => ranking.field === "fundingRate8h").flatMap((ranking) => rankingRows(rankings, ranking.key));
|
|
225
|
-
// The rankings show neither APR % nor Long %, only OI USD.
|
|
226
|
-
const ranked = RANKINGS.flatMap((ranking) => rankingRows(rankings, ranking.key));
|
|
227
|
-
return { sections, complete: !rankings.locked && rankings.status === "ok", errors: rankings.locked ? ["Full rankings need Gloom Pro"] : [],
|
|
228
|
-
...aprNote(ranked, { apr: false, longShare: false }),
|
|
229
|
-
freshness: perpFreshness(RANKINGS.flatMap((ranking) => rankingRows(rankings, ranking.key)), { funding }), metadata: { ...(notices.length ? { notices } : {}), ...listMetadata(rankings) } };
|
|
230
|
-
}
|
|
231
|
-
if (tab === "compare") {
|
|
232
|
-
// A canonical identity names one contract; its base asset is what the venues share.
|
|
233
|
-
const identity = marketQuery(requested);
|
|
234
|
-
const asked = identity.includes(":") ? (await fetchPerpSelection(identity, ctx.apiClient)).rows[0]?.baseAsset ?? identity : (requested || DEFAULT_MARKET).toUpperCase();
|
|
235
|
-
// A pair or plain name (BTC-USD, bitcoin) compares the base asset it stands for; the rows say which.
|
|
236
|
-
const compare = await fetchPerpsCompare(asked, ctx.apiClient);
|
|
237
|
-
if (!compare.rows.length && !compare.locked) throw noMarket(requested || asked, await nearestPerpMarkets(requested || asked, ctx.apiClient));
|
|
238
|
-
const base = compare.rows[0]?.baseAsset ?? asked;
|
|
239
|
-
const spread = fundingSpread(compare.rows);
|
|
240
|
-
const notices = [...(requested ? [] : [`Showing ${DEFAULT_MARKET}. Try fn PERP ${EXAMPLE_MARKETS[1]} --tab compare.`]),
|
|
241
|
-
...requested && !identity.includes(":") && base.toUpperCase() !== asked ? readAs(base, requested) : [], ...venueUnused(String(args.options.venue ?? "all"), "compare")];
|
|
242
|
-
return { sections: [{ ...marketSection("Contracts", COMPARE_TEXT_COLUMNS, compare.rows), ...lockedTable(compare.locked) },
|
|
243
|
-
...(spread ? [{ title: "Funding spread", entries: [{ key: "fundingSpread8h", label: "Funding spread 8h", value: spread.value, formatted: `${spread.text} ${spread.detail}` }] }] : [])],
|
|
244
|
-
complete: !compare.locked && compare.status === "ok", errors: compare.locked ? [more(compare.locked, compare.locked === 1 ? "contract" : "contracts")] : [],
|
|
245
|
-
...aprNote(compare.rows), freshness: perpFreshness(compare.rows, { funding: compare.rows }),
|
|
246
|
-
metadata: { ...(requested ? {} : { defaultArgument: DEFAULT_MARKET }), ...(notices.length ? { notices } : {}),
|
|
247
|
-
...listMetadata(compare), total: compare.total, baseAsset: base,
|
|
248
|
-
...(spread ? { fundingSpread8h: spread.value, fundingSpreadHigh: spread.high.marketId, fundingSpreadLow: spread.low.marketId } : {}) } };
|
|
249
|
-
}
|
|
250
|
-
if (tab === "liquidations" || tab === "depth") {
|
|
251
|
-
// A canonical identity names one contract; its base asset is what the venues share. A pair or plain name reads as its base asset.
|
|
252
|
-
const identity = marketQuery(requested);
|
|
253
|
-
const asked = identity.includes(":") ? (await fetchPerpSelection(identity, ctx.apiClient)).rows[0]?.baseAsset ?? identity : (requested || DEFAULT_MARKET).toUpperCase();
|
|
254
|
-
const notices = (base: string) => [...(requested ? [] : [`Showing ${DEFAULT_MARKET}. Try fn PERP ${EXAMPLE_MARKETS[1]} --tab ${tab}.`]),
|
|
255
|
-
...requested && !identity.includes(":") && base.toUpperCase() !== asked ? readAs(base, requested) : [], ...venueUnused(String(args.options.venue ?? "all"), tab)];
|
|
256
|
-
if (tab === "liquidations") {
|
|
257
|
-
const data = await fetchPerpsLiquidations(asked, ctx.apiClient);
|
|
258
|
-
if (!data.markets.length && data.status !== "unavailable") throw noMarket(requested || asked, await nearestPerpMarkets(requested || asked, ctx.apiClient));
|
|
259
|
-
const told = notices(data.baseAsset);
|
|
260
|
-
const locked = lockedTable(data.locked);
|
|
261
|
-
const entries = (["long24h", "short24h", "long7d", "short7d"] as const).map((key) => ({ key, label: `${key.startsWith("long") ? "Longs" : "Shorts"} liquidated ${key.endsWith("24h") ? "24h" : "7d"}`,
|
|
262
|
-
value: data.totals[key], formatted: `${compact(data.totals[key])} USD` }));
|
|
263
|
-
return { sections: [{ title: "Totals", entries: [...entries, { key: "collectingSince", label: "Collecting since", value: data.collectingSince, formatted: time(data.collectingSince) }] },
|
|
264
|
-
{ title: "By contract", columns: LIQUIDATION_TEXT_COLUMNS, rows: data.markets.map((row) => ({ ...row })) },
|
|
265
|
-
{ title: "Hourly", columns: HOURLY_COLUMNS, rows: data.hourly.map((row) => ({ ...row })), ...locked },
|
|
266
|
-
// The prints are the window's, not the 24 hours beside them: the heading says which.
|
|
267
|
-
{ title: "Largest prints", textTitle: windowDays(data) ? `Largest prints, ${windowDays(data)}` : "Largest prints", columns: printTextColumns(data.baseAsset), rows: data.largest.map((row) => ({ ...row })) }],
|
|
268
|
-
complete: !data.locked && data.status === "ok" && !downStreams(data).length, notes: data.notes,
|
|
269
|
-
errors: data.locked ? [freePreviewNote({ shows: "liquidation totals and the three largest prints", adds: "the hourly series and the twenty largest prints" })] : [],
|
|
270
|
-
freshness: liquidationFreshness(data),
|
|
271
|
-
metadata: { ...(requested ? {} : { defaultArgument: DEFAULT_MARKET }), ...(told.length ? { notices: told } : {}), baseAsset: data.baseAsset, asOf: data.asOf, from: data.from,
|
|
272
|
-
access: data.access, locked: data.locked, status: data.status, collectingSince: data.collectingSince, streams: data.streams, notionalCurrency: "USD" } };
|
|
273
|
-
}
|
|
274
|
-
const data = await fetchPerpsDepth(asked, ctx.apiClient);
|
|
275
|
-
if (!data.rows.length && data.status !== "unavailable") throw noMarket(requested || asked, await nearestPerpMarkets(requested || asked, ctx.apiClient));
|
|
276
|
-
const told = notices(data.baseAsset);
|
|
277
|
-
const staleNote = depthStaleNote(data.rows);
|
|
278
|
-
// The band totals over the current books, as the tab's figures show them; a floor (≥) when a book ends inside the band.
|
|
279
|
-
const bands = depthBandTotals(data.rows).map((band) => ({ key: `band${band.key}`, label: band.label, value: band.bids + band.asks,
|
|
280
|
-
formatted: `${band.floor ? "≥" : ""}${compact(band.bids + band.asks)} USD (bids ${compact(band.bids)} · asks ${compact(band.asks)}, ${band.books} ${band.books === 1 ? "book" : "books"})` }));
|
|
281
|
-
return { sections: [...bands.length ? [{ title: "Band totals", entries: bands }] : [],
|
|
282
|
-
{ title: "Order books", columns: DEPTH_TEXT_COLUMNS, rows: data.rows.map((row) => ({ ...row })) },
|
|
283
|
-
{ title: "Hourly depth", columns: DEPTH_HISTORY_COLUMNS, rows: data.history.map((row) => ({ ...row })), ...lockedTable(data.locked) }],
|
|
284
|
-
complete: !data.locked && data.status === "ok" && !staleNote, notes: [...staleNote ? [staleNote] : [], ...data.notes],
|
|
285
|
-
errors: data.locked ? [freePreviewNote({ shows: "each book's latest depth", adds: "the week's hourly depth" })] : [],
|
|
286
|
-
freshness: depthFreshness(data),
|
|
287
|
-
metadata: { ...(requested ? {} : { defaultArgument: DEFAULT_MARKET }), ...(told.length ? { notices: told } : {}), baseAsset: data.baseAsset, asOf: data.asOf,
|
|
288
|
-
access: data.access, locked: data.locked, status: data.status, sources: data.sources, notionalCurrency: "USD", reach: "fraction of mid" } };
|
|
289
|
-
}
|
|
290
|
-
const search = requested || DEFAULT_MARKET, venue = String(args.options.venue ?? "all");
|
|
291
|
-
const market = await fetchPerpSelection(search, ctx.apiClient, venue !== "all" ? venue : undefined);
|
|
292
|
-
const selected = market.rows[0];
|
|
293
|
-
if (!selected) throw noMarket(search, market.suggestions);
|
|
294
|
-
const notices = [...(requested ? [] : [`Showing ${DEFAULT_MARKET}. Try fn PERP ${EXAMPLE_MARKETS[1]}.`]),
|
|
295
|
-
...market.resolved ? readAs(marketLabel(selected), requested, market.resolved.others) : [], ...venueNotice(venue, selected, requested, market.access)];
|
|
296
|
-
const metadata = { ...(requested ? {} : { defaultArgument: DEFAULT_MARKET }), ...(notices.length ? { notices } : {}), marketId: selected.marketId, sourceUrl: selected.sourceUrl, observedAt: selected.observedAt, sourceAsOf: selected.sourceAsOf,
|
|
297
|
-
rates: "fraction", quoteCurrency: selected.quoteCurrency, oiCurrency: "USD", fundingIntervalHours: selected.fundingIntervalHours };
|
|
298
|
-
// The venue's market as last polled, with the funding its latest row shows.
|
|
299
|
-
const freshness = perpFreshness([selected], { funding: [selected] });
|
|
300
|
-
// The same Positioning lines the pane's Evidence shows; JSON keeps the raw reading on the market row.
|
|
301
|
-
const positioning = positioningFields(selected);
|
|
302
|
-
if (tab === "evidence") return {
|
|
303
|
-
sections: [marketSection("Market evidence", MARKET_COLUMNS, market.rows),
|
|
304
|
-
// Where the figures were read, as the pane's Evidence names it: the venue's own endpoint and its time.
|
|
305
|
-
{ title: "Source", entries: [{ key: "sourceUrl", label: "URL", value: selected.sourceUrl },
|
|
306
|
-
{ key: "sourceAsOf", label: "Venue as of", value: selected.sourceAsOf, formatted: time(selected.sourceAsOf) }] },
|
|
307
|
-
...(positioning ? [{ title: "Positioning", entries: positioning.map((field) => ({ key: field.key, label: field.label, value: field.value,
|
|
308
|
-
formatted: field.detail ? `${field.text} · ${field.detail}` : field.text })) }] : []),
|
|
309
|
-
{ title: "Observation revisions", columns: REVISION_COLUMNS, rows: market.evidence.map((row) => ({ ...row })), ...lockedTable(market.access !== "pro") }],
|
|
310
|
-
// Positioning dates the long share itself.
|
|
311
|
-
complete: market.access === "pro" && market.status === "ok", ...aprNote(market.rows, { longShare: false }), freshness,
|
|
312
|
-
errors: market.access !== "pro" ? [freePreviewNote({ shows: `${marketLabel(selected)}'s latest evidence and positioning`, adds: "its observation revisions" })] : [],
|
|
313
|
-
metadata: { ...metadata, asOf: market.asOf, access: market.access, locked: market.locked, status: market.status },
|
|
314
|
-
};
|
|
315
|
-
const history = await fetchPerpsHistory({ marketId: selected.marketId, from: new Date(Date.now() - Number(args.options.days ?? 7) * 86_400_000).toISOString(), resolution: "auto", limit: 5000 }, ctx.apiClient);
|
|
316
|
-
const locked = lockedTable(history.locked);
|
|
317
|
-
return { sections: [marketSection("Latest market", MARKET_COLUMNS, [selected]), { title: "Own observations", columns: observationColumns(selected.quoteCurrency), rows: history.rows.map((row) => ({ ...row })), ...locked },
|
|
318
|
-
{ title: "Paid funding", columns: FUNDING_COLUMNS, rows: history.funding.map((row) => ({ ...row })), ...locked }, { title: "Hourly candles", columns: candleColumns(selected.quoteCurrency), rows: history.candles.map((row) => ({ ...row })), ...locked },
|
|
319
|
-
{ title: "Long/short history", columns: LONG_SHORT_COLUMNS, rows: (history.longShortRatio ?? []).map((row) => ({ ...row })), ...locked }],
|
|
320
|
-
complete: !history.locked && !history.truncated && history.status === "ok", ...aprNote([selected]), freshness,
|
|
321
|
-
errors: history.locked ? [historyLock(selected, collectedVenueCount(market.sources))] : history.truncated ? ["History reached the 5,000-observation limit; narrow the range"] : [],
|
|
322
|
-
metadata: { ...metadata, asOf: history.asOf, access: history.access, locked: history.locked, status: history.status, from: history.from, to: history.to, resolution: history.resolution, truncated: history.truncated ?? false },
|
|
323
|
-
};
|
|
204
|
+
const result = await loadPerpTab(args, ctx);
|
|
205
|
+
// `--limit` lists the first rows of each table, in its own order.
|
|
206
|
+
const limit = args.options.limit == null ? null : Number(args.options.limit);
|
|
207
|
+
return limit == null ? result : { ...result, sections: result.sections.map((section) => section.rows ? { ...section, rows: section.rows.slice(0, limit) } : section) };
|
|
324
208
|
},
|
|
325
209
|
};
|
|
210
|
+
|
|
211
|
+
/** One tab of PERP, every row the server sent. */
|
|
212
|
+
async function loadPerpTab(args: HeadlessPaneLoadArgs, ctx: HeadlessPaneContext): Promise<HeadlessBundleResult> {
|
|
213
|
+
const requested = requestedOf(args);
|
|
214
|
+
const tab = tabOf(args);
|
|
215
|
+
if (tab === "board") {
|
|
216
|
+
const assetClass = String(args.options["asset-class"] ?? "all"), venue = String(args.options.venue ?? "all"), sort = String(args.options.sort ?? "oi");
|
|
217
|
+
const board = await fetchPerpsBoard({ ...(assetClass !== "all" ? { assetClass } : {}), ...(venue !== "all" ? { venue } : {}),
|
|
218
|
+
...(requested ? { search: boardSearchText(requested) } : {}), sort }, ctx.apiClient);
|
|
219
|
+
// The server answers a venue with its own markets; a server that does not filter by venue answers every venue's.
|
|
220
|
+
const rows = venue === "all" ? board.rows : board.rows.filter((row) => row.venue === venue);
|
|
221
|
+
const lock = venue === "all" ? more(board.locked, "markets") : venuePreviewLine(venue, rows, board.rows);
|
|
222
|
+
return { sections: [{ ...marketSection("Markets", BOARD_TEXT_COLUMNS, rows), ...lockedTable(board.locked && !rows.length) }], complete: !board.locked && board.status === "ok",
|
|
223
|
+
errors: board.locked ? [lock] : [], ...aprNote(rows), freshness: perpFreshness(rows, { funding: rows, venue }),
|
|
224
|
+
metadata: { ...listMetadata(board), total: board.total, assetClass, venue, sort, ...(requested ? { search: requested } : {}) } };
|
|
225
|
+
}
|
|
226
|
+
if (tab === "rankings") {
|
|
227
|
+
const rankings = await fetchPerpsRankings(ctx.apiClient);
|
|
228
|
+
// A ranking the free view leaves empty is locked, left out and said on the Pro line; one that has none to rank says so.
|
|
229
|
+
const sections: HeadlessBundleSection[] = RANKINGS.map((ranking) => {
|
|
230
|
+
const rows = rankingRows(rankings, ranking.key);
|
|
231
|
+
return { ...marketSection(ranking.label, rankingTextColumns(ranking), rows), ...lockedTable(rankings.locked && !rows.length) };
|
|
232
|
+
});
|
|
233
|
+
const notices = venueUnused(String(args.options.venue ?? "all"), "rankings");
|
|
234
|
+
// Only the funding lists show funding.
|
|
235
|
+
const funding = RANKINGS.filter((ranking) => ranking.field === "fundingRate8h").flatMap((ranking) => rankingRows(rankings, ranking.key));
|
|
236
|
+
// The rankings show neither APR % nor Long %, only OI USD.
|
|
237
|
+
const ranked = RANKINGS.flatMap((ranking) => rankingRows(rankings, ranking.key));
|
|
238
|
+
return { sections, complete: !rankings.locked && rankings.status === "ok", errors: rankings.locked ? ["Full rankings need Gloom Pro"] : [],
|
|
239
|
+
...aprNote(ranked, { apr: false, longShare: false }),
|
|
240
|
+
freshness: perpFreshness(RANKINGS.flatMap((ranking) => rankingRows(rankings, ranking.key)), { funding }), metadata: { ...(notices.length ? { notices } : {}), ...listMetadata(rankings) } };
|
|
241
|
+
}
|
|
242
|
+
if (tab === "compare") {
|
|
243
|
+
// A canonical identity names one contract; its base asset is what the venues share.
|
|
244
|
+
const identity = marketQuery(requested);
|
|
245
|
+
const asked = identity.includes(":") ? (await fetchPerpSelection(identity, ctx.apiClient)).rows[0]?.baseAsset ?? identity : (requested || DEFAULT_MARKET).toUpperCase();
|
|
246
|
+
// A pair or plain name (BTC-USD, bitcoin) compares the base asset it stands for; the rows say which.
|
|
247
|
+
const compare = await fetchPerpsCompare(asked, ctx.apiClient);
|
|
248
|
+
if (!compare.rows.length && !compare.locked) throw noMarket(requested || asked, await nearestPerpMarkets(requested || asked, ctx.apiClient));
|
|
249
|
+
const base = compare.rows[0]?.baseAsset ?? asked;
|
|
250
|
+
const spread = fundingSpread(compare.rows);
|
|
251
|
+
const notices = [...(requested ? [] : [`Showing ${DEFAULT_MARKET}. Try fn PERP ${EXAMPLE_MARKETS[1]} --tab compare.`]),
|
|
252
|
+
...requested && !identity.includes(":") && base.toUpperCase() !== asked ? readAs(base, requested) : [], ...venueUnused(String(args.options.venue ?? "all"), "compare")];
|
|
253
|
+
return { sections: [{ ...marketSection("Contracts", COMPARE_TEXT_COLUMNS, compare.rows), ...lockedTable(compare.locked) },
|
|
254
|
+
...(spread ? [{ title: "Funding spread", entries: [{ key: "fundingSpread8h", label: "Funding spread 8h", value: spread.value, formatted: `${spread.text} ${spread.detail}` }] }] : [])],
|
|
255
|
+
complete: !compare.locked && compare.status === "ok", errors: compare.locked ? [more(compare.locked, compare.locked === 1 ? "contract" : "contracts")] : [],
|
|
256
|
+
...aprNote(compare.rows), freshness: perpFreshness(compare.rows, { funding: compare.rows }),
|
|
257
|
+
metadata: { ...(requested ? {} : { defaultArgument: DEFAULT_MARKET }), ...(notices.length ? { notices } : {}),
|
|
258
|
+
...listMetadata(compare), total: compare.total, baseAsset: base,
|
|
259
|
+
...(spread ? { fundingSpread8h: spread.value, fundingSpreadHigh: spread.high.marketId, fundingSpreadLow: spread.low.marketId } : {}) } };
|
|
260
|
+
}
|
|
261
|
+
if (tab === "liquidations" || tab === "depth") {
|
|
262
|
+
// A canonical identity names one contract; its base asset is what the venues share. A pair or plain name reads as its base asset.
|
|
263
|
+
const identity = marketQuery(requested);
|
|
264
|
+
const asked = identity.includes(":") ? (await fetchPerpSelection(identity, ctx.apiClient)).rows[0]?.baseAsset ?? identity : (requested || DEFAULT_MARKET).toUpperCase();
|
|
265
|
+
const notices = (base: string) => [...(requested ? [] : [`Showing ${DEFAULT_MARKET}. Try fn PERP ${EXAMPLE_MARKETS[1]} --tab ${tab}.`]),
|
|
266
|
+
...requested && !identity.includes(":") && base.toUpperCase() !== asked ? readAs(base, requested) : [], ...venueUnused(String(args.options.venue ?? "all"), tab)];
|
|
267
|
+
if (tab === "liquidations") {
|
|
268
|
+
const data = await fetchPerpsLiquidations(asked, ctx.apiClient);
|
|
269
|
+
if (!data.markets.length && data.status !== "unavailable") throw noMarket(requested || asked, await nearestPerpMarkets(requested || asked, ctx.apiClient));
|
|
270
|
+
const told = notices(data.baseAsset);
|
|
271
|
+
const locked = lockedTable(data.locked);
|
|
272
|
+
const entries = (["long24h", "short24h", "long7d", "short7d"] as const).map((key) => ({ key, label: `${key.startsWith("long") ? "Longs" : "Shorts"} liquidated ${key.endsWith("24h") ? "24h" : "7d"}`,
|
|
273
|
+
value: data.totals[key], formatted: `${compact(data.totals[key])} USD` }));
|
|
274
|
+
return { sections: [{ title: "Totals", entries: [...entries, { key: "collectingSince", label: "Collecting since", value: data.collectingSince, formatted: time(data.collectingSince) }] },
|
|
275
|
+
{ title: "By contract", columns: LIQUIDATION_TEXT_COLUMNS, rows: data.markets.map((row) => ({ ...row })) },
|
|
276
|
+
{ title: "Hourly", columns: HOURLY_COLUMNS, rows: data.hourly.map((row) => ({ ...row })), ...locked },
|
|
277
|
+
// The prints are the window's, not the 24 hours beside them: the heading says which.
|
|
278
|
+
{ title: "Largest prints", textTitle: windowDays(data) ? `Largest prints, ${windowDays(data)}` : "Largest prints", columns: printTextColumns(data.baseAsset), rows: data.largest.map((row) => ({ ...row })) }],
|
|
279
|
+
complete: !data.locked && data.status === "ok" && !downStreams(data).length, notes: data.notes,
|
|
280
|
+
errors: data.locked ? [freePreviewNote({ shows: "liquidation totals and the three largest prints", adds: "the hourly series and the twenty largest prints" })] : [],
|
|
281
|
+
freshness: liquidationFreshness(data),
|
|
282
|
+
metadata: { ...(requested ? {} : { defaultArgument: DEFAULT_MARKET }), ...(told.length ? { notices: told } : {}), baseAsset: data.baseAsset, asOf: data.asOf, from: data.from,
|
|
283
|
+
access: data.access, locked: data.locked, status: data.status, collectingSince: data.collectingSince, streams: data.streams, notionalCurrency: "USD" } };
|
|
284
|
+
}
|
|
285
|
+
const data = await fetchPerpsDepth(asked, ctx.apiClient);
|
|
286
|
+
if (!data.rows.length && data.status !== "unavailable") throw noMarket(requested || asked, await nearestPerpMarkets(requested || asked, ctx.apiClient));
|
|
287
|
+
const told = notices(data.baseAsset);
|
|
288
|
+
const staleNote = depthStaleNote(data.rows);
|
|
289
|
+
// The band totals over the current books, as the tab's figures show them; a floor (≥) when a book ends inside the band.
|
|
290
|
+
const bands = depthBandTotals(data.rows).map((band) => ({ key: `band${band.key}`, label: band.label, value: band.bids + band.asks,
|
|
291
|
+
formatted: `${band.floor ? "≥" : ""}${compact(band.bids + band.asks)} USD (bids ${compact(band.bids)} · asks ${compact(band.asks)}, ${band.books} ${band.books === 1 ? "book" : "books"})` }));
|
|
292
|
+
return { sections: [...bands.length ? [{ title: "Band totals", entries: bands }] : [],
|
|
293
|
+
{ title: "Order books", columns: DEPTH_TEXT_COLUMNS, rows: data.rows.map((row) => ({ ...row })) },
|
|
294
|
+
{ title: "Hourly depth", columns: DEPTH_HISTORY_COLUMNS, rows: data.history.map((row) => ({ ...row })), ...lockedTable(data.locked) }],
|
|
295
|
+
complete: !data.locked && data.status === "ok" && !staleNote, notes: [...staleNote ? [staleNote] : [], ...data.notes],
|
|
296
|
+
errors: data.locked ? [freePreviewNote({ shows: "each book's latest depth", adds: "the week's hourly depth" })] : [],
|
|
297
|
+
freshness: depthFreshness(data),
|
|
298
|
+
metadata: { ...(requested ? {} : { defaultArgument: DEFAULT_MARKET }), ...(told.length ? { notices: told } : {}), baseAsset: data.baseAsset, asOf: data.asOf,
|
|
299
|
+
access: data.access, locked: data.locked, status: data.status, sources: data.sources, notionalCurrency: "USD", reach: "fraction of mid" } };
|
|
300
|
+
}
|
|
301
|
+
const search = requested || DEFAULT_MARKET, venue = String(args.options.venue ?? "all");
|
|
302
|
+
const market = await fetchPerpSelection(search, ctx.apiClient, venue !== "all" ? venue : undefined);
|
|
303
|
+
const selected = market.rows[0];
|
|
304
|
+
if (!selected) throw noMarket(search, market.suggestions);
|
|
305
|
+
const notices = [...(requested ? [] : [`Showing ${DEFAULT_MARKET}. Try fn PERP ${EXAMPLE_MARKETS[1]}.`]),
|
|
306
|
+
...market.resolved ? readAs(marketLabel(selected), requested, market.resolved.others) : [], ...venueNotice(venue, selected, requested, market.access)];
|
|
307
|
+
const metadata = { ...(requested ? {} : { defaultArgument: DEFAULT_MARKET }), ...(notices.length ? { notices } : {}), marketId: selected.marketId, sourceUrl: selected.sourceUrl, observedAt: selected.observedAt, sourceAsOf: selected.sourceAsOf,
|
|
308
|
+
rates: "fraction", quoteCurrency: selected.quoteCurrency, oiCurrency: "USD", fundingIntervalHours: selected.fundingIntervalHours };
|
|
309
|
+
// The venue's market as last polled, with the funding its latest row shows.
|
|
310
|
+
const freshness = perpFreshness([selected], { funding: [selected] });
|
|
311
|
+
// The same Positioning lines the pane's Evidence shows; JSON keeps the raw reading on the market row.
|
|
312
|
+
const positioning = positioningFields(selected);
|
|
313
|
+
if (tab === "evidence") return {
|
|
314
|
+
sections: [marketSection("Market evidence", MARKET_COLUMNS, market.rows),
|
|
315
|
+
// Where the figures were read, as the pane's Evidence names it: the venue's own endpoint and its time.
|
|
316
|
+
{ title: "Source", entries: [{ key: "sourceUrl", label: "URL", value: selected.sourceUrl },
|
|
317
|
+
{ key: "sourceAsOf", label: "Venue as of", value: selected.sourceAsOf, formatted: time(selected.sourceAsOf) }] },
|
|
318
|
+
...(positioning ? [{ title: "Positioning", entries: positioning.map((field) => ({ key: field.key, label: field.label, value: field.value,
|
|
319
|
+
formatted: field.detail ? `${field.text} · ${field.detail}` : field.text })) }] : []),
|
|
320
|
+
{ title: "Observation revisions", columns: REVISION_COLUMNS, rows: market.evidence.map((row) => ({ ...row })), ...lockedTable(market.access !== "pro") }],
|
|
321
|
+
// Positioning dates the long share itself.
|
|
322
|
+
complete: market.access === "pro" && market.status === "ok", ...aprNote(market.rows, { longShare: false }), freshness,
|
|
323
|
+
errors: market.access !== "pro" ? [freePreviewNote({ shows: `${marketLabel(selected)}'s latest evidence and positioning`, adds: "its observation revisions" })] : [],
|
|
324
|
+
metadata: { ...metadata, asOf: market.asOf, access: market.access, locked: market.locked, status: market.status },
|
|
325
|
+
};
|
|
326
|
+
const history = await fetchPerpsHistory({ marketId: selected.marketId, from: new Date(Date.now() - Number(args.options.days ?? 7) * 86_400_000).toISOString(), resolution: "auto", limit: 5000 }, ctx.apiClient);
|
|
327
|
+
const locked = lockedTable(history.locked);
|
|
328
|
+
return { sections: [marketSection("Latest market", MARKET_COLUMNS, [selected]), { title: "Own observations", columns: observationColumns(selected.quoteCurrency), rows: history.rows.map((row) => ({ ...row })), ...locked },
|
|
329
|
+
{ title: "Paid funding", columns: FUNDING_COLUMNS, rows: history.funding.map((row) => ({ ...row })), ...locked }, { title: "Hourly candles", columns: candleColumns(selected.quoteCurrency), rows: history.candles.map((row) => ({ ...row })), ...locked },
|
|
330
|
+
{ title: "Long/short history", columns: LONG_SHORT_COLUMNS, rows: (history.longShortRatio ?? []).map((row) => ({ ...row })), ...locked }],
|
|
331
|
+
complete: !history.locked && !history.truncated && history.status === "ok", ...aprNote([selected]), freshness,
|
|
332
|
+
errors: history.locked ? [historyLock(selected, collectedVenueCount(market.sources))] : history.truncated ? ["History reached the 5,000-observation limit; narrow the range"] : [],
|
|
333
|
+
metadata: { ...metadata, asOf: history.asOf, access: history.access, locked: history.locked, status: history.status, from: history.from, to: history.to, resolution: history.resolution, truncated: history.truncated ?? false },
|
|
334
|
+
};
|
|
335
|
+
}
|
|
@@ -18,7 +18,7 @@ import { loadPerpsCompare, loadPerpsEquity } from "./client";
|
|
|
18
18
|
import { perpEquityIdentity } from "./equity-identity";
|
|
19
19
|
import { useLivePerpRows } from "./live-rows";
|
|
20
20
|
import { compact, perpCell, percent, price, readingTime, venueName } from "./model";
|
|
21
|
-
import { useOpenPerpMarket } from "./open-market";
|
|
21
|
+
import { openPerpLabel, useOpenPerpMarket } from "./open-market";
|
|
22
22
|
import { contractText, foldSmallMarkets, mergeVenueMarkets, type PerpVenueMarket } from "./venue-markets";
|
|
23
23
|
|
|
24
24
|
const STOCK_TYPES = new Set(["STK", "EQUITY", "STOCK", "COMMON STOCK"]);
|
|
@@ -52,8 +52,11 @@ const COLUMNS: readonly Column[] = [
|
|
|
52
52
|
{ id: "oi", label: "OI USD", width: 7, align: "right" },
|
|
53
53
|
{ id: "volume", label: "Vol 24h", width: 7, align: "right" },
|
|
54
54
|
];
|
|
55
|
-
/**
|
|
56
|
-
|
|
55
|
+
/**
|
|
56
|
+
* What a narrow overview gives up first: the volume, then the contract, the premium, the open interest and the
|
|
57
|
+
* funding, so the columns left fit whole rather than squeezed into cut figures ("+0." for +0.0050%).
|
|
58
|
+
*/
|
|
59
|
+
const DROP_ORDER: readonly Column["id"][] = ["volume", "contract", "premium", "oi", "funding"];
|
|
57
60
|
const GAP = 2;
|
|
58
61
|
const span = (columns: readonly Column[]) => columns.reduce((sum, column) => sum + column.width, 0) + GAP * (columns.length - 1);
|
|
59
62
|
|
|
@@ -119,7 +122,7 @@ export function PerpMarketsSection({ symbol, exchange, instrumentType, quote, wi
|
|
|
119
122
|
const cell = (column: Column, market: PerpVenueMarket, row: PerpBoardRow): ColumnGridCell => {
|
|
120
123
|
if (column.id === "venue") {
|
|
121
124
|
return { text: venueName(market.venue), color: row.stale ? colors.textDim : colors.textBright,
|
|
122
|
-
link: { label:
|
|
125
|
+
link: { label: openPerpLabel(row), onOpen: () => openMarket(row.marketId) } };
|
|
123
126
|
}
|
|
124
127
|
if (column.id === "contract") return { text: contractText(market), color: colors.textMuted };
|
|
125
128
|
if (column.id === "mark") return { text: price(row.markPrice ?? row.lastPrice), color: colors.text };
|
|
@@ -49,7 +49,11 @@ export function underlyingTicker(row: Pick<PerpBoardRow, "underlyingSymbol" | "u
|
|
|
49
49
|
: row.underlying?.symbol.toUpperCase() === symbol ? row.underlying.listingExchange : undefined;
|
|
50
50
|
return !listing || isUsListingExchange(listing) ? symbol : publicTickerKey(symbol, listing);
|
|
51
51
|
}
|
|
52
|
-
|
|
52
|
+
/**
|
|
53
|
+
* A market as the Market column, the pane title and the CLI name it: its base asset, or for a market on a Hyperliquid
|
|
54
|
+
* builder dex Hyperliquid's own name for it, the dex before a colon (`xyz:NVDA`), which is also its contract symbol.
|
|
55
|
+
*/
|
|
56
|
+
export const marketLabel = (row: Pick<PerpBoardRow, "dex" | "baseAsset">) => row.dex && row.dex !== "default" ? `${row.dex.toLowerCase()}:${row.baseAsset}` : row.baseAsset;
|
|
53
57
|
|
|
54
58
|
/**
|
|
55
59
|
* Plain names for markets, as the Market column writes the contracts to try, nearest first. A name the board does
|
|
@@ -58,7 +62,7 @@ export const marketLabel = (row: Pick<PerpBoardRow, "dex" | "baseAsset">) => row
|
|
|
58
62
|
*/
|
|
59
63
|
const PLAIN_NAMES: Readonly<Record<string, readonly string[]>> = {
|
|
60
64
|
bitcoin: ["BTC"], ethereum: ["ETH"], ether: ["ETH"], solana: ["SOL"], dogecoin: ["DOGE"], ripple: ["XRP"],
|
|
61
|
-
brent: ["BZ", "BRENTOIL
|
|
65
|
+
brent: ["BZ", "xyz:BRENTOIL"], brentcrude: ["BZ", "xyz:BRENTOIL"], wti: ["CL"], wticrude: ["CL"], naturalgas: ["xyz:NATGAS"],
|
|
62
66
|
};
|
|
63
67
|
/** A pair as exchanges and charts write it: BTC-USD, BTC/USD, BTCUSD, BTCUSDT, BTC-PERP, BTC/USDT:USDT. */
|
|
64
68
|
const QUOTED_PAIR = /^([A-Z0-9]{1,15}?)([-/_ ]?)(?:USDT|USDC|USD|PERP)(?::[A-Z]{3,4})?$/;
|
|
@@ -73,8 +77,8 @@ export function perpBaseCandidates(input: string): string[] {
|
|
|
73
77
|
const pair = QUOTED_PAIR.exec(input.trim().toUpperCase());
|
|
74
78
|
return pair ? [pair[1]!] : [];
|
|
75
79
|
}
|
|
76
|
-
/** The base asset a Market column label names: `BRENTOIL
|
|
77
|
-
export const baseOfLabel = (label: string) => label.
|
|
80
|
+
/** The base asset a Market column label names: `xyz:BRENTOIL` is BRENTOIL. */
|
|
81
|
+
export const baseOfLabel = (label: string) => label.replace(/^[a-z][a-z0-9]*:/, "");
|
|
78
82
|
/** The base asset of a pair written with a separator (BTC-USD, BTC/USD), which no board symbol spells; null for anything else. */
|
|
79
83
|
export function separatedPairBase(input: string): string | null {
|
|
80
84
|
const pair = QUOTED_PAIR.exec(input.trim().toUpperCase());
|