estimate_cross_fee
株主優待クロス取引(現物買い+信用売りを同時に建てて優待だけ受け取る手法)の手数料を試算する。
【対象範囲】 ・同一証券会社内で「買い」と「売り」の両方を建てるケースのみを計算する。証券会社をまたいだ 組み合わせ(例: 楽天で買ってカブコムで売る)は計算しない。 ・buyMethod: 'spot'=現物買い(sbi/gmo/rakuten/kabucom) / 'system_margin_then_receipt'=制度信用買い+現引き(smbcのみ) ・sellMethod: 'general_short'=一般信用(短期) / 'general_long'=一般信用(無期限・長期) / 'system'=制度信用 ユーザーへの回答時はこれらの値をそのまま出さず、日本語(現物買い、制度信用買い+現引き、短期一般信用、 無期限一般信用、制度信用)に訳して説明すること。
【sellMethod=systemの行について】 逆日歩(金額が事前に確定しない追加費用)が別途発生しうる。total はあくまで「逆日歩が0だった場合の金額」 であり、確定額ではないことを必ず説明すること。前回の逆日歩率が分かる場合は note に参考値として付くが、 将来の逆日歩を予測するものではない。
【note フィールドについて】 一般信用の売り建てが現在できない・残数が無い証券会社も除外せず参考値として計算し、その旨を note に 記載する。note が無い行は現時点で実際にクロス可能。
【日付フィールドについて】 vestingDate=権利確定日(基準日)、lastDayWithRights=権利付最終日、exRightsDate=権利落ち日。 ユーザーが「いつまでに買えばいいか」を知りたいときは lastDayWithRights を案内すること (vestingDate は権利が確定する日そのものであり、買い付けの締切ではない)。
【assumptions フィールドについて】 実際に使用した証券会社プラン設定(ゼロ革命の有無、楽天のコース、カブコムの大口優遇ランク等)を毎回 そのまま返す。呼び出し側のAIは回答時に必ずこの内容(特にユーザーによって異なりうる設定)を明示し、 実際の契約プランと違う場合は指定し直せることを案内すること。 例:「楽天は"ゼロコース"、カブコムは大口優遇なしを前提に計算しています。異なるプランをご利用でしたら教えてください」
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| code | Yes | 銘柄コード。例: "7476" | |
| date | No | 約定日 (YYYY-MM-DD)。省略時は「今注文したとき」の約定日を自動算出する(JST 15:30より前なら当日、以降なら翌営業日。土日祝ならさらに翌営業日まで繰り上げる) | |
| price | No | 実勢株価を上書きする場合に指定。省略時は取得済みの概算株価を使う | |
| units | No | クロスする株数。省略時は minRequiredUnits(優待に必要な最小株数)を使う | |
| gmoVip | No | GMO VIPプラン。既定false | |
| sbiVip | No | SBI大口優遇(建玉5億円以上)。既定false | |
| kabucomSor | No | カブコムSOR(スマート・オーダー・ルーティング)。既定false | |
| rakutenVip | No | 楽天大口優遇。既定false | |
| rakutenCourse | No | 楽天のコース。既定"zero"(ゼロコース) | |
| kabucomLargeLot | No | カブコム大口優遇ランク。既定"none" | |
| sbiZeroRevolution | No | SBIゼロ革命(電子交付設定)。既定true | |
| rakutenPreferentialRate | No | 楽天優遇金利適用。既定false |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| code | No | ||
| name | No | ||
| price | No | 計算に使った株価(円)。入力のpriceを省略した場合は取得済みの概算株価(現在の正確な株価ではない)を使う | |
| message | No | 計算できなかった場合の理由。このときcode以外の他フィールドは付かない | |
| results | No | 証券会社×売り方式ごとの手数料内訳。totalの昇順 | |
| crossUnit | No | クロスする株数 | |
| tradeDate | No | 約定日 (YYYY-MM-DD) | |
| totalPrice | No | price × crossUnit | |
| assumptions | No | 実際に使用した証券会社プラン設定 | |
| vestingDate | No | 権利確定日(基準日) | |
| exRightsDate | No | 権利落ち日。クロスの決済(現渡し等)を入れる日 | |
| interestDays | No | 信用金利/貸株料の対象日数 | |
| lastDayWithRights | No | 権利付最終日。買い付けの締切はこちら(vestingDateではない) | |
| managementFeeMonths | No | 事務管理費がかかる月数 |