Swagger

This endpoint provides estimates for all integrated dexes based on profit

This endpoint retrieves a list of decentralized exchanges (dexes) where the selected pair can be swapped. The list is sorted by profit, so we recommend choosing the first dex in the list.

GET/api/v1/swap/estimate-all

Authorization

x-api-key

Query parameters

Response

200400401404

OK

Body

application/json

successfulEstimationsList*array of EstimatedTradeDto (object)

Request

JavaScriptCurlPython

const response = await fetch('/api/v1/swap/estimate-all?amount=text', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200

{
  "successfulEstimationsList": [
    {
      "swapName": "text",
      "delegatedDex": "text",
      "fromToken": "text",
      "fromTokenPrice": "text",
      "toToken": "text",
      "toTokenPrice": "text",
      "amountIn": "text",
      "amountOut": "text",
      "minAmountOut": "text",
      "route": "text",
      "reserves": [
        "text"
      ],
      "priceImpact": "text",
      "poolInfo": "text",
      "swapFee": "text",
      "networkFee": "text",
      "gasPrice": "text",
      "currentDexFeePercentage": "text",
      "crowdswapFeePercentage": "text",
      "swapFeeInUSDT": "text",
      "networkFeeInUSDT": "text",
      "crowdswapFeeInUSDT": "text",
      "totalFeeInUSDT": "text",
      "pricePerToken": "number",
      "cost": "number",
      "totalPaidInUSDT": "text",
      "totalIncomeInUSDT": "text",
      "amountOutInUSDT": "text",
      "amountInInUSDT": "text",
      "amountOutPerAmountInRatio": "text",
      "amountInPerAmountOutRatio": "text",
      "approveAddress": "text",
      "tradeType": "number",
      "trade": {}
    }
  ]
}

This endpoint returns the data for a swap transaction

This endpoint returns from, to, data, value, and gasLimit, all of which needed for executing a swap transaction

• A dex name must be added to the url. The dex name can be found in estimation e.g CrowdSwapV2, Quickswap

GET/api/v1/swap/{dex}

Authorization

x-api-key

Path parameters

dex*string

The dex name which will be used for the swap transaction. This value is available in the estimation result as swapName

Query parameters

Response

200400401

OK

Body

application/json

from*string

User address who submits input tokens for a swap

to*string

swap Contract address

data*string

populated transaction

value*string

transaction value

gasLimit*string

transaction gas limit

Request

JavaScriptCurlPython

const response = await fetch('/api/v1/swap/{dex}?amount=text&userAddress=text&amountOutMin=text&deadline=30', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200

{
  "from": "text",
  "to": "text",
  "data": "text",
  "value": "text",
  "gasLimit": "text"
}

This endpoint returns the estimation of a cross-chain swap

This endpoint finds a route with the potentially best possible outcome for the requested cross-chain pair and returns an estimation.

GET/api/v1/crossChainSwap/estimate-all

Authorization

x-api-key

Query parameters

Response

200400401

OK

Body

application/json

crossChainName*string

tokenIn*object

tokenOut*object

amountIn*string

amountOut*string

minAmountOut*string

approveAddress*string

status*object

Example: "number"

msg*string

swapTxobject

feesobject

includedInOutputFeesobject

swapSpecDataobject

Request

JavaScriptCurlPython

const response = await fetch('/api/v1/crossChainSwap/estimate-all?amountIn=text', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200

{
  "crossChainName": "text",
  "tokenIn": {
    "address": "string",
    "chainId": "number",
    "decimals": "number",
    "name": "string",
    "symbol": "string"
  },
  "tokenOut": {
    "address": "string",
    "chainId": "number",
    "decimals": "number",
    "name": "string",
    "symbol": "string"
  },
  "amountIn": "text",
  "amountOut": "text",
  "minAmountOut": "text",
  "approveAddress": "text",
  "status": "number",
  "msg": "text",
  "swapTx": {
    "to": "string",
    "data": "number",
    "value": "number",
    "gasLimit": "string"
  },
  "fees": {
    "token": {
      "address": "string",
      "chainId": "number",
      "decimals": "number",
      "name": "string",
      "symbol": "string"
    },
    "amount": "string",
    "type": "number"
  },
  "includedInOutputFees": {
    "token": {
      "address": "string",
      "chainId": "number",
      "decimals": "number",
      "name": "string",
      "symbol": "string"
    },
    "amount": "string",
    "type": "number"
  }
}

This endpoint returns the data for investing in an opportunity by a token except TokenA or Token B

This endpoint returns from, to, data, value, and gasLimit, all of which needed for investing in an opportunity. Also it returns amountDesiredTokenA, amountDesiredTokenB, and amountLP to show to the investors.

• An opportuniry name must be added to the url. e.g CROWD_USDT_LP_STAKE, mai-usdc-mimatic,and CAKE_WBNB_PANCAKE

GET/api/v1/opportunity/{opportunity}/investByToken

Path parameters

opportunity*string

Query parameters

Header parameters

Response

default

Body

application/json

from*string

User address who submits input tokens for a investment

to*string

opportunity Contract address

data*string

populated transaction

value*string

transaction value

gasLimit*string

transaction gas limit

amountDesiredTokenA*string

The amount of TokenA that we use for add liquidity

amountDesiredTokenB*string

The amount of TokenB that we use for add liquidity

amountLP*string

Amount of LP token after add liquidity

Request

JavaScriptCurlPython

const response = await fetch('/api/v1/opportunity/{opportunity}/investByToken?userAddress=text&amount=text&networkCoinPrice=text&slippage=0.5&deadline=30', {
    method: 'GET',
    headers: {
      "x-correlation-id": "text"
    },
});
const data = await response.json();

Response

default

{
  "from": "text",
  "to": "text",
  "data": "text",
  "value": "text",
  "gasLimit": "text",
  "amountDesiredTokenA": "text",
  "amountDesiredTokenB": "text",
  "amountLP": "text"
}

This endpoint returns the data for investing in an opportunity by a tokenA and Token B

This endpoint returns from, to, data, value, and gasLimit, all of which needed for investing in an opportunity. Also it returns amountDesiredTokenA, amountDesiredTokenB, and amountLP to show to the investors.

• An opportuniry name must be added to the url. e.g CROWD_USDT_LP_STAKE, mai-usdc-mimatic,and CAKE_WBNB_PANCAKE

GET/api/v1/opportunity/{opportunity}/investByTokenAAndTokenB

Path parameters

opportunity*string

Query parameters

Header parameters

Response

default

Body

application/json

from*string

User address who submits input tokens for a investment

to*string

opportunity Contract address

data*string

populated transaction

value*string

transaction value

gasLimit*string

transaction gas limit

amountDesiredTokenA*string

The amount of TokenA that we use for add liquidity

amountDesiredTokenB*string

The amount of TokenB that we use for add liquidity

amountLP*string

Amount of LP token after add liquidity

Request

JavaScriptCurlPython

const response = await fetch('/api/v1/opportunity/{opportunity}/investByTokenAAndTokenB?userAddress=text&amount=text&networkCoinPrice=text&slippage=0.5&deadline=30', {
    method: 'GET',
    headers: {
      "x-correlation-id": "text"
    },
});
const data = await response.json();

Response

default

{
  "from": "text",
  "to": "text",
  "data": "text",
  "value": "text",
  "gasLimit": "text",
  "amountDesiredTokenA": "text",
  "amountDesiredTokenB": "text",
  "amountLP": "text"
}

This endpoint returns the data for investing in an opportunity by a tokenA or Token B

This endpoint returns from, to, data, value, and gasLimit, all of which needed for investing in an opportunity. Also it returns amountDesiredTokenA, amountDesiredTokenB, and amountLP to show to the investors.

• An opportuniry name must be added to the url. e.g CROWD_USDT_LP_STAKE, mai-usdc-mimatic,and CAKE_WBNB_PANCAKE

GET/api/v1/opportunity/{opportunity}/investByTokenAOrTokenB

Path parameters

opportunity*string

Query parameters

Header parameters

Response

default

Body

application/json

from*string

User address who submits input tokens for a investment

to*string

opportunity Contract address

data*string

populated transaction

value*string

transaction value

gasLimit*string

transaction gas limit

amountDesiredTokenA*string

The amount of TokenA that we use for add liquidity

amountDesiredTokenB*string

The amount of TokenB that we use for add liquidity

amountLP*string

Amount of LP token after add liquidity

Request

JavaScriptCurlPython

const response = await fetch('/api/v1/opportunity/{opportunity}/investByTokenAOrTokenB?userAddress=text&amount=text&networkCoinPrice=text&slippage=0.5&deadline=30', {
    method: 'GET',
    headers: {
      "x-correlation-id": "text"
    },
});
const data = await response.json();

Response

default

{
  "from": "text",
  "to": "text",
  "data": "text",
  "value": "text",
  "gasLimit": "text",
  "amountDesiredTokenA": "text",
  "amountDesiredTokenB": "text",
  "amountLP": "text"
}

This endpoint returns the data for investing in an opportunity by LP token of the opportunity

This endpoint returns from, to, data, value, and gasLimit, all of which needed for investing in an opportunity. Also it returns amountDesiredTokenA, amountDesiredTokenB, and amountLP to show to the investors.

• An opportuniry name must be added to the url. e.g CROWD_USDT_LP_STAKE, mai-usdc-mimatic,and CAKE_WBNB_PANCAKE

GET/api/v1/opportunity/{opportunity}/investByLP

Path parameters

opportunity*string

Query parameters

Header parameters

Response

default

Body

application/json

from*string

User address who submits input tokens for a investment

to*string

opportunity Contract address

data*string

populated transaction

value*string

transaction value

gasLimit*string

transaction gas limit

amountDesiredTokenA*string

The amount of TokenA that we use for add liquidity

amountDesiredTokenB*string

The amount of TokenB that we use for add liquidity

amountLP*string

Amount of LP token after add liquidity

Request

JavaScriptCurlPython

const response = await fetch('/api/v1/opportunity/{opportunity}/investByLP?userAddress=text&amount=text&networkCoinPrice=text&slippage=0.5&deadline=30', {
    method: 'GET',
    headers: {
      "x-correlation-id": "text"
    },
});
const data = await response.json();

Response

default

{
  "from": "text",
  "to": "text",
  "data": "text",
  "value": "text",
  "gasLimit": "text",
  "amountDesiredTokenA": "text",
  "amountDesiredTokenB": "text",
  "amountLP": "text"
}

This endpoint returns the data for leave from an opportunity

This endpoint returns from, to, data, value, and gasLimit, all of which needed for leaving from an opportunity.

• An opportuniry name must be added to the url. e.g CROWD_USDT_LP_STAKE, mai-usdc-mimatic,and CAKE_WBNB_PANCAKE

GET/api/v1/opportunity/{opportunity}/leaveByLP

Path parameters

opportunity*string

Query parameters

Header parameters

Response

default

Body

application/json

from*string

User address who submits input tokens for a investment

to*string

opportunity Contract address

data*string

populated transaction

value*string

transaction value

gasLimit*string

transaction gas limit

amountDesiredTokenA*string

The amount of TokenA that we use for add liquidity

amountDesiredTokenB*string

The amount of TokenB that we use for add liquidity

amountLP*string

Amount of LP token after add liquidity

Request

JavaScriptCurlPython

const response = await fetch('/api/v1/opportunity/{opportunity}/leaveByLP?userAddress=text&amount=text&networkCoinPrice=text&slippage=0.5&deadline=30', {
    method: 'GET',
    headers: {
      "x-correlation-id": "text"
    },
});
const data = await response.json();

Response

default

{
  "from": "text",
  "to": "text",
  "data": "text",
  "value": "text",
  "gasLimit": "text",
  "amountDesiredTokenA": "text",
  "amountDesiredTokenB": "text",
  "amountLP": "text"
}

This endpoint returns the details of an opportunity

This endpoint returns tvl, apy, dailyInterest to inform users about how much the opportuniy profitable

• An opportuniry name must be added to the url. e.g CROWD_USDT_LP_STAKE, mai-usdc-mimatic,and CAKE_WBNB_PANCAKE

GET/api/v1/opportunity/getDetails/{opportunity}

Path parameters

opportunity*string

Query parameters

Response

default

Body

application/json

tvl*string

opportunity's TVL

apy*string

opportunity's APY

dailyInterest*string

opportunity's daily interest

Request

JavaScriptCurlPython

const response = await fetch('/api/v1/opportunity/getDetails/{opportunity}', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

default

{
  "tvl": "text",
  "apy": "text",
  "dailyInterest": "text"
}

This endpoint returns the data for investing in an opportunity by cross-chain

• An opportuniry name must be added to the url. e.g CROWD_USDT_LP_STAKE, mai-usdc-mimatic,and CAKE_WBNB_PANCAKE

GET/api/v1/opportunity/{opportunity}/crossChainEstimation

Path parameters

opportunity*string

Query parameters

Header parameters

Response

default

Body

application/json

estimation*Estimation (object)

tx*Tx (object)

Request

JavaScriptCurlPython

const response = await fetch('/api/v1/opportunity/{opportunity}/crossChainEstimation?srcChainId=1&srcChainTokenInAddress=0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE&srcChainTokenInAmount=text&slippage=3&dstChainId=56&dstChainTokenOutAddress=0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE&userAddress=text', {
    method: 'GET',
    headers: {
      "x-correlation-id": "text"
    },
});
const data = await response.json();

Response

default

{
  "estimation": {
    "srcChainTokenIn": {
      "address": "text",
      "name": "text",
      "symbol": "text",
      "decimals": 0,
      "amount": "text"
    },
    "srcChainTokenOut": {
      "address": "text",
      "name": "text",
      "symbol": "text",
      "decimals": 0,
      "amount": "text",
      "minAmount": "text"
    },
    "dstChainTokenIn": {
      "address": "text",
      "name": "text",
      "symbol": "text",
      "decimals": 0,
      "amount": "text",
      "minAmount": "text"
    },
    "dstChainTokenOut": {
      "address": "text",
      "name": "text",
      "symbol": "text",
      "decimals": 0,
      "amount": "text",
      "minAmount": "text"
    },
    "executionFee": {
      "token": {
        "address": "text",
        "name": "text",
        "symbol": "text",
        "decimals": 0
      },
      "recommendedAmount": "text",
      "actualAmount": "text"
    }
  },
  "tx": {
    "to": "text",
    "data": "text",
    "value": "text"
  }
}