find_apisBrowse and filter every API in the catalog.
get_api_artifactsOne API's artifacts, grouped by type.
get_openapiThe primary OpenAPI for this API.
find_similar_apisAPIs that look like this one.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This API

curl "https://apis.io/api/v1/apis/debridge-com:debridge-com-single-chain-swap-api"

All apis

curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

openapi: 3.2.0
info:
  title: deBridge Liquidity Network (DLN) single chain swap API
  description: 'A turnkey solution for a high-performance cross-chain trading


    Quick Start Guide'
  version: 1.0.0
  contact: {}
  termsOfService: https://app.debridge.finance/assets/files/DLN-TermsOfService.pdf
servers:
- url: https://dln.debridge.finance
tags:
- name: single chain swap
paths:
  /v1.0/chain/transaction:
    get:
      operationId: SingleSwapControllerV10_getChainTransaction
      parameters:
      - name: chainId
        required: true
        in: query
        description: An ID of a chain, a chain where the swap must be performed
        example:
          '1':
            summary: Ethereum
            value: '1'
          '10':
            summary: Optimism
            value: '10'
          '56':
            summary: BNB Chain
            value: '56'
          '137':
            summary: Polygon
            value: '137'
          '4663':
            summary: Robinhood
            value: '4663'
          '5042':
            summary: Arc
            value: '5042'
          '8453':
            summary: Base
            value: '8453'
          '42161':
            summary: Arbitrum One
            value: '42161'
          '43114':
            summary: Avalanche
            value: '43114'
          '59144':
            summary: Linea
            value: '59144'
          '7565164':
            summary: Solana
            value: '7565164'
          '100000013':
            summary: Story
            value: '100000013'
          '100000019':
            summary: Cronos
            value: '100000019'
          '100000022':
            summary: HyperEVM
            value: '100000022'
          '100000026':
            summary: Tron
            value: '100000026'
          '100000027':
            summary: Sei
            value: '100000027'
          '100000029':
            summary: Injective
            value: '100000029'
          '100000030':
            summary: Monad
            value: '100000030'
          '100000031':
            summary: Megaeth
            value: '100000031'
        schema:
          type: string
          enum:
          - '1'
          - '10'
          - '56'
          - '137'
          - '4663'
          - '5042'
          - '8453'
          - '42161'
          - '43114'
          - '59144'
          - '7565164'
          - '100000013'
          - '100000019'
          - '100000022'
          - '100000026'
          - '100000027'
          - '100000029'
          - '100000030'
          - '100000031'
      - name: tokenIn
        required: true
        in: query
        description: An address of an input token to swap
        example:
          usdt:
            summary: USDT token on Ethereum
            value: '0xdAC17F958D2ee523a2206206994597C13D831ec7'
          native:
            summary: Native coin (e.g., ETH on Ethereum, BNB on BNB Chain)
            value: '0x0000000000000000000000000000000000000000'
          native_solana:
            summary: Native token on SOLANA
            value: '11111111111111111111111111111111'
          usdc_solana:
            summary: USDC token on SOLANA
            value: EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v
        schema:
          type: string
      - name: tokenInAmount
        required: true
        in: query
        description: An amount of input tokens to swap
        example:
          usdt:
            summary: 50 USDT (decimals=6)
            value: 50000000
          busd:
            summary: 50 BUSD (decimals=18)
            value: 50000000000000000000
          eth:
            summary: 0.1 ETH (decimals=18)
            value: 100000000000000000
          sol:
            summary: 0.1 SOL (decimals=9)
            value: '100000000'
          max:
            summary: Use a maximum possible tokenInAmount calculated upon request
            value: max
          auto:
            summary: Use a recommended tokenInAmount calculated upon request
            value: auto
        schema:
          type: string
      - name: slippage
        required: false
        in: query
        description: A slippage constraint (in %) is a safeguard during swaps (on both source and destination chains, if applicable). It is also used to calculate the minimum possible outcome during estimation. This property can be set to "auto" so that the API will suggest the best possible slippage.
        schema:
          default: auto
          type: string
      - name: tokenOut
        required: true
        in: query
        description: An address of a target token.
        example:
          usdc:
            summary: USDC token on the Ethereum chain
            value: '0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48'
          native:
            summary: Native coin (e.g., ETH on Ethereum, BNB on BNB Chain)
            value: '0x0000000000000000000000000000000000000000'
          usdc_solana:
            summary: USDC token on SOLANA
            value: EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v
        schema:
          type: string
      - name: tokenOutAmount
        required: false
        in: query
        description: Amount of the target asset the market maker expects to receive upon order fulfillment. This property can be set to "auto" so that the API will suggest the best possible outcome of the order based on current market conditions and the protocol fees, keeping the order in a reasonable-to-fulfill state
        example:
          recommended:
            summary: Use a recommended tokenOutAmount calculated upon request (default)
            value: auto
          eth:
            summary: 0.1 ETH (decimals=18)
            value: '100000000000000000'
          usdt:
            summary: 50 USDT (decimals=6)
            value: '50000000'
          busd:
            summary: 50 BUSD (decimals=18)
            value: '50000000000000000000'
          usdc:
            summary: 50 USDC (decimals=6)
            value: '50000000'
        schema:
          type: string
      - name: tokenOutRecipient
        required: true
        in: query
        schema:
          type: string
      - name: affiliateFeePercent
        required: false
        in: query
        description: "\n The share of the input amount to be distributed to the `affiliateFeeRecipient` (if given) address as an affiliate fee.\n \n\n \nIf you are building on top of deSwap, you might want to take a small fee relative to the amount of a token a user provides for a swap. To achieve this, set this parameter to a desired % (e.g. `0.1` stands for 0.1%; the max value is `10` which stands for 10% of `srcAmountInParam`) and specify your wallet address in the `affiliateFeeRecipient` parameter.\n \n\n \nFor example, setting this parameter to `0.1` means that when the user gives 5000 USDT then you will receive 5 USDT immediately after transaction is being confirmed.\n       "
        example:
          no_fee:
            summary: No affiliate fee
            value: 0
          fee_0.1:
            summary: Set 0.1% affiliate fee
            value: 0.1
          fee_1:
            summary: Set 1% affiliate fee
            value: 1
        schema:
          type: number
      - name: affiliateFeeRecipient
        required: false
        in: query
        description: An address (on an origin chain) that will receive affiliate fees according to the `affiliateFeePercent` parameter. For solana affiliate fee you have to create & provide Jupiter's referral key (https://referral.jup.ag/dashboard).
        schema:
          type: string
      - name: senderAddress
        required: false
        in: query
        description: Address (on the source chain) who submits input tokens for a cross-chain swap
        schema:
          type: string
      - name: srcChainPriorityLevel
        required: false
        in: query
        description: Configures the priority level for transaction fee estimation.
        schema:
          default: normal
          type: string
          enum:
          - normal
          - aggressive
      - name: referralCode
        required: false
        in: query
        schema:
          type: number
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ChainTransactionResponseV10'
        '400':
          description: "The request is malformed, has missing parameters, or has incorrect or contradicting parameter values. Possible error ids: \n  \n        - INVALID_QUERY_PARAMETERS\n  \n  \n        - AFFILIATE_FEE_PERCENT_NOT_SET\n  \n  \n        - AFFILIATE_FEE_RECIPIENT_NOT_SET\n  \n  \n        - UNSUPPORTED_TOKEN_IN\n  \n  \n        - UNSUPPORTED_TOKEN_OUT\n  \n"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BadRequestResponse'
        '500':
          description: "The server has encountered a situation it does not know how to handle. Possible error ids: \n  \n        - INTERNAL_SERVER_ERROR\n  \n  \n        - INTERNAL_SDK_ERROR\n  \n"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/InternalServerErrorResponse'
      tags:
      - single chain swap
      summary: Single swap controller V10 get chain transaction
      x-summary-source: derived
  /v1.0/chain/estimation:
    get:
      operationId: SingleSwapControllerV10_getChainEstimation
      parameters:
      - name: chainId
        required: true
        in: query
        description: An ID of a chain, a chain where the swap must be performed
        example:
          '1':
            summary: Ethereum
            value: '1'
          '10':
            summary: Optimism
            value: '10'
          '56':
            summary: BNB Chain
            value: '56'
          '137':
            summary: Polygon
            value: '137'
          '4663':
            summary: Robinhood
            value: '4663'
          '5042':
            summary: Arc
            value: '5042'
          '8453':
            summary: Base
            value: '8453'
          '42161':
            summary: Arbitrum One
            value: '42161'
          '43114':
            summary: Avalanche
            value: '43114'
          '59144':
            summary: Linea
            value: '59144'
          '7565164':
            summary: Solana
            value: '7565164'
          '100000013':
            summary: Story
            value: '100000013'
          '100000019':
            summary: Cronos
            value: '100000019'
          '100000022':
            summary: HyperEVM
            value: '100000022'
          '100000026':
            summary: Tron
            value: '100000026'
          '100000027':
            summary: Sei
            value: '100000027'
          '100000029':
            summary: Injective
            value: '100000029'
          '100000030':
            summary: Monad
            value: '100000030'
          '100000031':
            summary: Megaeth
            value: '100000031'
        schema:
          type: string
          enum:
          - '1'
          - '10'
          - '56'
          - '137'
          - '4663'
          - '5042'
          - '8453'
          - '42161'
          - '43114'
          - '59144'
          - '7565164'
          - '100000013'
          - '100000019'
          - '100000022'
          - '100000026'
          - '100000027'
          - '100000029'
          - '100000030'
          - '100000031'
      - name: tokenIn
        required: true
        in: query
        description: An address of an input token to swap
        example:
          usdt:
            summary: USDT token on Ethereum
            value: '0xdAC17F958D2ee523a2206206994597C13D831ec7'
          native:
            summary: Native coin (e.g., ETH on Ethereum, BNB on BNB Chain)
            value: '0x0000000000000000000000000000000000000000'
          native_solana:
            summary: Native token on SOLANA
            value: '11111111111111111111111111111111'
          usdc_solana:
            summary: USDC token on SOLANA
            value: EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v
        schema:
          type: string
      - name: tokenInAmount
        required: true
        in: query
        description: An amount of input tokens to swap
        example:
          usdt:
            summary: 50 USDT (decimals=6)
            value: 50000000
          busd:
            summary: 50 BUSD (decimals=18)
            value: 50000000000000000000
          eth:
            summary: 0.1 ETH (decimals=18)
            value: 100000000000000000
          sol:
            summary: 0.1 SOL (decimals=9)
            value: '100000000'
          auto:
            summary: Use a recommended tokenInAmount calculated upon request
            value: auto
        schema:
          type: string
      - name: slippage
        required: false
        in: query
        description: A slippage constraint (in %) is a safeguard during swaps (on both source and destination chains, if applicable). It is also used to calculate the minimum possible outcome during estimation. This property can be set to "auto" so that the API will suggest the best possible slippage.
        schema:
          default: auto
          type: string
      - name: tokenOut
        required: true
        in: query
        description: An address of a target token.
        example:
          usdc:
            summary: USDC token on the Ethereum chain
            value: '0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48'
          native:
            summary: Native coin (e.g., ETH on Ethereum, BNB on BNB Chain)
            value: '0x0000000000000000000000000000000000000000'
          usdc_solana:
            summary: USDC token on SOLANA
            value: EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v
        schema:
          type: string
      - name: tokenOutAmount
        required: false
        in: query
        description: Amount of the target asset the market maker expects to receive upon order fulfillment. This property can be set to "auto" so that the API will suggest the best possible outcome of the order based on current market conditions and the protocol fees, keeping the order in a reasonable-to-fulfill state
        example:
          recommended:
            summary: Use a recommended tokenOutAmount calculated upon request (default)
            value: auto
          eth:
            summary: 0.1 ETH (decimals=18)
            value: '100000000000000000'
          usdt:
            summary: 50 USDT (decimals=6)
            value: '50000000'
          busd:
            summary: 50 BUSD (decimals=18)
            value: '50000000000000000000'
          usdc:
            summary: 50 USDC (decimals=6)
            value: '50000000'
        schema:
          type: string
      - name: affiliateFeePercent
        required: false
        in: query
        description: "\n The share of the input amount to be distributed to the `affiliateFeeRecipient` (if given) address as an affiliate fee.\n \n\n \nIf you are building on top of deSwap, you might want to take a small fee relative to the amount of a token a user provides for a swap. To achieve this, set this parameter to a desired % (e.g. `0.1` stands for 0.1%; the max value is `10` which stands for 10% of `srcAmountInParam`) and specify your wallet address in the `affiliateFeeRecipient` parameter.\n \n\n \nFor example, setting this parameter to `0.1` means that when the user gives 5000 USDT then you will receive 5 USDT immediately after transaction is being confirmed.\n       "
        example:
          no_fee:
            summary: No affiliate fee
            value: 0
          fee_0.1:
            summary: Set 0.1% affiliate fee
            value: 0.1
          fee_1:
            summary: Set 1% affiliate fee
            value: 1
        schema:
          type: number
      - name: affiliateFeeRecipient
        required: false
        in: query
        description: An address (on an origin chain) that will receive affiliate fees according to the `affiliateFeePercent` parameter.
        schema:
          type: string
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ChainEstimationResponseV10'
        '400':
          description: "The request is malformed, has missing parameters, or has incorrect or contradicting parameter values. Possible error ids: \n  \n        - INVALID_QUERY_PARAMETERS\n  \n  \n        - AFFILIATE_FEE_PERCENT_NOT_SET\n  \n  \n        - AFFILIATE_FEE_RECIPIENT_NOT_SET\n  \n  \n        - UNSUPPORTED_TOKEN_IN\n  \n  \n        - UNSUPPORTED_TOKEN_OUT\n  \n"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BadRequestResponse'
        '500':
          description: "The server has encountered a situation it does not know how to handle. Possible error ids: \n  \n        - INTERNAL_SERVER_ERROR\n  \n  \n        - INTERNAL_SDK_ERROR\n  \n"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/InternalServerErrorResponse'
      tags:
      - single chain swap
      summary: Single swap controller V10 get chain estimation
      x-summary-source: derived
