regulatory-reporting

規制報告

STATUS: STUB — このスキルでは、暗号資産の税務および規制報告に関する計画中の機能の概要を説明します。生成された出力はすべて、提出前に有資格の税務専門家が確認する必要があります。このスキルの内容は、税務上または法律上の助言を構成するものではありません。

概要

暗号資産の取引活動に関する規制報告書を追跡し、作成します。米国連邦税務フォーム（IRS Form 8949、Schedule D）、FinCEN の外国口座報告（FBAR）、州ごとの暗号資産に関する義務、高額取引のフラグ付け、期限の追跡に対応します。

暗号資産の税務報告は複雑で、制度も変化し続けています。ルールは頻繁に変更され、取得価額の算定方法は管轄区域によって異なり、DeFi の活動（スワップ、LP ポジション、エアドロップ、ステーキング報酬）は現行のガイダンスでは扱いが明確でない場合があります。このスキルは、規制当局が求める形式に取引データを整理するための構造化されたフレームワークを提供しますが、提出内容はすべて税務専門家による確認が必要です。

免責事項

WARNING: このスキルは、情報提供および教育のみを目的としています。税務、法律、または金融に関する助言を構成するものではありません。暗号資産に関する税法は複雑で、管轄区域ごとに異なり、急速に変化しています。実際の税務申告でこのスキルの出力を利用する前に、必ず暗号資産に詳しい有資格の税務専門家（CPA、EA、または税務弁護士）に相談してください。税務報告の誤りは、追徴課税、利息、法的措置につながる可能性があります。本資料の利用について、著者は一切の責任を負いません。

現在の状況

このスキルはSTUBです。ここに記載されているコードと参考資料は、データ構造と基本的な計算を示すための出発点です。現行の IRS ガイダンスや州税務当局の要件に照らした検証は行われていません。

現在利用できる機能

• 取引データから Form 8949 の基本的な明細を生成します（scripts/form_8949_generator.pyを参照）
• 規制要件の概要（references/planned_features.mdを参照）
• サンプル取引データを使ったデモモード

今後予定されている機能

• IRS Form 8949 および Schedule D の完全な PDF 生成
• 外国取引所の口座残高が $10,000 を超える場合の FinCEN FBAR 生成
• 州ごとの報告要件の検出とテンプレート
• 報告基準額の追跡と期限カレンダー
• 高額取引（現金相当額で $10,000 以上）のフラグ付け
• 外国口座の報告要件（FATCA Form 8938）
• ワッシュセールの検出と調整（該当する場合）
• 取得価額の算定方法の選択（FIFO、LIFO、Specific ID、HIFO）
• DeFi 固有のイベント分類（スワップ、LP の開始・終了、ステーキング、エアドロップ）
• IRS 互換の CSV/PDF 形式での実際のフォームデータ出力

前提条件

# No external dependencies for the demo script
python scripts/form_8949_generator.py --demo

本番環境で実装するには、以下が必要です。

uv pip install pandas reportlab  # PDF generation

主な概念

IRS Form 8949 — 資本資産の売却および処分

Form 8949 では、資本資産の売却または処分を個別に報告します。暗号資産の場合、すべての取引、スワップ、または支出イベントが課税対象となる処分です。主な項目は次のとおりです。

列	説明
(a)	資産の説明（例：「2.5 BTC」）
(b)	取得日
(c)	売却日または処分日
(d)	売却代金（米ドルでの売却価格）
(e)	取得価額またはその他の基準額
(f)	調整コード（例：ワッシュセールを示す W）
(g)	調整額
(h)	利益または損失（d から e を差し引き、g で調整）

取引はPart I（短期保有、保有期間が1年以下）とPart II（長期保有、保有期間が1年超）に分けられます。

Schedule D — キャピタルゲインおよびキャピタルロス

Schedule D では Form 8949 の合計を集計します。

• 1b/8b 行：Form 8949 の Part I / Part II からの合計（取得価額が IRS に報告済み）
• 1c/8c 行：取得価額が IRS に報告されていない場合の合計
• 7/15 行：短期／長期の純キャピタルゲインまたは純キャピタルロス
• 16 行：合計純利益または純損失

FinCEN FBAR（FinCEN Form 114）

暦年中のいずれかの時点で、外国金融口座の合計価値が10,000ドルを超える場合に提出が必要です。外国の取引所（米国以外の事業体向けのBinanceなど）で保有する暗号資産が、この要件の対象となる可能性があります。ただし、暗号資産口座が「外国金融口座」に該当するかどうかについてのIRSの指針は、現在も変化しています。

• 提出期限：4月15日（自動延長により10月15日まで）
• 未提出に対する罰則：故意でない違反は最大12,500ドル、故意の違反は最大100,000ドルまたは口座残高の50％

大口取引の報告

