> ## Documentation Index
> Fetch the complete documentation index at: https://docs.apexiumbet.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Money format - Amounts, currency and prices

> How the Apexium API writes amounts, currencies and prices, and the rules for the stake you send.

## Amounts

Every amount the API returns is an object with a decimal string, the same amount in integer cents, and an ISO 4217 currency code:

```json theme={null}
{ "amount": "1250.00", "amountCents": 125000, "currency": "USD" }
```

* **Decimal string.** `amount` always has two decimals and no thousands separator. It is a string so that no precision is lost: parse it with a decimal type, not a floating-point number.
* **Integer cents.** `amountCents` is the same amount as a whole number of cents: always `amount` × 100. Use it if your platform counts in cents; the two fields never disagree.
* **Sign.** Amounts that can be negative, such as a profit or loss, carry a leading `-`: `"-50.00"`. `amountCents` is negative too: `-5000`.
* **Currency.** Amounts are in your account currency, USD.

## The stake you send

`stake` on `POST /v1/orders` takes `amount` and `currency` only: the API does not read `amountCents` on input. These rules apply:

| Field | Rule | Error |
| - | - | - |
| `stake.amount` | Positive, at most two decimals: `"50"`, `"50.5"` and `"50.50"` are valid | `400 INVALID_STAKE` |
| `stake.currency` | Your account currency, `"USD"` | `400 CURRENCY_NOT_SUPPORTED` |

The stake is the total of the order. Apexium splits it across bookmakers; each bet shows its own `requestedStake` and `filledStake`.

## Prices

Prices are decimal odds, written as strings: `"1.95"`.

* **`minPrice`.** The price floor you send: at least `1.001`, at most four decimals.
* **`filledPrice`.** The price a bet was accepted at.
* **`averageFilledPrice`.** The stake-weighted price of an order's filled bets.

## Balance

`GET /v1/balance` returns four amounts:

| Field | Meaning |
| - | - |
| `cashBalance` | Your cash |
| `givenCredit` | The credit your agent gives you |
| `exposure` | What your bets not settled yet hold: their stake, or for a retail account the full liability, unmatched commitments and commission included |
| `available` | What you can stake now: `givenCredit` + `cashBalance` − `exposure`, or `cashBalance` − `exposure` for a retail account |

An order whose stake exceeds `available` is refused with `400 INSUFFICIENT_FUNDS`.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.