> For the complete documentation index, see [llms.txt](https://docs.expand.network/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.expand.network/integrations/dex-and-dex-aggregators/uniswap-v3.md). # Uniswap V3 ### Supported Chains Available on **Ethereum Mainnet and Testnet, Arbitrum, Avalanche, Base, Binance Smart Chain, zkSync Era and Polygon.** ### Available Endpoints: *Click on the endpoint to jump to the section with full details* * [**/****getprice**](#getprice) `GET` - Returns the swap quotation for a given token pair on Uniswap V3. * [**/getuserliquidity**](#getuserliquidity) `GET` - Returns the balance of a particular token pair of accounts. * [**/getpoolliquidity**](#getpoolliquidity) `GET` - Returns the total liquidity for a specified pool. * [**/gettokenliquidity**](#gettokenliquidity) `GET` - Returns the individual token liquidity within the specified liquidity pool. * [**/getliquidityholders**](#getliquidityholders) `GET` - Returns the total number of liquidity holders in a specified pool. * [**/getindividualposition**](#getindividualposition) `GET` - Returns the liquidity position for a specified user address across all the pools for a given DEX. * [**/****getpoolindividualliquidity**](#getpoolindividualliquidity) `GET` - Returns all user addresses, block numbers, and token position details for a specified pool address. * [**/gethistoricaltimeseries**](#gethistoricaltimeseries) `GET` - Returns historical time series transactions for a specific pool address. Available on Ethereum only. * [**/****gethistoricaltransactions**](#gethistoricaltransactions) `GET` - Returns historical transactions focusing on swaps associated with a specific pool address. Available on Ethereum only. * [**/****gethistoricalpoolchartdata** ](#gethistoricalpoolchartdata)`GET` - Returns OHCLV (Open, High, Close, Low, and Volume) data for a specified time interval. Available on Ethereum only. * [**/****getpooltradedata**](#getpooltradedata) `GET` - Returns trade data for a specified pool, block range, and event type. Available on Ethereum only. * [**/****swap**](#swap) `POST` - Initiate a swap transaction on a specified DEX. * [**/****addliquidity**](#addliquidity) `POST` - Add liquidity to a specified pool in a specified DEX. * [**/removeliquidity**](#removeliquidity) `POST` - Remove liquidity from a specified pool in a specified DEX. ### DEX IDs Many endpoints have a parameter where you can provide a DEX ID. Below is a list of DEX IDs related to Uniswap V3. Please see the [DEX ID page](broken://pages/8x8qwIu19Aq8uFsjOXvI) for a complete DEX ID list and more information. | DEX Name | Chain | DEX ID | | ------------------ | ------------------- | ------ | | Uniswap V3 | Ethereum | 1300 | | Uniswap V3 Testnet | Ethereum Testnet | 1302 | | Uniswap V3 | Avalanche | 1305 | | Uniswap V3 | Binance Smart Chain | 1306 | | Uniswap V3 | Polygon | 1307 | | Uniswap V3 | Arbitrum | 1308 | | Uniswap V3 | Base | 1309 | | Uniswap V3 | zkSync Era | 1310 | ## Endpoint Details ### /getprice Returns the swap quotation for a given token pair on Uniswap V3 `GET` `https://api.expand.network/dex/getprice` #### Query Parameters | Name | Type | Description | | ------------------------------------------ | ------ | -------------------------------------------------------------------------------------------------------------------------------- | | rpc | String | Remote procedural call URL. | | dexId\* | String |

See the DEX ID page for a list of all DEX IDs.
The DEX ID for Uniswap V3 on Ethereum is 1300.

| | path\* | String | Comma separated values of token addresses whose price is to be fetched. | | amountIn\* | String | Amount of token. | | poolFees | String | Different pool based on the fees. By default, it is selected as 3000. | {% tabs %} {% tab title="Sample Request" %} ```url https://api.expand.network/dex/getprice?dexId=1300&path=0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2,0xdac17f958d2ee523a2206206994597c13d831ec7&amountIn=10000000000000000000 ``` {% endtab %} {% tab title="Sample Response" %} ```json { "status": 200, "msg": "success", "data": { "amountIn": "10000000000000000000", "path": [ "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2", "0xdac17f958d2ee523a2206206994597c13d831ec7" ], "amountsOut": [ "10000000000000000000", "15671654661" ] } } ``` {% endtab %} {% endtabs %} [back to top](#endpoints-available) ### /getuserliquidity Returns the balance of a particular token pair of an account. `GET` `https://api.expand.network/dex/getuserliquidity` #### Query Parameters | Name | Type | Description | | ----------------------------------------- | ------ | ----------------------------------------------------------------------- | | rpc | String | Remote procedural call URL. | | tokenId\* | String | The token ID for uniswap V3 liquidity position. | | dexId\* | String | Refer to [DexId](broken://pages/8x8qwIu19Aq8uFsjOXvI) page for details. | {% tabs %} {% tab title="Sample Request" %} ```url https://api.expand.network/dex/getuserliquidity?dexId=1300&tokenId=3238 ``` {% endtab %} {% tab title="Sample Response" %} ```json { "status": 200, "msg": "success", "data": { "liquidity": "0", "tokenV3": "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2" } } ``` {% endtab %} {% endtabs %} [back to top](#endpoints-available) ### /getpoolliquidity Returns the total liquidity for a specified pool. `GET` `https://api.expand.network/dex/getpoolliquidity` #### Query Parameters | Name | Type | Description | | --------------------------------------------- | ------ | ------------------------------------------------------------------------ | | rpc | String | Remote procedural call URL. | | poolAddress\* | String | Pool address whose liquidity is to be fetched. | | dexId\* | String | Refer to [DEX ID](broken://pages/8x8qwIu19Aq8uFsjOXvI) page for details. | {% tabs %} {% tab title="Sample Request" %} ```url https://api.expand.network/dex/getpoolliquidity?dexId=1300&poolAddress=0xC12aF0C4AA39D3061c56cD3CB19f5e62dEeaeBdE ``` {% endtab %} {% tab title="Sample Response" %} ```json { "status": 200, "msg": "success", "data": { "totalLiquidity": "3560688052732075" } } ``` {% endtab %} {% endtabs %} [back to top](#endpoints-available) ### /gettokenliquidity Returns the individual token liquidity within the specified liquidity pool. `GET` `https://api.expand.network/dex/gettokenliquidity` #### Query Parameters | Name | Type | Description | | --------------------------------------------- | ------ | ------------------------------------------------------------------------ | | rpc | String | Remote procedural call URL. | | poolAddress\* | String | The pool address. | | dexId\* | String | Refer to [DEX ID](broken://pages/8x8qwIu19Aq8uFsjOXvI) page for details. | {% tabs %} {% tab title="Sample Request" %} ``` https://api.expand.network/dex/gettokenliquidity?dexId=1300&poolAddress=0xC12aF0C4AA39D3061c56cD3CB19f5e62dEeaeBdE ``` {% endtab %} {% tab title="Sample Response" %} ```json { "status": 200, "msg": "success", "data": { "wstETH": "1464524814018114", "WETH": "586998274859845123" } } ``` {% endtab %} {% endtabs %} [back to top](#endpoints-available) ### /getindividualposition Returns the liquidity position for a specified user address across all the pools for a given DEX. `GET` `https://api.expand.network/dex/getindividualposition` #### Query Parameters | Name | Type | Description | | ----------------------------------------- | ------ | ------------------------------------------------------------------------------- | | rpc | String | Remote procedural call URL. | | address\* | String | The public address of the liquidity holder. | | dexId\* | String | Refer to [DEX ID](broken://pages/8x8qwIu19Aq8uFsjOXvI) page for details. | | poolAddresses | String | The pool Addresses whose liquidity is to be fetched. *(Comma-separated vaules)* | {% tabs %} {% tab title="Sample Request" %} ```url https://api.expand.network/dex/getindividualposition?address=0xc36442b4a4522e871399cd717abdd847ab11fe88&poolAddresses=0x971194A53Dddc8Ccfa96d5DD1E42Cd9d15746827&dexId=1300 ``` {% endtab %} {% tab title="Sample Response" %} ```json { "status": 200, "msg": "success", "data": { "aggregatedLiquidity": "21292566467643316140077", "poolAddresses": { "JBUCKETSWETH": { "0x971194A53Dddc8Ccfa96d5DD1E42Cd9d15746827": "21292566467643316140077" } } } } ``` {% endtab %} {% endtabs %} [back to top](#endpoints-available) ### /getpoolindividualliquidity Returns all user addresses, block numbers, and token position details for a specified pool address. `GET` `https://historicallp.api.expand.network/dex/getpoolindividualliquidity` #### Query Parameters | Name | Type | Description | | --------------------------------------------- | ------ | ------------------------------------------------------------------------ | | rpc | String | Remote procedural call URL. | | poolAddress\* | String | The pool address. | | dexId\* | String | Refer to [DEX ID](broken://pages/8x8qwIu19Aq8uFsjOXvI) page for details. | | endBlock | String | Last block of the range. | | startBlock | String | Starting block of the range. | {% tabs %} {% tab title="Sample Request" %} ```url https://historicallp.api.expand.network/dex/getpoolindividualliquidity?poolAddress=0xa6cc3c2531fdaa6ae1a3ca84c2855806728693e8&dexId=1300&startBlock=21372439&endBlock=21372539 ``` {% endtab %} {% tab title="Sample Response" %} ```json { "status": 200, "msg": "success", "data": [ { "userAddress": "0xee41d6528b3e1fdb71ddb214a771a28f25d8b206", "liquidityData": [ { "blockNumber": "21372539", "transactionHash": "0xf24fd919f93cf4777433473c5ae67001d8633797a373f54a566334a61ef37750", "assets": { "LINK": "774232304240452363065", "WETH": "7078087636696543717" } } ] } ] } ``` {% endtab %} {% endtabs %} [back to top](#endpoints-available) ### /getpool Returns poolAddress, tickSpacing, poolFees, tokensLiquidity and liquidity data based on tokenA and tokenB `GET` `https://api.expand.network/dex/getpool` #### Query Parameters {% tabs %} {% tab title="Sample Request" %} ```url https://api.expand.network/dex/getpool?dexId=1300&tokenA=0xE0f63A424a4439cBE457D80E4f4b51aD25b2c56C&tokenB=0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2 ``` {% endtab %} {% tab title="Sample Response" %} ```json { "status": 200, "msg": "success", "data": [ { "poolAddress": "0xE60FbA68Aa34040a1da64Cc661d06920853C16CF", "poolFees": "500", "tickSpacing": "10", "tokensLiquidity": { "WETH": "36074166594774", "SPX": "309134096" }, "liquidity": "0" }, { "poolAddress": "0x7C706586679Af2BA6D1A9fC2DA9C6aF59883fdD3", "poolFees": "3000", "tickSpacing": "60", "tokensLiquidity": { "WETH": "119412980234699172767", "SPX": "48109198986022" }, "liquidity": "202665626831103007" }, { "poolAddress": "0x00Ed26e794b949E18B142F9108429b74CE08aC99", "poolFees": "10000", "tickSpacing": "200", "tokensLiquidity": { "WETH": "1494028163550308", "SPX": "188507950137" }, "liquidity": "7746865271654" } ] } ``` {% endtab %} {% endtabs %} ### /gethistoricaltimeseries Get historical time series transactions for a specific pool address. Available on Ethereum only. `GET` `https://historicaltrade.api.expand.network/dex/gethistoricaltimeseries` #### Query Parameters | Name | Type | Description | | --------------------------------------------- | ------ | ------------------------------------------------------------------------ | | dexId\* | String | Refer to [DEX ID](broken://pages/8x8qwIu19Aq8uFsjOXvI) page for details. | | endBlock | String | Last block of the range. | | startBlock | String | Starting block of the range. | | poolAddress\* | String | Pool address whose time series is to be fetched. | {% tabs %} {% tab title="Sample Request" %} ```url https://historicaltrade.api.expand.network/dex/gethistoricaltimeseries?dexId=1300&poolAddress=0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640 ``` {% endtab %} {% tab title="Sample Response" %} ```json { "status": 200, "msg": "success", "data": { "pair": "USDC/WETH", "priceData": [ { "hash": "0x38987fde3da3213ed19d4ba5f35ad19427a7bb948a29d9d53ef314e8290303c4", "timestamp": 1703751443, "price": 0.00041976984339351357 }, { "hash": "0xb761d35868ea8c5b9e3971dd7aa5fd21d3aebe2ecc438107ea887ed626e9e1f0", "timestamp": 1703751443, "price": 0.000419760992238418 }, { "hash": "0x39aad80e4e83ae62204cb25d7c97961c4ec4ddaa89f73e9c34ac3769602a24bf", "timestamp": 1703751431, "price": 0.0004197578615022704 }, { "hash": "0x5b4ab81a8addb871f537e9c2b778dd34864de232f3e56d33ba7fd835cbac1903", "timestamp": 1703751407, "price": 0.0004197562885194616 }, { "hash": "0x331285df3da92120335b89c8afc41b66ef813a22754a2ad2929e9dc4739cc4ac", "timestamp": 1703751383, "price": 0.00041974726650371503 }, { "hash": "0xc99d3ece4711f4e355eb538ce36650c0cee4ae6bddf965dfdfed4836a76e5d7b", "timestamp": 1703751347, "price": 0.00041973876117544354 }, { "hash": "0x710533e3977ea754f485b3bd70583e8e9efce49c6474d4d2b6c9a84d3ea43c4c", "timestamp": 1703751299, "price": 0.00041932018198753956 }, { "hash": "0x6b4c65707ced66be9bdfdc476e262f09f2faf288ff87701327734c6a4ea3cd54", "timestamp": 1703751287, "price": 0.00041973930702795154 }, { "hash": "0x269db22d154768f562e0a9064f8ed1bb2f6d157b6b46124b3c021ab1553bce8f", "timestamp": 1703751263, "price": 0.0004194194863550368 }, { "hash": "0x1e484c122e784479e3aa6b5c706100d2320945b0518b80125fec937a23e03f94", "timestamp": 1703751203, "price": 0.000419632602069267 }, { "hash": "0x94928f3b93dccd23a966a09a6164c43fca9396865ae5537cb169064442fb6038", "timestamp": 1703751155, "price": 0.0004197467760294749 }, { "hash": "0x945dba738ad85406361b2295bd7dc4df5d755d8d59c9ae1ec262a93dc26f2b27", "timestamp": 1703751155, "price": 0.0004197513702011714 }, { "hash": "0xb998b508ca1d6965190e7a5dc93621cd88a5a8958cfccfbab747764028de8377", "timestamp": 1703751155, "price": 0.0004201607446060059 }, { "hash": "0x6ca4feeb1c7cc7a5cbcd1dd67ec77d3c31fccbca490bb2e16e3773cb46f8f3a4", "timestamp": 1703751143, "price": 0.0004199672013049922 }, { "hash": "0x95d7526c279240fe98ec4a710b4b3c510d527ccf8caacdab3ee8aaffc3c874c8", "timestamp": 1703751095, "price": 0.00042029036707271275 }, { "hash": "0x6f9b15d401da224600f65d14c29a49598967ec211e3847f4e8541364291a52d2", "timestamp": 1703751083, "price": 0.0004204936256776377 } ] } } ``` {% endtab %} {% endtabs %} [back to top](#endpoints-available) ### /gethistoricaltransactions Get the historical transactions focusing on swaps associated with a specific pool address. Available on Ethereum only. `GET` `https://historicaltrade.api.expand.network/dex/gethistoricaltransactions` #### Query Parameters | Name | Type | Description | | --------------------------------------------- | ------ | ------------------------------------------------------------------------ | | dexId\* | String | Refer to [DEX ID](broken://pages/8x8qwIu19Aq8uFsjOXvI) page for details. | | endBlock | String | Last block of the range. | | startBlock | String | Starting block of the range. | | poolAddress\* | String | Pool address whose transactions is to be fetched. | {% tabs %} {% tab title="Sample Request" %} ```url https://historicaltrade.api.expand.network/dex/gethistoricaltransactions?poolAddress=0x8ad599c3a0ff1de082011efddc58f1908eb6e6d8&dexId=1300&startBlock=18709774&endBlock=18711525 ``` {% endtab %} {% tab title="Sample Response" %} ```json { "status": 200, "msg": "success", "data": { "pair": "USDC/WETH", "transactions": [ { "transactionHash": "0xd8c46225c354721655d84389d0017bb92bca0d49219c63b1c0e6b0cfe07442c7", "transactionDetails": { "blockHash": "0x99073be585a7b262b39280b278ba3757f9d2d357f6eb0a3a32bd38fdeb51d38e", "blockNumber": "18711525", "from": "0x8d5acf995dae10bdbbada2044c7217ac99edf5bf", "gas": "456262", "gasPrice": "44449889625", "maxFeePerGas": "58008491929", "maxPriorityFeePerGas": "100000000", "hash": "0xd8c46225c354721655d84389d0017bb92bca0d49219c63b1c0e6b0cfe07442c7", "input": "0xac9650d800000000000000000000000000000000000000000000000000000000000000200000000000000000000000000000000000000000000000000000000000000002000000000000000000000000000000000000000000000000000000000000004000000000000000000000000000000000000000000000000000000000000001e0000000000000000000000000000000000000000000000000000000000000016488316456000000000000000000000000a0b86991c6218b36c1d19d4a2e9eb0ce3606eb48000000000000000000000000c02aaa39b223fe8d0a0e5c4f27ead9083c756cc20000000000000000000000000000000000000000000000000000000000000bb8000000000000000000000000000000000000000000000000000000000003096c00000000000000000000000000000000000000000000000000000000000309a800000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000043a77aabd0077ffc700000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000043a77aabd0077ffc70000000000000000000000008d5acf995dae10bdbbada2044c7217ac99edf5bf00000000000000000000000000000000000000000000000000000000656d825b00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000412210e8a00000000000000000000000000000000000000000000000000000000", "nonce": "531", "to": "0xc36442b4a4522e871399cd717abdd847ab11fe88", "transactionIndex": "126", "value": "78000000000000000000", "type": "2", "accessList": [], "chainId": "1", "v": "0x1", "r": "0x1ac7d0ed1e2047f0535c7d1762c0ef862fc5f247285de80ad3667500261710c0", "s": "0x3b29d6d0489d3a3352aafd9638f3003b0d2ecd48986506b110a0c266e5269adc", "yParity": "0x1" } }, { "transactionHash": "0xc8280fdcf97f561ccae5bc4a571ffbbf187a1c7d4dc44062e3055647c47edfea", "transactionDetails": { "blockHash": "0x3429b4e7bc88936e97ed52e261ef012f4b87ab44e941a61c62dfc0be8c15756d", "blockNumber": "18709774", "from": "0x9c5c934672d289ffa05252841078bae754dc7eb1", "gas": "444856", "gasPrice": "36458104843", "maxFeePerGas": "54302243486", "maxPriorityFeePerGas": "616099394", "hash": "0xc8280fdcf97f561ccae5bc4a571ffbbf187a1c7d4dc44062e3055647c47edfea", "input": "0x88316456000000000000000000000000a0b86991c6218b36c1d19d4a2e9eb0ce3606eb48000000000000000000000000c02aaa39b223fe8d0a0e5c4f27ead9083c756cc20000000000000000000000000000000000000000000000000000000000000bb80000000000000000000000000000000000000000000000000000000000030a980000000000000000000000000000000000000000000000000000000000030bc40000000000000000000000000000000000000000000000000000002e90edd00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000002e90edd00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000009c5c934672d289ffa05252841078bae754dc7eb100000000000000000000000000000000000000000000000000000000656d2fb7", "nonce": "87", "to": "0xc36442b4a4522e871399cd717abdd847ab11fe88", "transactionIndex": "73", "value": "0", "type": "2", "accessList": [], "chainId": "1", "v": "0x1", "r": "0x222ac5e262c781fc92abac25683602ed20be24d2c08853d5bd85ddab50283363", "s": "0x7e43e2b4c406ffc3d0e9e956d87d97b37858e4176cc7501fee28ff7d7fe1976c", "yParity": "0x1" } }, { "transactionHash": "0x5eddbfc2dadaa56c29cb20ac863e3381875702000231c725450414f0b841dff8", "transactionDetails": { "blockHash": "0x6cae8b44cc42e7754f51494b0e01c2db1a21f4874484557d31d515fc6e2928ca", "blockNumber": "18710651", "from": "0xe63ef6b5cbaad5be3d6b984ebe8627b275ba2011", "gas": "484500", "gasPrice": "36104085907", "maxFeePerGas": "42198419459", "maxPriorityFeePerGas": "2480176656", "hash": "0x5eddbfc2dadaa56c29cb20ac863e3381875702000231c725450414f0b841dff8", "input": "0x88316456000000000000000000000000a0b86991c6218b36c1d19d4a2e9eb0ce3606eb48000000000000000000000000c02aaa39b223fe8d0a0e5c4f27ead9083c756cc20000000000000000000000000000000000000000000000000000000000000bb800000000000000000000000000000000000000000000000000000000000308f40000000000000000000000000000000000000000000000000000000000030b4c00000000000000000000000000000000000000000000000000000000029f6300000000000000000000000000000000000000000000000000007d43134c4d848600000000000000000000000000000000000000000000000000000000020364b4000000000000000000000000000000000000000000000000006ccabcaeb83d2d000000000000000000000000e63ef6b5cbaad5be3d6b984ebe8627b275ba201100000000000000000000000000000000000000000000000000000000656d5933", "nonce": "16", "to": "0xc36442b4a4522e871399cd717abdd847ab11fe88", "transactionIndex": "52", "value": "0", "type": "2", "accessList": [], "chainId": "1", "v": "0x0", "r": "0xe9d43c3d98a9ab874af15be82bf0564be4bb12c32d25ab2c2d855614dc9dee21", "s": "0x66f23ef791845f58be1f34c92c77f265b69ff37eed121ae15368574af7a9226b", "yParity": "0x0" } }, { "transactionHash": "0x3d6193001b90ba7cbbeafd0fdee714d5b53bcfd115c660cbcce6e1205b7ad75d", "transactionDetails": { "blockHash": "0xb0d4a62d43dda996d815806a53e905b21897b73a9152f0d41ec70e985b263b84", "blockNumber": "18709824", "from": "0x24affae9c683b7615d4130300288e348e4b5d091", "gas": "634666", "gasPrice": "41077993391", "maxFeePerGas": "61616990086", "maxPriorityFeePerGas": "0", "hash": "0x3d6193001b90ba7cbbeafd0fdee714d5b53bcfd115c660cbcce6e1205b7ad75d", "input": "0x1cff79cd000000000000000000000000ebc926a16ad7837e9a26c2eb22557ebbe2e6bbd5000000000000000000000000000000000000000000000000000000000000004000000000000000000000000000000000000000000000000000000000000000e43123dd7600000000000000000000000000000000000000000000000000000000656d2ff30000000000000000000000008ad599c3a0ff1de082011efddc58f1908eb6e6d8000000000000000000000000c02aaa39b223fe8d0a0e5c4f27ead9083c756cc2000000000000000000000000a0b86991c6218b36c1d19d4a2e9eb0ce3606eb480000000000000000000000000000000000000000000000001edc280dae4314000000000000000000000000000000000000000000000000001edc280dae431400000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000", "nonce": "77830", "to": "0x5050e08626c499411b5d0e0b5af0e83d3fd82edf", "transactionIndex": "0", "value": "9201664", "type": "2", "accessList": [ { "address": "0x8ad599c3a0ff1de082011efddc58f1908eb6e6d8", "storageKeys": [ "0x4599bbaa72a0f54af58cb2739cf429f4c2b98d872f82d2ddc59ada0987fe7786", "0x0d77e2d712980b9f161379006fa1cd3d3620dc913971aa0df321a1d9aed458d8", "0xc4e36790523d49948822155ef94f257b8a953b27f5171ffa2bd285edc0b036a4", "0x0000000000000000000000000000000000000000000000000000000000000002", "0x0000000000000000000000000000000000000000000000000000000000000004", "0x00000000000000000000000000000000000000000000000000000000000002c7", "0x4599bbaa72a0f54af58cb2739cf429f4c2b98d872f82d2ddc59ada0987fe7788", "0x0d77e2d712980b9f161379006fa1cd3d3620dc913971aa0df321a1d9aed458d9", "0xc4e36790523d49948822155ef94f257b8a953b27f5171ffa2bd285edc0b036a3", "0x0000000000000000000000000000000000000000000000000000000000000001", "0x4599bbaa72a0f54af58cb2739cf429f4c2b98d872f82d2ddc59ada0987fe7787", "0x0d77e2d712980b9f161379006fa1cd3d3620dc913971aa0df321a1d9aed458da", "0xc4e36790523d49948822155ef94f257b8a953b27f5171ffa2bd285edc0b036a1", "0xc4e36790523d49948822155ef94f257b8a953b27f5171ffa2bd285edc0b036a2", "0x00000000000000000000000000000000000000000000000000000000000002c8", "0x0000000000000000000000000000000000000000000000000000000000000000" ] }, { "address": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48", "storageKeys": [ "0x10d6a54a4754c8869d6886b5f5d7fbfa5b4522237ea5c60d11bc4e7a1ff9390b", "0x037115957c78e37f987a242ae6019b6d91ee5fe4035e6bd8dbead7487b2a0cdd", "0xc58bfc1a94e2de102d0112db2443321126998201ea69c15631ad885e318d85cd", "0xfc581e2e1d759407b26acc35e3d0231aeae791f35404c37eeed17c8cdf81bcfd", "0x7050c9e0f4ca769c69bd3a8ef740bc37934f8e2c036e5a723fd8ee048ed3f8c3", "0x861bc8718284ac24ff11398a41cd3dcfa30f40a29e63274364e80d202c20402c", "0xb95dd07fa1ed783744109930e951789ad0898d42d588ae87377539fa5fd5e26c", "0x0000000000000000000000000000000000000000000000000000000000000001", "0x14f06863b217bb724f48eeeae7a44747755f25ffffde525fba804b12abcd115f" ] }, { "address": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2", "storageKeys": [ "0x46907554d4b34c274883fc6378e0b8984501b080086b3ca0038d889b8150bd13", "0x037115957c78e37f987a242ae6019b6d91ee5fe4035e6bd8dbead7487b2a0cdd", "0xfc581e2e1d759407b26acc35e3d0231aeae791f35404c37eeed17c8cdf81bcfd" ] }, { "address": "0x9a5f2e0db22ff289d0cc40ef654a19a5b012d8aa", "storageKeys": [] }, { "address": "0xebc926a16ad7837e9a26c2eb22557ebbe2e6bbd5", "storageKeys": [] }, { "address": "0xa2327a938febf5fec13bacfb16ae10ecbc4cbdcf", "storageKeys": [] } ], "chainId": "1", "v": "0x0", "r": "0x2157a9e7e20319376325fb86f904a8811c7707295e39254dc526f965557329c1", "s": "0x3e7d0676a70b97527bd6dab06745e6f2bd39181e7b1fa3b05ebd64a2c7264537", "yParity": "0x0" } } ] } } ``` {% endtab %} {% endtabs %} [back to top](#endpoints-available) ### /gethistoricalpoolchartdata Returns OHCLV (Open, High, Close, Low, and Volume) data for a specified time interval. Available on Ethereum only. `GET` `https://api.expand.network/dex/gethistoricalpoolchartdata` #### Query Parameters | Name | Type | Description | | --------------------------------------------- | ------ | -------------------------------------------------------------------------------------------------------------------------- | | dexId\* | String | Refer to [DEX ID](broken://pages/8x8qwIu19Aq8uFsjOXvI) page for details. | | interval | String |

A number values representing the number of unix epoch seconds or in format of . For example 1m,1h
By default 15m

| | limit | String |

No of iteration.
Start limit is 100 and maximum limit is 500.
By default 100

| | poolAddress\* | String | Pool address whose transactions is to be fetched. | | rpc | String | Remote procedural call URL. | {% tabs %} {% tab title="Sample Request" %} ```url https://api.expand.network/dex/gethistoricalpoolchartdata?dexId=1300&poolAddress=0xCBCdF9626bC03E24f779434178A73a0B4bad62eD&interval=15m&limit=100 ``` {% endtab %} {% tab title="Sample Response" %} ```json { "status": 200, "msg": "success", "data": { "pair": "WBTC/WETH", "chartData": [ { "1719838149-1719839049": { "open": "18.163221842751827", "high": "18.163221842751827", "close": "18.163221842751827", "low": "18.163221842751827", "volume": "0" } }, { "1719843549-1719844449": { "open": "18.152023639366099", "high": "18.156148725301474", "low": "18.1520236393661", "close": "18.156148725301474", "volume": "201601.9224350474" } }, { "1719844449-1719845349": { "open": "18.156148725301474", "high": "18.16017042666642", "low": "18.156148725301474", "close": "18.160170426666419", "volume": "129231.68773261308" } }, { "1719845349-1719846249": { "open": "18.160170426666419", "high": "18.16017042666642", "low": "18.050222752064755", "close": "18.050222752064755", "volume": "94235.4810194197" } }, { "1719848049-1719848949": { "open": "18.050222752064755", "high": "18.050222752064755", "close": "18.050222752064755", "low": "18.050222752064755", "volume": "0" } }, { "1719848949-1719849849": { "open": "18.050222752064755", "high": "18.173391151776787", "low": "18.050222752064755", "close": "18.173391151776787", "volume": "639066.9529722976" } }, { "1719849849-1719850749": { "open": "18.173391151776787", "high": "18.217273210574778", "low": "18.173391151776787", "close": "18.217273210574778", "volume": "1876403.8841387564" } }, { "1719850749-1719851649": { "open": "18.217273210574778", "high": "18.219566652896766", "low": "18.217273210574778", "close": "18.219566652896766", "volume": "153407.83996704724" } }, { "1719851649-1719852549": { "open": "18.219566652896766", "high": "18.224300456903297", "low": "18.219566652896766", "close": "18.224300456903297", "volume": "241583.0271503234" } }, { "1719852549-1719853449": { "open": "18.224300456903297", "high": "18.227219275978346", "low": "18.224300456903297", "close": "18.227219275978346", "volume": "1153.246906113717" } }, { "1719853449-1719854349": { "open": "18.227219275978346", "high": "18.227219275978346", "close": "18.227219275978346", "low": "18.227219275978346", "volume": "0" } }, { "1719854349-1719855249": { "open": "18.227219275978346", "high": "18.228972258667778", "low": "18.227219275978346", "close": "18.228972258667778", "volume": "145781.1514006681" } }, { "1719855249-1719856149": { "open": "18.228972258667778", "high": "18.236323534365766", "low": "18.228972258667778", "close": "18.236323534365766", "volume": "364975.32283550635" } }, { "1719856149-1719857049": { "open": "18.236323534365766", "high": "18.243247391452595", "low": "18.236323534365766", "close": "18.243247391452595", "volume": "313983.57175287284" } }, { "1719857049-1719857949": { "open": "18.243247391452595", "high": "18.243247391452595", "close": "18.243247391452595", "low": "18.243247391452595", "volume": "0" } }, { "1719857949-1719858849": { "open": "18.243247391452595", "high": "18.2750111708498", "low": "18.243247391452595", "close": "18.275011170849801", "volume": "1229027.6233920907" } }, { "1719858849-1719859749": { "open": "18.275011170849801", "high": "18.278777750420854", "low": "18.2750111708498", "close": "18.278777750420854", "volume": "168149.5774921048" } }, { "1719859749-1719860649": { "open": "18.278777750420854", "high": "18.30066739721457", "low": "18.278777750420854", "close": "18.300667397214571", "volume": "989199.0190272806" } }, { "1719860649-1719861549": { "open": "18.300667397214571", "high": "18.300667397214571", "close": "18.300667397214571", "low": "18.300667397214571", "volume": "0" } }, { "1719861549-1719862449": { "open": "18.300667397214571", "high": "18.300667397214571", "close": "18.300667397214571", "low": "18.300667397214571", "volume": "0" } }, { "1719862449-1719863349": { "open": "18.300667397214571", "high": "18.30066739721457", "low": "18.18889036012872", "close": "18.188890360128720", "volume": "307947.5661696072" } }, { "1719863349-1719864249": { "open": "18.188890360128720", "high": "18.18889036012872", "low": "18.181132527860964", "close": "18.181132527860964", "volume": "339841.65016079927" } }, { "1719864249-1719865149": { "open": "18.181132527860964", "high": "18.181132527860964", "close": "18.181132527860964", "low": "18.181132527860964", "volume": "0" } }, { "1719866949-1719867849": { "open": "18.181132527860964", "high": "18.181132527860964", "close": "18.181132527860964", "low": "18.181132527860964", "volume": "0" } }, { "1719867849-1719868749": { "open": "18.181132527860964", "high": "18.181132527860964", "close": "18.181132527860964", "low": "18.181132527860964", "volume": "0" } }, { "1719868749-1719869649": { "open": "18.181132527860964", "high": "18.181132527860964", "close": "18.181132527860964", "low": "18.181132527860964", "volume": "0" } }, { "1719869649-1719870549": { "open": "18.181132527860964", "high": "18.181132527860964", "close": "18.181132527860964", "low": "18.181132527860964", "volume": "0" } }, { "1719870549-1719871449": { "open": "18.181132527860964", "high": "18.181132527860964", "close": "18.181132527860964", "low": "18.181132527860964", "volume": "0" } }, { "1719871449-1719872349": { "open": "18.181132527860964", "high": "18.181132527860964", "close": "18.181132527860964", "low": "18.181132527860964", "volume": "0" } }, { "1719872349-1719873249": { "open": "18.181132527860964", "high": "18.32482665886121", "low": "18.181132527860964", "close": "18.324826658861209", "volume": "1576669.406919741" } }, { "1719873249-1719874149": { "open": "18.324826658861209", "high": "18.324826658861209", "close": "18.324826658861209", "low": "18.324826658861209", "volume": "0" } }, { "1719874149-1719875049": { "open": "18.324826658861209", "high": "18.324826658861209", "close": "18.324826658861209", "low": "18.324826658861209", "volume": "0" } }, { "1719883149-1719884049": { "open": "18.324826658861209", "high": "18.324826658861209", "close": "18.324826658861209", "low": "18.324826658861209", "volume": "0" } }, { "1719884049-1719884949": { "open": "18.324826658861209", "high": "18.32482665886121", "low": "18.20688113164695", "close": "18.206881131646949", "volume": "848119.3291747774" } }, { "1719884949-1719885849": { "open": "18.206881131646949", "high": "18.206881131646949", "close": "18.206881131646949", "low": "18.206881131646949", "volume": "0" } }, { "1719885849-1719886749": { "open": "18.206881131646949", "high": "18.206881131646949", "close": "18.206881131646949", "low": "18.206881131646949", "volume": "0" } }, { "1719886749-1719887649": { "open": "18.206881131646949", "high": "18.206881131646949", "close": "18.206881131646949", "low": "18.206881131646949", "volume": "0" } }, { "1719887649-1719888549": { "open": "18.206881131646949", "high": "18.206881131646949", "close": "18.206881131646949", "low": "18.206881131646949", "volume": "0" } }, { "1719888549-1719889449": { "open": "18.206881131646949", "high": "18.206881131646949", "close": "18.206881131646949", "low": "18.206881131646949", "volume": "0" } }, { "1719905649-1719906549": { "open": "18.306582167780366", "high": "18.306582167780366", "close": "18.306582167780366", "low": "18.306582167780366", "volume": "0" } }, { "1719906549-1719907449": { "open": "18.306582167780366", "high": "18.306582167780366", "low": "18.196897586629063", "close": "18.196897586629063", "volume": "520.7672563922177" } }, { "1719907449-1719908349": { "open": "18.196897586629063", "high": "18.196897586629063", "low": "18.19509765552369", "close": "18.195097655523689", "volume": "100517.84642071436" } }, { "1719908349-1719909249": { "open": "18.195097655523689", "high": "18.195097655523689", "close": "18.195097655523689", "low": "18.195097655523689", "volume": "0" } }, { "1719909249-1719910149": { "open": "18.195097655523689", "high": "18.195097655523689", "close": "18.195097655523689", "low": "18.195097655523689", "volume": "0" } }, { "1719910149-1719911049": { "open": "18.195097655523689", "high": "18.195097655523689", "close": "18.195097655523689", "low": "18.195097655523689", "volume": "0" } }, { "1719911049-1719911949": { "open": "18.195097655523689", "high": "18.195097655523689", "close": "18.195097655523689", "low": "18.195097655523689", "volume": "0" } }, { "1719911949-1719912849": { "open": "18.195097655523689", "high": "18.19509765552369", "low": "18.190453464735036", "close": "18.193747691058498", "volume": "201225.37315880728" } }, { "1719912849-1719913749": { "open": "18.193747691058498", "high": "18.193747691058498", "low": "18.176071689228696", "close": "18.176071689228696", "volume": "701585.1156593484" } }, { "1719913749-1719914649": { "open": "18.176071689228696", "high": "18.176071689228696", "close": "18.176071689228696", "low": "18.176071689228696", "volume": "0" } }, { "1719914649-1719915549": { "open": "18.176071689228696", "high": "18.176071689228696", "low": "18.16718239025562", "close": "18.168675247623948", "volume": "288159.10085866053" } }, { "1719915549-1719916449": { "open": "18.168675247623948", "high": "18.168675247623948", "close": "18.168675247623948", "low": "18.168675247623948", "volume": "0" } }, { "1719916449-1719917349": { "open": "18.168675247623948", "high": "18.168675247623948", "close": "18.168675247623948", "low": "18.168675247623948", "volume": "0" } }, { "1719917349-1719918249": { "open": "18.168675247623948", "high": "18.168675247623948", "close": "18.168675247623948", "low": "18.168675247623948", "volume": "0" } }, { "1719918249-1719919149": { "open": "18.168675247623948", "high": "18.16867524762395", "low": "18.163221842751827", "close": "18.165239313218017", "volume": "169623.86583495548" } }, { "1719919149-1719920049": { "open": "18.165239313218017", "high": "18.165239313218017", "close": "18.165239313218017", "low": "18.165239313218017", "volume": "0" } }, { "1719927249-1719928149": { "open": "18.165239313218017", "high": "18.165239313218017", "close": "18.165239313218017", "low": "18.165239313218017", "volume": "0" } } ] } } ``` {% endtab %} {% endtabs %} [back to top](#endpoints-available) ### /getpooltradedata Returns trade data for a specified pool, block range, and event type. Available on Ethereum only. `GET` `https://historicaltrade.api.expand.network/dex/getpooltradedata` #### Query Parameters | Name | Type | Description | | --------------------------------------------- | ------ | ------------------------------------------------------------------------ | | dexId\* | String | Refer to [DEX ID](broken://pages/8x8qwIu19Aq8uFsjOXvI) page for details. | | endBlock | String | Last block of the range. | | startBlock | String | Starting block of the range. | | poolAddress\* | String | Pool address whose data is to be fetched. | | eventType | String | Swap, Burn or Mint(by default). | {% tabs %} {% tab title="Sample Request" %} ```url https://historicaltrade.api.expand.network/dex/getpooltradedata?poolAddress=0x5777d92f208679db4b9778590fa3cab3ac9e2168&dexId=1300&eventType=Swap ``` {% endtab %} {% tab title="Sample Response" %} ```json { "status": 200, "msg": "success", "data": { "pair": "DAI/USDC", "transactions": [ { "blockNumber": "18883082", "transactionHash": "0x7bb91700afc23ed9579e3e75870a6d822d5c9e9106a0afb4f894a48e1d3b1836", "values": { "0": "0x3fC91A3afd70395Cd496C647d5a6CC9D4B2b7FAD", "1": "0x3fC91A3afd70395Cd496C647d5a6CC9D4B2b7FAD", "2": "-773851782813653396142645", "3": "773994216704", "4": "79231558998781270027361", "5": "454941727155991731855001", "6": "-276324", "sender": "0x3fC91A3afd70395Cd496C647d5a6CC9D4B2b7FAD", "recipient": "0x3fC91A3afd70395Cd496C647d5a6CC9D4B2b7FAD", "amount0": "-773851782813653396142645", "amount1": "773994216704", "sqrtPriceX96": "79231558998781270027361", "liquidity": "454941727155991731855001", "tick": "-276324" }, "eventType": "Swap", "data": { "data": "0xffffffffffffffffffffffffffffffffffffffffffff5c216929d5728d7345cb000000000000000000000000000000000000000000000000000000b435a67d000000000000000000000000000000000000000000000010c726c37299ca15ec6100000000000000000000000000000000000000000000605670c11fccb1cd5e99fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffbc89c", "topics": [ "0xc42079f94a6350d7e6235f29174924f928cc2ac818eb64fed8004e115fbcca67", "0x0000000000000000000000003fc91a3afd70395cd496c647d5a6cc9d4b2b7fad", "0x0000000000000000000000003fc91a3afd70395cd496c647d5a6cc9d4b2b7fad" ] } }, { "blockNumber": "18883077", "transactionHash": "0xea5e9ba9947be9a0eb100f168f0f094e408ac52b162ce822b0c9635e15293a4e", "values": { "0": "0x3fC91A3afd70395Cd496C647d5a6CC9D4B2b7FAD", "1": "0x3fC91A3afd70395Cd496C647d5a6CC9D4B2b7FAD", "2": "-6664975302918764090197", "3": "6666190611", "4": "79231424221064230419989", "5": "454941727155991731855001", "6": "-276324", "sender": "0x3fC91A3afd70395Cd496C647d5a6CC9D4B2b7FAD", "recipient": "0x3fC91A3afd70395Cd496C647d5a6CC9D4B2b7FAD", "amount0": "-6664975302918764090197", "amount1": "6666190611", "sqrtPriceX96": "79231424221064230419989", "liquidity": "454941727155991731855001", "tick": "-276324" }, "eventType": "Swap", "data": { "data": "0xfffffffffffffffffffffffffffffffffffffffffffffe96b0e3128c478a2cab000000000000000000000000000000000000000000000000000000018d55ff130000000000000000000000000000000000000000000010c724e49efb2e4d3e1500000000000000000000000000000000000000000000605670c11fccb1cd5e99fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffbc89c", "topics": [ "0xc42079f94a6350d7e6235f29174924f928cc2ac818eb64fed8004e115fbcca67", "0x0000000000000000000000003fc91a3afd70395cd496c647d5a6cc9d4b2b7fad", "0x0000000000000000000000003fc91a3afd70395cd496c647d5a6cc9d4b2b7fad" ] } }, { "blockNumber": "18883066", "transactionHash": "0x106dcf2be3ad40c5f27bd818c8ae75d10271af6e61e45c8b38d82447d13eb38c", "values": { "0": "0x3fC91A3afd70395Cd496C647d5a6CC9D4B2b7FAD", "1": "0x163C5e051049e92915017Fe7BB9b8ce6182bcBb1", "2": "7110951881905262918177", "3": "-7110826137", "4": "79231423060262337608341", "5": "454941727155991731855001", "6": "-276324", "sender": "0x3fC91A3afd70395Cd496C647d5a6CC9D4B2b7FAD", "recipient": "0x163C5e051049e92915017Fe7BB9b8ce6182bcBb1", "amount0": "7110951881905262918177", "amount1": "-7110826137", "sqrtPriceX96": "79231423060262337608341", "liquidity": "454941727155991731855001", "tick": "-276324" }, "eventType": "Swap", "data": { "data": "0x0000000000000000000000000000000000000000000001817c480527b2a97a21fffffffffffffffffffffffffffffffffffffffffffffffffffffffe582967670000000000000000000000000000000000000000000010c724e07f3cedd37a9500000000000000000000000000000000000000000000605670c11fccb1cd5e99fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffbc89c", "topics": [ "0xc42079f94a6350d7e6235f29174924f928cc2ac818eb64fed8004e115fbcca67", "0x0000000000000000000000003fc91a3afd70395cd496c647d5a6cc9d4b2b7fad", "0x000000000000000000000000163c5e051049e92915017fe7bb9b8ce6182bcbb1" ] } }, { "blockNumber": "18883050", "transactionHash": "0x1e133891d6d5a109575ee9778ca99340b93b1a83c061cef8ce9c9f7280510a9d", "values": { "0": "0x3fC91A3afd70395Cd496C647d5a6CC9D4B2b7FAD", "1": "0x3fC91A3afd70395Cd496C647d5a6CC9D4B2b7FAD", "2": "-948340157679668203715232", "3": "948511118707", "4": "79231424298613658735017", "5": "454941727155991731855001", "6": "-276324", "sender": "0x3fC91A3afd70395Cd496C647d5a6CC9D4B2b7FAD", "recipient": "0x3fC91A3afd70395Cd496C647d5a6CC9D4B2b7FAD", "amount0": "-948340157679668203715232", "amount1": "948511118707", "sqrtPriceX96": "79231424298613658735017", "liquidity": "454941727155991731855001", "tick": "-276324" }, "eventType": "Swap", "data": { "data": "0xffffffffffffffffffffffffffffffffffffffffffff372e6085a7d6a31a8560000000000000000000000000000000000000000000000000000000dcd7ab15730000000000000000000000000000000000000000000010c724e4e583106dd1a900000000000000000000000000000000000000000000605670c11fccb1cd5e99fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffbc89c", "topics": [ "0xc42079f94a6350d7e6235f29174924f928cc2ac818eb64fed8004e115fbcca67", "0x0000000000000000000000003fc91a3afd70395cd496c647d5a6cc9d4b2b7fad", "0x0000000000000000000000003fc91a3afd70395cd496c647d5a6cc9d4b2b7fad" ] } } ] } } ``` {% endtab %} {% endtabs %} [back to top](#endpoints-available) ### /swap Initiate a swap transaction on a specified DEX. `POST` `https://api.expand.network/dex/swap` #### Request Body
NameTypeDescription
rpcStringRemote procedural call URL.
dexId*StringRefer to the DEX ID page for details.
path*ArrayComma-separated values of token addresses, inside an array, to swap.
amountIn*StringAmount of token to be swapped.
amountOutMinStringMinimum amount accepted as a result of swap.
to*StringAddress of the recipient of the token.
from*StringAddress of the sender of the token.
gasStringMaximum gas limit provided by the sender, for the transaction.
poolFeesStringDifferent pool based on the fees. By default, it is selected as 3000.
gasPriorityStringlow, medium, or high.
slippageString

Percentage of total swap value.
By default, 1.

0 <= slippage value <= 100

{% tabs %} {% tab title="Sample Request" %} ```json { "dexId": "1300", "amountIn": "1000000000000000", "amountOutMin": "0", "path": ["0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2","0x6B175474E89094C44Da98b954EedeAC495271d0F"], "to": "0x63056E00436Da25BcF48A40dfBbDcc7089351006", "poolFees": "2975", "from": "0x63056E00436Da25BcF48A40dfBbDcc7089351006", "gas": "173376" } ``` {% endtab %} {% tab title="Sample Response" %} ```json { "status": 200, "msg": "success", "data": { "chainId": "1", "from": "0x63056E00436Da25BcF48A40dfBbDcc7089351006", "to": "0x68b3465833fb72a70ecdf485e0e4c7bd8665fc45", "value": "0", "gas": "173376", "data": "0xac9650d800000000000000000000000000000000000000000000000000000000000000200000000000000000000000000000000000000000000000000000000000000001000000000000000000000000000000000000000000000000000000000000002000000000000000000000000000000000000000000000000000000000000000e4472b43f300000000000000000000000000000000000000000000000000038d7ea4c680000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000008000000000000000000000000063056e00436da25bcf48a40dfbbdcc70893510060000000000000000000000000000000000000000000000000000000000000002000000000000000000000000c02aaa39b223fe8d0a0e5c4f27ead9083c756cc20000000000000000000000006b175474e89094c44da98b954eedeac495271d0f00000000000000000000000000000000000000000000000000000000", "estimationCheck": true, "referenceId": "6b615dd983bd4033b12096c6a5a4b46c" } } ``` {% endtab %} {% endtabs %} {% tabs %} {% tab title="Sample Request" %} **With gasPriority (medium):** 
{
    "dexId": "1300",
    "amountIn": "1000000000",
    "amountOutMin": "0",
    "path": [
        "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2",
        "0x6B175474E89094C44Da98b954EedeAC495271d0F"
    ],
    "to": "0x6Fb447Ae94F5180254D436A693907a1f57696900",
    "from": "0x6Fb447Ae94F5180254D436A693907a1f57696900",
    "gas": "173376",
    "gasPriority": "medium"
}
{% endtab %} {% tab title="Sample Response" %} **With gasPriority:** ```json { "status": 200, "msg": "success", "data": { "chainId": "1", "from": "0x6Fb447Ae94F5180254D436A693907a1f57696900", "to": "0x68b3465833fb72a70ecdf485e0e4c7bd8665fc45", "value": "0", "gas": "173376", "data": "0xac9650d800000000000000000000000000000000000000000000000000000000000000200000000000000000000000000000000000000000000000000000000000000001000000000000000000000000000000000000000000000000000000000000002000000000000000000000000000000000000000000000000000000000000000e4472b43f3000000000000000000000000000000000000000000000000000000003b9aca00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000800000000000000000000000006fb447ae94f5180254d436a693907a1f576969000000000000000000000000000000000000000000000000000000000000000002000000000000000000000000c02aaa39b223fe8d0a0e5c4f27ead9083c756cc20000000000000000000000006b175474e89094c44da98b954eedeac495271d0f00000000000000000000000000000000000000000000000000000000", "gasPrice": "24931859242", "estimationCheck": true, "referenceId": "1a6c539d892c4b5ea107a6e2823ec8fd" } } ``` {% endtab %} {% endtabs %} {% tabs %} {% tab title="Sample Request" %} **With Slippage:** ```json { "dexId": "1300", "amountIn": "1000000", "amountOutMin": "999831028599930500", "path": [ "0xdAC17F958D2ee523a2206206994597C13D831ec7", "0x6B175474E89094C44Da98b954EedeAC495271d0F" ], "to": "0x22cf65ae3fa16d6379e72f4b4c2401c1b7c69731", "deadline": "1711931771", "from": "0x22cf65ae3fa16d6379e72f4b4c2401c1b7c69731", "gas": "933376", "gasPriority": "high", "slippage": "1" } ``` {% endtab %} {% tab title="Sample Response" %} **With Slippage:** ```json { "status": 200, "msg": "success", "data": { "chainId": "1", "from": "0x22cf65ae3fa16d6379e72f4b4c2401c1b7c69731", "to": "0x68b3465833fb72a70ecdf485e0e4c7bd8665fc45", "value": "0", "gas": "933376", "data": "0xac9650d800000000000000000000000000000000000000000000000000000000000000200000000000000000000000000000000000000000000000000000000000000001000000000000000000000000000000000000000000000000000000000000002000000000000000000000000000000000000000000000000000000000000000e4472b43f300000000000000000000000000000000000000000000000000000000000f42400000000000000000000000000000000000000000000000000dbcd290b8de3080000000000000000000000000000000000000000000000000000000000000008000000000000000000000000022cf65ae3fa16d6379e72f4b4c2401c1b7c697310000000000000000000000000000000000000000000000000000000000000002000000000000000000000000dac17f958d2ee523a2206206994597c13d831ec70000000000000000000000006b175474e89094c44da98b954eedeac495271d0f00000000000000000000000000000000000000000000000000000000", "gasPrice": "34222375359", "estimationCheck": true, "referenceId": "98f1fa52694740038103132f0abe72e6" } } ``` {% endtab %} {% endtabs %} [back to top](#endpoints-available) ### /addliquidity Add liquidity to a specified pool in a specified DEX. `POST` `https://api.expand.network/dex/addliquidity` #### Request Body | Name | Type | Description | | ------------------------------------------------ | ------ | -------------------------------------------------------------------------------------- | | dexId\* | String | Refer to the [DEX ID](broken://pages/8x8qwIu19Aq8uFsjOXvI) page for details. | | tokenA\* | String | Address of the first token being added. | | tokenB\* | String | Address of the second token being added. | | poolFees\* | String | Different pool based on the fees. | | amountADesired\* | String | Desired amount of token A. | | amountBDesired\* | String | Desired amount of token B. | | amountAMin\* | String | Minimum amount of token A. | | amountBMin\* | String | Minimum amount of token B. | | deadline\* | String | Deadline for the transaction to be executed (UNIX Timestamp). | | to\* | String | Address of the recipient of the token. | | from\* | String | Address of the sender of the token. | | gas | String | Maximum gas limit provided by the sender, for the transaction. | | rpc | String | Remote procedural call URL. | | tokenId | String | The token ID for uniswap V3 liquidity position. | | gasPriority | String | low, medium, or high. | | slippage | String |

Percentage of total value.
By default, 1.

0 <= slippage value <= 100

| {% tabs %} {% tab title="Sample Request" %} ```json { "dexId": "1300", "tokenA": "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2", "tokenB": "0x6B175474E89094C44Da98b954EedeAC495271d0F", "poolFees": "3000", "amountADesired": "1000000000000000", "amountBDesired": "1294471768449933344", "amountAMin": "0", "amountBMin": "0", "deadline": "1666193668", "to": "0x63056E00436Da25BcF48A40dfBbDcc7089351006", "from": "0x63056E00436Da25BcF48A40dfBbDcc7089351006", "gas": "5446762" } ``` {% endtab %} {% tab title="Sample Response" %} ```json { "status": 200, "msg": "success", "data": { "chainId": "1", "from": "0x63056E00436Da25BcF48A40dfBbDcc7089351006", "to": "0xC36442b4a4522E871399CD717aBDD847Ab11FE88", "value": "0", "gas": "5446762", "data": "0xac9650d800000000000000000000000000000000000000000000000000000000000000200000000000000000000000000000000000000000000000000000000000000002000000000000000000000000000000000000000000000000000000000000004000000000000000000000000000000000000000000000000000000000000001e0000000000000000000000000000000000000000000000000000000000000016488316456000000000000000000000000c02aaa39b223fe8d0a0e5c4f27ead9083c756cc20000000000000000000000006b175474e89094c44da98b954eedeac495271d0f0000000000000000000000000000000000000000000000000000000000000bb8fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffece24fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffecf1400000000000000000000000000000000000000000000000000038d7ea4c6800000000000000000000000000000000000000000000000000011f6e3370a3ae0200000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000063056e00436da25bcf48a40dfbbdcc7089351006000000000000000000000000000000000000000000000000000000006350190400000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000412210e8a00000000000000000000000000000000000000000000000000000000", "estimationCheck": true, "referenceId": "7fa6a06af5f041c18204e3daa95f48bb" } } ``` {% endtab %} {% endtabs %} {% tabs %} {% tab title="Sample Request" %} **With gasPriority (medium):** ```json { "dexId": "1300", "tokenA": "0x6B175474E89094C44Da98b954EedeAC495271d0F", "tokenB": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48", "amountADesired": "1000000000000000", "amountBDesired": "999", "amountAMin": "0", "amountBMin": "0", "poolFees":"3000", "from": "0x356dB816602c85e2075774bB77D13995c8Bab023", "to":"0x356dB816602c85e2075774bB77D13995c8Bab023", "deadline":"1699966737054", "gas": "123444", "gasPriority":"medium" } ``` {% endtab %} {% tab title="Sample Response" %} **With gasPriority:** ```json { "status": 200, "msg": "success", "data": { "chainId": "1", "from": "0x356dB816602c85e2075774bB77D13995c8Bab023", "to": "0xC36442b4a4522E871399CD717aBDD847Ab11FE88", "value": "0", "gas": "123444", "data": "0xac9650d800000000000000000000000000000000000000000000000000000000000000200000000000000000000000000000000000000000000000000000000000000002000000000000000000000000000000000000000000000000000000000000004000000000000000000000000000000000000000000000000000000000000001e00000000000000000000000000000000000000000000000000000000000000164883164560000000000000000000000006b175474e89094c44da98b954eedeac495271d0f000000000000000000000000a0b86991c6218b36c1d19d4a2e9eb0ce3606eb480000000000000000000000000000000000000000000000000000000000000bb8fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffbc800fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffbc8f000000000000000000000000000000000000000000000000000038d7ea4c6800000000000000000000000000000000000000000000000000000000000000003e700000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000356db816602c85e2075774bb77d13995c8bab0230000000000000000000000000000000000000000000000000000018bcde9da9e00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000412210e8a00000000000000000000000000000000000000000000000000000000", "gasPrice": "28313536592", "estimationCheck": true, "referenceId": "17a42397a3214f8f9ebb83c88bef723f" } } ``` {% endtab %} {% endtabs %} {% tabs %} {% tab title="Sample Request" %} **With Slippage:** ```json { "dexId": "1300", "tokenA": "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2", "tokenB": "0x6B175474E89094C44Da98b954EedeAC495271d0F", "poolFees": "3000", "amountADesired": "1000000000000000", "amountBDesired": "1294471768449933344", "amountAMin": "0", "amountBMin": "0", "deadline": "1666193668", "to": "0x63056E00436Da25BcF48A40dfBbDcc7089351006", "from": "0x63056E00436Da25BcF48A40dfBbDcc7089351006", "gas": "5446762", "slippage": "5" } ``` {% endtab %} {% tab title="Sample Response" %} **With Slippage:** ```json { "status": 200, "msg": "success", "data": { "chainId": "1", "from": "0x63056E00436Da25BcF48A40dfBbDcc7089351006", "to": "0xC36442b4a4522E871399CD717aBDD847Ab11FE88", "value": "0", "gas": "5446762", "data": "0xac9650d800000000000000000000000000000000000000000000000000000000000000200000000000000000000000000000000000000000000000000000000000000002000000000000000000000000000000000000000000000000000000000000004000000000000000000000000000000000000000000000000000000000000001e0000000000000000000000000000000000000000000000000000000000000016488316456000000000000000000000000c02aaa39b223fe8d0a0e5c4f27ead9083c756cc20000000000000000000000006b175474e89094c44da98b954eedeac495271d0f0000000000000000000000000000000000000000000000000000000000000bb8fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffece24fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffecf1400000000000000000000000000000000000000000000000000038d7ea4c6800000000000000000000000000000000000000000000000000011f6e3370a3ae0200000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000063056e00436da25bcf48a40dfbbdcc7089351006000000000000000000000000000000000000000000000000000000006350190400000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000412210e8a00000000000000000000000000000000000000000000000000000000", "estimationCheck": true, "referenceId": "d77137490d89447e82922330352d5b85" } } ``` {% endtab %} {% endtabs %} [back to top](#endpoints-available) ### /removeliquidity Remove liquidity from a specified pool for a specified DEX. `POST` `https://api.expand.network/dex/removeliquidity` #### Request Body | Name | Type | Description | | ------------------------------------------- | ------ | -------------------------------------------------------------------------------------- | | dexId\* | String | Refer to the [DEX ID](broken://pages/8x8qwIu19Aq8uFsjOXvI) page for details. | | tokenId\* | String | The token ID for uniswap V3 liquidity position. | | amountAMin | String | Minimum amount of Token A. | | amountAMax | String | Maximum amount of Token A. | | amountBMax | String | Maximum amount of Token B. | | recipient | String | Recipient for sweep tokens. | | deadline\* | String | Deadline for the transaction to be executed (UNIX Timestamp). | | from\* | String | Address of the sender of the token. | | gas | String | Maximum gas limit provided by the sender, for the transaction. | | rpc | String | Remote procedural call URL. | | tokenA\* | String | Address of the first token being removed. | | tokenB | String | Address of the second token being removed. | | liquidity\* | string | The liquidity to be removed. | | amountBMin | String | Minimum amount of Token B. | | gasPriority | String | low, medium, or high. | | slippage | String |

Percentage of total value.
By default, 1.

0 <= slippage value <= 100

| {% tabs %} {% tab title="Sample Request" %} ```json { "dexId": "1300", "tokenId": "38177", "tokenA":"0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2", "liquidity": "499737032187727318211", "amountAMin": "0", "amountBMin": "0", "deadline": "1763180052", "recipient": "0x0000000000000000000000000000000000000000", "amountAMax": "340282366920938463463374607431768211455", "amountBMax": "340282366920938463463374607431768211455", "tokenB": "0x6B175474E89094C44Da98b954EedeAC495271d0F", "from": "0x63056E00436Da25BcF48A40dfBbDcc7089351006", "gas": "2421200" } ``` {% endtab %} {% tab title="Sample Response" %} ```json { "status": 200, "msg": "success", "data": { "chainId": "1", "from": "0x63056E00436Da25BcF48A40dfBbDcc7089351006", "to": "0xC36442b4a4522E871399CD717aBDD847Ab11FE88", "value": "0", "gas": "2421200", "data": "0xac9650d80000000000000000000000000000000000000000000000000000000000000020000000000000000000000000000000000000000000000000000000000000000400000000000000000000000000000000000000000000000000000000000000800000000000000000000000000000000000000000000000000000000000000160000000000000000000000000000000000000000000000000000000000000022000000000000000000000000000000000000000000000000000000000000002a000000000000000000000000000000000000000000000000000000000000000a40c49ccbe000000000000000000000000000000000000000000000000000000000000952100000000000000000000000000000000000000000000001b173e970df1700cc300000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000006917fe14000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000084fc6f78650000000000000000000000000000000000000000000000000000000000009521000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000ffffffffffffffffffffffffffffffff00000000000000000000000000000000ffffffffffffffffffffffffffffffff00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000004449404b7c000000000000000000000000000000000000000000000000000000000000000000000000000000000000000063056e00436da25bcf48a40dfbbdcc7089351006000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000064df2ab5bb000000000000000000000000c02aaa39b223fe8d0a0e5c4f27ead9083c756cc2000000000000000000000000000000000000000000000000000000000000000000000000000000000000000063056e00436da25bcf48a40dfbbdcc708935100600000000000000000000000000000000000000000000000000000000", "estimationCheck": true, "referenceId": "00bdfa2223af4b21ac8ecad90acbebec" } } ``` {% endtab %} {% endtabs %} {% tabs %} {% tab title="Sample Request" %} **With gasPriority:** ```json { "dexId": "1300", "tokenId": "609214", "tokenA": "0x9813037ee2218799597d83D4a5B6F3b6778218d9", "liquidity": "202694601337334530", "chainId": "1", "amountAMin": "0", "amountBMin": "0", "recipientA": "0x0000000000000000000000000000000000000000", "amountAMax": "340282366920938463463374607431768211455", "amountBMax": "340282366920938463463374607431768211455", "amountMinimumA": "0", "recipientB": "0x4C99D660A51D41bE5D47D66a3d89d5B83D92f27E", "to": "0x4C99D660A51D41bE5D47D66a3d89d5B83D92f27E", "deadline": "1700642704004", "from": "0x4C99D660A51D41bE5D47D66a3d89d5B83D92f27E", "gas": "80000", "gasPriority":"medium" } ``` {% endtab %} {% tab title="Sample Response" %} **With gasPriority:** ```json { "status": 200, "msg": "success", "data": { "chainId": "1", "from": "0x4C99D660A51D41bE5D47D66a3d89d5B83D92f27E", "to": "0xC36442b4a4522E871399CD717aBDD847Ab11FE88", "value": "0", "gas": "80000", "data": "0xac9650d80000000000000000000000000000000000000000000000000000000000000020000000000000000000000000000000000000000000000000000000000000000400000000000000000000000000000000000000000000000000000000000000800000000000000000000000000000000000000000000000000000000000000160000000000000000000000000000000000000000000000000000000000000022000000000000000000000000000000000000000000000000000000000000002a000000000000000000000000000000000000000000000000000000000000000a40c49ccbe0000000000000000000000000000000000000000000000000000000000094bbe00000000000000000000000000000000000000000000000002d01daa7e99eb02000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000018bf6344a84000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000084fc6f78650000000000000000000000000000000000000000000000000000000000094bbe000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000ffffffffffffffffffffffffffffffff00000000000000000000000000000000ffffffffffffffffffffffffffffffff00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000004449404b7c00000000000000000000000000000000000000000000000000000000000000000000000000000000000000004c99d660a51d41be5d47d66a3d89d5b83d92f27e000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000064df2ab5bb0000000000000000000000009813037ee2218799597d83d4a5b6f3b6778218d900000000000000000000000000000000000000000000000000000000000000000000000000000000000000004c99d660a51d41be5d47d66a3d89d5b83d92f27e00000000000000000000000000000000000000000000000000000000", "gasPrice": "31358145710", "estimationCheck": true, "referenceId": "f5e038c02dfb469fb0427f23e3cc1730" } } ``` {% endtab %} {% endtabs %} {% tabs %} {% tab title="Sample Request" %} **With slippage:** ```json { "dexId": "1300", "tokenId": "38177", "tokenA": "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2", "liquidity": "499737032187727318211", "amountAMin": "10000000", "amountBMin": "10000000", "deadline": "1763180052", "recipient": "0x0000000000000000000000000000000000000000", "amountAMax": "340282366920938463463374607431768211455", "amountBMax": "340282366920938463463374607431768211455", "tokenB": "0x6B175474E89094C44Da98b954EedeAC495271d0F", "from": "0x63056E00436Da25BcF48A40dfBbDcc7089351006", "gas": "2421200", "slippage": "9.50" } ``` {% endtab %} {% tab title="Sample Response" %} **With slippage:** ```json { "status": 200, "msg": "success", "data": { "chainId": "1", "from": "0x63056E00436Da25BcF48A40dfBbDcc7089351006", "to": "0xC36442b4a4522E871399CD717aBDD847Ab11FE88", "value": "0", "gas": "2421200", "data": "0xac9650d80000000000000000000000000000000000000000000000000000000000000020000000000000000000000000000000000000000000000000000000000000000400000000000000000000000000000000000000000000000000000000000000800000000000000000000000000000000000000000000000000000000000000160000000000000000000000000000000000000000000000000000000000000022000000000000000000000000000000000000000000000000000000000000002a000000000000000000000000000000000000000000000000000000000000000a40c49ccbe000000000000000000000000000000000000000000000000000000000000952100000000000000000000000000000000000000000000001b173e970df1700cc300000000000000000000000000000000000000000000000000000000008a179000000000000000000000000000000000000000000000000000000000008a1790000000000000000000000000000000000000000000000000000000006917fe14000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000084fc6f78650000000000000000000000000000000000000000000000000000000000009521000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000ffffffffffffffffffffffffffffffff00000000000000000000000000000000ffffffffffffffffffffffffffffffff00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000004449404b7c00000000000000000000000000000000000000000000000000000000008a179000000000000000000000000063056e00436da25bcf48a40dfbbdcc7089351006000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000064df2ab5bb000000000000000000000000c02aaa39b223fe8d0a0e5c4f27ead9083c756cc200000000000000000000000000000000000000000000000000000000008a179000000000000000000000000063056e00436da25bcf48a40dfbbdcc708935100600000000000000000000000000000000000000000000000000000000", "estimationCheck": true, "referenceId": "73e42929b7ea42d08b3aee4416191b47" } } ``` {% endtab %} {% endtabs %} [back to top](#endpoints-available) --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.expand.network/integrations/dex-and-dex-aggregators/uniswap-v3.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.