---
title: 배당
description: 가격 동기화 시 Finnhub이 반환하는 주당 배당 데이터를 기반으로, 현재 보유 종목의 연간 및 월별 배당 수입을 추정합니다.
---

export const yieldRows = [
  { cmd: 'YIELD',    desc: '현재 수익률: 연간 DPS ÷ 오늘 시가. 주가 변동에 따라 매일 바뀝니다. Finnhub이 반환하는 값.' },
  { cmd: 'YLD@COST', desc: '취득 단가 기준 수익률: 연간 DPS ÷ 평균 매수 단가. 본인의 cost basis에 고정됩니다. 실제 투입한 자본 대비 수익률을 측정합니다.' },
];

export const optionsRows = [
  { cmd: <code>firma show dividend</code>,        desc: '로컬 통화로 표시 (기본 KRW)' },
  { cmd: <code>firma show dividend -c USD</code>, desc: '수입을 현재 환율로 USD로 변환' },
  { cmd: <code>firma show dividend --json</code>, desc: '머신 친화 출력' },
];

export const claudeExchange = [{
  user: '올해 배당으로 얼마나 패시브 인컴 나오고 있어?',
  ai: <p>
    현재 보유 종목과 최신 가격 기준으로, 연간 약 <code>$109</code>의 배당이
    예상됩니다. 월 평균 <code>$9</code>. MSFT가 <code>$58</code> (18주 × $3.24 DPS,
    수익률 0.88%)로 가장 많고, AAPL이 <code>$44</code> (43주 × $1.03 DPS,
    수익률 0.38%), NVDA가 <code>$6</code> (156주 × $0.04 DPS, 수익률 0.02%)를
    기여합니다. TSLA는 배당을 지급하지 않습니다.
  </p>,
}];

<Section label="firma show dividend">
배당을 지급하는 보유 종목별로 배당 수익률, 연환산 DPS, 추정 연간 수입을
표시합니다. 로컬 가격 캐시에 배당 데이터가 있는 티커만 포함됩니다 -
먼저 <code>firma sync</code>를 실행해 캐시를 채웁니다.

<div className="terminal">
  <div className="terminal-line">
    <span className="term-prompt">$</span>
    <span className="term-cmd">firma show dividend</span>
  </div>
  <table className="term-table">
    <thead>
      <tr><th>TICKER</th><th>SHARES</th><th>YIELD</th><th>YLD@COST</th><th>ANN. DPS</th><th>EST. ANNUAL</th></tr>
    </thead>
    <tbody>
      <tr className="sep"><td colSpan={6}/></tr>
      <tr><td className="td-bold">MSFT</td><td>18</td><td className="td-muted">0.88%</td><td style={{ color: 'var(--yellow)' }}>1.30%</td><td className="td-muted">$3.2394</td><td>$58</td></tr>
      <tr><td className="td-bold">AAPL</td><td>43</td><td className="td-muted">0.38%</td><td style={{ color: 'var(--yellow)' }}>0.66%</td><td className="td-muted">$1.0318</td><td>$44</td></tr>
      <tr><td className="td-bold">NVDA</td><td>156</td><td className="td-muted">0.02%</td><td style={{ color: 'var(--yellow)' }}>0.03%</td><td className="td-muted">$0.0399</td><td>$6</td></tr>
      <tr className="sep"><td colSpan={6}/></tr>
    </tbody>
    <tfoot>
      <tr><td className="td-muted">Annual income</td><td colSpan={5}>$109</td></tr>
      <tr><td className="td-muted">Monthly avg</td><td colSpan={5} className="td-muted">$9</td></tr>
    </tfoot>
  </table>
</div>

  <Note>
    수익률과 DPS는 Finnhub 데이터로, 마지막 sync 결과를 반영합니다.
    갱신하려면 <code>firma sync</code>를 실행합니다. TSLA와 NVDA는 배당을 지급하지
    않으므로 표시되지 않습니다.
  </Note>
</Section>

<Section label="Yield on Cost vs 현재 수익률">
이 표에는 두 가지 수익률 컬럼이 있습니다. 각각 다른 질문에 답합니다:

  <CommandTable rows={yieldRows} />

예시: MSFT를 평균 <code>$250/주</code>에 매수했다고 합시다. 연간 DPS가
<code>$3.24</code>이므로 Yield on Cost는 <code>1.30%</code>. 주가가 오늘
어떻든 본인이 투입한 자본 대비 배당이 돌려주는 수익률입니다. MSFT가 현재
<code>$368</code>이라면 현재 수익률은 <code>0.88%</code> (주가 상승으로 더 낮음).
장기 보유자의 경우 주가가 상승하면서 배당도 계속 지급되어 YLD@COST가 표면
수익률보다 훨씬 높은 경우가 많습니다.

  <Note>
    Yield on Cost는 cost basis 계산을 위해 거래 내역에 매수 거래가 한 번 이상
    있어야 합니다. Cost 데이터가 없는 티커는 YLD@COST 컬럼에 대시(─)가 표시됩니다.
  </Note>
</Section>

<Section label="옵션">
  <CommandTable rows={optionsRows} />
</Section>

<Section label="Claude와 함께">
  <ChatDemo header="Claude Desktop · firma MCP 연결됨" exchanges={claudeExchange} />
</Section>
