Skip to main content
POST
Quote a desk order

Authorizations

Authorization
string
header
required

Your Jenzy API key: Authorization: Bearer jz_live_…

Body

application/json
from_asset
string
required

The asset you pay. One side is a stablecoin and the other a corridor currency from GET /v2/orders/corridors; the stablecoin side decides the direction. Any other pair is unsupported_pair (422).

Minimum string length: 1
Example:

"USDT"

to_asset
string
required

The asset you receive (on a to-bank order) or that is credited to your balance (on a from-bank order).

Minimum string length: 1
Example:

"BIF"

from_amount

Fix what you pay; to_amount is derived. Send exactly one of from_amount and to_amount.

Example:

"1000"

to_amount

Fix what the beneficiary receives (or what you are credited); from_amount is derived.

Example:

"2850500"

Response

The quote. Both amounts are frozen on it.

quote_id
string<uuid>
required

Pass this to POST /v2/orders. Consumed by exactly one order.

from_asset
string
required

An asset code as GET /v2/assets lists it — uppercase, never compound (KES, USDT; never USDT-TRON). Network and rail live on the payment object.

Minimum string length: 1
Example:

"USDT"

to_asset
string
required

An asset code as GET /v2/assets lists it — uppercase, never compound (KES, USDT; never USDT-TRON). Network and rail live on the payment object.

Minimum string length: 1
Example:

"BIF"

from_amount
string
required

What you will pay, in from_asset.

Example:

"1000"

to_amount
string
required

What the beneficiary receives (to-bank order) or you are credited (from-bank order), in to_asset. The derived side is rounded to the asset’s decimals: the corridor currency down, the stablecoin up.

Example:

"2850500"

rate
string
required

Corridor currency per one stablecoin, all-in, as a trimmed decimal string. Frozen on the quote.

Example:

"2850.5"

expires_at
string
required

ISO 8601. The moment this quote dies — normally 60 seconds after issue; always read this field rather than assuming a window. Create the order before it or take a new quote; an expired quote is quote_expired (422).

Example:

"2026-09-22T10:01:00.000Z"