Skip to main content
POST
Quote a desk order

Authorizations

Authorization
string
header
required

Your Jenzy API key: Authorization: Bearer jz_live_…

Headers

HERMES-ORG
string<uuid>

The id of one of your Child orgs. The call then acts on that Child org, not on your organization. If you do not send it, the call acts on your organization. An id that is not one of your Child orgs gives 404.

Example:

"3f1c2a9e-8b7d-4e21-9a6f-0c5d4b3e2a10"

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 (USDC, USD; never USDC-ETHEREUM). 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 (USDC, USD; never USDC-ETHEREUM). 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"