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

# Get Quote

> Returns available swap routes for the given sell and buy assets.



## OpenAPI

````yaml api-reference/openapi.json post /v1/quote
openapi: 3.1.0
info:
  title: dKit API
  description: Cross-chain swap aggregation API
  contact:
    name: API Support
    email: support@dkit.xyz
  version: v1
servers:
  - url: https://api.dkit.xyz
    description: Production API server
  - url: https://staging-api.dkit.xyz
    description: Staging API server
security: []
tags:
  - name: Core Endpoints
    description: Primary swap operations for quotes and tracking
  - name: Service Endpoints
    description: Specific transaction and integrations services
  - name: Data Endpoints
    description: Information endpoints for tokens, rates, and network data
externalDocs:
  description: API Documentation
  url: https://docs.dkit.xyz
paths:
  /v1/quote:
    post:
      tags:
        - Core Endpoints
      summary: Get Quote
      description: Returns available swap routes for the given sell and buy assets.
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/QuoteRequest'
            examples:
              default:
                value:
                  sellAsset: ETH.USDC-0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48
                  sellAmount: '150'
                  buyAsset: ETH.ETH
                  slippage: 5
                  affiliate: dz
                  affiliateFee: 88
                  includeTx: true
                  providers:
                    - THORCHAIN
                  sourceAddress: '0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb7'
                  destinationAddress: '0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb7'
                summary: Swap USDC to ETH using ThorChain
              USDC to ETH on ThorChain:
                value:
                  sellAsset: ETH.USDC-0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48
                  sellAmount: '150'
                  buyAsset: ETH.ETH
                  slippage: 5
                  affiliate: dz
                  affiliateFee: 88
                  includeTx: true
                  providers:
                    - THORCHAIN
                    - THORCHAIN_STREAMING
                summary: Swap USDC to ETH using ThorChain with streaming
              MayaChain Synthetic Swap:
                value:
                  sellAsset: MAYA.DASH/DASH
                  sellAmount: '150'
                  buyAsset: MAYA.CACAO
                  slippage: 5
                  affiliate: dz
                  affiliateFee: 88
                  includeTx: true
                  providers:
                    - MAYACHAIN
                summary: Swap synthetic DASH to CACAO on MayaChain
              Chainflip USDC to BTC:
                value:
                  sellAsset: ETH.USDC-0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48
                  sellAmount: '150'
                  buyAsset: BTC.BTC
                  slippage: 0.5
                  affiliate: dz
                  affiliateFee: 50
                  includeTx: true
                  providers:
                    - CHAINFLIP
                summary: Cross-chain swap USDC to BTC via Chainflip
              1inch USDC to WETH:
                value:
                  sellAsset: ETH.USDC-0XA0B86991C6218B36C1D19D4A2E9EB0CE3606EB48
                  sellAmount: '10'
                  buyAsset: ETH.WETH-0XC02AAA39B223FE8D0A0E5C4F27EAD9083C756CC2
                  slippage: 1
                  affiliate: dz
                  affiliateFee: 0
                  includeTx: true
                  providers:
                    - ONEINCH
                  sourceAddress: '0x4E71F9debEC9117F1FACc7eeB490758AF45806A7'
                  destinationAddress: '0x4E71F9debEC9117F1FACc7eeB490758AF45806A7'
                summary: Swap USDC to WETH on Ethereum using 1inch
              Jupiter SOL swap:
                value:
                  sellAsset: SOL.USDC-EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v
                  sellAmount: '150'
                  buyAsset: SOL.SOL-So11111111111111111111111111111111111111112
                  slippage: 0.5
                  affiliate: ELD
                  affiliateFee: 0
                  includeTx: true
                  providers:
                    - JUPITER
                  sourceAddress: FpBMY2s1uGN5ahb5CkhaNJdtsGfN4aqrpTgsNdHsvpUC
                  destinationAddress: FpBMY2s1uGN5ahb5CkhaNJdtsGfN4aqrpTgsNdHsvpUC
                summary: Swap USDC to SOL on Solana using Jupiter
              Cross-chain Jupiter to Chainflip:
                value:
                  sellAsset: SOL.JUP-JUPyiwrYJFskUPiHa7hkeR8VUtAeFoSYbKedZNsDvCN
                  sellAmount: '30'
                  buyAsset: ARB.USDC-0xaf88d065e77c8cC2239327C5EDb3A432268e5831
                  slippage: 1
                  sourceAddress: FWcTwCU9ohDn2eXiagCCdtzdLuDrX6nhy3PCVFfdGHd4
                  destinationAddress: '0x494447b317d2ee41d4c02600edb7c2193b2c9085'
                  affiliate: dz
                  affiliateFee: 88
                  includeTx: true
                  providers:
                    - JUPITER->CHAINFLIP
                summary: Cross-chain swap JUP to USDC using Jupiter and Chainflip
              1inch Arbitrum swap:
                value:
                  sellAsset: ARB.USDC-0XAF88D065E77C8CC2239327C5EDB3A432268E5831
                  sellAmount: '10'
                  buyAsset: ARB.ETH
                  slippage: 1
                  affiliate: dz
                  affiliateFee: 0
                  includeTx: true
                  providers:
                    - ONEINCH
                summary: Swap USDC to ETH on Arbitrum using 1inch
              1inch Avalanche swap:
                value:
                  sellAsset: AVAX.USDC-0XB97EF9EF8734C71904D8002F8B6BC66DD9C48A6E
                  sellAmount: '10'
                  buyAsset: AVAX.AVAX
                  slippage: 1
                  affiliate: dz
                  affiliateFee: 0
                  includeTx: true
                  providers:
                    - ONEINCH
                summary: Swap USDC to AVAX on Avalanche using 1inch
      responses:
        '200':
          description: Successful quote response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/QuoteResponse'
              examples:
                ThorChain quote response:
                  value:
                    quoteId: a1b2c3d4-e5f6-7890-abcd-ef1234567890
                    routes:
                      - providers:
                          - THORCHAIN
                        sellAsset: ETH.USDC-0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48
                        sellAmount: '150'
                        buyAsset: ETH.ETH
                        expectedBuyAmount: '43567890123456789'
                        expectedBuyAmountMaxSlippage: '41389345617284210'
                        fees:
                          - type: NETWORK
                            asset: ETH.ETH
                            amount: '2000000000000000'
                            chain: ETH
                            protocol: THORCHAIN
                          - type: AFFILIATE
                            asset: ETH.ETH
                            amount: '383396073076470'
                            chain: ETH
                            protocol: THORCHAIN
                        estimatedTime:
                          inbound: 600
                          swap: 10
                          outbound: 600
                          total: 1210
                        meta:
                          priceImpact: 0.05
                          slippagePercent: 5
                  summary: ThorChain USDC to ETH swap quote
                1inch quote response:
                  value:
                    quoteId: c2b8e017-c695-44fe-adbb-39db625fcee4
                    routes:
                      - providers:
                          - ONEINCH
                        sellAsset: ARB.USDC-0XAF88D065E77C8CC2239327C5EDB3A432268E5831
                        sellAmount: '10'
                        buyAsset: ARB.ARB-0X912CE59144191C1204E64559FE8253A0E49E6548
                        expectedBuyAmount: '28995421060263166005'
                        expectedBuyAmountMaxSlippage: '27545650000000000000'
                        sourceAddress: '0x817bFA97Cc8E5Bfa499D401f43E3087B07AE96f9'
                        destinationAddress: '0x817bFA97Cc8E5Bfa499D401f43E3087B07AE96f9'
                        fees:
                          - type: AFFILIATE
                            amount: '88000'
                            asset: >-
                              ARB.USDC-0XAF88D065E77C8CC2239327C5EDB3A432268E5831
                            chain: ARB
                            protocol: ONEINCH
                        transaction:
                          to: '0x111111125421ca6dc452d289314280a0f8842a65'
                          from: '0x817bfa97cc8e5bfa499d401f43e3087b07ae96f9'
                          value: '0'
                          data: >-
                            0x07ed2379000000000000000000000000de9e4fe32b049f821c7f3e9802381aa470ffca73...
                          chain: ARB
                        estimatedTime:
                          inbound: 0
                          swap: 30
                          outbound: 0
                          total: 30
                        legs:
                          - provider: ONEINCH
                            sellAsset: >-
                              ARB.USDC-0XAF88D065E77C8CC2239327C5EDB3A432268E5831
                            sellAmount: '10'
                            buyAsset: ARB.ARB-0X912CE59144191C1204E64559FE8253A0E49E6548
                            buyAmount: '28995421060263166005'
                            buyAmountMaxSlippage: '27545650000000000000'
                            fees:
                              - type: AFFILIATE
                                amount: '88000'
                                asset: >-
                                  ARB.USDC-0XAF88D065E77C8CC2239327C5EDB3A432268E5831
                                chain: ARB
                                protocol: ONEINCH
                  summary: 1inch USDC to ARB swap on Arbitrum
                Cross-chain quote response:
                  value:
                    quoteId: d4e5f6a7-b8c9-0123-4567-890abcdef123
                    routes:
                      - providers:
                          - JUPITER->CHAINFLIP
                        sellAsset: SOL.JUP-JUPyiwrYJFskUPiHa7hkeR8VUtAeFoSYbKedZNsDvCN
                        sellAmount: '30'
                        buyAsset: ARB.USDC-0xaf88d065e77c8cC2239327C5EDb3A432268e5831
                        expectedBuyAmount: '25432100'
                        expectedBuyAmountMaxSlippage: '25177779'
                        sourceAddress: FWcTwCU9ohDn2eXiagCCdtzdLuDrX6nhy3PCVFfdGHd4
                        destinationAddress: '0x494447b317d2ee41d4c02600edb7c2193b2c9085'
                        fees:
                          - type: NETWORK
                            amount: '5000'
                            asset: SOL.SOL
                            chain: SOL
                            protocol: JUPITER
                          - type: LIQUIDITY
                            amount: '10000'
                            asset: >-
                              ARB.USDC-0xaf88d065e77c8cC2239327C5EDb3A432268e5831
                            chain: ARB
                            protocol: CHAINFLIP
                          - type: AFFILIATE
                            amount: '223900'
                            asset: >-
                              ARB.USDC-0xaf88d065e77c8cC2239327C5EDb3A432268e5831
                            chain: ARB
                            protocol: CHAINFLIP
                        estimatedTime:
                          inbound: 30
                          swap: 180
                          outbound: 600
                          total: 810
                        legs:
                          - provider: JUPITER
                            sellAsset: >-
                              SOL.JUP-JUPyiwrYJFskUPiHa7hkeR8VUtAeFoSYbKedZNsDvCN
                            sellAmount: '30'
                            buyAsset: >-
                              SOL.USDC-EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v
                            buyAmount: '27000000'
                            fees:
                              - type: NETWORK
                                amount: '5000'
                                asset: SOL.SOL
                                chain: SOL
                                protocol: JUPITER
                          - provider: CHAINFLIP
                            sellAsset: >-
                              SOL.USDC-EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v
                            sellAmount: '27000000'
                            buyAsset: >-
                              ARB.USDC-0xaf88d065e77c8cC2239327C5EDb3A432268e5831
                            buyAmount: '25432100'
                            buyAmountMaxSlippage: '25177779'
                            fees:
                              - type: LIQUIDITY
                                amount: '10000'
                                asset: >-
                                  ARB.USDC-0xaf88d065e77c8cC2239327C5EDb3A432268e5831
                                chain: ARB
                                protocol: CHAINFLIP
                              - type: AFFILIATE
                                amount: '223900'
                                asset: >-
                                  ARB.USDC-0xaf88d065e77c8cC2239327C5EDb3A432268e5831
                                chain: ARB
                                protocol: CHAINFLIP
                  summary: Cross-chain JUP to USDC swap using Jupiter and Chainflip
        '400':
          description: >-
            Bad Request - The request was invalid or cannot be served. Check the
            error message for details.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ValidationError'
        '500':
          description: Internal Server Error - An unexpected error occurred on the server.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/InternalServerError'
