trade-accounting について
取引業務向けのPython製複式簿記スキルで、トークン取引、手数料、ステーキング、エアドロップ、LP収益を記録します。財務レポートを作成し、戦略評価用の取引損益と税務向けの実現損益を区別します。
主な機能
- 01複式簿記の取引台帳
- 02取引、手数料、ステーキング、LP収益の記録
- 03損益計算書、貸借対照表、キャッシュフロー計算書の作成
- 04FIFOによる実現損益と取得原価の追跡
- 05取引損益と税務損益の区別
活用シーン
- 01手数料控除後の取引損益の集計
- 02税務申告用の取得原価記録の整理
- 03手数料が利益に与える影響の分析
- 04戦略ごとの純損益の比較
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ agiprolabs/ claude-trading-skills --skill trade-accountingインストール後、Claude Code で/trade-accountingを入力して読み込まれたか確認します。
同梱ファイルreferences/planned_features.mdscripts/trading_ledger.py
詳細
取引会計
取引業務をビジネスとして運営しましょう。使った SOL、取得したトークン、支払ったすべての手数料、実現したすべての利益を、複式簿記で記録して帳簿の貸借を常に一致させます。個人ウォレットでも LLC でも、適切な会計処理によって混乱が明確になります。
基本原則:すべての取引は、少なくとも2つの勘定科目に影響します。トークンを購入すると、現金が減り、トークン保有額が同じ金額だけ増えます。この複式記帳の制約によって、エラーが自動的に検出されます。借方と貸方が一致しない場合、何かが間違っています。
トレーダーに会計が必要な理由
多くのトレーダーは損益を大まかに記録しています。「最初は50 SOLで、今は62 SOLある」。しかし、これだけでは次のことは何もわかりません。
- 実現した取引と未実現のポジションから、それぞれいくら得たか
- 累計で支払った手数料(ガス代、優先手数料、スワップ手数料)
- ステーキングや LP の収入が運営コストをまかなえているか
- 保有資産ごとの実際の取得原価(税務上重要)
- キャッシュフローのタイミング — 利益は出ていても流動性がない状態かどうか
適切な会計処理を行えば、これらすべてに答えられます。また、取引損益(時価評価による損益。戦略の評価に役立ちます)と、税務上の損益(特定の取得原価計算方法に基づく実現利益。コンプライアンス上必要です)を分けて管理できます。
勘定科目の種類
取引業務では、標準的な会計に従って4つの勘定科目カテゴリを使用します。
| カテゴリ | 通常残高 | 例 |
|---|---|---|
| 資産 | 借方 | 現金(SOL/USDC)、トークン保有、LP ポジション、ステーキング預入金、未収金 |
| 負債 | 貸方 | 証拠金借入、未払税金 |
| 収益 | 貸方 | 実現した取引利益、ステーキング報酬、エアドロップ収入、LP 手数料収入 |
| 費用 | 借方 | 取引手数料、ガス代/優先手数料、サブスクリプション費用、データフィード |
| 資本 | 貸方 | 所有者による資本拠出、利益剰余金、引き出し(控除項目) |
勘定科目一覧
勘定科目一覧の全体については、references/planned_features.md を参照してください。最小限の構成は次のとおりです。
1000 Assets
1010 Cash – SOL
1020 Cash – USDC
1100 Token Holdings (one sub-account per token)
1200 LP Positions
1300 Staking Deposits
3000 Income
3010 Realized Trading Gains
3020 Staking Rewards
3030 Airdrop Income
3040 LP Fee Income
4000 Expenses
4010 Trading Fees (DEX swap fees)
4020 Gas & Priority Fees
4030 Slippage Cost
5000 Equity
5010 Owner Capital
5020 Retained Earnings
5030 Owner Withdrawals (contra-equity)
複式簿記
すべての取引では、借方と貸方を同額で記録します。借方は資産勘定と費用勘定を増やし、貸方は負債勘定、収益勘定、資本勘定を増やします。
仕訳例
1000 BONK を 0.5 SOL で購入(ガス代 0.001 SOL):
| 勘定科目 | 借方 | 貸方 |
|---|---|---|
| トークン保有 – BONK | 0.501 SOL | |
| 現金 – SOL | 0.501 SOL |
または、手数料を明示的に分ける場合:
| 勘定科目 | 借方 | 貸方 |
|---|---|---|
| トークン保有 – BONK | 0.5 SOL | |
| ガス代・優先手数料 | 0.001 SOL | |
| 現金 – SOL | 0.501 SOL |
1000 BONK を 0.8 SOL で売却(取得原価は 0.5 SOL、ガス代は 0.001 SOL):
| 勘定科目 | 借方 | 貸方 |
|---|---|---|
| 現金 – SOL | 0.799 SOL | |
| ガス代・優先手数料 | 0.001 SOL | |
| トークン保有 – BONK | 0.5 SOL | |
| 実現取引利益 | 0.3 SOL |
ステーキング報酬 0.05 SOL を受け取る:
| 勘定科目 | 借方 | 貸方 |
|---|---|---|
| 現金 – SOL | 0.05 SOL | |
| ステーキング報酬 | 0.05 SOL |
5000 JUP のエアドロップを受け取る(受取時の評価額は 2.1 SOL):
| 勘定科目 | 借方 | 貸方 |
|---|---|---|
| トークン保有 – JUP | 2.1 SOL | |
| エアドロップ収入 | 2.1 SOL |
LP 手数料 0.03 SOL を回収する:
| 勘定科目 | 借方 | 貸方 |
|---|---|---|
| 現金 – SOL | 0.03 SOL | |
| LP 手数料収入 | 0.03 SOL |
一部決済 — ポジションの半分を売却:
取得原価 1.0 SOL の 2000 BONK を保有していて、そのうち1000を 0.7 SOL で売却する場合:
| 勘定科目 | 借方 | 貸方 |
|---|---|---|
| 現金 – SOL | 0.699 SOL | |
| ガス代・優先手数料 | 0.001 SOL | |
| トークン保有 – BONK | 0.5 SOL | |
| 実現取引利益 | 0.2 SOL |
売却分の取得原価(0.5 SOL = 1.0 SOL の半分)は、資産勘定から取り除かれます。
取引の種類
台帳では、次の取引フローを扱います。
| フロー | 影響を受ける勘定 |
|---|---|
| 口座への入金 | 現金(借方)、オーナー資本(貸方) |
| 資金の引き出し | オーナー引き出し(借方)、現金(貸方) |
| トークンの購入 | トークン保有高(借方)、現金(貸方)、ガス費用(借方) |
| トークンの売却 | 現金(借方)、トークン保有高(貸方)、実現利益(貸方、損失の場合は借方)、ガス費用(借方) |
| 一部決済 | 売却と同じ。取得原価を按分 |
| トークン同士のスワップ | トークン B(借方)、トークン A(貸方)、手数料 |
| ステーキングへの預け入れ | ステーキング預け入れ(借方)、現金(貸方) |
| ステーキング報酬 | 現金(借方)、ステーキング報酬(貸方) |
| エアドロップの受け取り | トークン保有高(借方)、エアドロップ収入(貸方) |
| LP 手数料の受け取り | 現金(借方)、LP 手数料収入(貸方) |
| 取引手数料 | 取引手数料(借方)、現金(貸方) |
| ガス/優先手数料 | ガス・優先手数料(借方)、現金(貸方) |
レポート
損益計算書
期間中の収益から費用を差し引いた金額を示します。
═══════════════════════════════════════════
P&L Statement: 2026-02-01 to 2026-02-28
═══════════════════════════════════════════
INCOME
Realized Trading Gains ........ 4.200 SOL
Staking Rewards ............... 0.150 SOL
Airdrop Income ................ 2.100 SOL
LP Fee Income ................. 0.090 SOL
─────────
Total Income 6.540 SOL
EXPENSES
Trading Fees .................. 0.120 SOL
Gas & Priority Fees ........... 0.045 SOL
Slippage Cost ................. 0.030 SOL
─────────
Total Expenses 0.195 SOL
═══════════════════════════════════════════
NET INCOME 6.345 SOL
═══════════════════════════════════════════
貸借対照表
会計等式「資産 = 負債 + 純資産」を示します。
═══════════════════════════════════════════
Balance Sheet: 2026-02-28
═══════════════════════════════════════════
ASSETS
Cash – SOL .................... 32.450 SOL
Cash – USDC ................... 0.000 SOL
Token Holdings ................ 12.300 SOL
LP Positions .................. 5.000 SOL
Staking Deposits .............. 10.000 SOL
─────────
Total Assets 59.750 SOL
EQUITY
Owner Capital ................. 50.000 SOL
Retained Earnings ............. 3.405 SOL
Net Income (current period) ... 6.345 SOL
─────────
Total Equity 59.750 SOL
═══════════════════════════════════════════
Assets - Equity = 0.000 SOL ✓ Balanced
═══════════════════════════════════════════
キャッシュフロー計算書
現金の調達元と使途を追跡します。
═══════════════════════════════════════════
Cash Flow: 2026-02-01 to 2026-02-28
═══════════════════════════════════════════
OPERATING ACTIVITIES
Trading proceeds .............. 8.500 SOL
Token purchases ............... (4.300) SOL
Fees paid ..................... (0.195) SOL
Staking rewards received ...... 0.150 SOL
LP fees received .............. 0.090 SOL
─────────
Net Operating Cash Flow 4.245 SOL
INVESTING ACTIVITIES
LP deposits ................... (5.000) SOL
Staking deposits .............. (2.000) SOL
─────────
Net Investing Cash Flow (7.000) SOL
FINANCING ACTIVITIES
Capital contributions ......... 10.000 SOL
Withdrawals ................... (1.000) SOL
─────────
Net Financing Cash Flow 9.000 SOL
═══════════════════════════════════════════
Net Change in Cash 6.245 SOL
Beginning Cash Balance 26.205 SOL
Ending Cash Balance 32.450 SOL
═══════════════════════════════════════════
取引損益と税務上の損益
これらは異なる数値であり、目的も異なります。
| 項目 | 取引損益 | 税務上の損益 |
|---|---|---|
| 目的 | 戦略の評価 | 法令遵守、申告 |
| 未実現利益 | 含む(時価評価) | 含まない(実現するまで) |
| 取得原価の計算方法 | 平均原価(簡便) | FIFO、LIFO、または個別法(管轄区域による) |
| 計上時期 | リアルタイム | 処分時 |
| エアドロップ | 受領時の価値で評価 | 受領時の公正市場価値(FMV)に基づく通常所得 |
| LP のインパーマネントロス(IL) | 未実現損失として追跡 | 引き出すまでは課税対象の事象ではない |
scripts/trading_ledger.py にある台帳は、デフォルトで FIFO を使用して実現利益を追跡します。取引損益については、未決済ポジションに時価評価を重ねて適用できます。
FIFO と平均原価では、同じ取引から異なる損益が生じる例を詳しく示した references/planned_features.md を参照してください。
事業体に関する考慮事項
LLC または S-Corp を通じて取引を行うトレーダーは、次の追加勘定を追跡する必要があります。
- 管理手数料 — 事業体が管理手数料を請求する場合
- 分配金 — 事業体からオーナーへの支払い(取引口座からの引き出しとは異なります)
- 給与費用 — S-Corp の役員報酬
- 税金引当金 — 四半期ごとの予定納税額
会計原則は同じで、勘定科目表が拡張されるだけです。このスキルのスクリプトは、事業体レベルのレポートの基礎となる取引レベルの台帳に重点を置いています。
クイックスタート
from trading_ledger import Ledger, Amount
ledger = Ledger(base_currency="SOL")
# Fund the account
ledger.record_funding(amount=50.0, memo="Initial capital")
# Buy a token
ledger.record_buy(
token="BONK",
quantity=100_000,
cost_sol=0.5,
fee_sol=0.001,
memo="Entry on volume spike"
)
# Sell for profit
ledger.record_sell(
token="BONK",
quantity=100_000,
proceeds_sol=0.8,
fee_sol=0.001,
memo="Target hit"
)
# Record staking reward
ledger.record_income(
income_type="staking",
amount_sol=0.05,
memo="Epoch 580 rewards"
)
# Generate reports
ledger.print_pnl(start="2026-02-01", end="2026-02-28")
ledger.print_balance_sheet(as_of="2026-02-28")
デモスクリプトを実行すると、すべてのレポート形式とともに、1か月分の取引活動を確認できます。
python scripts/trading_ledger.py --demo
ユースケース
- 実際の損益を追跡 — エントリー価格と決済価格だけでなく、すべての手数料を差し引いた後の利益を正確に把握します
- 税務申告の準備 — 取得原価と実現利益を記録した、整理された台帳を税理士に渡せます
- 手数料の分析 — ガス代と優先手数料が粗利益の 3% を占めていることを把握できます
- 戦略の比較 — 勝率だけでなく、戦略ごとの純損益を比較します
- キャッシュフローの計画 — 次の取引に十分な流動性のある SOL があるかを把握します
- 監査証跡 — すべての数値を、日付とメモが付いた仕訳までたどれます
前提条件
- Python 3.10+
- 外部依存関係なし(台帳では標準ライブラリのみを使用します)
ファイル
| ファイル | 説明 |
|---|---|
references/planned_features.md | 勘定科目表、複式簿記の例、レポート形式、取引損益と税務上の損益 |
scripts/trading_ledger.py | 損益計算書、貸借対照表、デモモードを備えた複式簿記台帳 |
免責事項:このスキルは、情報提供および整理のみを目的として、会計の構成と計算を提供します。税務、法律、または財務に関する助言ではありません。具体的な納税義務については、資格を持つ税務専門家または公認会計士にご相談ください。暗号資産の税務上の取り扱いは、管轄地域によって異なり、頻繁に変更されます。