Quote API

The API allows developers and users to get the best swap quotes to speed up integration.

API base path

https://api.bulbaswap.io/v1/quote

Params

Name	Require	Type	Note
amount	true	number	Positive integer
tokenInAddress	true	string	eth, ETH, 0x...
tokenOutAddress	true	string	eth, ETH, 0x...
type	true	string	(0, exactIn, buy)/(1, exactOut, sell)
slippage	false	number	min: 0.01, max: 100, default: 0.5
protocols	false	string	v2/v3/v2,v3 (default: v2,v3)
recipient	false	string	0x...
deadline	false	number	Positive integer, min: 60, max: 3600
minSplits	false	number	Positive integer, min: 1, max: 7
permitSignature	false	string
permitNonce	false	number	Positive integer
permitExpiration	false	number	Positive integer
permitAmount	false	number	Positive integer
permitSigDeadline	false	number	Positive integer

Example

// Get query
https://api.bulbaswap.io/v1/quote?amount=10000000000000000
    &tokenInAddress=ETH
    &tokenOutAddress=0xc7D67A9cBB121b3b0b9c053DD9f469523243379A
    &type=0
    &slippage=0.5
    &recipient=0x3210f5d1a49842634F224dD50a8BadF02e9aB3a4
    &deadline=600
    &protocols=v2,v3

{
    "methodParameters": {
        "calldata": "0x3593564c000000000000000000000000000000000000000000000000000000000000006000000000000000000000000000000000000000000000000000000000000000a0000000000000000000000000000000000000000000000000000000006811f748000000000000000000000000000000000000000000000000000000000000000108000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000001000000000000000000000000000000000000000000000000000000000000002000000000000000000000000000000000000000000000000000000000000001000000000000000000000000003210f5d1a49842634f224dd50a8badf02e9ab3a4000000000000000000000000000000000000000000000000002386f26fc100000000000000000000000000000000000000000000000000000000000001107d7f00000000000000000000000000000000000000000000000000000000000000a0000000000000000000000000000000000000000000000000000000000000000100000000000000000000000000000000000000000000000000000000000000020000000000000000000000005300000000000000000000000000000000000011000000000000000000000000c7d67a9cbb121b3b0b9c053dd9f469523243379a",
        "value": "0x00",
        "to": "0xb789922D715475F419b7CB47B6155bF7a2ACECD6"
    },
    "blockNumber": "9858849",
    "amount": "10000000000000000",
    "amountDecimals": "0.01",
    "quote": "17947209",
    "quoteDecimals": "17.947209",
    "quoteGasAdjusted": "17921053",
    "quoteGasAdjustedDecimals": "17.921053",
    "gasUseEstimateQuote": "26155",
    "gasUseEstimateQuoteDecimals": "0.026155",
    "gasUseEstimate": "135000",
    "gasUseEstimateUSD": "0.026155",
    "gasPriceWei": "107627739",
    "route": [
        [
            {
                "type": "v2-pool",
                "tokenIn": {
                    "chainId": 2818,
                    "decimals": 18,
                    "address": "0x5300000000000000000000000000000000000011",
                    "symbol": "WETH"
                },
                "tokenOut": {
                    "chainId": 2818,
                    "decimals": 6,
                    "address": "0xc7D67A9cBB121b3b0b9c053DD9f469523243379A",
                    "symbol": "USDT"
                },
                "reserve0": {
                    "token": {
                        "chainId": 2818,
                        "decimals": 18,
                        "address": "0x5300000000000000000000000000000000000011",
                        "symbol": "WETH"
                    },
                    "quotient": "513270123276242675630"
                },
                "reserve1": {
                    "token": {
                        "chainId": 2818,
                        "decimals": 6,
                        "address": "0xc7D67A9cBB121b3b0b9c053DD9f469523243379A",
                        "symbol": "USDT"
                    },
                    "quotient": "923966427372"
                },
                "amountIn": "10000000000000000",
                "amountOut": "17947209"
            }
        ]
    ],
    "routeString": "[V2] 100.00% = WETH -- [0x00BF5210b24d371E3Df88179Da61B2cd83AB44EE] --> USDT"
}