components:
  schemas:
    QuoteRequest:
      type: object
      properties:
        sellAsset:
          type: string
          description: Asset to sell
        buyAsset:
          type: string
          description: Asset to buy
        sellAmount:
          type: string
        providers:
          type: array
          items:
            type: string
            enum:
              - THORCHAIN
              - THORCHAIN_STREAMING
              - CHAINFLIP
              - CHAINFLIP_STREAMING
              - MAYACHAIN
              - MAYACHAIN_STREAMING
              - ONEINCH
              - JUPITER
              - GARDEN
              - JUPITER->CHAINFLIP
              - ONEINCH->CHAINFLIP
              - CHAINFLIP->ONEINCH
            description: List of providers to use
        sourceAddress:
          type: string
          description: Address to send asset from
        destinationAddress:
          type: string
          description: Address to send asset to
        slippage:
          type: number
          minimum: 0
          maximum: 100
          description: >-
            Slippage tolerance in percentage (e.g., 0.5 = 0.5%, 3 = 3%). Rounded
            to bps internally.
        affiliate:
          type: string
          description: Affiliate thorname
        affiliateFee:
          type: number
        includeTx:
          type: boolean
          description: Set to true to include an transaction object (EVM only)
      required:
        - sellAsset
        - buyAsset
        - sellAmount
        - slippage
    QuoteResponse:
      type: object
      properties:
        quoteId:
          type: string
          description: Quote ID
        routes:
          type: array
          items:
            $ref: '#/components/schemas/QuoteResponseRoute'
        error:
          type: string
          description: Error message
        providerErrors:
          type: array
          items:
            type: object
            properties:
              provider:
                type: string
                enum:
                  - THORCHAIN
                  - THORCHAIN_STREAMING
                  - CHAINFLIP
                  - CHAINFLIP_STREAMING
                  - MAYACHAIN
                  - MAYACHAIN_STREAMING
                  - ONEINCH
                  - JUPITER
                  - GARDEN
                  - JUPITER->CHAINFLIP
                  - ONEINCH->CHAINFLIP
                  - CHAINFLIP->ONEINCH
                description: Provider that returned the error
              errorCode:
                type: string
                enum:
                  - unknownError
                  - tradingHalted
                  - providerQuoteTimeout
                  - tokenNotFound
                  - unsupportedChainId
                  - invalidSellAmount
                  - crossChainNotSupported
                  - insufficientLiquidity
                  - swapAmountTooSmall
                  - quoteNotFound
                  - dexAggregationNotSupported
                  - httpError
                  - missingChainflipBuyAsset
                  - missingChainflipBuyChain
                  - missingChainflipSellAsset
                  - missingChainflipSellChain
                description: Standardized error code identifying the type of error
              message:
                type: string
                description: Human-readable error message
            description: Provider-specific error information
          description: List of errors from different providers
      required:
        - quoteId
        - routes
    ValidationError:
      type: object
      properties:
        type:
          type: string
          enum:
            - /errors/validation-error
        title:
          type: string
          enum:
            - Validation Error
        status:
          type: number
          enum:
            - 400
        detail:
          type: string
        instance:
          type: string
        timestamp:
          type: string
          format: date-time
        traceId:
          type: string
        errors:
          type: array
          items:
            type: object
            properties:
              field:
                type: string
              message:
                type: string
              code:
                type: string
            required:
              - message
      required:
        - type
        - title
        - status
        - detail
    InternalServerError:
      type: object
      properties:
        type:
          type: string
          enum:
            - /errors/internal-server-error
        title:
          type: string
          enum:
            - Internal Server Error
        status:
          type: number
          enum:
            - 500
        detail:
          type: string
          default: An unexpected error occurred
        instance:
          type: string
        timestamp:
          type: string
          format: date-time
        traceId:
          type: string
      required:
        - type
        - title
        - status
    QuoteResponseRoute:
      type: object
      properties:
        providers:
          type: array
          items:
            type: string
            enum:
              - THORCHAIN
              - THORCHAIN_STREAMING
              - CHAINFLIP
              - CHAINFLIP_STREAMING
              - MAYACHAIN
              - MAYACHAIN_STREAMING
              - ONEINCH
              - JUPITER
              - GARDEN
              - JUPITER->CHAINFLIP
              - ONEINCH->CHAINFLIP
              - CHAINFLIP->ONEINCH
        sellAsset:
          type: string
          description: Asset to sell
        sellAmount:
          type: string
          description: Sell amount
        buyAsset:
          type: string
          description: Asset to buy
        expectedBuyAmount:
          type: string
          description: Expected Buy amount
        expectedBuyAmountMaxSlippage:
          type: string
          description: Expected Buy amount max slippage
        sourceAddress:
          type: string
          description: Source address
        destinationAddress:
          type: string
          description: Destination address
        targetAddress:
          type: string
          description: Target address
        inboundAddress:
          type: string
          description: Inbound address
        expiration:
          type: string
          description: Expiration
        memo:
          type: string
          description: Memo
        fees:
          $ref: '#/components/schemas/Fees'
        tx:
          anyOf:
            - type: object
              properties:
                chain_id:
                  type: number
                gas_limit:
                  type: string
                to:
                  type: string
                  description: Address of the recipient
                from:
                  type: string
                  description: Address of the sender
                value:
                  type: string
                  description: Value to send
                data:
                  type: string
                  description: Data to send
              required:
                - to
                - from
                - value
                - data
            - type: object
              properties:
                msgs:
                  type: array
                  items:
                    type: object
                    properties:
                      type:
                        type: string
                        description: Message type
                      value:
                        type: object
                        properties:
                          sender:
                            type: string
                          from_address:
                            type: string
                          to_address:
                            type: string
                          amount:
                            anyOf:
                              - type: string
                              - type: array
                                items:
                                  type: object
                                  properties:
                                    denom:
                                      type: string
                                    amount:
                                      type: string
                                  required:
                                    - denom
                                    - amount
                          memo:
                            type: string
                          delegator_address:
                            type: string
                          validator_address:
                            type: string
                          contract:
                            type: string
                          msg:
                            type: string
                          funds:
                            type: array
                            items:
                              type: object
                              properties:
                                denom:
                                  type: string
                                amount:
                                  type: string
                              required:
                                - denom
                                - amount
                        description: Message value object
                    required:
                      - type
                      - value
                fee:
                  type: object
                  properties:
                    amount:
                      type: array
                      items:
                        type: object
                        properties:
                          denom:
                            type: string
                          amount:
                            type: string
                        required:
                          - denom
                          - amount
                    gas:
                      type: string
                  required:
                    - amount
                    - gas
                memo:
                  type: string
                  description: Transaction memo
              required:
                - msgs
                - fee
            - type: string
        estimatedTime:
          $ref: '#/components/schemas/EstimatedTime'
        totalSlippageBps:
          type: number
          description: Total slippage in bps
        legs:
          type: array
          items:
            type: object
            properties:
              provider:
                type: string
                enum:
                  - THORCHAIN
                  - THORCHAIN_STREAMING
                  - CHAINFLIP
                  - CHAINFLIP_STREAMING
                  - MAYACHAIN
                  - MAYACHAIN_STREAMING
                  - ONEINCH
                  - JUPITER
                  - GARDEN
                  - JUPITER->CHAINFLIP
                  - ONEINCH->CHAINFLIP
                  - CHAINFLIP->ONEINCH
              sellAsset:
                type: string
                description: Asset to sell
              sellAmount:
                type: string
                description: Sell amount
              buyAsset:
                type: string
                description: Asset to buy
              buyAmount:
                type: string
                description: Buy amount
              buyAmountMaxSlippage:
                type: string
                description: Buy amount max slippage
              fees:
                $ref: '#/components/schemas/Fees'
            required:
              - provider
              - sellAsset
              - sellAmount
              - buyAsset
              - buyAmount
              - buyAmountMaxSlippage
        warnings:
          type: array
          items:
            type: object
            properties:
              code:
                type: string
                enum:
                  - highSlippage
                  - highPriceImpact
                  - lowLiquidity
                  - exceedsRecommendedSlippage
              display:
                type: string
              tooltip:
                type: string
            required:
              - code
              - display
        meta:
          type: object
          properties:
            priceImpact:
              type: number
              description: Price impact
            assets:
              type: array
              items:
                type: object
                properties:
                  asset:
                    type: string
                    description: Asset name
                  price:
                    type: number
                    description: Price in USD
                  image:
                    type: string
                    description: Asset image
                required:
                  - asset
                  - price
                  - image
            approvalAddress:
              type: string
              description: Approval address for swap
            streamingInterval:
              type: number
            maxStreamingQuantity:
              type: number
            tags:
              type: array
              items:
                type: string
                enum:
                  - CHEAPEST
                  - FASTEST
                  - RECOMMENDED
            affiliate:
              type: string
              description: Affiliate code
            affiliateFee:
              type: number
              description: Affiliate fee in basis points
            orderId:
              type: string
            typedData:
              type: object
              properties:
                domain:
                  type: object
                  properties:
                    name:
                      type: string
                    version:
                      type: string
                    chainId:
                      type: string
                    verifyingContract:
                      type: string
                  required:
                    - name
                    - version
                    - chainId
                    - verifyingContract
                message:
                  type: object
                  properties:
                    amount:
                      type: string
                    redeemer:
                      type: string
                    secretHash:
                      type: string
                    timelock:
                      type: string
                  required:
                    - amount
                    - redeemer
                    - secretHash
                    - timelock
                primaryType:
                  type: string
                types:
                  type: object
                  properties:
                    EIP712Domain:
                      type: array
                      items:
                        type: object
                        properties:
                          name:
                            type: string
                          type:
                            type: string
                        required:
                          - name
                          - type
                    Initiate:
                      type: array
                      items:
                        type: object
                        properties:
                          name:
                            type: string
                          type:
                            type: string
                        required:
                          - name
                          - type
                  required:
                    - EIP712Domain
                    - Initiate
              required:
                - domain
                - message
                - primaryType
                - types
          required:
            - tags
      required:
        - providers
        - sellAsset
        - sellAmount
        - buyAsset
        - expectedBuyAmount
        - expectedBuyAmountMaxSlippage
        - sourceAddress
        - destinationAddress
        - fees
        - totalSlippageBps
        - legs
        - warnings
        - meta
    Fees:
      type: array
      items:
        type: object
        properties:
          type:
            type: string
            enum:
              - liquidity
              - network
              - inbound
              - outbound
              - affiliate
              - tax
              - priority
          amount:
            type: string
          asset:
            type: string
          chain:
            type: string
            enum:
              - ARB
              - AVAX
              - BASE
              - BSC
              - BTC
              - BCH
              - GAIA
              - DASH
              - DOGE
              - ETH
              - FIAT
              - KUJI
              - LTC
              - MAYA
              - OP
              - DOT
              - FLIP
              - MATIC
              - XRD
              - THOR
              - SOL
              - ZEC
              - HYPE
          protocol:
            type: string
            enum:
              - THORCHAIN
              - THORCHAIN_STREAMING
              - CHAINFLIP
              - CHAINFLIP_STREAMING
              - MAYACHAIN
              - MAYACHAIN_STREAMING
              - ONEINCH
              - JUPITER
              - GARDEN
              - JUPITER->CHAINFLIP
              - ONEINCH->CHAINFLIP
              - CHAINFLIP->ONEINCH
        required:
          - type
          - amount
          - asset
          - chain
          - protocol
    EstimatedTime:
      type: object
      properties:
        inbound:
          type: number
          description: Time to receive inbound asset in seconds
        swap:
          type: number
          description: Time to swap assets in seconds
        outbound:
          type: number
          description: Time to receive outbound asset in seconds
        total:
          type: number
          description: Total time in seconds
      required:
        - total

````