KryptoSkatt
Svensk kryptoskattekalkylator — beräknar kapitalvinster och -förluster enligt genomsnittsmetoden (GAV) och genererar underlag för K4- och T2-blanketterna.
Ansvarsfriskrivning: KryptoSkatt är ett hjälpverktyg. Det ersätter inte professionell skatterådgivning. Kontrollera alltid dina uppgifter mot Skatteverkets aktuella regler innan du lämnar in din deklaration. Appen har användarvillkor (/villkor), integritetspolicy (/integritet) och en metodbeskrivning (/om-berakningen). Texterna bör granskas av en jurist innan en publik instans lanseras.
Dokumentation
Funktioner
| Område | Vad som stöds |
|---|
| Importer | Coinbase, Coinbase Advanced Trade, Crypto.com, MEXC, Binance, KuCoin, Kraken, Bybit, Bitstamp, OKX, Gate.io, Ledger Live, manuell swap-CSV |
| On-chain-hämtning | Utan nyckel: Bitcoin inkl. xpub (Blockstream), Ethereum/Base/Arbitrum/Polygon (Blockscout), XRP, Kadena. Med gratisnyckel: BNB (Etherscan), Solana (Helius/Solscan), TRON, VeChain, Peaq/Substrate. Anpassade Blockscout-/Etherscan-kedjor |
| Beräkning | GAV (genomsnittsmetoden) med gemensam pool över alla plånböcker, kostnadsneutrala flyttar mellan egna plånböcker, 70 %-regeln för förluster (K4 avsnitt D), avduplicering, transfermatchning, prisberikning (eget pris → swap-implicit → CoinGecko → Binance/Kraken → CoinAPI, till SEK via Riksbanken) |
| Rapporter | K4-underlag (CSV/JSON/HTML), SRU-export för Skatteverket (avsnitt D), T2-inkomstrapport, år-till-år GAV-överföring, revisionsunderlag, GAV-historik, nettopositoner, skrivskyddad delningslänk till revisor, datakvalitetsflaggor |
| Gränssnitt | Webb-UI (FastAPI + Jinja2, svenska/engelska) · REST API (/api/v1/) · CLI |
| Integritet & säkerhet | Anonyma konton (inget namn, ingen e-post, inget lösenord), bara nödvändiga cookies, inga tredjepartsskript eller externa typsnitt, hashade sessionstokens, krypterade API-nycklar, SSRF-skydd, begränsning av inloggningsförsök per IP och globalt, multi-tenant-isolation, GDPR-export och radering, automatisk radering av inaktiva konton |
Snabbstart
Lokalt (egen dator)
git clone https://github.com/bambapappa/kryptoskatt.git
cd kryptoskatt
cp .env.example .env # sätt COOKIE_SECURE=false för http://localhost
docker compose up -d --build
# öppna http://localhost:8000
Migreringar och rensning av inaktiva konton körs automatiskt vid start. Inga API-nycklar behövs.
Publik sida (Linuxserver med egen domän)
cp .env.example .env # sätt DOMAIN, POSTGRES_PASSWORD/DATABASE_URL, SECRET_KEY,
# CORS_ORIGINS, OPERATOR_NAME, OPERATOR_CONTACT
docker compose -f docker-compose.yml -f docker-compose.prod.yml up -d --build
docker-compose.prod.yml lägger Caddy framför appen (automatisk HTTPS via Let's Encrypt). Appen och databasen nås då bara på ett internt nät. Uppdatera med bash deploy.sh (tar säkerhetskopia först). Hela genomgången, med brandvägg, säkerhetskopior, övervakning, GDPR och checklista före lansering, finns i docs/drift.md.
Installation för utveckling
Krav: Python 3.12+, PostgreSQL 14+ (Docker-imagen kör Python 3.13 och composen Postgres 18)
Uppgradering till Postgres 18: en ny major-version startar inte på en gammal datakatalog. Vill du inte migrera databasen nu — sätt POSTGRES_IMAGE=postgres:16-alpine (din nuvarande major) i .env så rörs inte volymen; app-migrationerna fungerar ändå. Vill du faktiskt gå till 18: ta en dump först (docker compose exec db pg_dump -U kryptoskatt kryptoskatt > backup.sql), ta bort pgdata-volymen, starta på 18 och återställ.
# Skapa virtuell miljö och installera
python -m venv .venv
source .venv/bin/activate
pip install -e ".[dev]"
# Miljöfil
cp .env.example .env
# Redigera .env med databasanslutning
# Kör migrationer
alembic upgrade head
# Starta webb
kryptoskatt serve --host 0.0.0.0 --port 8000
Miljövariabler
Alla inställningar sätts via .env eller miljövariabler (se .env.example för komplett lista):
# Obligatorisk
DATABASE_URL=postgresql://user:pass@localhost:5432/kryptoskatt
# API-nycklar (alla valfria, gratisnivåer räcker; användare kan även ange egna)
ETHERSCAN_API_KEY= # BNB (+ ETH/Polygon/Base/Arbitrum, annars Blockscout utan nyckel)
HELIUS_API_KEY= # Solana (rekommenderas)
SOLSCAN_API_KEY= # Solana (reserv)
COINGECKO_API_KEY= # Historiska priser (demo-nyckel ger högre gränser)
# Säkerhet
COOKIE_SECURE=true # false vid lokal HTTP-utveckling
CORS_ORIGINS=["https://yourdomain.com"]
SECRET_KEY= # krypterar användarnas API-nycklar, krävs för att spara dem
FORWARDED_ALLOW_IPS=127.0.0.1 # reverse proxyns IP
# Juridik & integritet
OPERATOR_NAME= # personuppgiftsansvarig, visas i /integritet och /villkor
OPERATOR_CONTACT= # kontakt-e-post
INACTIVE_ACCOUNT_MONTHS=24 # radera konton som inte använts så här länge
ACCESS_LOG=false # HTTP-åtkomstloggar innehåller IP-adresser och delningstoken
# Övrigt
LOG_LEVEL=INFO
DEBUG_MODE=false
PRICE_HISTORY_DIR=PriceHistory
Kommandon (CLI)
kryptoskatt --help
# Importera CSV-fil
kryptoskatt import --file export.csv
kryptoskatt import --file export.csv --platform coinbase
# Hämta on-chain-transaktioner
kryptoskatt fetch --all # Alla registrerade plånböcker
kryptoskatt fetch --address 0x... --chain ETHEREUM
# Beräkna skatt för ett år
kryptoskatt calculate 2024
# Generera rapporter
kryptoskatt report 2024 # K4 till stdout
kryptoskatt report 2024 --format csv --output-dir ./rapporter
# SRU-filer för Skatteverkets e-inlämning (INFO.SRU + BLANKETTER.SRU)
kryptoskatt report 2024 --format sru --personnummer ÅÅÅÅMMDDNNNN --namn "För Efternamn"
# År-till-år GAV-överföring (ingående/utgående balans per mynt)
kryptoskatt report 2024 --format carryover
# Starta webbserver
kryptoskatt serve --host 0.0.0.0 --port 8000
# Radera konton som inte använts på INACTIVE_ACCOUNT_MONTHS (körs även vid container-start;
# schemalägg gärna dagligen via cron)
kryptoskatt purge-inactive
# Kontrollera datakvalitet
kryptoskatt issues 2024
# Hantera plånböcker
kryptoskatt wallet add --address 0x... --chain ETHEREUM --label "Metamask"
kryptoskatt wallet list
kryptoskatt wallet remove --address 0x...
kryptoskatt wallet add-xpub zpub6r... # härled alla Bitcoin-adresser från xpub/ypub/zpub
REST API
Bas-URL: http://localhost:8000/api/v1
Autentisering via sessionscookie (kryptoskatt_session).
# Hälsokontroll (ingen auth)
curl http://localhost:8000/api/v1/health
# Skapa konto
curl -X POST http://localhost:8000/api/v1/auth/account
# Logga in (sparar cookie)
curl -X POST http://localhost:8000/api/v1/auth/session \
-H "Content-Type: application/json" \
-d '{"account_id": "ord-ord-ord-NNNN"}' \
-c cookies.txt
Komplett API-referens: docs/api.md
Dataflöde
CSV/TSV / Blockchain-API
│
[Parsers / Chain Adapters]
│
[Transaction DB]
│
┌────┼────┐
[Dedup] [Match] [Priser]
│
[GAV-motor]
│
[Disposals + GAV Ledger]
│
[K4] [T2] [Audit]
Se docs/arkitektur.md för fullständig beskrivning.
Tester
pytest # Alla 600+ tester
pytest tests/test_gav.py # Enskild fil
pytest --cov=kryptoskatt # Med täckning
ruff check src/ # Lint
mypy # Typkontroll (kärnan)
Docker
docker compose up -d
docker compose exec app kryptoskatt calculate 2024
# Importera fil i container
docker compose cp export.csv app:/tmp/
docker compose exec app kryptoskatt import --file /tmp/export.csv
Plattformar
Börser (CSV-import)
| Plattform | Platform-ID | Kommentar |
|---|
| Bitstamp | bitstamp | Transaktionsexport (v1 och v2) |
| Coinbase | coinbase | Standardexport |
| Coinbase Advanced Trade | coinbase_advanced | Fill statements |
| Crypto.com | crypto_com | |
| MEXC | mexc | Inkl. handelsavgifter |
| Binance | binance | Handelshistorik |
| KuCoin | kucoin | |
| Gate.io | gateio | Kontoutdrag ("my bill") |
| Kraken | kraken | Ledger-export |
| Bybit | bybit | |
| Ledger Live | ledger | NFT-filtrering |
| OKX | okx | Handels- och funding-utdrag |
| Manuell swap | manual_swap | Eget CSV-format |
| NFT-liggare | nft | Eget CSV-format för NFT-köp/-försäljning (se nedan) |
NFT-liggare (nft)
NFT:er kan inte prissättas automatiskt, så köp- och säljbelopp anges i SEK.
Varje NFT blir en unik tillgång (NFT:<samling>#<token-id>) som går genom
genomsnittsmetoden och hamnar på K4 (avsnitt D) precis som annan krypto.
date,action,collection,token_id,chain,amount_sek,fee_sek,tx_hash,notes
2024-03-01,BUY,Bored Apes,1234,ETHEREUM,50000,500,0xabc,mint
2024-09-15,SELL,Bored Apes,1234,ETHEREUM,120000,1000,0xdef,
action är BUY/MINT, SELL, TRANSFER_IN eller TRANSFER_OUT.
amount_sek är NFT:ns totala pris; fee_sek läggs till omkostnaden vid köp
och dras från försäljningspriset vid sälj.
On-chain (automatisk hämtning)
| Kedja | API-nyckel behövs |
|---|
| Ethereum / Polygon / Base / Arbitrum | — (Blockscout). Etherscan används om ETHERSCAN_API_KEY finns |
| BNB Smart Chain | ETHERSCAN_API_KEY (gratis) |
| Solana | HELIUS_API_KEY (gratis) eller SOLSCAN_API_KEY |
| Bitcoin | — (Blockstream) |
| TRON | TRONSCAN_API_KEY |
| VeChain | VECHAINSTATS_API_KEY |
| Peaq / Substrate | SUBSCAN_API_KEY |
| XRP | — (XRPL.org) |
| Kadena | — (Chainweb) |
| Anpassad kedja | Konfigureras via inställningar |
Bidra
Bidrag välkomnas! Se CONTRIBUTING.md för hur du sätter upp dev-miljön, lägger till parsers/kedjor och skapar pull requests.
Säkerhetsproblem rapporteras privat via GitHub Security Advisories — se SECURITY.md.
Licens
Apache 2.0 — fri att använda, modifiera och distribuera, med uttryckligt patentskydd. Se även NOTICE.
