The charges
Pricing is two-sided. Money is charged on the way in and again for what you do with it, so a movement that arrives and then converts carries both. These are the names your contract uses, and the same names come back on every itemised price.
The clearest way to see it: money arriving from a bank and paid straight out to another bank carries the inbound fee and a rail fee on each leg. Money arriving as digital currency and paid out as cash additionally carries the conversion fee. Money already sitting with you and paid out today carries the rail fee alone. Its inbound fee was charged on the way in. Money arriving as digital currency on a
fiat account, a crypto inbound, carries the inbound fee, the conversion fee and the rail fee of its network, which the quote names after the network, such as tron_inbound.
Not every fee is charged per movement. Onboarding and setup, account management and any monthly minimum are set in your contract and billed on their own terms. They are not part of a movement’s price and never appear on a quotation, so a figure on your invoice with no matching line on a quote is one of these.
Two rail charges look alike and are not the same thing. What you pay for a rail — a bank wire or a blockchain — is a Kira charge and appears on your price as the rail fee. On a payout delivered as digital currency you also bear the chain’s own transfer cost, which comes out of the amount delivered rather than out of what you send; on a grouped quotation it is
fees.network_fee. What Kira pays to run its own rails is separate again, and is never billed to you.Knowing the price before you commit
You can ask what a movement will cost before making it, with Create a quotation. The answer breaks the price into its charges, together with the amount that will actually arrive. The quotation object is every field of it. You can lock that price for a short window. Within it, the movement settles at exactly the quoted figure even if rates move. This is what lets you show a firm number to your own customer rather than an estimate.When a conversion is involved
A conversion has two parts, and they are separate: the conversion fee for performing it, and the rate at which it happens. The rate is the market rate at that moment, and the price you are shown carries both the rate applied and the market rate it came from, so the difference is visible rather than buried. Fees are calculated on the face value of the movement, not on the converted amount. The rate changes what arrives, never what you are charged. A crypto inbound is priced when it arrives. The rate and the fees are fixed then, so a long compliance review does not change them. Where one side of the conversion is a stablecoin, the rate can be held at parity instead of the rate sampled from the market. That adjustment is part of the rate itself. It is never a charge and never appears as its own line. You see it as the gap between the rate applied and the market rate beside it, with the price marking that it was held. The hold works in one direction per leg. Converting into a stablecoin, it applies only while the coin is trading below parity; converting out of one, only while it is trading above. A movement watching the other direction will never see it. A crypto inbound converts out of a stablecoin, so a token trading below one dollar is converted at its market rate. The dollars this leaves uncredited come back on the deposit asdepeg_cost. It is part of the rate, not a fee, so it is in no fee line; it reads 0.00 when the token was at par.
What is not charged
- Holding money. A balance can sit indefinitely at no cost.
- Asking for a price. Quotes are free, whether or not you act on them.