ForHosting KIT · Strumenti per sviluppatori

Calcolatore del costo medio crypto

Questo calcolatore del costo medio crypto riunisce acquisti effettuati a prezzi e con quantità diverse in un unico costo medio ponderato per moneta.

● BetaGratis · nel tuo browser

Esegui gratis nel browser Vedi l'API

Usalo da WebAPIEmailTelegramApp presto

Inserisca ogni acquisizione indicando quantità e prezzo unitario: otterrà la quantità totale detenuta, il costo totale di acquisto e il costo medio. Lo strumento è utile per monitorare un portafoglio, stimare il punto di pareggio e verificare i dati prima di preparare i registri. Il calcolo è deterministico e attribuisce agli acquisti più grandi il peso corretto, evitando la media semplice e fuorviante dei prezzi quotati.

Inserisca ogni acquisto come lotto separato

Crei una riga per ogni acquisto di criptovaluta da includere nel calcolo. Ogni riga richiede la quantità di monete acquistate e il prezzo pagato per una moneta. Sono ammesse quantità frazionarie: un acquisto di 0.015 monete è valido purché il numero sia maggiore di zero. Anche i prezzi devono essere numeri positivi e finiti. Utilizzi la stessa valuta di quotazione in tutte le righe: se il primo prezzo è espresso in dollari statunitensi, anche tutti i successivi devono esserlo. Il calcolatore non converte valute e non recupera tassi di cambio, ma elabora esattamente i numeri forniti. Non unisca gli acquisti calcolandone prima il prezzo medio, perché ciò eliminerebbe l'effetto delle diverse quantità. Se due operazioni hanno lo stesso prezzo, può comunque inserirle separatamente per conservare una traccia di controllo chiara. L'impostazione facoltativa dei decimali regola soltanto l'arrotondamento visualizzato e non riduce intenzionalmente la precisione del calcolo ponderato intermedio. In una richiesta si possono elaborare fino a 10,000 acquisti.

Comprenda il calcolo della media ponderata

Per ogni acquisto, il calcolatore moltiplica la quantità per il prezzo unitario e determina così il costo di acquisizione del lotto. Successivamente somma separatamente i costi di tutti i lotti e tutte le quantità. Il costo medio equivale al costo totale di acquisizione diviso per la quantità totale. Si tratta quindi di una media ponderata: un acquisto di due monete incide sul risultato il doppio rispetto a un acquisto di una sola moneta. Una semplice media aritmetica dei prezzi assegnerebbe la stessa importanza a ogni riga e potrebbe risultare molto imprecisa quando i lotti hanno dimensioni diverse. Il costo totale restituito può essere riconciliato direttamente con i dati inseriti, mentre la quantità totale mostra il denominatore impiegato. Una somma compensata limita i normali errori in virgola mobile quando valori molto piccoli e molto grandi compaiono insieme. I risultati vengono arrotondati al numero richiesto di decimali, da zero a dodici. Il conteggio degli acquisti consente inoltre di verificare che tutte le righe previste siano state incluse.

Usi il risultato entro i limiti appropriati

Il costo medio è un dato pratico per il portafoglio, ma non costituisce automaticamente un valore pronto per la dichiarazione fiscale. Questo calcolatore riguarda soltanto le acquisizioni e presume che il costo di un lotto sia pari alla quantità moltiplicata per il prezzo. Non aggiunge commissioni della piattaforma, costi di rete, rimborsi, trasferimenti, cessioni, proventi da mining, ricompense di staking, donazioni, fork o conversioni valutarie. Se nel Suo caso una commissione rientra legalmente nel costo di acquisizione, la incorpori in un prezzo unitario rettificato prima di inserire la riga e conservi la documentazione che spiega la rettifica. Alla vendita delle monete, l'autorità fiscale può richiedere identificazione specifica, FIFO, LIFO o un altro criterio previsto dalla giurisdizione. Tali metodi possono produrre plusvalenze realizzate diverse anche conoscendo la media attuale. Utilizzi il risultato per pianificazione, monitoraggio, riconciliazione o come riferimento per il pareggio, quindi consulti le regole applicabili nel Suo territorio. Una richiesta automatizzata tramite API costa $0.002.

Casi d'uso

Monitorare il prezzo di ingresso del portafoglio

