> ## Documentation Index
> Fetch the complete documentation index at: https://jupiter-feat-jupiterz-docs.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Global Order

> Get the best RFQ quote across multiple candidate output mints



## OpenAPI

````yaml openapi-spec/swap/v2/jupiterz.yaml get /global-order
openapi: 3.0.3
info:
  title: JupiterZ API
  version: 1.0.0
  description: >
    Standalone JupiterZ (RFQ) API. Request a firm quote and unsigned transaction
    from

    Jupiter's market makers (`/order`, `/global-order`), have the taker sign the
    transaction,

    and submit it for the market maker to co-sign and execute (`/execute`).


    Access is whitelisted: your API key must be enabled for the JupiterZ API.

    Request access via the enterprise form at
    https://airtable.com/apppC9l7PaT9XG8jN/pagjXGV6PFNwUd9P2/form
servers:
  - url: https://api.jup.ag/swap/v2/jupiterz
    description: JupiterZ API Endpoint
security: []
paths:
  /global-order:
    get:
      summary: Get the best quote across multiple candidate output mints
      description: >
        Quotes one input mint against a comma-separated list of candidate output
        mints and

        returns only the leg worth the most in USD. `ExactIn` only. The response
        has the

        same shape as `/order`: `orderInfo.output.token` identifies the winning
        mint, and

        `requestId` identifies the winning leg. Pass it to `/execute` unchanged.


        The candidate list is capped server-side (currently 3 mints, duplicates
        ignored).

        Passing zero mints or more than the cap returns `400`.
      operationId: getJupiterzGlobalOrder
      parameters:
        - $ref: '#/components/parameters/inputMint'
        - name: outputMint
          in: query
          required: true
          schema:
            type: string
          description: |
            Comma-separated list of candidate output token mint addresses
            (currently up to 3). Duplicates are ignored
          example: >-
            EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v,Es9vMFrzaCERmJfrF4H2FYD4KCoNkY11McCe8BenwNYB
        - $ref: '#/components/parameters/amount'
        - $ref: '#/components/parameters/taker'
        - $ref: '#/components/parameters/version'
        - $ref: '#/components/parameters/isWsol'
        - $ref: '#/components/parameters/receiver'
        - $ref: '#/components/parameters/ataAccountPayer'
        - $ref: '#/components/parameters/inputTokenAccount'
        - $ref: '#/components/parameters/outputTokenAccount'
        - $ref: '#/components/parameters/integratorTokenAccount'
        - $ref: '#/components/parameters/integratorFee'
        - $ref: '#/components/parameters/integratorFeeSide'
        - $ref: '#/components/parameters/settingsPda'
        - $ref: '#/components/parameters/signers'
      responses:
        '200':
          description: Quote retrieved successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/QuoteResponse'
        '400':
          description: >-
            Invalid or missing parameters, `ExactOut` requested, or too many
            output mints
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '401':
          description: Missing or invalid `x-api-key` header
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '404':
          description: No market maker quoted any candidate leg
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                error: No quote found
                errorCode: NO_QUOTE_FOUND
        '429':
          description: Rate limit exceeded
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      security:
        - ApiKeyAuth: []
