Amounts

Every amount in the API and in the webhooks is a string of digits in base units, next to a decimals field that says where the decimal point goes:

human value = amount / 10^decimals

`amount`	`decimals`	Human value
`"500000000"`	`2`	5,000,000.00 (cash, US dollars)
`"5000000000000"`	`6`	5,000,000.000000 (tokens)
`"7495"`	`2`	74.95
`"0"`	`6`	0

Parse amounts with a decimal or big-integer type. A token amount can exceed what a 64-bit float holds exactly; never convert one to a JavaScript number or a Python float.

// Exact: BigInt for the integer, string slicing for the decimal point.
function toHuman(amount, decimals) {
  const digits = amount.padStart(decimals + 1, '0');
  const whole = digits.slice(0, digits.length - decimals);
  const fraction = digits.slice(digits.length - decimals);
  return decimals ? `${whole}.${fraction}` : whole;
}
toHuman('500000000', 2); // "5000000.00"

Cash and tokens

Amount	Unit	`decimals` from
Deposits, `depositMovements`, redemption confirmations, payouts	The minor unit of `currencyId`: cents for the US dollar	The currency
Transactions, mintings, redemption transfers, `sourceTransaction`, holdings	The token’s base unit	The token

currencyId 1 is the US dollar, with decimals 2. A deposit and the tokens issued for it are in different units, and the conversion between them is the fund’s price at issuance, which the API does not carry. Reconcile the cash against your bank and the deposits, the tokens against your wallets and the transactions, and the two against each other with the price your fund agreement sets.

Holdings

GET /assets returns totalTokens for each token: the sum of what your account holds across every wallet and custody arrangement Securitize knows of, in the token’s base units. Compare it with the sum of your transactions only after every pending transaction has a closedTimestamp.

Get started

Guides

Concepts

Help

API reference

Cash and tokens

Holdings