> ## Documentation Index
> Fetch the complete documentation index at: https://developer.bron.org/llms.txt
> Use this file to discover all available pages before exploring further.

# Request indicative swap quote

> Request an indicative price for a potential swap between two assets without creating an on-chain order. Used by broadcaster integrators to display rates before initiating `createOrder`. Includes a hard floor (`minToAmount`) enforced on-chain via `maxPrice`.

<sup>API Key permissions: View only, Transaction Operator, Full Access</sup>



## OpenAPI

````yaml /bron-open-api-public.json post /workspaces/{workspaceId}/intents/quote
openapi: 3.1.1
info:
  description: >-
    Bron API is based on the RESTish interface provided for data exchange
    between a client and a server with the use of HTTPS requests and responses.
  title: Bron API
  version: latest
  x-bron-formats:
    bigint: Arbitrary-precision integer encoded as a JSON string.
    date-time-millis: >-
      Epoch milliseconds (UTC) encoded as a JSON string. Convert with `new
      Date(parseInt(value))` or equivalent.
    decimal: Arbitrary-precision decimal encoded as a JSON string.
    int32: 32-bit integer encoded as a JSON string.
    int64: >-
      Long integer encoded as a JSON string to preserve precision (e.g. account
      IDs).
servers:
  - description: app.bron.org
    url: https://api.bron.org
security: []
tags:
  - name: stake
  - name: balances
  - name: addresses
  - name: intents
  - name: assets
  - name: transaction-limits
  - name: canton
  - name: address-book
  - name: workspaces
  - name: accounts
  - name: transactions
paths:
  /workspaces/{workspaceId}/intents/quote:
    post:
      tags:
        - intents
      summary: Request indicative swap quote
      description: >-
        Request an indicative price for a potential swap between two assets
        without creating an on-chain order. Used by broadcaster integrators to
        display rates before initiating `createOrder`. Includes a hard floor
        (`minToAmount`) enforced on-chain via `maxPrice`.


        <sup>API Key permissions: View only, Transaction Operator, Full
        Access</sup>
      parameters:
        - description: ID of the source asset
          example:
            - '2'
          in: query
          name: fromAssetId
          required: true
          schema:
            type: string
        - description: ID of the destination asset
          example:
            - '5002'
          in: query
          name: toAssetId
          required: true
          schema:
            type: string
        - description: >-
            Amount of the from-asset. Exactly one of `fromAmount` or `toAmount`
            must be specified.
          example:
            - '120.015'
          in: query
          name: fromAmount
          required: false
          schema:
            format: decimal
            type: string
        - description: >-
            Amount of the to-asset. Exactly one of `fromAmount` or `toAmount`
            must be specified.
          example:
            - '117500.03'
          in: query
          name: toAmount
          required: false
          schema:
            format: decimal
            type: string
        - in: path
          name: workspaceId
          required: true
          schema:
            type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/IntentsQuote'
          description: OK
        '400':
          content:
            application/json:
              schema:
                properties:
                  error:
                    description: The machine-readable error code
                    examples:
                      - bad-request
                    type: string
                  message:
                    description: >-
                      A human-readable message providing more details about the
                      error
                    type: string
                type: object
          description: Bad Request
        '403':
          content:
            application/json:
              schema:
                properties:
                  error:
                    description: The machine-readable error code
                    examples:
                      - forbidden
                    type: string
                  message:
                    description: >-
                      A human-readable message providing more details about the
                      error
                    type: string
                type: object
          description: Forbidden
        '409':
          content:
            application/json:
              schema:
                properties:
                  error:
                    description: The machine-readable error code
                    examples:
                      - conflict
                    type: string
                  message:
                    description: >-
                      A human-readable message providing more details about the
                      error
                    type: string
                type: object
          description: Conflict
components:
  schemas:
    IntentsQuote:
      properties:
        fromAmount:
          description: Amount of the from-asset (echo of the request)
          examples:
            - '120.015'
          format: decimal
          type: string
        fromAssetId:
          description: ID of the source asset
          examples:
            - '2'
          type: string
        minPrice:
          description: >-
            Minimum acceptable price (quote/base) for the on-chain order.
            Solvers cannot fill below this. Multiply by `10^18` and pass as
            `CreateOrderParams.maxPrice_e18` (the contract's legacy field name).
          examples:
            - '973.4500'
          format: decimal
          type: string
        minToAmount:
          description: >-
            Hard floor on the to-asset amount, enforced by `minPrice` in the
            on-chain order. Solvers cannot fill below this.
          examples:
            - '116912.53'
          format: decimal
          type: string
        oracleFeePercent:
          description: Oracle protocol fee in percent applied to the order
          examples:
            - '0.02'
          format: decimal
          type: string
        solverFeePercent:
          description: Solver protocol fee in percent applied to the order
          examples:
            - '0.05'
          format: decimal
          type: string
        toAmount:
          description: >-
            Indicative expected amount of the to-asset. May drift slightly
            toward `minToAmount` between quote time and order execution.
          examples:
            - '117500.03'
          format: decimal
          type: string
        toAssetId:
          description: ID of the destination asset
          examples:
            - '5002'
          type: string
      required:
        - fromAssetId
        - toAssetId
        - fromAmount
        - toAmount
        - minToAmount
        - minPrice
        - solverFeePercent
        - oracleFeePercent
      type: object

````