Get Stablecoin Quote

POST

/v1/stable/order/get-quote

Overview

Retrieve the real-time quote that converts a fiat amount into its stablecoin equivalent (USDC or USDT).
The quote is intended for checkout displays and pre-payment confirmation screens, and it includes a lock window (expiry time) during which the quoted rate is valid.

What it does
• Calculates how much USDC/USDT is required to settle a given fiat amount.
• Returns the stablecoin amount and a price validity period (lock/expiry timestamp).
• Can be used to render “Pay XX USDT for YY BRL” messages to end-users before they pay.

Request

Body Params application/json

{
    "businessType": "STABLE_BUY",
    "paymentMethod": "VIRTUAL_ACCOUNT",
    "sourceAccountId": "3350",
    "sourceCurrency": "BRL",
    "targetCurrency": "USDC",
    "targetAccountId": 2982,
    "sourceAmount": 2000
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location '/v1/stable/order/get-quote' \
--header 'Content-Type: application/json' \
--data '{
    "businessType": "STABLE_BUY",
    "paymentMethod": "VIRTUAL_ACCOUNT",
    "sourceAccountId": "3350",
    "sourceCurrency": "BRL",
    "targetCurrency": "USDC",
    "targetAccountId": 2982,
    "sourceAmount": 2000
}'

Responses

🟢200OK

application/json

Bodyapplication/json

{
    "status": 200,
    "code": null,
    "msg": "OK",
    "data": {
        "quoteId": "45f1442bd30e4a09ad8893820a7d3a87",
        "businessType": "STABLE_BUY",
        "paymentMethod": "VIRTUAL_ACCOUNT",
        "price": 0.00070401,
        "sourceFiatCurrency": "NGN",
        "sourceCryptoCurrency": null,
        "sourceCryptoAmount": null,
        "mintCryptoCurrency": "cNGN",
        "burnCryptoCurrency": "USDC",
        "targetFiatCurrency": null,
        "targetCryptoCurrency": "USDC",
        "targetCryptoAmount": 2.10,
        "taxFeeCurrency": "NGN",
        "taxFee": 0,
        "taxFeeUsd": 0.00,
        "taxFeeRate": 0,
        "swiftFeeCurrency": null,
        "swiftFee": 0,
        "swiftFeeInUsd": 0,
        "swiftFeeRate": null,
        "thirdFeeRate": null,
        "thirdFee": null,
        "thirdFeeCurrency": null,
        "sourceFiatAmount": 3000,
        "targetFiatAmount": 2.10,
        "quotationExpiredAt": 1774425666856,
        "fiatPrecision": 2,
        "lp": null,
        "entity": null,
        "sourceAccountId": null,
        "targetAccountId": 2982,
        "finalPrice": 0.000700,
        "ourPrice": 0.00070190,
        "ourFeeCurrency": "USDC",
        "ourFeeRate": 0.003,
        "ourFeeAmount": 0.01,
        "ourFeeAmountUsd": 0.01
    },
    "traceId": "Auto:822de7fe93814c4e92eeb164b727844b",
    "success": true
}

Inquery FX Rate

Create Stable Order