mcpField
T
trade-accounting

trade-accounting

github.com/agiprolabsその他456460 回インストール8 週間前に更新
リポジトリ

trade-accounting について

取引業務向けのPython製複式簿記スキルで、トークン取引、手数料、ステーキング、エアドロップ、LP収益を記録します。財務レポートを作成し、戦略評価用の取引損益と税務向けの実現損益を区別します。

主な機能

  1. 01複式簿記の取引台帳
  2. 02取引、手数料、ステーキング、LP収益の記録
  3. 03損益計算書、貸借対照表、キャッシュフロー計算書の作成
  4. 04FIFOによる実現損益と取得原価の追跡
  5. 05取引損益と税務損益の区別

活用シーン

  1. 01手数料控除後の取引損益の集計
  2. 02税務申告用の取得原価記録の整理
  3. 03手数料が利益に与える影響の分析
  4. 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):

勘定科目借方貸方
トークン保有 – BONK0.501 SOL
現金 – SOL0.501 SOL

または、手数料を明示的に分ける場合:

勘定科目借方貸方
トークン保有 – BONK0.5 SOL
ガス代・優先手数料0.001 SOL
現金 – SOL0.501 SOL

1000 BONK を 0.8 SOL で売却(取得原価は 0.5 SOL、ガス代は 0.001 SOL):

勘定科目借方貸方
現金 – SOL0.799 SOL
ガス代・優先手数料0.001 SOL
トークン保有 – BONK0.5 SOL
実現取引利益0.3 SOL

ステーキング報酬 0.05 SOL を受け取る:

勘定科目借方貸方
現金 – SOL0.05 SOL
ステーキング報酬0.05 SOL

5000 JUP のエアドロップを受け取る(受取時の評価額は 2.1 SOL):

勘定科目借方貸方
トークン保有 – JUP2.1 SOL
エアドロップ収入2.1 SOL

LP 手数料 0.03 SOL を回収する:

勘定科目借方貸方
現金 – SOL0.03 SOL
LP 手数料収入0.03 SOL

一部決済 — ポジションの半分を売却:

取得原価 1.0 SOL の 2000 BONK を保有していて、そのうち1000を 0.7 SOL で売却する場合:

勘定科目借方貸方
現金 – SOL0.699 SOL
ガス代・優先手数料0.001 SOL
トークン保有 – BONK0.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

ユースケース

  1. 実際の損益を追跡 — エントリー価格と決済価格だけでなく、すべての手数料を差し引いた後の利益を正確に把握します
  2. 税務申告の準備 — 取得原価と実現利益を記録した、整理された台帳を税理士に渡せます
  3. 手数料の分析 — ガス代と優先手数料が粗利益の 3% を占めていることを把握できます
  4. 戦略の比較 — 勝率だけでなく、戦略ごとの純損益を比較します
  5. キャッシュフローの計画 — 次の取引に十分な流動性のある SOL があるかを把握します
  6. 監査証跡 — すべての数値を、日付とメモが付いた仕訳までたどれます

前提条件

  • Python 3.10+
  • 外部依存関係なし(台帳では標準ライブラリのみを使用します)

ファイル

ファイル説明
references/planned_features.md勘定科目表、複式簿記の例、レポート形式、取引損益と税務上の損益
scripts/trading_ledger.py損益計算書、貸借対照表、デモモードを備えた複式簿記台帳

免責事項:このスキルは、情報提供および整理のみを目的として、会計の構成と計算を提供します。税務、法律、または財務に関する助言ではありません。具体的な納税義務については、資格を持つ税務専門家または公認会計士にご相談ください。暗号資産の税務上の取り扱いは、管轄地域によって異なり、頻繁に変更されます。

コメント