Usa Prezzi Live per aggiungere prezzi di valutazione aggiornati automaticamente a un ledger Beancount.io ospitato. I feed gestiti forniscono direttive price datate per criptovalute, azioni, fondi e valute estere supportate. Continui a registrare acquisti, vendite e trasferimenti come al solito.
Scegli le tue fonti di prezzo
- Apri il selettore della fonte di prezzo.
- Scegli la valuta in cui desideri valutare i tuoi asset.
- Seleziona i tuoi asset dalle scorciatoie o cerca per simbolo, come
BTCoAAPL. Puoi anche incollare un estratto del ledger per trovarne gli asset; l'estratto rimane nel tuo browser. - Verifica che ogni simbolo di asset corrisponda alla commodity nel tuo ledger. Il selettore genera include per le coppie elencate. Una coppia non elencata può supportare la derivazione su richiesta, ma il selettore la esclude finché il supporto non è confermato.
- Copia gli include generati. Accedi a Beancount.io per usare il tuo ledger ospitato e ispezionare i feed che richiedono autenticazione.
Scegli la valuta di valutazione per i tuoi libri contabili, non per la lingua di questa pagina. Selezionare una valuta di quotazione non rinomina le commodity né modifica le tue transazioni.
Includi i feed nel tuo ledger ospitato
Incolla le righe generate in main.bean, o in un altro file che il tuo ledger già include. Ogni riga identifica una fonte di prezzo. Ad esempio, l'include ospitato per Bitcoin in dollari statunitensi è mostrato commentato qui sotto, così questo esempio rimane sicuro da caricare con Beancount upstream:
; Hosted Beancount.io ledger: remove the leading semicolon to enable this feed.
; include "https://beancount.io/prices/BTC-USD"Rimuovi il ; iniziale quando aggiungi la riga al tuo ledger ospitato. Gli include URL sono un'estensione di Beancount.io. Gli include locali ordinari accettano ancora nomi di file, come descritto in supporto multi-file.
Apri il tuo ledger come al solito. Il suo loader risolve i feed gestiti in voci di prezzo in sola lettura. Verifica la presenza di nuovi dati quando il ledger viene caricato dopo la finestra di aggiornamento di cinque minuti. L'aggiornamento dei prezzi non riscrive i tuoi file sorgente né crea commit del ledger. Le voci di prezzo gestite non contano ai fini del limite di voci del tuo ledger.
Leggi prezzi e valutazioni
Un feed contiene prezzi datati e può includere i metadati price-source, price-kind, observed-at e provisional. Ispeziona l'ora di osservazione e il tipo di prezzo quando valuti una quotazione. L'ora di aggiornamento del loader non è l'ora di osservazione del provider.
Questi sono prezzi di valutazione aggiornati automaticamente, non quotazioni di trading in streaming. Un report necessita di un prezzo per la coppia di commodity pertinente alla sua data di valutazione o precedente. Il prezzo odierno non può colmare una lacuna in un report precedente.
I prezzi rendono possibile la valutazione di mercato negli strumenti e nei report che utilizzano le direttive di prezzo. Una vista dell'account che mostra il costo continuerà a mostrare il costo; collegare un feed non cambia quella vista al valore di mercato. Vedi la guida alle query per la distinzione tra costo e valutazione di mercato.
Un aggiornamento dei prezzi non modifica quantità, costi di acquisto, flussi di cassa, commissioni o plusvalenze realizzate registrate nel tuo ledger. Non compila nemmeno il prezzo @ o il {cost} di una transazione. Registra quelli dalla transazione stessa. Le perizie immobiliari, le commodity fittizie di esempio e gli asset senza un feed supportato richiedono comunque i tuoi prezzi datati.
Sovrascrivi un prezzo gestito
Scrivi la tua direttiva price datata in un file del ledger modificabile quando hai bisogno di una particolare valutazione. Per la stessa data e coppia di commodity, il tuo prezzo ha la precedenza sul feed gestito. Questo vale anche per la coppia reciproca e non dipende dall'ordine degli include.
Un prezzo manuale non è un blocco permanente: una quotazione gestita in una data successiva può comunque essere usata per una valutazione successiva. Le voci gestite stesse sono in sola lettura. Modifica la tua direttiva di prezzo, o rimuovi l'include per smettere di usare quel feed.
Usa i prezzi con gli strumenti locali
| Dove carichi il ledger | Come fornire i prezzi |
|---|---|
| Beancount.io ospitato | Usa gli include URL gestiti dal selettore. |
Una versione compatibile della CLI bea | Segui le istruzioni sui prezzi gestiti della CLI per la risoluzione degli URL e l'esportazione dei file di prezzo locali. |
| Beancount upstream o Fava | Carica file di prezzo locali; questi strumenti non recuperano gli include URL da soli. |
Per il comportamento specifico della versione della CLI, usa la guida ai prezzi gestiti di bea. Le versioni compatibili offrono bea price status, bea price refresh e bea price export --output audit. Usa bea --offline balance per letture solo dalla cache o bea --strict-prices check per rifiutare fonti obsolete o non disponibili. Vedi il riferimento della CLI per i dettagli e il flusso di lavoro alternativo con Beanprice locale.
La CLI recupera senza credenziali e rifiuta i redirect. Un feed che reindirizza al login ospitato non è disponibile per un recupero CLI nuovo, anche se hai effettuato l'accesso tramite il browser. Usa un feed supportato raggiungibile o prezzi datati locali. Le versioni più vecchie della CLI possono trattare qualsiasi include URL come un glob di file non corrispondente.
Mantieni i file di prezzo datati locali quando hai bisogno di un report offline riproducibile. Un commit del ledger da solo non cattura la revisione del feed gestito utilizzata da una valutazione passata. Conserva i prezzi usati insieme al ledger e al report.
Per le integrazioni con il servizio dei prezzi, consulta il riferimento dell'API Prices. I suoi endpoint sono separati dall'aggiunta di un include a un ledger ospitato.
Risolvi una valutazione mancante o inattesa
| Sintomo | Cosa verificare |
|---|---|
| Il catalogo non si carica | Riprova con il selettore. Non indovinare un URL di include da un simbolo non supportato. |
| Un asset selezionato è escluso dagli include copiati | Verifica il supporto per quell'asset nella valuta di quotazione scelta e fai corrispondere il simbolo del ledger. |
| L'apertura di un feed reindirizza al login | Accedi per ispezionarlo nel flusso di lavoro ospitato. La CLI non invia quella sessione e rifiuta i redirect. |
| I prezzi sembrano vecchi | Confronta l'ora di osservazione con la data del report. Un aggiornamento fallito può mantenere un feed in cache precedentemente validato; i dati in cache possono essere obsoleti. |
| Nessun prezzo è disponibile | Senza un prezzo in cache validato, i libri contabili possono comunque essere caricati, ma la partecipazione potrebbe mancare di una valutazione di mercato. Fornisci un prezzo manuale adeguato se necessario. |
| Il tuo prezzo manuale sembra ignorato | Verifica la data e la coppia esatte. Una quotazione gestita successiva può applicarsi a un report successivo. |
| Un loader locale segnala un include non corrispondente | Usa una versione compatibile di bea o sostituisci l'include URL con un file di prezzo locale. |
| Il valore dell'account non è cambiato | Verifica se la vista mostra il costo e se il report ha prezzi che coprono la sua data di valutazione. |
Vedi il riferimento della sintassi dei prezzi per le direttive manuali e gli esempi di ledger funzionanti per registrazioni di investimenti statiche e riproducibili.