> ## Documentation Index > Fetch the complete documentation index at: https://docs.jenzy.com/llms.txt > Use this file to discover all available pages before exploring further. # Quote a desk order > Pin a rate for one order. One side is a stablecoin and the other a corridor currency; the stablecoin side decides the direction (stablecoin → currency is a to-bank order paid to a beneficiary; currency → stablecoin is a from-bank order credited to your balance). Fix either amount; the other is derived at the corridor rate and rounded to the asset’s decimals (currency down, stablecoin up). A quote is short-lived — `expires_at` is authoritative, normally 60 seconds after issue — is consumed by exactly one order, reserves no balance and is not listed. No Idempotency-Key. ## OpenAPI ````yaml /v2/openapi.json post /orders/quotes openapi: 3.1.0 info: title: Jenzy Hermes Multi-asset API version: 2.0.0 description: >- Hold, convert and pay out across the assets enabled for your organization. Every amount is an exact decimal string beside an `asset` field. Authenticate with the same `jz_live_…` API key as `/v1`. servers: - url: https://api.jenzy.com/v2 description: Production security: [] paths: /orders/quotes: post: summary: Quote a desk order description: >- Pin a rate for one order. One side is a stablecoin and the other a corridor currency; the stablecoin side decides the direction (stablecoin → currency is a to-bank order paid to a beneficiary; currency → stablecoin is a from-bank order credited to your balance). Fix either amount; the other is derived at the corridor rate and rounded to the asset’s decimals (currency down, stablecoin up). A quote is short-lived — `expires_at` is authoritative, normally 60 seconds after issue — is consumed by exactly one order, reserves no balance and is not listed. No Idempotency-Key. requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/OrderQuoteCreate' responses: '201': description: The quote. Both amounts are frozen on it. content: application/json: schema: $ref: '#/components/schemas/OrderQuote' '400': description: >- Malformed body, neither or both amounts, or an amount with more decimals than the asset carries. content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' '401': description: Missing, malformed, or revoked API key. content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' '403': description: >- Organization suspended, request IP not on the allowlist, no multi-asset access yet (`onboarding_incomplete` / `access_suspended`), or the desk is not enabled for your organization (`corridor_not_enabled`). content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' '422': description: >- `unsupported_pair` (not one stablecoin and one corridor currency) or `amount_below_minimum` (the stablecoin side is under the corridor’s `min`). content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' '503': description: >- `rate_unavailable` — this direction has no rate right now; `service_maintenance` / `service_incident` — the desk is closed; or the `/v2` shutter is closed. content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' security: - ApiKeyAuth: [] components: schemas: OrderQuoteCreate: type: object properties: from_asset: type: string minLength: 1 description: >- 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). example: USDT to_asset: type: string minLength: 1 description: >- The asset you receive (on a to-bank order) or that is credited to your balance (on a from-bank order). example: BIF from_amount: anyOf: - type: integer - type: string pattern: ^\d+(\.\d+)?$ description: >- Fix what you pay; `to_amount` is derived. Send exactly one of `from_amount` and `to_amount`. example: '1000' to_amount: anyOf: - type: integer - type: string pattern: ^\d+(\.\d+)?$ description: >- Fix what the beneficiary receives (or what you are credited); `from_amount` is derived. example: '2850500' required: - from_asset - to_asset OrderQuote: type: object properties: quote_id: type: string format: uuid description: Pass this to `POST /v2/orders`. Consumed by exactly one order. from_asset: type: string minLength: 1 description: >- 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. example: USDT to_asset: type: string minLength: 1 description: >- 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. example: BIF from_amount: type: string description: What you will pay, in `from_asset`. example: '1000' to_amount: type: string description: >- 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: type: string description: >- Corridor currency per one stablecoin, all-in, as a trimmed decimal string. Frozen on the quote. example: '2850.5' expires_at: type: string description: >- 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' required: - quote_id - from_asset - to_asset - from_amount - to_amount - rate - expires_at ErrorEnvelope: type: object properties: error: type: object properties: code: type: string enum: - validation_error - unauthorized - forbidden - not_found - conflict - rate_limited - internal_error - unknown_institution - invalid_mobile_number - invalid_account_number - mobile_number_institution_mismatch - service_unavailable - sandbox_only - insufficient_funds - rail_disabled - amount_limit_exceeded - org_limit_exceeded - service_incident - service_maintenance - onboarding_incomplete - access_suspended - corridor_not_enabled - unsupported_pair - invalid_wallet_address - rate_unavailable - quote_expired - quote_used - limit_exceeded - amount_below_minimum - unsupported_asset - unsupported_network - unsupported_media_type - payload_too_large - client_ref_used - beneficiary_required - beneficiary_not_allowed - proof_not_expected description: >- Stable identifier a client may branch on — never renamed or removed. message: type: string required: - code - message required: - error securitySchemes: ApiKeyAuth: type: http scheme: bearer description: 'Your Jenzy API key: `Authorization: Bearer jz_live_…`' ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.