# API Reference

## Quote

* Method: Get
* URL: [https://api.0xgen.io/v1/:chain/quote](https://api.0xgen.io/v1/bsc/quote?inTokenAddress=0x55d398326f99059ff775485246999027b3197955\&outTokenAddress=0x9029FdFAe9A03135846381c7cE16595C3554e10A\&amount=5\&gasPrice=5)
* Parameters:

<table data-header-hidden><thead><tr><th width="207"></th><th width="150"></th><th width="199.2677376171352"></th><th></th></tr></thead><tbody><tr><td><strong>Parameter name</strong></td><td><strong>Type</strong></td><td><strong>Example</strong></td><td><strong>Description</strong></td></tr><tr><td>chain</td><td>string</td><td>bsc</td><td>eth, bsc, polygon, avax, arbitrum, fantom, xdai, heco, boba, moonriver, aurora, cronos, harmony, sifchain, osmosis, optimism, ont, tron, terra, okex</td></tr><tr><td>inTokenAddress</td><td>string</td><td>0x55d398326f99059ff775485246999027b3197955</td><td>sell token address</td></tr><tr><td>outTokenAddress</td><td>string</td><td>0x8ac76a51cc950d9822d68b83fe1ad97b32cd580d</td><td>buy token address</td></tr><tr><td>amount</td><td>number</td><td>1</td><td>sell amount(without decimals)</td></tr><tr><td>gasPrice</td><td>number</td><td>5</td><td>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</td></tr></tbody></table>

* 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](https://api.0xgen.io/v1/bsc/quote?inTokenAddress=0x55d398326f99059ff775485246999027b3197955\&outTokenAddress=0x9029FdFAe9A03135846381c7cE16595C3554e10A\&amount=5\&gasPrice=5)
* Parameters:

<table data-header-hidden><thead><tr><th width="207"></th><th width="150"></th><th width="199.2677376171352"></th><th></th></tr></thead><tbody><tr><td><strong>Parameter name</strong></td><td><strong>Type</strong></td><td><strong>Example</strong></td><td><strong>Description</strong></td></tr><tr><td>chain</td><td>string</td><td>avax</td><td>eth, bsc, polygon, avax, arbitrum, fantom, xdai, heco, boba, moonriver, aurora, cronos, harmony, sifchain, osmosis, optimism, ont, tron, terra, okex</td></tr><tr><td>dex</td><td>string</td><td>1inch</td><td>openOcean, 1inch, matcha, jupiter</td></tr><tr><td>inTokenAddress</td><td>string</td><td>0x49D5c2BdFfac6CE2BFdB6640F4F80f226bc10bAB</td><td>sell token address</td></tr><tr><td>outTokenAddress</td><td>string</td><td>0xf693248f96fe03422fea95ac0afbbbc4a8fdd172</td><td>buy token address</td></tr><tr><td>amount</td><td>number</td><td>1</td><td>sell amount(without decimals)</td></tr><tr><td>gasPrice</td><td>number</td><td>5</td><td>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</td></tr><tr><td>slippage</td><td>number</td><td>1</td><td>0-50, 1 equal 1%</td></tr><tr><td>account</td><td>string</td><td>0x929B44e589AC4dD99c0282614e9a844Ea9483C69</td><td>wallet address</td></tr><tr><td>disableEstimate</td><td>bool</td><td>true</td><td>true/false</td></tr></tbody></table>

* 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"
    }
}
```
