quote_id is what makes it more than an estimate. Send it with a payout and the payout settles at exactly these figures, until quote_expires_at passes. Every payout needs one: a payout without quote_id is refused.
Which shape comes back depends on the version you are pinned to. The itemized one below is the current shape; the older grouped one is at the end of this page.
Example
Every amount is a whole number in the currency’s smallest unit, with the
precision to divide by. 1000.00 USD arrives as amount: 100000 with precision: 2. Rates are decimal strings.What the quotation is
The money
source is what you send and recipient is what the counterparty ends up with. Both carry amount, currency and precision.
The charges
fees is one entry per charge. Add them up and you get totals.fee_total. The names are the ones your contract uses — How you’re charged has what each is for.
A
percentage line carries four more fields, and a fixed line carries none of them:
Not every line appears on every quote. A movement with no currency change carries no conversion line, and a payout from a balance you already hold carries no inbound charge. That was taken when the money arrived.
The totals
The conversion
Always present. When no currency changed, it echoes the movement back at a rate of1.000000. Compare source_currency with target_currency, or read pair, to tell whether a conversion actually happened.
Why this price
pricing_context says what the price was worked out against.
The grouped shape
A quote read on2026-04-14 comes back grouped rather than itemized, and every amount is a decimal string instead of a whole number with a precision.
The charges arrive under
fees, in groups rather than as lines: base_fees is what Kira charged, client_markup is what you charged on top, network_fee is the chain’s transfer cost, and fx carries the rates when the quote converts. fees.total_fees adds up base_fees and client_markup, and fees.total repeats it. On a quote funded in a token it also holds the spread, network_fee and fx.depeg_loss, so do not add them. On a quote delivered as digital currency, network_fee comes off the tokens delivered and is not in total_fees. network_fee is 0.00 on a bank payout.
The two shapes carry the same charges. What the itemized one adds is a line per charge, each naming what it is and what it was calculated on, instead of a group total you have to take apart.