# Currencies

## Match Currency

The match currency determines the standardized bet amounts for all players in the matchmaking pool:

* USD - Required if players participate in the global matchmaking
* Custom operator currency - Any currency chosen by the operator (e.g., “stars”). Players cannot participate in global matchmaking if it is not USD-pegged, which may increase waiting times.

## User Currency

Players always see amounts in their **user currency.** The player’s currency can be provided by operator during game launch (standard: [Authenticate Users](/integration/launch-game/standard/authenticate-users.md)  or custom: [Authenticate Users](/integration/launch-game/custom/authenticate-users.md)). Bet amounts are converted to this currency using exchange rates from [www.xe.com](https://www.xe.com/) (updated every 6 hours). Rates are frozen for the session and applied to both entry fees and potential payouts.

Conversion from match currency to user currency is supported for following [ISO 4217 codes](https://en.wikipedia.org/wiki/ISO_4217):

BTC, ARS, AZN, BRL, CLP, CNY, COP, EGP, EUR, GBP, GHS, IDR, INR, JPY, KES, KZT, MXN, NGN, PEN, RUB, RWF, THB, TRY, TZS, UAH, UGX, UZS, ZAR.

## API

All amounts in the API are expressed in the smallest unit of the currency (e.g., cents for USD, satoshis for BTC) in the user currency.

## Notes

* Some currencies do not have 2 decimal digits (e.g., CLP, JPY, RWF, UGX).
* BTC amounts are in satoshis
* More currencies can be added on operator's request


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.thndr.io/integration/server-webhooks/currencies.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