現金で10,000ドル以上（最近の指針では暗号資産が含まれる可能性があります）を受け取る事業者は、15日以内にIRS Form 8300を提出する必要があります。通常、個人トレーダーはForm 8300を提出しませんが、取引所が大口取引を報告する場合があります。

クイックスタート

"""Generate Form 8949 line items from trade history."""
from dataclasses import dataclass
from datetime import date
from decimal import Decimal

@dataclass
class Trade:
    asset: str
    quantity: Decimal
    date_acquired: date
    date_sold: date
    proceeds_usd: Decimal
    cost_basis_usd: Decimal

def classify_holding_period(trade: Trade) -> str:
    """Return 'short-term' or 'long-term' based on holding period."""
    holding_days = (trade.date_sold - trade.date_acquired).days
    return "short-term" if holding_days <= 365 else "long-term"

def compute_gain_loss(trade: Trade) -> Decimal:
    """Compute capital gain or loss for a single trade."""
    return trade.proceeds_usd - trade.cost_basis_usd

# Example
trade = Trade(
    asset="SOL",
    quantity=Decimal("10"),
    date_acquired=date(2025, 1, 15),
    date_sold=date(2025, 8, 20),
    proceeds_usd=Decimal("2500.00"),
    cost_basis_usd=Decimal("1800.00"),
)
gain = compute_gain_loss(trade)
period = classify_holding_period(trade)
print(f"{trade.asset}: {period} gain of ${gain}")
# SOL: short-term gain of $700.00

ユースケース

1. 年末の税務申告準備 — 取引所から取引履歴をエクスポートし、Form 8949の明細を生成してSchedule Dの合計を計算し、整理したデータを税務専門家に渡します。

2. 四半期ごとの予定納税の追跡 — 年間を通じて実現益の累計を監視し、四半期ごとの納税額（IRS Form 1040-ES）を見積もります。

3. FBARの基準額の監視 — 外国の取引所口座の残高を合算して追跡し、FBARの提出が必要かどうかを判断します。

4. 税務調査への備え — IRSからの照会に備えて、取得原価の記録を含むすべての処分記録を整理して保管します。

5. 複数州での申告 — 追加要件のある州で取引する場合に、州固有の暗号資産報告義務を特定します。

ファイル

リファレンス

• references/planned_features.md — 規制要件の概要、Form 8949／Schedule Dの各項目の説明、FBARの基準額、州の要件の概要、報告期限

スクリプト

• scripts/form_8949_generator.py — 取引データからForm 8949の明細を生成する基本スクリプト。--demoモードに対応し、外部依存関係はありません

制限事項

• 法律または税務に関する助言ではありません。 これはソフトウェアツールであり、税務専門家ではありません。
• 米国に特化しています。 国際的な税務義務は対象外です。
• 規則は変化しています。 暗号資産に関する税務指針は頻繁に変更されるため、このスキルに最新のIRS通知や裁定が反映されていない場合があります。
• DeFiの分類には未対応です。 複雑なDeFiイベント（LPポジション、イールドファーミング、リベーストークンなど）には、まだ対応していません。
• ウォッシュセールの判定は確定できません。 ウォッシュセール規則が暗号資産に適用されるかどうかは未確定です。このスキルはウォッシュセールの可能性を検出しますが、確定的な判断はできません。
• 取得原価の計算方法は限定されています。 デモではFIFOのみが実装されており、LIFO、HIFO、特定ID法は今後実装予定です。

報告期限（米国連邦）

フォーム	期限	延長
Form 8949／Schedule D	4月15日	10月15日（Form 4868を提出した場合）
FinCEN FBAR（Form 114）	4月15日	10月15日（自動延長）
Form 8300	取引後15日以内	なし
FATCA Form 8938	納税申告書と同時	納税申告書の延長と同時
1040-ES（四半期ごと）	4月15日、6月15日、9月15日、1月15日	なし

コントリビューション

これは大幅な拡張の余地があるスタブスキルです。次の分野でのコントリビューションを歓迎します。

• 追加の取得原価計算方法（LIFO、HIFO、特定ID法）
• DeFiイベントの分類（LPへの預け入れ／引き出し、ステーキング、エアドロップ、ブリッジ）
• 州固有の要件データベース
• ウォッシュセール検出アルゴリズム
• PDFフォームの生成（IRS互換の出力）
• 国際的な税務管轄区域への対応
• 取引所APIのエクスポート形式との統合

すべてのコントリビューションには適切な免責事項を含め、具体的な税務助言を行わないでください。コントリビューションのガイドラインについては、プロジェクトのCLAUDE.mdを参照してください。

関連スキル

• portfolio-analytics — 税務報告に利用できるポートフォリオのパフォーマンス追跡
• trade-journal — Form 8949の元データとして利用できる取引記録