Technical Contract Clarification: Longport capital_flow Unit, Currency, Scale, and Turnover Compatibility

オープン
#1,260 コメント 4 件 リアクション 0 件 担当者 0 名 GitHub で見る

メンテナーはふだん 1 日以内に返信

まだ誰も着手していません。

評価

難易度
5/5
見積もり時間
1週間以上
初心者へのやさしさ
35/100
issue の種類
ドキュメント
明瞭さ
おおむね明確
活発さ
活発
技術スタック
typescript

調査の方向性

公式 CLI ドキュメントと、issue で参照されている QuoteContext.capital_flow、quote、candlestick インターフェース、および SDK と Hosted MCP のパスを確認する。作業は、権威のあるバージョン付きの記述によって、系列のセマンティクス、単位、通貨、スケーリング、互換性、および変換が確認されるか、その契約がどこに文書化されているかが特定された時点で完了する。

索引モデルが issue の本文から書いたものです。

説明

documentation question

Hello Longport Technical Support,

We are integrating the official Longport Hosted MCP capital_flow output into a fail-closed, read-only validation workflow.

The official CLI documentation states that each bar represents the net inflow for that minute. We have also verified from the official CLI, MCP, and SDK source paths that the returned Decimal value is passed through without a visible accumulation or scaling transformation.

However, we do not want to infer a monetary contract from observed values or implementation behavior. We therefore need authoritative clarification of the following points:

  1. Series semantics

Does each CapitalFlowLine.inflow returned by QuoteContext.capital_flow(symbol) represent the net inflow for that individual minute, rather than a cumulative intraday value?

Does this same semantic contract apply to the value exposed through the official SDK, CLI, and Hosted MCP capital_flow tool?

  1. Monetary unit and scale

What is the exact monetary unit of CapitalFlowLine.inflow?

For example, is the returned Decimal already expressed in the major currency unit, or is there an implicit minor-unit or other numeric scale?

Please specify any required multiplier or divisor.

  1. Currency

Is capital_flow denominated in the security's quote currency?

Specifically, would:

AAPL.US capital flow be denominated in USD; and
700.HK capital flow be denominated in HKD?

Is this rule guaranteed for all supported securities/markets?

  1. capital_distribution compatibility

For the same symbol, do the monetary values returned by capital_flow and capital_distribution use exactly the same:

monetary unit,
numeric scale, and
currency?

  1. turnover dimensional compatibility

Does the turnover field returned by the official quote and candlestick interfaces use the same monetary unit, scale, and currency contract as capital_flow.inflow?

In particular, is the following expression dimensionally valid without any additional unit or currency conversion?

sum(CapitalFlowLine.inflow) / turnover

  1. Hidden transformations

Is there any implicit multiplier, divisor, denomination conversion, currency conversion, or other numeric transformation between the underlying provider value and the value exposed by:

QuoteContext.capital_flow → official SDK → official CLI / Hosted MCP?

If possible, please provide or identify the authoritative and versioned documentation, schema, source contract, or technical specification that guarantees these answers.

If no published specification currently exists, a written confirmation from the Longport technical team stating the applicable contract and the affected API/SDK versions would also be very helpful.

This request contains no access token, refresh token, account identifier, cookie, Authorization header, or other credential.

Thank you.

主要言語
TypeScript
スター
61
フォーク
30
平均マージ
7時間 45分
マージ済み PR(30日)
17

環境構築

はじめの一歩

  1. issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
  2. 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
  3. リポジトリをフォークし、ブランチを切って変更します。
  4. issue 番号を参照したプルリクエストを送ります。

longbridge/developers のほかの issue

longbridge/developers の issue をすべて見る

似ている issue

TypeScript の issue をもっと見る

新しい issue をメールで受け取る

初心者向けの GitHub issue を短くまとめたダイジェスト。