155API

Currencies

Supported currencies and precision information


Every wire amount is an integer equal to displayValue × 10^(precision), where precision is per-currency. To read it back, divide by 10^precision. Try any amount below, then see the full currency list.

Debit and credit the integer exactly

Move the amount as the exact integer you receive — never round-trip it through a display value or round it to fewer decimals. Use the precision below only to display amounts to players, not for your wallet's debit/credit math. (Round-tripping a high-precision currency like kIDR through a 2-decimal display is the usual cause of a failing balance-reconciliation check.)

Currency converter

Precision

The rule, once: the wire amount is the display value scaled up by the currency's precision.

amount = displayValue × 10^(precision)

Most fiat — plus the stablecoins (USDT/USDC/DAI) and special currencies — use precision 5, so $1 = 100000. BTC uses 8. The kilo variants kIDR/kVND use 8. Cryptocurrencies vary (6, 8, 9, or 10) — the exact value per coin is in the Cryptocurrencies table.

Worked examples

You want to sendCurrencyPrecisionWire amount
$1.00USD5100000
€50.00EUR55000000
50,000 RpIDR55000000000
50 kRp (= 50,000 Rp)kIDR85000000000
1 BTCBTC8100000000

Each row is displayValue × 10^precision: 1×10^5, 50×10^5, 50000×10^5, 50×10^8, 1×10^8.

Wrong precision mis-renders amounts by orders of magnitude. Sending 100000 for 1 BTC reads as 0.001 BTC, because BTC's precision is 8, not 5.

Kilo currencies (kIDR, kVND)

kIDR/kVND are the same money as IDR/VND; the operator just works in thousands (1 kRp = 1,000 Rp). For the same real amount the wire integer is identical — only the display number you type changes (kRp is 1000× the Rp number). The precision (8 vs 5) exactly absorbs that 1000×.

The only trap is mixing the two codes: typing Rp-scale numbers under a kIDR config. 50 under kIDR and 50000 under IDR are the same 50,000 Rp (both wire 5000000000). But 50000 under kIDR means 50,000 kRp — 1000× too much. Pick one code per operator.

Rounding

Bet amounts are always clean minor-unit values, but win amounts can carry sub-unit precision because they come from multiplier math. If your system supports fewer decimals than our precision for a currency, divide by 10^precision and round down, applied consistently across /balance, /bet, /win, and /rollback. Anything below the smallest representable unit floors to 0.

$1.00 bet × 3.14159x → 314159 → 314159 / 100000 = 3.14159 → round down → 3.14

Zero-decimal currencies (e.g. CLP, JPY): bet amounts are always whole numbers, but win amounts may still have fractional values from multipliers — round down to whole units for display.

Supported Currencies

Fiat Currencies

CodeCurrency
AEDUAE Dirham
ALLAlbanian Lek
ARSArgentine Peso
AUDAustralian Dollar
AZNAzerbaijani Manat
BAMBosnia-Herzegovina Convertible Mark
BDTBangladeshi Taka
BOBBolivian Boliviano
BRLBrazilian Real
BYNBelarusian Ruble
CADCanadian Dollar
CHFSwiss Franc
CLPChilean Peso
CNYChinese Yuan
COPColombian Peso
CZKCzech Koruna
DKKDanish Krone
EGPEgyptian Pound
ETBEthiopian Birr
EUREuro
GBPBritish Pound
GELGeorgian Lari
GHSGhanaian Cedi
GTQGuatemalan Quetzal
HKDHong Kong Dollar
HNLHonduran Lempira
HUFHungarian Forint
IDRIndonesian Rupiah
ILSIsraeli Shekel
INRIndian Rupee
ISKIcelandic Króna
JPYJapanese Yen
KESKenyan Shilling
KGSKyrgyzstani Som
KRWSouth Korean Won
KZTKazakhstani Tenge
LKRSri Lankan Rupee
MKDMacedonian Denar
MXNMexican Peso
MYRMalaysian Ringgit
MZNMozambican Metical
NGNNigerian Naira
NOKNorwegian Krone
NZDNew Zealand Dollar
PENPeruvian Sol
PHPPhilippine Peso
PKRPakistani Rupee
PLNPolish Zloty
RONRomanian Leu
RSDSerbian Dinar
RUBRussian Ruble
SEKSwedish Krona
SGDSingapore Dollar
THBThai Baht
TNDTunisian Dinar
TRYTurkish Lira
TWDTaiwan Dollar
TZSTanzanian Shilling
UAHUkrainian Hryvnia
UGXUgandan Shilling
USDUS Dollar
UZSUzbekistani Som
VESVenezuelan Bolívar
VNDVietnamese Dong
XOFWest African CFA Franc
ZARSouth African Rand

Send the value in Code as the currency parameter on Get Game URL and in callback payloads. Units are denomination labels for display purposes; we do not accept them as currency codes on the wire.

Cryptocurrencies

CodeCurrencyPrecisionUnits
BTCBitcoin8BTC, mBTC, sat
BCHBitcoin Cash8BCH
ETHEthereum8ETH, mETH, Gwei
LTCLitecoin8LTC, mLTC, litoshi
DOTPolkadot10DOT
USDTTether (stablecoin)5USDT
USDCUSD Coin (stablecoin)5USDC
DAIDai (stablecoin)5DAI
XRPRipple6XRP, mXRP
TRXTron8TRX, mTRX
DOGEDogecoin6DOGE, mDOGE
ADACardano6ADA, mADA
SOLSolana9SOL, mSOL
BNBBinance Coin8BNB, mBNB
TONToncoin9TON, mTON
SHIBShiba Inu8SHIB
PYUSDPayPal USD (stablecoin)6PYUSD

Special Currencies

CodeCurrencyDescription
XXXFun MoneyDemo/test currency
GLDGoldCoinVirtual currency, 10,000 coins = 1 USD
SS1SweepCoinSweepstakes currency, 1:1 with USD
UFCFun MoneyAlternative fun currency
USD1Fun MoneyUSD-denominated fun currency
CVDCoverd CashSweepstakes cash, 1:1 with USD
WOWGoldCoinSweepstakes gold coin, 100 coins = 1 USD
GCGoldCoinSweepstakes gold coin, 100 coins = 1 USD

Kilo Currency Variants

These are "kilo" (thousands) versions of base currencies, used when dealing with large denominations. The display number you type is in thousands, but the wire amount (displayValue × 10^8) is the same integer as the base currency for the same real money — see Kilo currencies above.

CodeCurrencyPrecisionDescription
kIDRIndonesian Rupiah (k)8IDR in thousands (1 kRp = 1,000 Rp)
kVNDVietnamese Dong (k)8VND in thousands (1 kVND = 1,000 ₫)

Fun Money

Use currency code XXX for demo/test mode. See Get Game URL for details.

On this page