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 in minor unit. For IDR, exponent is 0. |
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
- do not use float equality in downstream systems
Common fields by surface
- quotes and trades:
external_amount_minor,shares_micro - wallet adapter:
amount_minor,currency_code,idempotency_key - webhook payloads: final integer amounts only
- balance operations: integer amount plus direction and status