> ## 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.

# 金额格式 - 金额、币种与价格

> Apexium API 如何表示金额、币种和价格，以及您发送的投注额须遵守的规则。

## 金额

API 返回的每个金额都是一个对象，包含一个十进制字符串、以整数分表示的同一金额，以及一个 ISO 4217 币种代码：

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

* **十进制字符串。** `amount` 始终带两位小数，且没有千位分隔符。它是字符串，以确保不丢失精度：请用十进制类型解析，而不要用浮点数。
* **整数分。** `amountCents` 是以整数分表示的同一金额：始终等于 `amount` × 100。如果您的平台以分计数，请使用它；两个字段始终一致。
* **符号。** 可能为负的金额，例如盈亏，带有前导 `-`：`"-50.00"`。`amountCents` 同样为负数：`-5000`。
* **币种。** 金额以您的账户币种计，即 USD。

## 您发送的投注额

`POST /v1/orders` 上的 `stake` 只接受 `amount` 和 `currency`：API 不读取输入中的 `amountCents`。须遵守以下规则：

| 字段 | 规则 | 错误 |
| - | - | - |
| `stake.amount` | 为正数，最多两位小数：`"50"`、`"50.5"` 和 `"50.50"` 均有效 | `400 INVALID_STAKE` |
| `stake.currency` | 您的账户币种，`"USD"` | `400 CURRENCY_NOT_SUPPORTED` |

投注额是订单的总额。Apexium 会将它拆分到各博彩公司；每笔注单显示各自的 `requestedStake` 和 `filledStake`。

## 价格

价格是十进制赔率，以字符串书写：`"1.95"`。

* **`minPrice`。** 您发送的价格下限：至少 `1.001`，最多四位小数。
* **`filledPrice`。** 注单被接受时的价格。
* **`averageFilledPrice`。** 订单已成交注单按投注额加权的价格。

## 余额

`GET /v1/balance` 返回四个金额：

| 字段 | 含义 |
| - | - |
| `cashBalance` | 您的现金 |
| `givenCredit` | 您的代理给予您的授信额度 |
| `exposure` | 尚未结算的注单所占用的金额：其投注额；零售账户则为全部负债，包括未成交的承诺和佣金 |
| `available` | 您现在可用于投注的金额：`givenCredit` + `cashBalance` − `exposure`；零售账户为 `cashBalance` − `exposure` |

投注额超过 `available` 的订单会被拒绝，并返回 `400 INSUFFICIENT_FUNDS`。


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