> ## 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.

# Execute quote

> Submits a signed transaction using the quote ID, route name, and optional provider request ID returned by the quote endpoint. Poll this endpoint with the same request until the transaction status is CONFIRMED.



## OpenAPI

````yaml https://api.sunrise.xyz/openapi post /v1/execute
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/execute:
    post:
      tags:
        - Execution
      summary: Execute quote
      description: >-
        Submits a signed transaction using the quote ID, route name, and
        optional provider request ID returned by the quote endpoint. Poll this
        endpoint with the same request until the transaction status is
        CONFIRMED.
      operationId: executeQuote
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                signedTransaction:
                  type: string
                  minLength: 1
                  description: >-
                    Base64-encoded transaction signed by the connected Solana
                    wallet.


                    ```ts

                    import { getBase64Decoder, getBase64Encoder } from
                    "@solana/kit";


                    const [signed] = await
                    wallet.features["solana:signTransaction"].signTransaction({
                      account,
                      chain: "solana:mainnet",
                      transaction: new Uint8Array(getBase64Encoder().encode(quote.unsignedTransaction)),
                    });


                    const signedTransaction =
                    getBase64Decoder().decode(signed.signedTransaction);

                    ```
                quoteId:
                  type: string
                  minLength: 1
                  description: Quote identifier returned by the quote endpoint.
                routeName:
                  type: string
                  minLength: 1
                  description: Liquidity route returned with the quote.
                providerRequestId:
                  type: string
                  minLength: 1
                  description: Provider request identifier returned with the quote.
              required:
                - signedTransaction
              additionalProperties: false
        description: Signed quote execution parameters.
        required: true
      responses:
        '200':
          description: Transaction submission status.
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    enum:
                      - true
                    type: boolean
                  data:
                    type: object
                    properties:
                      txHash:
                        type: string
                        description: Submitted Solana transaction signature.
                      status:
                        enum:
                          - CONFIRMED
                          - SUBMITTED
                        type: string
                        description: Current transaction submission status.
                    required:
                      - txHash
                      - status
                  timestamp:
                    type: string
                required:
                  - success
                  - data
                  - timestamp
        '400':
          description: Invalid execution 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: Execution 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: Execution 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 execution 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

````