API Reference

Quote

• Method: Get

• URL: https://api.0xgen.io/v1/:chain/quote

• Parameters:

Parameter name	Type	Example	Description
chain	string	bsc	eth, bsc, polygon, avax, arbitrum, fantom, xdai, heco, boba, moonriver, aurora, cronos, harmony, sifchain, osmosis, optimism, ont, tron, terra, okex
inTokenAddress	string	0x55d398326f99059ff775485246999027b3197955	sell token address
outTokenAddress	string	0x8ac76a51cc950d9822d68b83fe1ad97b32cd580d	buy token address
amount	number	1	sell amount(without decimals)
gasPrice	number	5	The target gas price (in wei) for the swap transaction. If the price is too low to achieve the quote, an error will be returned

• Example:

Request:

https://api.0xgen.io/v1/bsc/quote?inTokenAddress=0x55d398326f99059ff775485246999027b3197955&outTokenAddress=0x8ac76a51cc950d9822d68b83fe1ad97b32cd580d&amount=5&gasPrice=5

Response:

{
    "code": 200,
    "data": {
        "dexes": [
            {
                "name": "openOcean",
                "amount": "4995642973232943774",
                "useTime": 397
            },
            {
                "name": "1inch",
                "amount": "4984061907198958392",
                "useTime": 1033
            },
            {
                "name": "matcha",
                "amount": "4984061907198958392",
                "useTime": 1261
            }
        ],
        "maxOutAmount": "4995642973232943774",
        "minOutAmount": "4984061907198958392",
        "inToken": {
            "symbol": "USDT",
            "name": "Binance-Peg USD (T)",
            "decimals": 18,
            "address": "0x55d398326f99059ff775485246999027b3197955"
        },
        "outToken": {
            "symbol": "USDC",
            "name": "Binance-Peg USD Coin",
            "address": "0x8ac76a51cc950d9822d68b83fe1ad97b32cd580d",
            "decimals": 18
        },
        "inAmount": "5000000000000000000",
        "useTime": 1284
    }
}

Swap

• Method: Get

• URL: https://api.0xgen.io/v1/:chain/:dex/swap_quote

• Parameters:

Parameter name	Type	Example	Description
chain	string	avax	eth, bsc, polygon, avax, arbitrum, fantom, xdai, heco, boba, moonriver, aurora, cronos, harmony, sifchain, osmosis, optimism, ont, tron, terra, okex
dex	string	1inch	openOcean, 1inch, matcha, jupiter
inTokenAddress	string	0x49D5c2BdFfac6CE2BFdB6640F4F80f226bc10bAB	sell token address
outTokenAddress	string	0xf693248f96fe03422fea95ac0afbbbc4a8fdd172	buy token address
amount	number	1	sell amount(without decimals)
gasPrice	number	5	The target gas price (in wei) for the swap transaction. If the price is too low to achieve the quote, an error will be returned
slippage	number	1	0-50, 1 equal 1%
account	string	0x929B44e589AC4dD99c0282614e9a844Ea9483C69	wallet address
disableEstimate	bool	true	true/false

• Example:

Request:

https://api.0xgen.io/v1/avax/openOcean/swap_quote?inTokenAddress=0x49D5c2BdFfac6CE2BFdB6640F4F80f226bc10bAB&outTokenAddress=0xf693248f96fe03422fea95ac0afbbbc4a8fdd172&amount=50000&&gasPrice=0.001&slippage=1.251&account=0x929B44e589AC4dD99c0282614e9a844Ea9483C69&disableEstimate=true

Response:

{
    "code": 200,
    "data": {
        "inToken": {
            "address": "0x49D5c2BdFfac6CE2BFdB6640F4F80f226bc10bAB",
            "decimals": 18,
            "name": "Wrapped Ether",
            "symbol": "WETH.e"
        },
        "outToken": {
            "address": "0xf693248F96Fe03422FEa95aC0aFbBBc4a8FdD172",
            "decimals": 18,
            "symbol": "TUS",
            "name": "Treasure Under Sea"
        },
        "inAmount": "50000000000000000000000",
        "outAmount": "106528459642362063142601203",
        "estimatedGas": "627382",
        "minOutAmount": "105196853896832537353318688",
        "from": "0x929B44e589AC4dD99c0282614e9a844Ea9483C69",
        "to": "0x6352a56caadC4F1E25CD6c75970Fa768A3304e64",
        "value": "0",
        "gasPrice": "1000000",
        "data": "0x90411a3200000000000000000000000012cfe671e9b186f21d9852d69bdbfe3f8ac9ecb1000000000000000000000000000000000000000000000000000000000000006000000000000000000000000000000000000000000000000000000000000001c000000000000000000000000049d5c2bdffac6ce2bfdb6640f4f80f226bc10bab000000000000000000000000f693248f96fe03422fea95ac0afbbbc4a8fdd1720000000000000000000000009ab2de34a33fb459b538c43f251eb825645e8595000000000000000000000000929b44e589ac4dd99c0282614e9a844ea9483c69000000000000000000000000000000000000000000000a968163f0a57b40000000000000000000000000000000000000000000000057044ce06e0e0327a8f120000000000000000000000000000000000000000000581e475e68f781931941f30000000000000000000000000000000000000000000000000000000000000002000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000001400000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000600000000000000000000000000000000000000000000000000000000000000c000000000000000000000000000000000000000000000000000000000000001e00000000000000000000000000000000000000000000000000000000000000440000000000000000000000000000000000000000000000000000000000000056000000000000000000000000000000000000000000000000000000000000007c000000000000000000000000000000000000000000000000000000000000008e00000000000000000000000009ab2de34a33fb459b538c43f251eb825645e859500000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000008000000000000000000000000000000000000000000000000000000000000000649331621200000000000000000000000049d5c2bdffac6ce2bfdb6640f4f80f226bc10bab000000000000000000000000b31f66aa3c1e785363f0875a1b74e27b85fd66c700000000000000000000000012cfe671e9b186f21d9852d69bdbfe3f8ac9ecb100000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000008000000000000000000000000000000000000000000000000000000000000001a49f865422000000000000000000000000b31f66aa3c1e785363f0875a1b74e27b85fd66c700000000000000000000000000000002000000000000000000000000000000140000000000000000000000000000000000000000000000000000000000000080000000000000000000000000000000000000000000000000000000000000004400000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000800000000000000000000000000000000000000000000000000000000000000064d1660f99000000000000000000000000b31f66aa3c1e785363f0875a1b74e27b85fd66c7000000000000000000000000bced3b6d759b9ca8fc7706e46aa81627b2e9eae80000000000000000000000000000000000000000000000000000000000000001000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000800000000000000000000000000000000000000000000000000000000000000064cac460ee00000000000000003b6d0340bced3b6d759b9ca8fc7706e46aa81627b2e9eae8000000000000000000000000b31f66aa3c1e785363f0875a1b74e27b85fd66c700000000000000000000000012cfe671e9b186f21d9852d69bdbfe3f8ac9ecb100000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000008000000000000000000000000000000000000000000000000000000000000001a49f865422000000000000000000000000b31f66aa3c1e785363f0875a1b74e27b85fd66c700000000000000000000000000000012000000000000000000000000000000120000000000000000000000000000000000000000000000000000000000000080000000000000000000000000000000000000000000000000000000000000004400000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000800000000000000000000000000000000000000000000000000000000000000064d1660f99000000000000000000000000b31f66aa3c1e785363f0875a1b74e27b85fd66c7000000000000000000000000565d20bd591b00ead0c927e4b6d7dd8a33b0b3190000000000000000000000000000000000000000000000000000000000000001000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000800000000000000000000000000000000000000000000000000000000000000064cac460ee00000000000000003b6d0340565d20bd591b00ead0c927e4b6d7dd8a33b0b319000000000000000000000000b31f66aa3c1e785363f0875a1b74e27b85fd66c700000000000000000000000012cfe671e9b186f21d9852d69bdbfe3f8ac9ecb100000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000008000000000000000000000000000000000000000000000000000000000000001a49f865422000000000000000000000000f693248f96fe03422fea95ac0afbbbc4a8fdd17200000000000000000000000000000001000000000000000000000000000000010000000000000000000000000000000000000000000000000000000000000080000000000000000000000000000000000000000000000000000000000000004400000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000800000000000000000000000000000000000000000000000000000000000000064d1660f99000000000000000000000000f693248f96fe03422fea95ac0afbbbc4a8fdd172000000000000000000000000929b44e589ac4dd99c0282614e9a844ea9483c6900000000000000000000000000000000000000000000000000000000000000010000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000"
    }
}