tax-liability-tracking

税務負債の追跡

アクティブな Solana トレーダー向けに特化した、リアルタイムの税務負債分析です。部分売却時の比例配分による取得原価を追跡し、実現損益と含み損益を分類し、四半期ごとの納税額を予測するとともに、取引判断にフィードバックする税務を考慮したシグナルを提示します。

重要な理由

アクティブな暗号資産トレーダーは、年間に数百件もの課税対象イベントを発生させます。リアルタイムで追跡しなければ、次のような問題が起こります。

• 年末まで、税引き後の実際の損益がわかりません
• 部分売却（「元手を回収する」取引）によって取得原価がわかりにくくなります
• 短期か長期かの分類によって、実効税率が15～20％変わります
• 気づかないうちに、税務上の損失を確定できる期間を逃します
• 四半期ごとの予定納税額が推測になってしまいます

このスキルは、取引活動と並行して税務台帳を継続的に管理し、あらゆる判断に税務上の影響を反映できるようにします。

主な概念

部分売却における比例配分による取得原価

これは最も重要な概念です。保有ポジションの一部を売却すると、取得原価も比例配分されます。残りのトークンの取得原価がゼロになるわけではありません。

例 — 買い増し／元手回収の取引：

1. 購入：1,000トークンを1トークンあたり1.00ドルで購入します。取得原価の合計 = 1,000ドル。
2. 部分売却：800トークンを1トークンあたり1.25ドルで売却します。売却収入 = 1,000ドル。
3. 結果：
   • 売却した800トークンの比例配分による取得原価 = 800 x 1.00ドル = 800ドル
   • 売却による実現益 = 1,000ドル - 800ドル = 200ドル
   • 残りの200トークンの取得原価 = 200 x 1.00ドル = 200ドル
   • 残りのトークンは「無料」ではありません。購入時の1トークンあたりの取得原価が引き継がれます

よくある間違い：部分売却を「元手回収済み、残りの取得原価 = 0」と記録することです。これは部分売却時の実現益を過少に計上し、残りのトークンを後で売却したときの利益を過大に計上します。どちらの方法でも納税額の合計は同じですが、納税の時期や分類（短期か長期か）は大きく異なる場合があります。

利益の分類

分類	保有期間	米国連邦税率（2024年）
短期キャピタルゲイン	< 1年	通常の所得税率（10～37%）
長期キャピタルゲイン	>= 1年	0%、15%、または20%

各税務ロットには、それぞれの取得日が記録されます。部分売却では、会計方法（FIFO、LIFO、または個別法）で指定した順にロットが充当されます。

SOL建ての取引とUSDでの報告

Solana のトレーダーは通常SOL建てで考えますが、米国の納税義務はUSD建てです。課税対象イベントごとに、次の情報が必要です。

1. 取得時のSOL価格 — USD建ての取得原価を確定します
2. 処分時のSOL価格 — USD建ての売却収入を確定します
3. 両イベント時点のSOL建てトークン価格 — SOL/USDレートを使ってUSDに換算します

このスキルは、各イベントのタイムスタンプにおけるSOL/USDレートを追跡し、USD建ての損益を計算します。

実現損益と含み損益

• 実現：ポジションを全額または一部決済済みです。課税対象イベントが発生しています。
• 含み：ポジションは保有中です。まだ課税イベントは発生していませんが、年末までに決済する予定がある場合は、推定納税額に影響します。

税引き後損益の表示では両方が示され、含み益には現在の推定税率が適用されます。

機能

税務ロットの追跡

• 購入、売却、トークン間スワップを課税対象イベントとして記録します
• 取得日とともに、ロットごとの取得原価を管理します
• FIFO、LIFO、個別法による会計方法に対応します
• 取得原価を比例配分して部分売却を処理します

利益分類エンジン

• 実現益を短期または長期に分類します
• 各未決済ロットについて、長期保有の基準に達するまでの日数を追跡します
• 保有期間が1年に近づいているポジションにフラグを付けます

四半期ごとの納税額予測

• 累進税率を使って連邦税の納税額を推定します
• 設定可能な税率で州税も推定します
• 第1四半期から第4四半期までの予定納税額を予測します
• 四半期ごとの実現益の累計を追跡します

税金を考慮した取引シグナル

• 長期保有基準のアラート：「N 日後にポジションが長期保有基準に達します」
• 利益確定コスト：「ここで利益を確定すると、短期譲渡益に対して $X の税金が発生します」
• 損失の損益通算：「損益通算に利用できる含み損が $X あります」
• 売却タイミングの効果：「今売却する場合と 30 日待つ場合を比べると、税金を $X 節約できます」
• ウォッシュセールの警告：「30 日以内に買い戻すと、ウォッシュセールのルールが適用される可能性があります」

税引後損益の表示

• 標準的な取引損益と並べて、推定税引後損益を表示
• ポジションごとに税引前と税引後のリターンを表示
• 年初来の税負担の累計

前提条件

