---
title: 거래 내역
description: 거래는 포트폴리오의 진실의 원천(source of truth)입니다. 보유 종목과 평균 단가는 거래에서 도출됩니다. 별도의 보유 테이블을 동기화할 필요가 없습니다.
---

<Section label="firma show txns [ticker]">
모든 거래를 누적 평균 단가와 함께 표시합니다. 티커를 인자로 주면 단일 종목으로
필터링됩니다. **ID** 컬럼은 특정 거래를 수정하거나 삭제할 때 사용합니다.

<div className="terminal">
  <div className="terminal-line">
    <span className="term-prompt">$</span>
    <span className="term-cmd">firma show txns TSLA</span>
  </div>
  <table className="term-table">
    <thead>
      <tr><th>ID</th><th>DATE</th><th>TYPE</th><th>SHARES</th><th>PRICE</th><th>TOTAL</th><th>AVG COST</th></tr>
    </thead>
    <tbody>
      <tr className="sep"><td colSpan={7}/></tr>
      <tr><td className="td-muted">#86</td><td className="td-muted">2026-04-08</td><td className="td-green">buy</td><td>5</td><td>$351.69</td><td>$1,758.43</td><td className="td-muted">$245.68</td></tr>
      <tr><td className="td-muted">#8</td><td className="td-muted">2026-04-01</td><td className="td-green">buy</td><td>5</td><td>$354.75</td><td>$1,773.75</td><td className="td-muted">$244.24</td></tr>
      <tr><td className="td-muted">#39</td><td className="td-muted">2026-03-25</td><td className="td-green">buy</td><td>8</td><td>$387.85</td><td>$3,102.80</td><td className="td-muted">$242.72</td></tr>
      <tr><td className="td-muted">#28</td><td className="td-muted">2026-02-28</td><td className="td-green">buy</td><td>18</td><td>$396.37</td><td>$7,134.66</td><td className="td-muted">$237.22</td></tr>
      <tr><td className="td-muted">#101</td><td className="td-muted">2025-11-17</td><td className="td-green">buy</td><td>8</td><td>$406.45</td><td>$3,251.60</td><td className="td-muted">$228.60</td></tr>
      <tr><td className="td-muted">#1</td><td className="td-muted">2025-01-02</td><td className="td-muted">deposit</td><td>100</td><td>$78.00</td><td>$7,800.00</td><td className="td-muted">$78.00</td></tr>
      <tr className="sep"><td colSpan={7}/></tr>
    </tbody>
    <tfoot>
      <tr><td className="td-muted" colSpan={7}>24 transactions</td></tr>
    </tfoot>
  </table>
</div>

  <Note>
    거래 유형: <code>buy</code>, <code>sell</code>, <code>deposit</code> (입고),
    <code>dividend</code>, <code>tax</code>.
    가격이 있는 <code>buy</code>와 <code>deposit</code>만 평균 단가에 영향을 줍니다.
  </Note>
</Section>

<Section label="firma add txn">
인터랙티브 프롬프트로 새 거래를 기록합니다. 평균 단가는 매 입력 후 자동으로
재계산됩니다.

  <Terminal
    command="firma add txn"
    rows={[
      { type: 'val',  label: '◆  Asset type',       value: 'Stock' },
      { type: 'val',  label: '◆  Type',             value: 'buy' },
      { type: 'val',  label: '◆  Market',           value: 'US' },
      { type: 'val',  label: '◆  Stock',            value: 'AAPL' },
      { type: 'val',  label: '◆  Shares',           value: '15' },
      { type: 'val',  label: '◆  Price (USD)',      value: '$211.00' },
      { type: 'val',  label: '◆  Date',             value: '2026-04-25' },
      { type: 'beat', text:  'Transaction recorded.  AAPL avg cost → $196.40' },
    ]}
  />

  <Note>
    첫 프롬프트는 자산 종류입니다. <strong>Stock</strong>은 시장(US, KRX, JP, HK 등)과
    티커를 묻습니다. 비-주식 종류(크립토, 원자재, 부동산)는 대신 자유 입력 이름과
    통화를 묻습니다 — 이런 자산은 <code>firma add price</code>로 가치를 입력합니다.
    금액은 해당 자산의 통화로 입력하고 USD로 저장됩니다.
  </Note>

  <Note>
    Claude Desktop에서도 거래를 추가할 수 있습니다. "AAPL 15주 $211에 샀어"라고
    말하면 Claude가 <code>add_txn</code>을 직접 호출합니다.
  </Note>
</Section>

<Section label="firma edit txn [id]">
ID로 기존 거래를 수정합니다. ID를 생략하면 최근 거래 중에서 선택할 수 있는
인터랙티브 피커가 나타납니다. 변경한 항목만 업데이트되고 나머지는 그대로 유지됩니다.

  <Terminal
    command="firma edit txn 86"
    rows={[
      { type: 'val',  label: <>◆  Price per share <span style={{color:'var(--muted)'}}>($351.69)</span></>, value: '$349.00' },
      { type: 'beat', text:  'Transaction #86 updated.' },
    ]}
  />
</Section>

<Section label="firma delete txn [id]">
거래를 영구 삭제합니다. 보유 수량과 평균 단가는 즉시 재계산됩니다. ID를
생략하면 인터랙티브 피커가 나타납니다.

  <Terminal
    command="firma delete txn 86"
    rows={[
      { type: 'val',  label: '◆  Delete #86 · TSLA buy 5 @ $351.69 on 2026-04-08?', value: 'Yes' },
      { type: 'beat', text:  'Transaction #86 deleted.' },
    ]}
  />
</Section>
