Reference
Units and money
Reference for IDR, credits-equivalent, shares, FX, and basis points.
Units and money
Use integer units everywhere.
Core units
| Unit | Meaning |
|---|---|
amount_minor | Operator-facing currency amount stored and displayed as a zero-decimal integer. The legacy _minor suffix does not imply ISO currency exponent scaling. |
credits_equivalent | Integer internal buying-power unit where 10000 = 1 USDT. |
shares_micro | Integer market share unit where 1000000 = 1 share. |
idr_per_usdt | FX rate: IDR for 1 USDT. |
bps | Basis points with denominator 10000. |
Reference conversions
10000 credits_equivalent = 1 USDT
1000000 shares_micro = 1 share
100 bps = 1%
Rounding convention
- floor on final integer conversion
- never round up credits-equivalent
- never round up payout amount
Operator-facing implications
- compare integer amounts only in reconciliation
- keep wallet adapter amounts as integers
- display
10000as10,000in the operator currency, never as100.00 - only
shares_microuses a decimal scaling factor (1000000 = 1 share) - do not use float equality in downstream systems
Common fields by surface
- quotes and trades:
external_amount_minor,shares_micro - wallet adapter:
external_user_id,amount_minor,currency_code,idempotency_key - webhook payloads: final integer amounts only
- balance operations: integer amount plus direction and status