components:
  parameters:
    inputMint:
      name: inputMint
      in: query
      required: true
      schema:
        type: string
      description: Input token mint address
      example: So11111111111111111111111111111111111111112
    amount:
      name: amount
      in: query
      required: true
      schema:
        type: string
      description: |
        Amount in the token's smallest unit, as a string.
        Input amount for `ExactIn`, output amount for `ExactOut`
      example: '1000000000'
    taker:
      name: taker
      in: query
      required: false
      schema:
        type: string
      description: >
        Taker wallet address. Required to receive a `transaction` in the
        response.

        Without it the response is an indicative quote with `transaction: null`
    version:
      name: version
      in: query
      required: false
      schema:
        type: string
        default: v1
      description: RFQ protocol version
    isWsol:
      name: isWsol
      in: query
      required: false
      schema:
        type: boolean
      description: Set when the swap involves wSOL rather than native SOL
    receiver:
      name: receiver
      in: query
      required: false
      schema:
        type: string
      description: Address receiving the output tokens, when different from the taker
    ataAccountPayer:
      name: ataAccountPayer
      in: query
      required: false
      schema:
        type: string
      description: Address paying for Associated Token Account creation
    inputTokenAccount:
      name: inputTokenAccount
      in: query
      required: false
      schema:
        type: string
      description: Existing taker-owned input token account. Bypasses ATA derivation
    outputTokenAccount:
      name: outputTokenAccount
      in: query
      required: false
      schema:
        type: string
      description: Existing taker-owned output token account. Bypasses ATA derivation
    integratorTokenAccount:
      name: integratorTokenAccount
      in: query
      required: false
      schema:
        type: string
      description: |
        Token account that receives your integrator fee. It must already exist
        (be pre-initialised): the API does not create it. Create the associated
        token account for the fee mint before requesting an order.
        Must be provided together with `integratorFee`
    integratorFee:
      name: integratorFee
      in: query
      required: false
      schema:
        type: integer
        maximum: 10000
      description: |
        Your integrator fee in basis points (max `10000`).
        Must be provided together with `integratorTokenAccount`
    integratorFeeSide:
      name: integratorFeeSide
      in: query
      required: false
      schema:
        type: string
        enum:
          - input
          - output
      description: >
        Side of the swap the integrator fee is charged on. When omitted,
        defaults to the

        user-fixed side: `input` for `ExactIn`, `output` for `ExactOut`.

        Requires `integratorTokenAccount`
    settingsPda:
      name: settingsPda
      in: query
      required: false
      schema:
        type: string
      description: Squads V5 settings PDA address. Required for Squads vault swaps
    signers:
      name: signers
      in: query
      required: false
      schema:
        type: string
      description: |
        Comma-separated signer pubkeys for Squads vault swaps.
        The first signer is the fee payer
  schemas:
    QuoteResponse:
      type: object
      properties:
        routing:
          type: string
          enum:
            - spot
            - onchain
          description: Routing type. `spot` for RFQ fills
          example: spot
        requestId:
          type: string
          description: |
            Identifies this quote request. Pass it to `/execute` unchanged.
            For `/global-order`, identifies the winning leg
          example: 629bddf3-0038-43a6-8956-f5433d6b1191
        quoteId:
          type: string
          description: Identifies this specific quote. Pass it to `/execute` unchanged
          example: 59db3e19-c7b0-4753-a8aa-206701004498
        maker:
          type: string
          description: Market maker wallet filling the order
          example: maker2p9zXHQ5GKdZjSxLu7BfVz8YmF9oQ7TEd1rWqw
        provider:
          type: string
          description: Name of the market maker the `maker` address belongs to
          example: MM Trading
        swapMode:
          type: string
          enum:
            - exactIn
            - exactOut
          description: Swap mode of the quote
          example: exactIn
        orderInfo:
          type: object
          properties:
            input:
              $ref: '#/components/schemas/OrderIO'
            output:
              $ref: '#/components/schemas/OrderIO'
          required:
            - input
            - output
        transaction:
          type: string
          nullable: true
          description: >
            Base64-encoded versioned transaction for the taker to sign. The
            market maker

            adds the final signature and submits it on-chain. `null` for
            indicative quotes

            (no `taker` provided, or the transaction could not be built, see
            `error`)
        expireAt:
          type: string
          nullable: true
          description: >
            Unix timestamp (seconds) after which the transaction is no longer
            valid.

            Sign and execute before this time
          example: '1736968572'
        error:
          type: string
          enum:
            - insufficientBalance
            - missingAtaAccount
          description: >
            Present only when `taker` was provided but no transaction could be
            built.

            `insufficientBalance`: the taker does not hold enough of the input
            token.

            `missingAtaAccount`: a token account required by the swap does not
            exist on-chain
      required:
        - routing
        - requestId
        - quoteId
        - maker
        - provider
        - swapMode
        - orderInfo
    ErrorResponse:
      type: object
      properties:
        error:
          type: string
          description: |
            Error description. Always present. Usually human-readable
            (for example `Unauthorized`, `No quote found`), but some hard
            failures return an opaque request identifier here instead
          example: No quote found
        errorCode:
          type: string
          nullable: true
          description: >
            Machine-readable error code. `null` unless the failure maps to a
            known code:

            `NO_QUOTE_FOUND` (no market maker quoted the pair), `QUOTE_EXPIRED`
            (the quote

            expired before `/execute`), `0x1` (taker has insufficient funds),
            `0xbc4`

            (a required token account is missing), `0x11` (a token account is
            frozen),

            `SIMULATION_FAILED`, `TRANSACTION_ERROR`, `INSTRUCTION_ERROR`
            (simulation failures)
          example: NO_QUOTE_FOUND
      required:
        - error
    OrderIO:
      type: object
      properties:
        token:
          type: string
          description: Token mint address
          example: So11111111111111111111111111111111111111112
        startAmount:
          type: string
          description: Amount in the token's smallest unit
          example: '1000000000'
        endAmount:
          type: string
          description: >
            Amount in the token's smallest unit. Equal to `startAmount` for RFQ
            fills,

            market makers quote a firm price with no slippage range
          example: '1000000000'
      required:
        - token
        - startAmount
        - endAmount
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key
      description: Get API key via https://developers.jup.ag/portal

````