> ## 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 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.
      parameters:
        - $ref: '#/components/parameters/HermesOrg'
      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:
  parameters:
    HermesOrg:
      name: HERMES-ORG
      in: header
      required: false
      description: >-
        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`.
      schema:
        type: string
        format: uuid
        example: 3f1c2a9e-8b7d-4e21-9a6f-0c5d4b3e2a10
  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 (`USDC`, `USD`; never `USDC-ETHEREUM`). 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 (`USDC`, `USD`; never `USDC-ETHEREUM`). 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
                - invalid_beneficiary
                - beneficiary_exists
                - beneficiary_not_active
                - invoice_required
                - prohibited_industry
              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.