Riunisca gli acquisti periodici in un prezzo medio ponderato per moneta da mostrare chiaramente nel pannello del portafoglio.

Stimare il punto di pareggio

Confronti il costo medio di acquisizione con un prezzo di mercato prima di considerare commissioni, imposte o regole di cessione.

Riconciliare i registri di una piattaforma

Verifichi che quantità e costi esportati degli acquisti producano i totali aggregati attesi.

Domande frequenti

Quale formula utilizza il calcolatore?

Divide la somma dei prodotti tra quantità e prezzo di ogni acquisto per la somma di tutte le quantità acquistate.

Perché non calcolare direttamente la media dei prezzi?

Una media diretta assegna la stessa influenza a un acquisto piccolo e a uno grande. La ponderazione riflette quante monete sono state comprate a ciascun prezzo.

Le quantità possono contenere frazioni?

Sì. Sono ammesse quantità frazionarie positive, essenziali per gli asset normalmente acquistati in piccole frazioni di moneta.

Il risultato include commissioni di scambio o di rete?

No. Inserisca un prezzo rettificato se deve includerle e conservi i documenti che spiegano come lo ha calcolato.

Questo valore equivale al costo a fini fiscali?

Non necessariamente. Il trattamento fiscale dipende dalla giurisdizione, dallo storico delle operazioni e dal metodo di cessione consentito. Il calcolatore produce soltanto una media ponderata delle acquisizioni.

Quanto costa un calcolo tramite API?

Ogni richiesta API costa $0.002. Il calcolo nel browser è disponibile senza effettuare una richiesta API.

Per sviluppatori — accesso via API

Tutto quello che vedi in questa pagina è disponibile anche via API. Questa sezione è per i team che vogliono integrarlo nei propri sistemi; chi non ne ha bisogno può semplicemente usare lo strumento qui sopra.

Endpoint

POSThttps://api.kit.forhosting.com/finance/crypto-cost-basis

Autenticazione con Bearer token: un POST mette in coda l'attività e il risultato arriva via webhook o link firmato.

Chiamala dal tuo stack

curl -X POST https://api.kit.forhosting.com/finance/crypto-cost-basis \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"purchases":[{"quantity":0.5,"price":30000},{"quantity":0.25,"price":36000},{"quantity":1.25,"price":28000}]}'

const res = await fetch("https://api.kit.forhosting.com/finance/crypto-cost-basis", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "purchases": [
      {
        "quantity": 0.5,
        "price": 30000
      },
      {
        "quantity": 0.25,
        "price": 36000
      },
      {
        "quantity": 1.25,
        "price": 28000
      }
    ]
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/finance/crypto-cost-basis",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "purchases": [
        {
            "quantity": 0.5,
            "price": 30000
        },
        {
            "quantity": 0.25,
            "price": 36000
        },
        {
            "quantity": 1.25,
            "price": 28000
        }
    ]
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/finance/crypto-cost-basis", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"purchases":[{"quantity":0.5,"price":30000},{"quantity":0.25,"price":36000},{"quantity":1.25,"price":28000}]}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"purchases":[{"quantity":0.5,"price":30000},{"quantity":0.25,"price":36000},{"quantity":1.25,"price":28000}]}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/finance/crypto-cost-basis", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

Esempio di richiesta

{
  "purchases": [
    {
      "quantity": 0.5,
      "price": 30000
    },
    {
      "quantity": 0.25,
      "price": 36000
    },
    {
      "quantity": 1.25,
      "price": 28000
    }
  ]
}

Esempio di risposta

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "finance.crypto_cost_basis",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

L'API è asincrona: ricevi subito un task_id e puoi fare polling fino a 1 richiesta al secondo.

Prezzi

per richiesta$0.002

Prezzo pubblicato, senza token né crediti. Se l'attività fallisce, non paghi.

Errori

HTTP	Codice	Significato
`401`	`unauthorized`	Chiave API mancante o non valida: controlla l'header Authorization.
`402`	`insufficient_balance`	Credito esaurito: ricarica per continuare a eseguire attività.
`404`	`unknown_type`	Tipo di attività sconosciuto: controlla il campo type della richiesta.
`429`	`rate_limited`	Troppe richieste in poco tempo: rallenta e riprova tra qualche secondo.

Leggi la documentazione completa del KIT →