WhaleBooks formát CSV

Máte data svých krypto transakcí v jiném formátu, než WhaleBooks běžně podporuje?

Nativní formát WhaleBooks umožňuje importovat transakce ze strukturovaného CSV souboru bez ohledu na jejich původ. Import probíhá v prostředí Data Manager, kde lze data před zpracováním upravit a validovat.

Formát WhaleBooks v3.3.1 WB-v331-sample_final.csv

image-20260119-112015.png

Formát souboru

Importovaný soubor musí být ve formátu CSV (Comma-Separated Values).
Hodnoty buněk jsou odděleny znakem středník ; a desetinným oddělovačem je čárka , .
Všechny vstupní číselné hodnoty musí být větší než 0.
Pokud je jakákoli číselná hodnota menší nebo rovna 0, je celá transakce při importu ignorována a zaznamenána do error logu.
Maximální počet celých číslic je 15 a maximální počet desetinných míst je 15.

Popis sloupců

UID – uživatelské ID transakce
DATE – datum a čas vytvoření
SYMBOL – měnový pár (BASE – podkladová měna / QUOTE – kotace)
ACTION – typ transakce

  • BUY (nákup), SELL (prodej), FEE (poplatek), REBATE (sleva)

  • DEPOSIT (vklad), WITHDRAWAL (výběr), INCOMING PAYMENT (příchozí platba), OUTGOING PAYMENT (odchozí platba)

  • STAKE (uzamčení), UNSTAKE (odemčení), STAKE REWARD (stake odměna)

  • REWARD (odměna), AIRDROP (odměna), EARN (odměna), FORK (větvení)

QUANTITY – množství base
UNIT_PRICE – jednotková cena base

VOLUME_QUOTE – množství kotace, volitelné – pokud je vyplněno, UNIT_PRICE se ignoruje
FEE – poplatek
FEE_CURRENCY – měna poplatku
ADDRESS_FROM – adresa odesílatele
ADDRESS_TO – adresa příjemce
NOTE – poznámka transakce
LABELS – štítky transakce, oddělovač štítků je znak : (bez mezer)
PARTNER – název protistrany
REFERENCE – externí identifikace transakce (např. variabilní symbol, reference platby)

Platby (INCOMING / OUTGOING PAYMENT)

Transakce typu INCOMING PAYMENT a OUTGOING PAYMENT slouží k evidenci krypto plateb mezi uživatelem a jinou protistranou.

Jde o ekonomický pohyb kryptoměny, který obvykle vzniká konverzí technických transakcí (např. DEPOSIT nebo WITHDRAWAL), nikoliv o nákup nebo prodej.

Platby se evidují vždy v kryptoměně (BASE). FIAT měna slouží pouze k ocenění (QUOTE).

Ocenění platby se při importu určuje podle vyplněných polí:

  • Pouze QUANTITY
    Platba je oceněna do výchozí FIAT měny (nastavení dle daňových pravidel) podle denního uzavřeného kurzu.

  • QUANTITY + UNIT_PRICE
    Platba je oceněna jednotkovou cenou; měna ocenění vychází z QUOTE uvedené v SYMBOL (např. BTC/CZK, BTC/EUR).

  • QUANTITY + VOLUME_QUOTE
    Platba je oceněna celkovou hodnotou. Jednotková cena se dopočítá automaticky jako VOLUME_QUOTE / QUANTITY.

Pole REFERENCE slouží k uložení externí identifikace platby (např. variabilní symbol, reference platby, poznámka protistrany). Podporuje kombinaci velkých a malých písmen nebo jiných symbolů.

Podporované formáty sloupce DATE

DD.MM.YYYY HH:MM:SS
DD/MM/YYYY HH:MM:SS
DD-MM-YYYY HH:MM:SS
YYYY.MM.DD HH:MM:SS
YYYY-MM-DD HH:MM:SS
YYYY/MM/DD HH:MM:SS

Zápis podporuje jedno- i dvouciferné hodnoty dne, měsíce i času.
Čas lze uvést bez sekund nebo zcela vynechat.