🧾Quote and offer object

Quote responses combine amounts, normalized price information, availability context, and provider metadata.

Core amount fields

Field	Meaning
currency_amount	Buy input or sell payout amount, depending on direction.
cryptocurrency_amount	Buy output or sell input amount.
total_fee	Monetary fee value returned for the quote.
profit_rate	Effective rate calculated from quote amounts.
true_fee	Percentage difference between effective rate and market reference.
quote_id	Provider quote identifier when supplied. Pass it when creating the transaction.

True Fee calculation

profit_rate is the effective rate implied by the quote amounts, and true_fee is its signed distance from the market reference, in percent.

For a buy quote:

profit_rate    = total_currency_amount / cryptocurrency_amount
true_fee       = (profit_rate - market_price) / market_price * 100

For a sell quote the sign is reversed, because a worse payout sits below the market price rather than above it:

profit_rate    = currency_amount / cryptocurrency_amount
true_fee       = (market_price - profit_rate) / market_price * 100

In both cases a higher true_fee is worse for the user. true_fee is null when no market reference is available for the pair.

Do not treat true_fee as interchangeable with:

• total_fee, which is a quoted monetary fee rather than a relative comparison;

• a provider's advertised processing fee;

• discount_percent, a provider promotion;

• a network or smart-contract fee, which is reported separately in the quote.

true_fee is derived from a time-sensitive quote and a live market reference, so it changes when the quote is refreshed. A provider can also adjust the final checkout if the inputs change or the quote expires.

See True Fee for the product-level explanation.

Offer signals

Field	Meaning
is_best_rate	Best effective result in the current search.
is_recommended	Provider is recommended for comparable region, currency, and method conditions.
is_best_success_rate	Provider has the strongest recent success-rate signal for comparable conditions.
has_been_used_before	Authenticated user previously completed a comparable provider transaction.
is_kyc_ready	Reusable KYC is ready for the authenticated user and provider.
nokyc	Quote qualifies for the configured simplified-KYC combination and limit.

For anonymous White Label requests, user-specific flags such as has_been_used_before and is_kyc_ready can remain false.

Provider promotion fields

The nested service can include:

• discount_percent for an active buy promotion;

• discount_percent_sell for an active sell promotion.

An expired promotion is returned as null. Display the promotion alongside, not instead of, the actual amount and True Fee.

Indirect buy fields

When buy_native is false, smart_contract_data describes the intermediate asset, amount, and smart-contract fee. Preserve this object when creating the selected transaction.

{
  "buy_native": false,
  "smart_contract_data": {
    "middle_cryptocurrency": {
      "id": 10,
      "name": "USD Coin",
      "symbol": "USDC"
    },
    "middle_cryptocurrency_amount": "100.25",
    "fee": "0.15"
  }
}