Fiat Pay-in Quote
Developing
POST
/v2/fiat/pay-in/quote
What This API Does
fiat_amount or token_amount, not both.token_amount when the user wants to buy a fixed amount of crypto.fiat_amount when the user wants to spend a fixed amount of fiat.Request Data Structure
Option A: Fixed Token Amount
{
"fiat_currency": "EUR",
"token": "USDT",
"token_amount": 100
}Option B: Fixed Fiat Amount
{
"fiat_currency": "EUR",
"token": "USDT",
"fiat_amount": 500
}| Field | Type | Required / Nullable | Conditions / Notes |
|---|---|---|---|
fiat_currency | string | Required, cannot be null | Fiat currency code. |
token | string | Required, cannot be null | Token symbol, for example USDT. |
fiat_amount | float | Conditionally required, nullable only when token_amount is provided | Fiat amount the user wants to spend. Cannot be combined with token_amount. |
token_amount | float | Conditionally required, nullable only when fiat_amount is provided | Crypto amount the user wants to buy. Cannot be combined with fiat_amount. |
WARNING
fiat_amount and token_amount are mutually exclusive. Sending both or neither should be treated as invalid.Response Structure
{
"fiat_currency": "EUR",
"token": "USDT",
"fiat_amount": 89.5,
"token_amount": 100,
"min_limit": 1.0,
"max_limit": 150000.0,
"can_transact": true,
"message": null
}| Field | Type | Nullable | Description |
|---|---|---|---|
fiat_currency | string | No | Fiat currency. |
token | string | No | Token symbol. |
fiat_amount | float | No | Fiat amount including TransFi processing fees. This is the amount the user pays. |
token_amount | float | No | Crypto amount the user receives. |
min_limit | float | No | Minimum allowed fiat amount. |
max_limit | float | No | Maximum allowed fiat amount. |
can_transact | boolean | No | true if the fiat amount is within [min_limit, max_limit]. |
message | string | Yes | Human-readable reason when can_transact is false. Otherwise null. |
Logic in a Nutshell
can_transact. If can_transact is false, do not create a fiat order. Show message to the user or ask them to change the amount.Request
None
Responses
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://api.aio.cash/v2/v2/fiat/pay-in/quote'Response Response Example
{
"success": true,
"msg": "ok",
"data": {}
}Modified at 2026-05-18 08:39:10