• Python 3.10+
• コアの追跡機能に外部依存関係はありません（標準ライブラリのみ）
• 正確な USD 換算には SOL/USD の過去の価格データが必要です
• 取引履歴は構造化された形式で用意してください（タイムスタンプ、売買区分、トークン、数量、価格）

クイックスタート

from tax_tracker import TaxTracker, Trade

tracker = TaxTracker(
    accounting_method="fifo",
    federal_bracket=0.32,   # Your marginal federal rate
    state_rate=0.05,        # Your state income tax rate
    long_term_rate=0.15,    # Your long-term capital gains rate
)

# Record the accumulate/house-money play
tracker.add_trade(Trade(
    timestamp="2025-06-15T10:00:00Z",
    side="buy",
    token="BONK",
    amount=1_000_000,
    price_usd=0.00002,      # Per-token price in USD
    total_usd=20.00,
))

tracker.add_trade(Trade(
    timestamp="2025-07-20T14:30:00Z",
    side="sell",
    token="BONK",
    amount=800_000,          # Sell 80% to recover capital
    price_usd=0.000025,
    total_usd=20.00,
))

# Check what happened
summary = tracker.position_summary("BONK")
print(f"Realized gain: ${summary.realized_gain:.2f}")
# Realized gain: $4.00  (sold 800k at $0.000025 = $20, basis = $16, gain = $4)

print(f"Remaining basis: ${summary.remaining_cost_basis:.2f}")
# Remaining basis: $4.00  (200k tokens x $0.00002 = $4)

print(f"Classification: {summary.gain_type}")
# Classification: short-term  (held ~35 days)

# Tax-aware signals
signals = tracker.get_signals("BONK", current_price_usd=0.00003)
for signal in signals:
    print(f"  [{signal.type}] {signal.message}")
# [long_term_countdown] Position crosses long-term threshold in 330 days
# [profit_taking_cost] Taking full profit triggers $2.80 short-term liability

ユースケース

1. デイトレーダーの税金管理

毎日の数百件の取引を追跡します。すべて短期取引です。四半期ごとの予定納税額の正確性と累積税負担を重視します。

2. 元本回収を伴うスイングトレード

一部を売却して元本を回収し、残りのポジションは保有し続けます。取得原価を比例配分することで、どちらの部分も正確に追跡できます。

3. 長期保有者によるモニタリング

1 年の長期保有基準に近づいているポジションを追跡します。今売却する場合と N 日待つ場合で税区分が変わるときに、シグナルで通知します。

4. タックスロス・ハーベスティング

含み損のあるポジションを特定します。ウォッシュセールのルールに注意しながら、損失を確定して利益と損益通算します。

5. 年末の税務計画

残りの四半期の税負担を予測し、12 月 31 日までに最適化の機会を特定します。

6. 複数トークンのポートフォリオ

数十種類のトークンにわたる取得原価と利益を同時に追跡し、トークンごとと全体の両方を表示します。

会計方法

FIFO（先入先出法）

売却時に最も古いロットから消費します。ほとんどのトレーダーにとってのデフォルトです。長期間にわたって取得を続けている場合、一般に長期譲渡益が増えます。

LIFO（後入先出法）

売却時に最も新しいロットから消費します。直近の購入価格が高かった場合、短期譲渡益を抑えられることがあります。

個別法

売却するロットを選択します。税務最適化の柔軟性は最大ですが、慎重な記録管理が必要です。取引後ではなく、取引前に選択する必要があります。

取引ワークフローとの連携

Trade Signal → Tax-Aware Filter → Execute/Defer Decision
                    │
                    ├─ "Short-term gain: $X liability"
                    ├─ "Long-term in N days — consider waiting"
                    ├─ "Loss harvest opportunity: $X offset"
                    └─ "Net after-tax profit: $Y"

税金を考慮したフィルターは取引をブロックしません。トレーダーがタイミングについて情報に基づいた判断を下せるよう、情報を提供します。

ファイル

参考資料

• references/planned_features.md — 詳細な機能一覧、具体例を含む取得原価の比例配分計算、利益区分のルール、四半期ごとの税額予測の方法

スクリプト

• scripts/tax_tracker.py — 取得原価の比例配分、利益区分、税金を考慮したシグナル、四半期予測を備えたデモ実装です。蓄積と元本回収のシナリオ例を表示するには、--demo を指定して実行してください。

制限事項

• 米国の連邦税および州税のルールのみ対応しています（現在、国際税務には対応していません）
• ステーキング報酬、エアドロップ、DeFi 利回りを収入イベントとして扱いません（対応予定）
• ウォッシュセールのルールには警告を出しますが、自動では適用しません
• IRS の指針に従い、トークン同士のスワップは売却と購入（課税対象イベント 2 件）として扱います
• 公式の税務申告書は作成しません（追跡と計画のみを目的としてご利用ください）

免責事項

このスキルによる税額計算は、情報提供を目的とした追跡のみを目的としています。暗号資産の税法は複雑で、変化し続けています。税額はすべて、申告前に資格を持つ税務専門家に確認してください。このスキルは税務アドバイスを行うものではありません。個別の状況に応じた助言については、CPA または税務専門弁護士にご相談ください。