Precizia zecimală pentru calculele API

Calculele interne ale API sunt efectuate utilizând atâtea zecimale câte sunt necesare, în funcție de precizia monedei în cauză, dar valorile afișate sunt uneori rotunjite/trunchiate pentru a obține o valoare utilizabilă sau în scopuri de formatare.

De exemplu, calculele Bitcoin (BTC) utilizează până la 10 zecimale (precizia maximă utilizabilă pentru BTC este de 8 zecimale), dar sunt uneori afișate utilizând doar 5 zecimale. Similar, calculele Dolarului American (USD) utilizează până la 4 zecimale (precizia maximă utilizabilă pentru USD este, desigur, de 2 zecimale), dar sunt adesea afișate utilizând doar 2 zecimale.

Endpoint-ul Assets al API-ului REST poate fi utilizat pentru a determina preciziile zecimale maxime pentru monedele individuale:

$ ./krakenapi Assets asset=xbt,usd

{"error":[],"result":{"XXBT":{"aclass":"currency","altname":"XBT","decimals":10,"display_decimals":5},"ZUSD":{"aclass":"currency","altname":"USD","decimals":4,"display_decimals":2}}}

După cum se arată, endpoint-ul Assets oferă preciziile zecimale de calcul prin câmpurile decimals și oferă preciziile zecimale de afișare prin câmpurile display_decimals.

Corelarea valorilor locale cu valorile API

Valorile derivate din calcule locale (cum ar fi calcularea modificărilor soldului dintr-un preț și volum al unei tranzacții) au adesea mai multe zecimale decât este necesar și trebuie rotunjite/trunchiate pentru a se potrivi cu valorile furnizate de API.

De exemplu, un ordin SHIB/USD de cumpărare a 50.123 SHIB la 0,00002901 $ rezultă într-o tranzacție în valoare de 1,45406823 $ (50.123 x 0,00002901 = 1,45406823 $), dar endpoint-ul Ledgers al API-ului REST arată că soldul USD a scăzut cu o valoare de precizie mai mică de 1,4541 $:

"L2A7BN-OLRUR-DGZH7F":{"refid":"T5JORM-HM432-GQ3RGY","time":1639991413.4671,"type":"trade","subtype":"","aclass":"currency","asset":"ZUSD","amount":"-1.4541","fee":"0.0000","balance":"124.7277"}

Soluția pentru acest tip de discrepanță a preciziei zecimale este de a rotunji/trunchia valorile locale pentru a se potrivi cu precizia zecimală furnizată de endpoint-ul Assets al API-ului REST.

Continuând exemplul SHIB/USD, endpoint-ul Assets indică o precizie de calcul USD de 4 (vezi secțiunea anterioară de mai sus), prin urmare, valoarea calculată local de 1,45406823 $ ar trebui, de asemenea, rotunjită/trunchiată la o precizie zecimală de 4: