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

# Money

> Amounts, currencies and timestamps.

## Amounts are integer strings

Every amount is an integer number of the currency's **minor unit** (cents, pence, kobo), sent and returned as a **string**:

```json theme={null}
{ "minorUnits": "125000", "currency": "USD" }
```

That's US\$1,250.00. Strings, not numbers, because JSON numbers lose precision above 2<sup>53</sup> in many languages, and an amount is the last place to find that out.

Never parse an amount as a float. In Python, use `int` or `Decimal`:

```python theme={null}
from decimal import Decimal

minor = int(account["available"]["minorUnits"])  # 125000
major = Decimal(minor) / 100                      # Decimal('1250')
```

To send £25.50, send `"2550"`.

## Currencies

Currencies are ISO 4217 codes, upper case. All the currencies you can hold have two decimal places:

| Currency | Accounts | Payment links and invoices |
| - | - | - |
| USD | ✓ | ✓ |
| GBP | ✓ | ✓ |
| EUR | ✓ | ✓ |
| NGN | ✓ | |
| KES | ✓ | |
| ZAR | ✓ | |
| GHS | ✓ | |

Recipients can be paid in other currencies too: [destination requirements](https://docs.talescria.com/api-reference/recipients/get-destination-requirements.md) lists every corridor.

## Balances

An account has three balances, all in its own currency:

| Field | Meaning |
| - | - |
| `available` | What you can spend now. Use this for decisions. |
| `posted` | Money that has settled in the account. |
| `pending` | Money set aside for payments that haven't completed yet. |

When you send a payment, the amount leaves `available` immediately and shows in `pending` until the payment completes or fails.

## Exchange rates

When money changes currency, Talescria quotes both sides as integers: what leaves (`amountFromMinorUnits`) and what arrives (`amountToMinorUnits`). **Those two amounts are the agreement.** The rate (`rateMicro`, the rate × 1,000,000) is for showing people; multiplying one amount by it won't reliably give you the other.

## Timestamps

Timestamps such as `createdAt`, `expiresAt` and `dueAt` are **milliseconds since the Unix epoch**, in UTC. Calendar dates, such as a recurring series' `startDate`, are `YYYY-MM-DD`.


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