components:
  schemas:
    SwapAdapterComparisonDto:
      type: object
      properties:
        name:
          type: string
          description: Name of the swap aggregator
        amount:
          type: string
          description: Amount out from this aggregator
        approximateUsdValue:
          type: number
          description: Approximate USD value of the amount out from this aggregator
        priceDrop:
          type: number
          description: Price drop compared to the best aggregator in basis points (bps)
        imageUrl:
          type: string
          description: Image URL of the swap aggregator
        gas:
          type: string
          description: Gas units required to execute the swap via this aggregator
        gasUsdValue:
          type: number
          description: Approximate USD cost of the gas required to execute the swap
        finalAmountUsdValue:
          type: number
          description: Approximate USD value of the amount out minus gas cost (approximateUsdValue - gasUsdValue)
      required:
      - name
      - amount
      - approximateUsdValue
      - priceDrop
      - imageUrl
    ChainEstimationResponseV10:
      type: object
      properties:
        estimation:
          $ref: '#/components/schemas/SingleChainEstimation'
      required:
      - estimation
    TokenWithMinAmount:
      type: object
      properties:
        address:
          type: string
        name:
          type: string
        symbol:
          type: string
        decimals:
          type: integer
        amount:
          type: string
        minAmount:
          type: string
        approximateUsdValue:
          type: number
      required:
      - address
      - name
      - symbol
      - decimals
      - amount
      - minAmount
    InternalServerErrorResponse:
      type: object
      properties:
        errorCode:
          type: integer
        errorId:
          type: string
          enum:
          - INTERNAL_SERVER_ERROR
          - INTERNAL_SDK_ERROR
        errorMessage:
          type: string
        errorPayload:
          type: object
      required:
      - errorCode
      - errorId
      - errorMessage
      - errorPayload
    TokenWithUsdValue:
      type: object
      properties:
        address:
          type: string
        name:
          type: string
        symbol:
          type: string
        decimals:
          type: integer
        amount:
          type: string
        approximateUsdValue:
          type: number
      required:
      - address
      - name
      - symbol
      - decimals
      - amount
    ChainTransactionResponseV10:
      type: object
      properties:
        tokenIn:
          $ref: '#/components/schemas/TokenWithUsdValue'
        tokenOut:
          $ref: '#/components/schemas/TokenWithMinAmount'
        slippage:
          type: number
        recommendedSlippage:
          type: number
        protocolFee:
          type: string
        protocolFeeApproximateUsdValue:
          type: string
        estimatedTransactionFee:
          description: Estimated transaction fee (gasCost) for the transaction
          allOf:
          - $ref: '#/components/schemas/FeeInfo'
        costsDetails:
          description: Costs details
          type: array
          items:
            $ref: '#/components/schemas/CostsDetailsProperty'
        comparedAggregators:
          description: Comparison data for all swap aggregators that were compared
          type: array
          items:
            $ref: '#/components/schemas/SwapAdapterComparisonDto'
        tx:
          description: Transaction data. For max-amount requests, includes gasLimit, gasPrice, and estimatedTransactionFee.
          allOf:
          - $ref: '#/components/schemas/Tx'
      required:
      - tokenIn
      - tokenOut
      - slippage
      - recommendedSlippage
      - comparedAggregators
      - tx
    BadRequestResponse:
      type: object
      properties:
        errorCode:
          type: integer
        errorId:
          type: string
          enum:
          - INVALID_QUERY_PARAMETERS
          - SOURCE_AND_DESTINATION_CHAINS_ARE_EQUAL
          - INCLUDED_GAS_FEE_NOT_COVERED_BY_INPUT_AMOUNT
          - INCLUDED_GAS_FEE_CANNOT_BE_ESTIMATED_FOR_TRANSACTION_BUNDLE
        errorMessage:
          type: string
        errorPayload:
          type: object
      required:
      - errorCode
      - errorId
      - errorMessage
      - errorPayload
    FeeInfo:
      type: object
      properties:
        total:
          type: string
        details:
          $ref: '#/components/schemas/FeeDetails'
        approximateUsdValue:
          type: number
          description: USD approximate value of the transaction fee
      required:
      - total
      - details
    Tx:
      type: object
      properties:
        to:
          type: string
        data:
          type: string
        value:
          type: string
      required:
      - to
      - data
      - value
    FeeDetails:
      type: object
      properties:
        giveOrderState:
          type: string
        giveOrderWallet:
          type: string
        nonceMaster:
          type: string
        txFee:
          type: string
        priorityFee:
          type: string
        gasLimit:
          type: string
        gasPrice:
          type: string
        baseFee:
          type: string
        maxFeePerGas:
          type: string
        maxPriorityFeePerGas:
          type: string
    SingleChainEstimation:
      type: object
      properties:
        tokenIn:
          $ref: '#/components/schemas/TokenWithUsdValue'
        tokenOut:
          $ref: '#/components/schemas/TokenWithMinAmount'
        slippage:
          type: number
        recommendedSlippage:
          type: number
        protocolFee:
          type: string
        protocolFeeApproximateUsdValue:
          type: string
        estimatedTransactionFee:
          description: Estimated transaction fee (gasCost) for the transaction
          allOf:
          - $ref: '#/components/schemas/FeeInfo'
        costsDetails:
          description: Costs details
          type: array
          items:
            $ref: '#/components/schemas/CostsDetailsProperty'
        comparedAggregators:
          description: Comparison data for all swap aggregators that were compared
          type: array
          items:
            $ref: '#/components/schemas/SwapAdapterComparisonDto'
      required:
      - tokenIn
      - tokenOut
      - slippage
      - recommendedSlippage
      - comparedAggregators
    CostsDetailsProperty:
      type: object
      properties:
        chain:
          type: string
        tokenIn:
          type: string
        tokenOut:
          type: string
        amountIn:
          type: string
        amountOut:
          type: string
        type:
          type: string
        payload:
          $ref: '#/components/schemas/Payload'
      required:
      - chain
      - tokenIn
      - tokenOut
      - amountIn
      - amountOut
      - type
    Payload:
      type: object
      properties:
        feeAmount:
          type: string
        feeBps:
          type: string
        amountOutBeforeCorrection:
          type: string
        estimatedVolatilityBps:
          type: string
        actualFeeAmount:
          type: string
        actualFeeBps:
          type: string
        subsidyAmount:
          type: string
        feeApproximateUsdValue:
          type: string
        additionalMarginAmount:
          type: string
        additionalMarginBps:
          type: string
externalDocs:
  description: DLN API documentation
  url: https://docs.debridge.finance/dln-the-debridge-liquidity-network-protocol/introduction