Configura preus automàtics a Beancount

Utilitza Live Prices per afegir preus de valoració actualitzats automàticament a un llibre Beancount.io allotjat. Les fonts gestionades proporcionen directives price amb data per a criptomonedes, accions, fons i divises admeses. Tu segueixes registrant compres, vendes i transferències com de costum.

Tria les teves fonts de preus​

1. Obre el selector de fonts de preus.
2. Tria la divisa en què vols valorar els teus actius.
3. Selecciona els teus actius a les dreceres o cerca per símbol, com ara BTC o AAPL. També pots enganxar un fragment del llibre per trobar-ne els actius; el fragment es queda al teu navegador.
4. Comprova que cada símbol d'actiu coincideixi amb la mercaderia del teu llibre. El selector genera includes per als parells llistats. Un parell no llistat pot admetre derivació sota demanda, però el selector l'omet fins que es confirmi la compatibilitat.
5. Copia els includes generats. Inicia sessió a Beancount.io per utilitzar el teu llibre allotjat i inspeccionar fonts que requereixin autenticació.

Tria la divisa de valoració per als teus llibres, no per a l'idioma d'aquesta pàgina. Seleccionar una divisa de cotització no canvia el nom de les mercaderies ni altera les teves transaccions.

Inclou les fonts al teu llibre allotjat​

Enganxa les línies generades a main.bean, o a un altre fitxer que el teu llibre ja inclogui. Cada línia identifica una font de preus. Per exemple, l'include allotjat per a Bitcoin en dòlars nord-americans es mostra comentat a continuació perquè aquest exemple segueixi sent segur de carregar amb Beancount upstream:

; Hosted Beancount.io ledger: remove the leading semicolon to enable this feed.
; include "https://beancount.io/prices/BTC-USD"

Elimina el ; inicial quan afegeixis la línia al teu llibre allotjat. Els includes d'URL són una extensió de Beancount.io. Els includes locals ordinaris encara accepten noms de fitxer, tal com es descriu a suport multifitxer.

Obre el teu llibre com de costum. El seu carregador resol les fonts gestionades en entrades de preus de només lectura. Comprova si hi ha dades noves quan el llibre es carrega després de la finestra d'actualització de cinc minuts. Actualitzar els preus no reescriu els teus fitxers font ni crea commits al llibre. Les entrades de preus gestionades no compten per al límit d'entrades del teu llibre.

Llegeix preus i valoracions​

Una font conté preus amb data i pot incloure metadades price-source, price-kind, observed-at i provisional. Inspecciona el moment d'observació i el tipus de preu quan jutgis una cotització. El moment d'actualització del carregador no és el moment d'observació del proveïdor.

Aquests són preus de valoració actualitzats automàticament, no cotitzacions de trading en temps real. Un informe necessita un preu per al parell de mercaderies rellevant en la seva data de valoració o abans. El preu d'avui no pot omplir un buit en un informe anterior.

Els preus fan possible la valoració de mercat en eines i informes que utilitzen directives de preu. Una vista de compte que mostra el cost encara mostrarà el cost; connectar una font no canvia aquesta vista a valor de mercat. Consulta la guia de consultes per a la distinció entre cost i valoració de mercat.

Una actualització de preus no canvia les quantitats, els costos de compra, els fluxos d'efectiu, les comissions ni els guanys realitzats registrats al teu llibre. Tampoc no omple el preu @ ni el {cost} d'una transacció. Registra'ls a partir de la mateixa transacció. Les taxacions de propietats, les mercaderies d'exemple fictícies i els actius sense una font admesa encara necessiten els teus propis preus amb data.

Anul·la un preu gestionat​

Escriu la teva pròpia directiva price amb data en un fitxer de llibre editable quan necessitis una valoració concreta. Per a la mateixa data i parell de mercaderies, el teu preu té prioritat sobre la font gestionada. Això també s'aplica al parell recíproc i no depèn de l'ordre dels includes.

Un preu manual no és un bloqueig permanent: una cotització gestionada en una data posterior encara es pot utilitzar per a una valoració posterior. Les entrades gestionades mateixes són de només lectura. Edita la teva pròpia directiva de preu, o elimina l'include per deixar d'utilitzar aquesta font.

Utilitza preus amb eines locals​

Per al comportament específic de cada versió de la CLI, utilitza la guia de preus gestionats de bea. Les versions compatibles ofereixen bea price status, bea price refresh i bea price export --output audit. Utilitza bea --offline balance per a lectures només de la memòria cau o bea --strict-prices check per rebutjar fonts obsoletes o no disponibles. Consulta la referència de la CLI per als detalls i el flux de treball alternatiu amb Beanprice local.

La CLI obté dades sense credencials i refuseix les redireccions. Una font que redirigeix a l'inici de sessió allotjat no està disponible per a una obtenció nova de la CLI, encara que tinguis la sessió iniciada al navegador. Utilitza en el seu lloc una font admesa accessible o preus locals amb data. Les versions més antigues de la CLI poden tractar qualsevol include d'URL com un patró glob de fitxer no coincident.

Conserva els fitxers de preus locals amb data quan necessitis un informe offline reproduïble. Un commit del llibre per si sol no captura la revisió de la font gestionada utilitzada en una valoració passada. Preserva els preus utilitzats juntament amb el llibre i l'informe.

Per a integracions amb el servei de preus, consulta la referència de l'API de preus. Els seus endpoints són independents d'afegir un include a un llibre allotjat.

Soluciona una valoració absent o inesperada​

Consulta la referència de sintaxi de preus per a directives manuals i els exemples de llibres en funcionament per a registres d'inversió estàtics i reproduïbles.