FX 히스토리

과거 통화 변환에 사용되는 로컬 FX 환율 캐시를 조회합니다. Firma sync (또는 firma sync fx)로 FRED에서 채웁니다. KRW, JPY, EUR, CNY, GBP에 대해 "USD 1당 외화" 형태로 저장됩니다.

firma show fx

인자 없이 실행하면 캐시의 통화별 커버리지를 보여줍니다. 통화별 행 수와 날짜 범위. 백필이 완료됐고 캐시가 가장 이른 항목 날짜를 포함하는지 검증할 때 유용합니다.
$firma show fx
CURRENCYROWSFIRSTLAST
CNY19052018-08-282026-04-17
EUR19052018-08-282026-04-17
GBP19052018-08-282026-04-17
JPY19052018-08-282026-04-17
KRW19052018-08-282026-04-17
USD는 행이 없습니다. 기준 통화로 코드에서 항상 1.0입니다. FIRST 날짜는 가장 이른 거래/자산/현금흐름 항목의 날짜에 가깝습니다 (백필의 시작점).

firma show fx <currency>

통화 코드와 함께 실행하면 가장 최근의 N개 환율을 표시합니다 (기본 30):
$firma show fx KRW --limit 5
DATEKRW per USD
2026-04-171461.6600
2026-04-161478.1900
2026-04-151474.4100
2026-04-141471.5100
2026-04-131486.9400
최신 순 정렬. 모든 통화의 방향은 일관됩니다. USD 1당 외화. USD 가치에 환율을 곱하면 홈 통화 가치가 나옵니다.

기간 지정

명시적 기간을 지정하려면 --from과 --to를 사용합니다 (기간이 설정되면 기본 limit은 무시됩니다):
$firma show fx KRW --from 2020-03-01 --to 2020-04-01
DATE            KRW per USD
──────────────────────────────
2020-03-31      1217.4200
2020-03-30      1224.5500
2020-03-27      1218.0800
2020-03-26      1232.0100
2020-03-25      1241.4900
2020-03-24      1247.9800
2020-03-23      1267.2500   ← COVID crash peak
...

JSON 출력

--json은 두 형태(커버리지 요약, 통화별 시계열) 모두에서 동작합니다:
$firma show fx KRW --json --limit 2
{
"currency": "KRW",
"count": 2,
"observations": [
  { "date": "2026-04-17", "currency": "KRW", "rate_to_usd": 1461.66 },
  { "date": "2026-04-16", "currency": "KRW", "rate_to_usd": 1478.19 }
]
}

firma의 캐시 사용 방식

USD가 아닌 통화로 과거 데이터를 표시할 때, firma는 각 항목을 자기 날짜의 환율로 변환합니다. 여기서 조회됩니다.
📊
show balance / show flow
각 항목은 자기 날짜의 환율로 변환됩니다. 출력 푸터에 FX @ 2026-03-31: 1 USD = 1523.5 KRW가 표시되어 변환 과정을 검증할 수 있습니다.
📈
report (시계열)
각 기간은 해당 시점의 환율로 집계됩니다. 순자산 추세는 "오늘 USD 가치 × 오늘 환율"이 아니라 실제로 그 시점에 보유했던 홈 통화 기준 가치를 반영합니다.
💼
show portfolio Net Worth
가장 최근 자산 기간의 과거 환율을 사용. 포트폴리오 시가(현재 보유 자산)는 실시간 환율을 그대로 사용. 두 개념은 구분됩니다.

캐시 미스와 폴백

어떤 날짜가 캐시에 없으면(주말, 공휴일, 또는 마지막 sync 이후 새로 추가된 항목의 날짜), firma는 7일 lookback 윈도우 내에서 가장 가까운 직전 환율로 폴백합니다. 그것마저 없으면 open.er-api.com의 실시간 환율을 최후의 수단으로 사용합니다. 오래된 데이터를 추가한 뒤 firma sync fx를 실행하면 캐시가 전체 이력을 포함하도록 보장됩니다.
MIT License