실시간 가격을 사용하여 호스팅된 Beancount.io 원장에 자동으로 새로고침되는 평가 가격을 추가하세요. 관리형 피드는 지원되는 암호화폐, 주식, 펀드, 외화에 대해 날짜가 지정된 price 지시자를 제공합니다. 매수, 매도, 이체는 평소처럼 계속 기록하면 됩니다.
가격 소스 선택하기
- 가격 소스 선택기를 엽니다.
- 자산을 평가할 통화를 선택합니다.
- 단축 목록에서 자산을 선택하거나
BTC또는AAPL과 같이 심볼로 검색합니다. 원장 일부를 붙여넣어 자산을 찾을 수도 있으며, 붙여넣은 내용은 브라우저에만 남습니다. - 각 자산 심볼이 원장의 상품(commodity)과 일치하는지 확인합니다. 선택기는 나열된 쌍에 대한 include를 생성합니다. 나열되지 않은 쌍은 온디맨드 파생을 지원할 수 있지만, 지원이 확인될 때까지 선택기에서 제외됩니다.
- 생성된 include를 복사합니다. 호스팅된 원장을 사용하려면 Beancount.io에 로그인하고 인증이 필요한 피드를 확인하세요.
이 페이지의 언어가 아니라 장부의 평가 통화를 선택하세요. 견적 통화를 선택해도 상품 이름이 바뀌거나 거래가 변경되지 않습니다.
호스팅된 원장에 피드 포함하기
생성된 줄을 main.bean 또는 원장이 이미 포함하는 다른 파일에 붙여넣습니다. 각 줄은 하나의 가격 소스를 나타냅니다. 예를 들어, 미국 달러로 표시된 비트코인의 호스팅 include는 아래에서 주석 처리되어 있어 이 예제가 업스트림 Beancount에서도 안전하게 로드될 수 있습니다:
; Hosted Beancount.io ledger: remove the leading semicolon to enable this feed.
; include "https://beancount.io/prices/BTC-USD"호스팅된 원장에 줄을 추가할 때는 앞의 ;를 제거하세요. URL include는 Beancount.io의 확장 기능입니다. 일반적인 로컬 include는 다중 파일 지원에 설명된 대로 여전히 파일 이름을 사용합니다.
평소처럼 원장을 엽니다. 로더가 관리형 피드를 읽기 전용 가격 항목으로 해석합니다. 5분 새로고침 주기가 지난 후 원장을 로드할 때 새 데이터를 확인합니다. 가격을 새로고침해도 소스 파일이 다시 작성되거나 원장 커밋이 생성되지 않습니다. 관리형 가격 항목은 원장의 항목 제한에 포함되지 않습니다.
가격과 평가 읽기
피드에는 날짜가 지정된 가격이 포함되며 price-source, price-kind, observed-at, provisional 메타데이터가 포함될 수 있습니다. 시세를 판단할 때 관측 시간과 가격 종류를 확인하세요. 로더의 새로고침 시간은 제공자의 관측 시간이 아닙니다.
이는 자동으로 새로고침되는 평가 가격이며, 실시간 거래 시세가 아닙니다. 보고서는 평가 날짜 당일 또는 그 이전의 해당 상품 쌍에 대한 가격이 필요합니다. 오늘의 가격으로 이전 보고서의 공백을 채울 수 없습니다.
가격은 가격 지시자를 사용하는 도구와 보고서에서 시장 평가를 가능하게 합니다. 원가를 표시하는 계정 보기는 여전히 원가를 표시하며, 피드를 연결해도 해당 보기가 시장 가치로 전환되지 않습니다. 원가와 시장 평가의 차이는 쿼리 가이드를 참조하세요.
가격 새로고침은 원장에 기록된 수량, 매입 원가, 현금 흐름, 수수료, 실현 이익을 변경하지 않습니다. 또한 거래의 @ 가격이나 {cost}를 채우지도 않습니다. 이는 거래 자체에서 기록하세요. 부동산 감정, 가상의 예시 상품, 지원되는 피드가 없는 자산에는 여전히 직접 날짜가 지정된 가격이 필요합니다.
관리형 가격 재정의하기
특정 평가가 필요할 때 편집 가능한 원장 파일에 직접 날짜가 지정된 price 지시자를 작성하세요. 동일한 날짜와 상품 쌍에 대해서는 관리형 피드보다 직접 작성한 가격이 우선합니다. 이는 역방향 쌍에도 적용되며 include 순서에 의존하지 않습니다.
수동 가격은 영구적인 잠금이 아닙니다. 이후 날짜의 관리형 시세는 이후 평가에 여전히 사용될 수 있습니다. 관리형 항목 자체는 읽기 전용입니다. 직접 작성한 가격 지시자를 편집하거나, include를 제거하여 해당 피드 사용을 중단하세요.
로컬 도구와 함께 가격 사용하기
| 원장을 로드하는 위치 | 가격을 제공하는 방법 |
|---|---|
| 호스팅된 Beancount.io | 선택기에서 생성된 관리형 URL include를 사용합니다. |
호환되는 bea CLI 버전 | URL 해석 및 로컬 가격 파일 내보내기에 대한 CLI의 관리형 가격 지침을 따릅니다. |
| 업스트림 Beancount 또는 Fava | 로컬 가격 파일을 로드합니다. 이 도구들은 URL include를 직접 가져오지 않습니다. |
버전별 CLI 동작은 bea 관리형 가격 가이드를 참조하세요. 호환되는 버전은 bea price status, bea price refresh, bea price export --output audit을 제공합니다. 캐시 전용 읽기에는 bea --offline balance를 사용하거나, 오래되거나 사용할 수 없는 소스를 거부하려면 bea --strict-prices check를 사용하세요. 자세한 내용과 대체 로컬 Beanprice 워크플로는 CLI 레퍼런스를 참조하세요.
CLI는 자격 증명 없이 가져오며 리다이렉트를 거부합니다. 호스팅된 로그인으로 리다이렉트되는 피드는 브라우저에서 로그인했더라도 새 CLI 가져오기에서 사용할 수 없습니다. 접근 가능한 지원 피드나 로컬 날짜 지정 가격을 대신 사용하세요. 구버전 CLI는 모든 URL include를 일치하지 않는 파일 글롭으로 취급할 수 있습니다.
재현 가능한 오프라인 보고서가 필요할 때는 로컬 날짜 지정 가격 파일을 보관하세요. 원장 커밋만으로는 과거 평가에 사용된 관리형 피드 리비전을 담지 못합니다. 원장과 보고서와 함께 사용된 가격을 보존하세요.
가격 서비스와의 통합에 대해서는 Prices API 레퍼런스를 참조하세요. 해당 엔드포인트는 호스팅된 원장에 include를 추가하는 것과는 별개입니다.
누락되거나 예상치 못한 평가 문제 해결
| 증상 | 확인할 사항 |
|---|---|
| 카탈로그가 로드되지 않음 | 선택기를 다시 시도하세요. 지원되지 않는 심볼로 include URL을 추측하지 마세요. |
| 선택한 자산이 복사된 include에서 제외됨 | 선택한 견적 통화에서 해당 자산의 지원 여부를 확인하고 원장의 심볼과 일치시키세요. |
| 피드를 열면 로그인으로 리다이렉트됨 | 호스팅된 워크플로에서 확인하려면 로그인하세요. CLI는 해당 세션을 보내지 않고 리다이렉트를 거부합니다. |
| 가격이 오래된 것처럼 보임 | 관측 시간을 보고서 날짜와 비교하세요. 새로고침 실패 시 이전에 검증된 캐시된 피드가 유지될 수 있으며, 캐시된 데이터는 오래되었을 수 있습니다. |
| 사용 가능한 가격이 없음 | 검증된 캐시 가격이 없으면 장부는 여전히 로드될 수 있지만, 보유 자산에 시장 평가가 없을 수 있습니다. 필요하면 적절한 수동 가격을 제공하세요. |
| 수동 가격이 무시된 것처럼 보임 | 정확한 날짜와 쌍을 확인하세요. 이후의 관리형 시세는 이후 보고서에 적용될 수 있습니다. |
| 로컬 로더가 일치하지 않는 include를 보고함 | 호환되는 bea 버전을 사용하거나 URL include를 로컬 가격 파일로 교체하세요. |
| 계정 가치가 변경되지 않음 | 해당 보기가 원가를 표시하는지, 보고서에 평가 날짜를 포함하는 가격이 있는지 확인하세요. |
수동 지시자는 가격 구문 레퍼런스를, 정적이고 재현 가능한 투자 기록은 실제 원장 예제를 참조하세요.