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

# Get quotes

> Returns pricing quotes. Include wallet addresses to receive an unsigned transaction for execution.



## OpenAPI

````yaml https://api.sunrise.xyz/openapi post /v1/quotes
openapi: 3.1.0
info:
  title: Sunrise API
  description: Authenticated API for Sunrise.
  version: 1.0.0
servers:
  - url: https://api.sunrise.xyz
security:
  - bearerAuth: []
paths:
  /v1/quotes:
    post:
      tags:
        - Quotes
      summary: Get quotes
      description: >-
        Returns pricing quotes. Include wallet addresses to receive an unsigned
        transaction for execution.
      operationId: getQuotes
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                fromToken:
                  type: string
                  minLength: 1
                  description: Input token mint address.
                toToken:
                  type: string
                  minLength: 1
                  description: Output token mint address.
                fromAddress:
                  type: string
                  minLength: 1
                  description: Wallet address sending the input token.
                toAddress:
                  type: string
                  minLength: 1
                  description: Wallet address receiving the output token.
                fromAmount:
                  type: string
                  minLength: 1
                  description: Input amount in the token's base units.
              required:
                - fromToken
                - toToken
                - fromAmount
              additionalProperties: false
        description: Quote parameters.
        required: true
      responses:
        '200':
          description: Available quotes from the supported routes.
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    enum:
                      - true
                    type: boolean
                  data:
                    type: object
                    properties:
                      quotes:
                        type: array
                        items:
                          type: object
                          properties:
                            quoteId:
                              type: string
                              minLength: 1
                              description: Identifier to pass when executing the quote.
                            routeName:
                              type: string
                              minLength: 1
                              description: Liquidity route used by the quote.
                            providerRequestId:
                              type: string
                              minLength: 1
                              description: >-
                                Provider request identifier to echo when
                                executing.
                            unsignedTransaction:
                              type: string
                              minLength: 1
                              description: >-
                                Base64-encoded Solana transaction to sign, when
                                wallet addresses are provided.
                            fromToken:
                              type: string
                              minLength: 1
                              description: Input token mint address.
                            toToken:
                              type: string
                              minLength: 1
                              description: Output token mint address.
                            fromAmount:
                              type: string
                              description: Input amount in the token's base units.
                            fromAmountUSD:
                              type: number
                              description: Estimated USD value of the input.
                            toAmount:
                              type: string
                              description: >-
                                Estimated output amount in the token's base
                                units.
                            toAmountUSD:
                              type: number
                              description: Estimated USD value of the output.
                            slippageBps:
                              type: integer
                              description: Estimated slippage in basis points.
                          required:
                            - quoteId
                            - routeName
                            - fromToken
                            - toToken
                            - fromAmount
                            - toAmount
                        description: Available swap quotes.
                    required:
                      - quotes
                  timestamp:
                    type: string
                required:
                  - success
                  - data
                  - timestamp
        '400':
          description: Invalid quote request.
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    enum:
                      - false
                    type: boolean
                  error:
                    type: object
                    properties:
                      code:
                        type: string
                      message:
                        type: string
                      requestId:
                        type: string
                    required:
                      - code
                      - message
                    additionalProperties: false
                  timestamp:
                    type: string
                required:
                  - success
                  - error
                  - timestamp
                additionalProperties: false
        '403':
          description: Quote request blocked by Sunrise policy.
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    enum:
                      - false
                    type: boolean
                  error:
                    type: object
                    properties:
                      code:
                        type: string
                      message:
                        type: string
                      requestId:
                        type: string
                    required:
                      - code
                      - message
                    additionalProperties: false
                  timestamp:
                    type: string
                required:
                  - success
                  - error
                  - timestamp
                additionalProperties: false
        '413':
          description: Quote request too large.
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    enum:
                      - false
                    type: boolean
                  error:
                    type: object
                    properties:
                      code:
                        type: string
                      message:
                        type: string
                      requestId:
                        type: string
                    required:
                      - code
                      - message
                    additionalProperties: false
                  timestamp:
                    type: string
                required:
                  - success
                  - error
                  - timestamp
                additionalProperties: false
        '429':
          description: >-
            Rate limited: verification_rate_limited means the local verification
            budget was exceeded; rate_limited means Unkey quota or upstream
            throttling.
          headers:
            X-Sunrise-RateLimit-Scope:
              description: >-
                Local per-key verification budget exceeded; back off requests
                for this key.
              schema:
                type: string
                enum:
                  - key
            Retry-After:
              description: Seconds to wait; present for local verification throttling.
              schema:
                type: integer
                example: 60
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    enum:
                      - false
                    type: boolean
                  error:
                    type: object
                    properties:
                      code:
                        enum:
                          - verification_rate_limited
                          - rate_limited
                        type: string
                      message:
                        type: string
                      requestId:
                        type: string
                    required:
                      - code
                      - message
                    additionalProperties: false
                  timestamp:
                    type: string
                required:
                  - success
                  - error
                  - timestamp
                additionalProperties: false
        '502':
          description: Sunrise unavailable.
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    enum:
                      - false
                    type: boolean
                  error:
                    type: object
                    properties:
                      code:
                        type: string
                      message:
                        type: string
                      requestId:
                        type: string
                    required:
                      - code
                      - message
                    additionalProperties: false
                  timestamp:
                    type: string
                required:
                  - success
                  - error
                  - timestamp
                additionalProperties: false
        default:
          description: Sunrise quote error.
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    enum:
                      - false
                    type: boolean
                  error:
                    type: object
                    properties:
                      code:
                        type: string
                      message:
                        type: string
                      requestId:
                        type: string
                    required:
                      - code
                      - message
                    additionalProperties: false
                  timestamp:
                    type: string
                required:
                  - success
                  - error
                  - timestamp
                additionalProperties: false
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````