コンテンツへスキップ

投資一覧 - list-investments

接続されている投資アカウント、保有資産のポジション、そして必要に応じて投資取引を返します。

プロンプトの例

  • 「私の投資を教えて」
  • 「ポートフォリオの成績はどう?」
  • 「楽天証券の口座でどんな株を持っている?」
  • 「投資の取引履歴を教えて」

スキーマ

入力パラメータ

名前任意デフォルト説明
localestringはいja名称のローカライズに使用する言語。指定可能な値: ja, en。ゲストが英語で会話している場合は明示的に en を指定してください。
outputarray<string>はいcontent応答の返却方法を指定します。content はモデル向けのコンパクトなテキストペイロードを返します。structuredContent はプログラムから扱いやすい生の型付きデータを返します。両方を同時に指定することも可能です。指定可能な値: content, structuredContent
financial_institutionarray<string>はい全投資アカウント金融機関のエンティティキーで絞り込みます。list-institutions または list-accounts の出力にある institution_entity_key と一致する値を指定します。
include_transactionsbooleanはいfalsetrue にすると、取引型の投資アカウントの購入・売却取引を取得します。レイテンシが増加します。
investment_transactions_sincestringはいなしISO日付(YYYY-MM-DD)。include_transactions が true の場合、updated_at >= investment_transactions_since の取引に絞り込みます。取得可能な最大履歴: 120ヶ月。

出力構造

名前任意説明
investment_accountsarray<object>いいえ指定した条件に一致する接続済みの投資アカウント。
investment_accounts[].account_nicknamestringいいえゲストが設定したアカウントのニックネーム。未設定の場合は institution_account_name が使用されます。
investment_accounts[].institution_namestringいいえ金融機関の表示名。
investment_accounts[].institution_entity_keystringいいえ金融機関の安定した識別子。
investment_accounts[].institution_account_namestringいいえ金融機関に登録されているアカウント名。account_nickname とは異なります。
investment_accounts[].account_balancenumberいいえ直近の同期時点での投資アカウントの現在評価額。銀行・ポイントアカウントと異なり、投資アカウントには基準通貨への換算がなく、常に account_currency の値で表されます。
investment_accounts[].account_currencystringいいえアカウントの ISO 4217 通貨コード(例: JPY, USD)。
investment_accounts[].account_subtypestringいいえより詳細なアカウント分類(例: investment, pension)。
investment_accounts[].account_detail_typestringいいえこのアカウントの保有情報が positions(株式・ファンドなど非現金の投資)と transactions(MRF/MMFなどの現金・現金同等物)のどちらで報告されるか。
positionsarray<object>いいえポジション型の投資アカウント全体における保有資産のポジション。
positions[].account_nicknamestringいいえこのポジションが属するアカウントのニックネーム。investment_accounts との結合キー。
positions[].institution_entity_keystringいいえ金融機関の安定した識別子。
positions[].position_datestringいいえこのポジションが最後に評価された日付。
positions[].position_asset_classstringいいえ保有資産の大分類(例: 株式、債券、ファンド)。予告なく新しい値が追加される場合があります。
positions[].position_asset_subclassstring | nullいいえposition_asset_class 内でのより詳細な分類。取得できない場合は null。
positions[].position_tickerstring | nullいいえ該当する場合のポジションのティッカーまたは資産コード。該当しない場合は null。
positions[].position_namestring | nullいいえ保有資産の表示名。Moneytreeが可能な範囲で整形しています。
positions[].position_currencystringいいえポジションの評価に使用される ISO 4217 通貨コード。
positions[].position_tax_typearray<string> | nullいいえこのポジションに適用される税制上の分類: ippan, tokutei, NISA, dc pension, stock option, または unknown。適用対象外の場合は null。
positions[].position_tax_sub_typestring | nullいいえposition_tax_type の詳細情報。金融機関が提供していない場合は null。
positions[].position_market_valuenumberいいえ直近の同期時点でのポジションの現在市場価値。
positions[].position_acquisition_valuenumber | nullいいえポジション取得時の総取得コスト。取得できない場合は null。
positions[].position_profitnumber | nullいいえ未実現損益: position_market_value から position_acquisition_value を引いた値。取得できない場合は null。
positions[].position_quantitynumber | nullいいえこのポジションで保有している資産の数量。取得できない場合は null。
transactionsarray<object> | nullいいえ取引型アカウント全体における投資取引。include_transactions が true でない限り null。
transactions[].account_nicknamestringいいえこの取引が属するアカウントのニックネーム。investment_accounts との結合キー。
transactions[].institution_entity_keystringいいえ金融機関の安定した識別子。
transactions[].transaction_datestringいいえ取引が発生した日付。
transactions[].transaction_amountnumberいいえ取引金額。支出は負数、収入は正数。
transactions[].transaction_descriptionstring | nullいいえ取引の説明。Moneytreeが可能な範囲で整形しています。
transactions[].transaction_balancenumber | nullいいえ金融機関が報告している場合の、この取引後のアカウント残高。取得できない場合は null。
transactions[].transaction_fx_base_currencystring | nullいいえ外国通貨で行われた場合の、元の取引の通貨。外国通貨取引でない場合は null。
transactions[].transaction_fx_base_amountnumber | nullいいえ外国通貨で行われた場合の、transaction_fx_base_currency での取引金額。外国通貨取引でない場合は null。

注記

  • ポジションの値は履歴を保持しません。Moneytreeが最後に取得した時点での保有状況を反映しています。