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

# Quote Pro Buy

> Get a buy quote for a pro pool.

Returns the estimated token output, fees, and minimum output after slippage. Unlike standard quotes, pro pool quotes require the `pool` address since pro pool PDAs include the creator in their derivation.

Pass the full response to `/tx/pro/buy` to build the transaction.



## OpenAPI

````yaml /openapi.json post /quote/pro/buy
openapi: 3.1.0
info:
  title: heaven-tx-api
  description: ''
  license:
    name: ''
  version: 0.1.14
servers:
  - url: https://tx.api.heaven.xyz
security: []
tags:
  - name: heaven-api
    description: Heaven API
paths:
  /quote/pro/buy:
    post:
      tags:
        - Pro Pool API
      summary: Quote Pro Buy
      description: >-
        Get a buy quote for a pro pool.


        Returns the estimated token output, fees, and minimum output after
        slippage. Unlike standard quotes, pro pool quotes require the `pool`
        address since pro pool PDAs include the creator in their derivation.


        Pass the full response to `/tx/pro/buy` to build the transaction.
      operationId: quote_pro_buy
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/QuoteProBuyRequest'
        required: true
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/QuoteBuyResponse'
components:
  schemas:
    QuoteProBuyRequest:
      type: object
      required:
        - config_version
        - mint
        - program_id
        - max_sol_spend
        - slippage_bps
        - pool
      properties:
        config_version:
          type: integer
          format: int32
          minimum: 0
          description: >-
            Protocol config version. Use 1 for community tokens, 2 for creator
            tokens, 3 for pro pools.
        mint:
          type: string
          description: Mint address of the SPL token (token A) in the pool.
        program_id:
          type: string
          description: >-
            Program ID of the Heaven DEX program. Use
            `HEAVENoP2qxoeuF8Dj2oT1GHEnu49U5mJYkdeC8BAX2o` for mainnet.
        max_sol_spend:
          type: number
          format: double
          description: >-
            Maximum SOL to spend (in SOL, not lamports). For example, 1.5 means
            1.5 SOL.
        slippage_bps:
          type: integer
          format: int64
          minimum: 0
          description: >-
            Maximum acceptable slippage in basis points. 50 = 0.5%. Set to 0 for
            no slippage tolerance.
        pool:
          type: string
          description: >-
            On-chain address of the pro pool state account. Returned in the
            response when creating a pool.
      description: >-
        Request a buy quote for a pro pool. Returns the estimated token output
        and fee breakdown.
    QuoteBuyResponse:
      type: object
      required:
        - max_sol_spend
        - max_lamport_spend
        - minimum_out
        - minimum_out_ui
        - config_version
        - mint
        - program_id
        - slippage_bps
      properties:
        config_version:
          type: integer
          format: int32
          minimum: 0
          description: Protocol config version used for the quote.
        max_lamport_spend:
          type: integer
          description: Maximum amount of lamports to spend for the buy operation
          minimum: 0
        max_sol_spend:
          type: number
          description: Maximum amount of SOL to spend for the buy operation
        minimum_out:
          type: integer
          description: Minimum amount of tokens to receive from the buy operation
          minimum: 0
        minimum_out_ui:
          type: number
          description: >-
            Minimum amount of tokens to receive from the buy operation in UI
            format
        mint:
          type: string
          description: Mint address of the token being bought.
        program_id:
          type: string
          description: Heaven DEX program ID used.
        slippage_bps:
          type: integer
          format: int64
          minimum: 0
          description: Slippage tolerance applied (basis points).

````