# Uniswap V2 ### /getprice Returns the swap quotation for the given token pair. `GET` `https://api.expand.network/dex/getprice` #### Query Parameters | Name | Type | Description | | ------------------------------------------ | ------ | ----------------------------------------------------------------------- | | rpc | String | Remote procedural call URL. | | dexId | String | Refer to the [DEX ID](/ids/dex-ids.md) page for details. | | path\* | String | Comma separated values of token addresses whose price is to be fetched. | | amountIn\* | String | Amount of token. | {% tabs %} {% tab title="Sample Request" %} ```url https://api.expand.network/dex/getprice?dexId=1000&path=0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2,0xdac17f958d2ee523a2206206994597c13d831ec7&amountIn=10000000000000000000 ``` {% endtab %} {% tab title="Sample Response" %} ```json { "status": 200, "msg": "success", "data": { "amountIn": "10000000000000000000", "path": [ "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2", "0xdac17f958d2ee523a2206206994597c13d831ec7" ], "amountsOut": [ "10000000000000000000", "15682130807" ] } } ``` {% endtab %} {% endtabs %} ### /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. | | tokenA\* | String | Address of token. | | address\* | String | Public address of liquidity provider. | | dexId | String | Refer to [DEX ID](/ids/dex-ids.md) page for details. | | tokenB\* | String | Address of token. | {% tabs %} {% tab title="Sample Request" %} ```url https://api.expand.network/dex/getuserliquidity?tokenA=0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2&tokenB=0x6b175474e89094c44da98b954eedeac495271d0f&address=0x6fb447ae94f5180254d436a693907a1f57696900&dexId=1000 ``` {% endtab %} {% tab title="Sample Response" %} ```json { "status": 200, "msg": "success", "data": { "pairAddress": "0xA478c2975Ab1Ea89e8196811F51A7B7Ade33eB11", "liquidity": "2087379027763486", "tokenA": "91297717639957", "tokenB": "153006474077467970" } } ``` {% endtab %} {% endtabs %} ### /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](/ids/dex-ids.md) page for details. | {% tabs %} {% tab title="Sample Request" %} ```url https://api.expand.network/dex/getpoolliquidity?poolAddress=0x0d4a11d5eeaac28ec3f61d100daf4d40471f1852&dexId=1000 ``` {% endtab %} {% tab title="Sample Response" %} ```json { "status": 200, "msg": "success", "data": { "totalLiquidity": "312219425553389289" } } ``` {% endtab %} {% endtabs %} ### /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](/ids/dex-ids.md) page for details. | {% tabs %} {% tab title="Sample Request" %} ``` https://api.expand.network/dex/gettokenliquidity?poolAddress=0x0d4a11d5eeaac28ec3f61d100daf4d40471f1852&dexId=1000 ``` {% endtab %} {% tab title="Sample Response" %} ```json { "status": 200, "msg": "success", "data": { "WETH": "16984981267096993883931", "USDT": "31586831096555" } } ``` {% endtab %} {% endtabs %} ### /getindividualposition Returns the liquidity position for a specified user address across all the pools for the 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](/ids/dex-ids.md) page for details. | | poolAddresses | String | The pool Addresses whose liquidity is to be fetched. *(Comma-separated vaules)* | | poolSize | String |

The number of pools for which the user intends to fetch the individual position.
By default: 50, Maximum: 9,950

| {% tabs %} {% tab title="Sample Request" %} ```url https://api.expand.network/dex/getindividualposition?dexId=1000&address=0x6Fb447Ae94F5180254D436A693907a1f57696900 ``` {% endtab %} {% tab title="Sample Response" %} ```json { "status": 200, "msg": "success", "data": { "aggregatedLiquidity": "2370404879481514", "poolAddresses": { "DAIWETH": { "0xA478c2975Ab1Ea89e8196811F51A7B7Ade33eB11": "2370404879481514" } } } } ``` {% endtab %} {% endtabs %} ### /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](/ids/dex-ids.md) 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=0xa43fe16908251ee70ef74718545e4fe6c5ccec9f&dexId=1000&startBlock=21358069&endBlock=21359069 ``` {% endtab %} {% tab title="Sample Response" %} ```json { "status": 200, "msg": "success", "data": [ { "userAddress": "0x93a01d90016335f33735c02c5fa91c7a17f72569", "liquidityData": [ { "blockNumber": "21359069", "transactionHash": "0xd69c1ff2bc34c148db6b2b7007c3d5d7313fb106fcf0418e8e9148b45d5ab528", "assets": { "PEPE": "35060749841636831432190339", "WETH": "234823806408693706" } } ] } ] } ``` {% endtab %} {% endtabs %} ### /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=1000&tokenA=0xE0f63A424a4439cBE457D80E4f4b51aD25b2c56C&tokenB=0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2 ``` {% endtab %} {% tab title="Sample Response" %} ```json { "status": 200, "msg": "success", "data": [ { "poolAddress": "0x52c77b0CB827aFbAD022E6d6CAF2C44452eDbc39", "tickSpacing": "NA", "poolFees": "NA", "tokensLiquidity": { "WETH": "2910405301067921285758", "SPX": "908036884543124" }, "liquidity": "275719418962876831" } ] } ``` {% endtab %} {% endtabs %} ### /gethistoricaltimeseries Get the historical time series transactions for a specific pool address. `GET` `https://historicaltrade.api.expand.network/dex/gethistoricaltimeseries` #### Query Parameters | Name | Type | Description | | --------------------------------------------- | ------ | ---------------------------------------------------- | | dexId\* | String | Refer to [DEX ID](/ids/dex-ids.md) 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?poolAddress=0x517f9dd285e75b599234f7221227339478d0fcc8&dexId=1000 ``` {% endtab %} {% tab title="Sample Response" %} ```json { "status": 200, "msg": "success", "data": { "pair": "DAI/MKR", "priceData": [ { "hash": "0x0700027e70d6d216810815c38a0959fe0635867ea2480ab1f6e20d3c98731ff0", "timestamp": 1703748059, "price": "0.0006244081987727642" }, { "hash": "0x1c3b182bb64097b756b03aaa3717663af8064ecf3e05f02f7b6e339785558f1f", "timestamp": 1703747891, "price": "0.0006261003865058129" }, { "hash": "0xec8964514a2cb94d565c84794cf7125333f2a18e376764fc24c5fd32df09a93e", "timestamp": 1703747855, "price": "0.0006274642197158615" }, { "hash": "0x4ece3e41b95e78c882ce79ec2fa80bd7eef0503a6d7b759bc3336cc9fc40867b", "timestamp": 1703747843, "price": "0.00062797052848499" }, { "hash": "0xf4e8eb0cc1661d952dc0e2d5d5ee2b16dd66b5f8a275fd3d148dd9ce53ed7964", "timestamp": 1703746955, "price": "0.0006318073557952554" }, { "hash": "0xcae75ad1f4b23672972cc793b8dfa97e5c257f368ed3b6d72afb1bcb92444ea5", "timestamp": 1703746403, "price": "0.0006311921656383271" }, { "hash": "0xbf1eef520c783cd699c1b040b8c1274c90ff4cc76b24994fb95123e3a9b360d5", "timestamp": 1703746355, "price": "0.0006303980131723315" }, { "hash": "0xddf411be6d49bcddcc306cae01f4a3d7bbee240a295ba18e1a762e3a3290f302", "timestamp": 1703746319, "price": "0.000629607991380723" }, { "hash": "0x31e8736e4e7eb1f862bfc4a66414859bb49102390bb97736facf4613035a81e5", "timestamp": 1703745695, "price": "0.0006261412353574351" }, { "hash": "0x6dea226fba19c1da6e96feb49511e1fef3a27cbded505e3d597bb9e5f5121e9e", "timestamp": 1703745083, "price": "0.0006301614630221084" }, { "hash": "0xc1ae0d5cb6774c9b76c3f005eb136b9fb5951c0d32f1027806d755ff45760b0d", "timestamp": 1703744891, "price": "0.000629113433416803" }, { "hash": "0x20937932802b6eb955192a589c7e0143127554fa60f05a429dc25f5cc6342f5e", "timestamp": 1703743655, "price": "0.0006273380063042033" }, { "hash": "0xaf2d9bfae18358fb785d4a7ae8b35099c63777c557e92db96c98bc0b41531071", "timestamp": 1703743631, "price": "0.0006255421068541817" }, { "hash": "0x161d09fdd5e30165040ebd65832b35337fd608d47e119a139f608b2045410409", "timestamp": 1703742575, "price": "0.0006215430273569083" }, { "hash": "0xc264388fba6edb499d5846a456217a4ddf0668d156356c8695ab34c6be55ce23", "timestamp": 1703742515, "price": "0.0006222533452384632" } ] } } ``` {% endtab %} {% endtabs %} ### /gethistoricaltransactions Get the historical transactions focusing on swaps associated with a specific pool address. `GET` `https://historicaltrade.api.expand.network/dex/gethistoricaltransactions` #### Query Parameters | Name | Type | Description | | --------------------------------------------- | ------ | ---------------------------------------------------- | | dexId\* | String | Refer to [DEX ID](/ids/dex-ids.md) 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=0xb4e16d0168e52d35cacd2c6185b44281ec28c9dc&dexId=1000 ``` {% endtab %} {% tab title="Sample Response" %} ```json { "status": 200, "msg": "success", "data": { "pair": "USDC/WETH", "transactions": [ { "transactionHash": "0xe02a5ced07a09949bb143486c5d57947d0b904d7ffa620637e2b11a4810ff645", "transactionDetails": { "blockHash": "0xa870d68aa85ea355176dd1f49912cb0df145a967a8a6789a2e9a9ca659aabfc5", "blockNumber": "18879055", "from": "0xcc4ea98876f3ee733712ac64137c34e637fc2dae", "gas": "203074", "gasPrice": "30150130093", "maxFeePerGas": "41820000000", "maxPriorityFeePerGas": "110000000", "hash": "0xe02a5ced07a09949bb143486c5d57947d0b904d7ffa620637e2b11a4810ff645", "input": "0xf305d719000000000000000000000000a0b86991c6218b36c1d19d4a2e9eb0ce3606eb48000000000000000000000000000000000000000000000000000000e210966f48000000000000000000000000000000000000000000000000000000e0ef3985c30000000000000000000000000000000000000000000000164f0244c4ce3dffe6000000000000000000000000cc4ea98876f3ee733712ac64137c34e637fc2dae00000000000000000000000000000000000000000000000000000000658c7c4b", "nonce": "212", "to": "0x7a250d5630b4cf539739df2c5dacb4c659f2488d", "transactionIndex": "88", "value": "413589505640828440000", "type": "2", "accessList": [], "chainId": "1", "v": "0x0", "r": "0xc01569d522e3ed0c193fbc1e6cf689d61ab1affdcdba0eab79fa09afe441415f", "s": "0x4fe253f33af8c7efa878194c1d074b4b4ff662016eb47a7dd0d1948f30b45e73", "yParity": "0x0" } } ] } } ``` {% endtab %} {% endtabs %} ### /gethistoricalpoolchartdata Get the data the OHCLV (Open, High, Close, Low, and Volume) within the specified time interval for pool on Uniswap V2. `GET` `https://api.expand.network/dex/gethistoricalpoolchartdata` #### Query Parameter | Name | Type | Description | | --------------------------------------------- | ------ | -------------------------------------------------------------------------------------------------------------------------- | | dexId\* | String | Refer to [DEX ID](/ids/dex-ids.md) 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?limit=100&interval=15m&dexId=1000&poolAddress=0x517F9dD285e75b599234F7221227339478d0FcC8 ``` {% endtab %} {% tab title="Sample Response" %} ```json { "status": 200, "msg": "success", "data": { "pair": "DAI/MKR", "chartData": [ { "1717125831-1717131231": { "open": "0.000362632162257", "high": "0.000362632162257", "low": "0.000361794833636", "close": "0.000361794833636", "volume": "116481.29177121137" } }, { "1717131231-1717136631": { "open": "0.000361794833636", "high": "0.000365928955432", "low": "0.000361794833636", "close": "0.000365928955432", "volume": "235921.476776501" } }, { "1717136631-1717142031": { "open": "0.000365928955432", "high": "0.000365928955432", "low": "0.000362839374156", "close": "0.000364908316209", "volume": "134774.33877705893" } }, { "1717142031-1717147431": { "open": "0.000364908316209", "high": "0.000364994397092", "low": "0.00036205860551", "close": "0.000362058605510", "volume": "107370.6898340171" } }, { "1717147431-1717152831": { "open": "0.000362058605510", "high": "0.00036205860551", "low": "0.000359033408766", "close": "0.000359033408766", "volume": "336427.99136697256" } }, { "1717152831-1717158231": { "open": "0.000359033408766", "high": "0.000359033408766", "low": "0.000356260063139", "close": "0.000356260063139", "volume": "298827.4098542738" } }, { "1717158231-1717163631": { "open": "0.000356260063139", "high": "0.000361164606828", "low": "0.000355876159312", "close": "0.000361164606828", "volume": "411818.4971458898" } }, { "1717163631-1717169031": { "open": "0.000361164606828", "high": "0.000363586360976", "low": "0.000361164606828", "close": "0.000363586360976", "volume": "261654.1491814648" } }, { "1717169031-1717174431": { "open": "0.000363586360976", "high": "0.000367226232551", "low": "0.000363586360976", "close": "0.000365009517321", "volume": "439832.30726375314" } }, { "1717174431-1717179831": { "open": "0.000365009517321", "high": "0.000365009517321", "low": "0.000363441412141", "close": "0.000363441412141", "volume": "149974.2380735921" } }, { "1717179831-1717185231": { "open": "0.000363441412141", "high": "0.000363441412141", "low": "0.00036319351977", "close": "0.000363193519770", "volume": "34293.96745051358" } }, { "1717185231-1717190631": { "open": "0.000363193519770", "high": "0.00036319351977", "low": "0.000362332243839", "close": "0.000362332243839", "volume": "92751.61460970972" } }, { "1717190631-1717196031": { "open": "0.000362332243839", "high": "0.000365110121117", "low": "0.000362332243839", "close": "0.000365110121117", "volume": "84731.33451069353" } }, { "1717196031-1717201431": { "open": "0.000365110121117", "high": "0.000370459107108", "low": "0.000365110121117", "close": "0.000370459107108", "volume": "562503.5842784377" } }, { "1717201431-1717206831": { "open": "0.000370459107108", "high": "0.000370787680558", "low": "0.000370459107108", "close": "0.000370787680558", "volume": "40674.1448916809" } }, { "1717206831-1717212231": { "open": "0.000370787680558", "high": "0.000370787680558", "close": "0.000370787680558", "low": "0.000370787680558", "volume": "0" } }, { "1717212231-1717217631": { "open": "0.000370787680558", "high": "0.000370787680558", "low": "0.000367479192595", "close": "0.000367479192595", "volume": "141155.25179660812" } }, { "1717217631-1717223031": { "open": "0.000367479192595", "high": "0.000367479192595", "low": "0.000367318759906", "close": "0.000367318759906", "volume": "6405.706904196158" } }, { "1717223031-1717228431": { "open": "0.000367318759906", "high": "0.000367318759906", "close": "0.000367318759906", "low": "0.000367318759906", "volume": "0" } }, { "1717228431-1717233831": { "open": "0.000367318759906", "high": "0.000367318759906", "low": "0.000367258190562", "close": "0.000367258190562", "volume": "6561.94365795704" } }, { "1717233831-1717239231": { "open": "0.000367258190562", "high": "0.000370245962397", "low": "0.000367258190562", "close": "0.000370245962397", "volume": "91673.4718149821" } }, { "1717239231-1717244631": { "open": "0.000370245962397", "high": "0.000372848707784", "low": "0.000370245962397", "close": "0.000372848707784", "volume": "302051.36778228875" } }, { "1717244631-1717250031": { "open": "0.000372848707784", "high": "0.000373255574321", "low": "0.000372848707784", "close": "0.000373255574321", "volume": "15550.594379299635" } }, { "1717250031-1717255431": { "open": "0.000373255574321", "high": "0.000373527782488", "low": "0.000371102274044", "close": "0.000371102274044", "volume": "61022.01807920491" } }, { "1717255431-1717260831": { "open": "0.000371102274044", "high": "0.000373300780092", "low": "0.000371102274044", "close": "0.000373300780092", "volume": "32143.056071166695" } }, { "1717260831-1717266231": { "open": "0.000373300780092", "high": "0.000373593989008", "low": "0.000373300780092", "close": "0.000373593989008", "volume": "29080.840115908824" } }, { "1717266231-1717271631": { "open": "0.000373593989008", "high": "0.000374035210903", "low": "0.000373593989008", "close": "0.000374035210903", "volume": "52720.216943570405" } }, { "1717271631-1717277031": { "open": "0.000374035210903", "high": "0.000374274458383", "low": "0.000374035210903", "close": "0.000374274458383", "volume": "6877.1558868414995" } }, { "1717277031-1717282431": { "open": "0.000374274458383", "high": "0.000374274458383", "low": "0.000371999332044", "close": "0.000371999332044", "volume": "13045.768939033636" } }, { "1717282431-1717287831": { "open": "0.000371999332044", "high": "0.000371999332044", "low": "0.000371909662179", "close": "0.000371909662179", "volume": "5780.75988915263" } }, { "1717287831-1717293231": { "open": "0.000371909662179", "high": "0.000371909662179", "low": "0.000370992647421", "close": "0.000370992647421", "volume": "97770.29458585857" } }, { "1717293231-1717298631": { "open": "0.000370992647421", "high": "0.000373227199414", "low": "0.000370992647421", "close": "0.000373227199414", "volume": "7193.474706512013" } }, { "1717298631-1717304031": { "open": "0.000373227199414", "high": "0.000373797899718", "low": "0.000373227199414", "close": "0.000373797899718", "volume": "59414.48037483847" } }, { "1717304031-1717309431": { "open": "0.000373797899718", "high": "0.000374304087103", "low": "0.000373797899718", "close": "0.000374304087103", "volume": "54211.467425947136" } }, { "1717309431-1717314831": { "open": "0.000374304087103", "high": "0.00037558397742", "low": "0.000374304087103", "close": "0.000375583977420", "volume": "129562.12395260207" } }, { "1717368831-1717374231": { "open": "0.000378870323560", "high": "0.00037887032356", "low": "0.000378289301449", "close": "0.000378289301449", "volume": "57860.0799234203" } }, ] } } ``` {% endtab %} {% endtabs %} ### /getpoolchartdata Get the data for the pool and obtain the OHCL (Open, High, Close, Low) prices within the specified time interval. `GET` `https://historicaltrade.api.expand.network/dex/getpoolchartdata` #### Query Parameters | Name | Type | Description | | --------------------------------------------- | ------ | ---------------------------------------------------- | | dexId\* | String | Refer to [DEX ID](/ids/dex-ids.md) page for details. | | interval | String | 15 mins(by default), 30 mins, 60 mins, and 90 mins. | | poolAddress\* | String | Pool address whose transactions is to be fetched. | {% tabs %} {% tab title="Sample Request" %} ```url https://historicaltrade.api.expand.network/dex/getpoolchartdata?dexId=1000&poolAddress=0xb4e16d0168e52d35cacd2c6185b44281ec28c9dc&interval=60 ``` {% endtab %} {% tab title="Sample Response" %} ```json { "status": 200, "msg": "success", "data": { "pair": "USDC/WETH", "chartData": { "18882523 to 18882800": [ { "open_price": "419005433942909", "close_price": "419447697581705", "low_price": "418943818861548", "high_price": "422263827518504", "transactions": [ { "blockNumber": "18882529", "price": "418986597113367", "amount": { "token0": "2400000000", "token1": "1005567833072081114" } }, { "blockNumber": "18882531", "price": "421498241454276", "amount": { "token0": "679221347", "token1": "286290603318704585" } }, { "blockNumber": "18882538", "price": "418975454284176", "amount": { "token0": "376508407", "token1": "157747780864636534" } }, { "blockNumber": "18882543", "price": "418968454985399", "amount": { "token0": "513835000", "token1": "215280656067422305" } }, { "blockNumber": "18882543", "price": "418963677671102", "amount": { "token0": "93100000", "token1": "39005518391179607" } }, { "blockNumber": "18882548", "price": "418960589212921", "amount": { "token0": "300000000", "token1": "125688176763876449" } }, { "blockNumber": "18882560", "price": "418954948262823", "amount": { "token0": "417601922", "token1": "174956391625965577" } }, { "blockNumber": "18882561", "price": "418947749154645", "amount": { "token0": "498134300", "token1": "208692243761724622" } }, { "blockNumber": "18882565", "price": "421805099375960", "amount": { "token0": "42147657986", "token1": "17778097065248708608" } } ] } ] } } } ``` {% endtab %} {% endtabs %} ### /getpooltradedata Get the trade data from the pool within a specified block range, for the specified event type `GET` `https://historicaltrade.api.expand.network/dex/getpooltradedata` #### Query Parameters | Name | Type | Description | | --------------------------------------------- | ------ | ---------------------------------------------------- | | dexId\* | String | Refer to [DEX ID](/ids/dex-ids.md) 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 | Transfer, Swap, Burn or Mint(by default). | {% tabs %} {% tab title="Sample Request" %} ```url https://historicaltrade.api.expand.network/dex/getpooltradedata?poolAddress=0xb4e16d0168e52d35cacd2c6185b44281ec28c9dc&dexId=1000&eventType=Burn ``` {% endtab %} {% tab title="Sample Response" %} ```json { "status": 200, "msg": "success", "data": { "pair": "USDC/WETH", "transactions": [ { "blockNumber": "18880403", "transactionHash": "0x47d3993957a8497a7549276c96b3c18987586075f5882124cfd477fd989cd3fd", "values": { "0": "0x7a250d5630B4cF539739dF2C5dAcb4c659F2488D", "1": "1596637993", "2": "671389840781055738", "3": "0x7a250d5630B4cF539739dF2C5dAcb4c659F2488D", "sender": "0x7a250d5630B4cF539739dF2C5dAcb4c659F2488D", "amount0": "1596637993", "amount1": "671389840781055738", "to": "0x7a250d5630B4cF539739dF2C5dAcb4c659F2488D" }, "eventType": "Burn", "data": { "data": "0x000000000000000000000000000000000000000000000000000000005f2ac32900000000000000000000000000000000000000000000000009514180c58f96fa", "topics": [ "0xdccd412f0b1252819cb1fd330b93224ca42612892bb3f4f789976e6d81936496", "0x0000000000000000000000007a250d5630b4cf539739df2c5dacb4c659f2488d", "0x0000000000000000000000007a250d5630b4cf539739df2c5dacb4c659f2488d" ] } }, { "blockNumber": "18879029", "transactionHash": "0x22c9fcffc57264eb4270f2ecf0d4f23b39a3871adcee89414285f3a1e1f152e2", "values": { "0": "0x7a250d5630B4cF539739dF2C5dAcb4c659F2488D", "1": "970041191908", "2": "413293955455183879313", "3": "0x7a250d5630B4cF539739dF2C5dAcb4c659F2488D", "sender": "0x7a250d5630B4cF539739dF2C5dAcb4c659F2488D", "amount0": "970041191908", "amount1": "413293955455183879313", "to": "0x7a250d5630B4cF539739dF2C5dAcb4c659F2488D" }, "eventType": "Burn", "data": { "data": "0x000000000000000000000000000000000000000000000000000000e1daf5ede4000000000000000000000000000000000000000000000016679b16c2e259fc91", "topics": [ "0xdccd412f0b1252819cb1fd330b93224ca42612892bb3f4f789976e6d81936496", "0x0000000000000000000000007a250d5630b4cf539739df2c5dacb4c659f2488d", "0x0000000000000000000000007a250d5630b4cf539739df2c5dacb4c659f2488d" ] } } ] } } ``` {% endtab %} {% endtabs %} ### /swap Initiate a swap transaction on a specified DEX. `POST` `https://api.expand.network/dex/swap` #### Request Body | Name | Type | Description | | ---------------------------------------------- | ------ | ------------------------------------------------------------------------------------------- | | dexId | String | Refer to the [DEX ID](/ids/dex-ids.md) page for details. | | path\* | Array | Comma-separated values of token addresses, inside an array, to swap. | | amountIn\* | String | Amount of token to be swapped. | | amountOutmin\* | String | Minimum amount accepted as the result of swap. | | to\* | String | Address of the recipient of the token. | | 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. | | gasPriority | String | low, medium, or high. | | slippage | String |

Percentage of total swap value.
By default, 1.

0 <= slippage value <= 100

| {% tabs %} {% tab title="Sample Request" %} ```json { "dexId":"1000", "amountIn": "1000000000000000", "amountOutMin": "0", "path": ["0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2","0x6B175474E89094C44Da98b954EedeAC495271d0F"], "to": "0x63056E00436Da25BcF48A40dfBbDcc7089351006", "deadline": "1665990894", "from": "0x63056E00436Da25BcF48A40dfBbDcc7089351006", "gas": "173376" } ``` {% endtab %} {% tab title="Sample Response" %} ```json { "status": 200, "msg": "success", "data": { "chainId": "1", "from": "0x63056E00436Da25BcF48A40dfBbDcc7089351006", "to": "0x7a250d5630B4cF539739dF2C5dAcb4c659F2488D", "value": "0", "gas": "173376", "data": "0x38ed173900000000000000000000000000000000000000000000000000038d7ea4c68000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000a000000000000000000000000063056e00436da25bcf48a40dfbbdcc708935100600000000000000000000000000000000000000000000000000000000634d00ee0000000000000000000000000000000000000000000000000000000000000002000000000000000000000000c02aaa39b223fe8d0a0e5c4f27ead9083c756cc20000000000000000000000006b175474e89094c44da98b954eedeac495271d0f", "estimationCheck": true, "referenceId": "f6e53dc2b6404645bf503e547811a0d4" } } ``` {% endtab %} {% endtabs %} {% tabs %} {% tab title="Sample Request" %} **With gasPriority:** 
{
    "dexId": "1000",
    "amountIn": "10000000000",
    "amountOutMin": "0",
    "path": [
        "0x6B175474E89094C44Da98b954EedeAC495271d0F",
        "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2"
    ],
    "to": "0x356dB816602c85e2075774bB77D13995c8Bab023",
    "deadline": "1765990894",
    "from": "0x356dB816602c85e2075774bB77D13995c8Bab023",
    "gas": "273376",
    "gasPriority": "high"
}
{% endtab %} {% tab title="Sample Response" %} **With gasPriority:** ```json { "status": 200, "msg": "success", "data": { "chainId": "1", "from": "0x356dB816602c85e2075774bB77D13995c8Bab023", "to": "0x7a250d5630B4cF539739dF2C5dAcb4c659F2488D", "value": "0", "gas": "273376", "data": "0x38ed173900000000000000000000000000000000000000000000000000000002540be400000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000a0000000000000000000000000356db816602c85e2075774bb77d13995c8bab023000000000000000000000000000000000000000000000000000000006942e1ee00000000000000000000000000000000000000000000000000000000000000020000000000000000000000006b175474e89094c44da98b954eedeac495271d0f000000000000000000000000c02aaa39b223fe8d0a0e5c4f27ead9083c756cc2", "gasPrice": "35333757810", "estimationCheck": true, "referenceId": "c65d3c66ac72477786f5aa4a3b7dd192" } } ``` {% endtab %} {% endtabs %} {% tabs %} {% tab title="Sample Request" %} **With Slippage:** ```json { "dexId": "1000", "amountIn": "10000000000000", "amountOutMin": "0", "path": [ "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2", "0x6B175474E89094C44Da98b954EedeAC495271d0F" ], "to": "0x22cf65ae3fa16d6379e72f4b4c2401c1b7c69731", "deadline": "1701931771", "from": "0x22cf65ae3fa16d6379e72f4b4c2401c1b7c69731", "gas": "173376", "slippage": "10" } ``` {% endtab %} {% tab title="Sample Response" %} **With Slippage:** ```json { "status": 200, "msg": "success", "data": { "chainId": "1", "from": "0x22cf65ae3fa16d6379e72f4b4c2401c1b7c69731", "to": "0x7a250d5630B4cF539739dF2C5dAcb4c659F2488D", "value": "0", "gas": "173376", "data": "0x38ed1739000000000000000000000000000000000000000000000000000009184e72a000000000000000000000000000000000000000000000000000004f2c564cb7cb0000000000000000000000000000000000000000000000000000000000000000a000000000000000000000000022cf65ae3fa16d6379e72f4b4c2401c1b7c697310000000000000000000000000000000000000000000000000000000065716afb0000000000000000000000000000000000000000000000000000000000000002000000000000000000000000c02aaa39b223fe8d0a0e5c4f27ead9083c756cc20000000000000000000000006b175474e89094c44da98b954eedeac495271d0f", "estimationCheck": true, "referenceId": "431c127d298b4a8484ced40bc34a55ab" } } ``` {% endtab %} {% endtabs %} ### /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](/ids/dex-ids.md) page for details. | | tokenA\* | String | Address of the first token being added. | | tokenB\* | String | Address of the second token being added. | | 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. | | 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": "1000", "tokenA": "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2", "tokenB": "0x6B175474E89094C44Da98b954EedeAC495271d0F", "amountADesired": "1000000000000000", "amountBDesired": "1332066335118442626", "amountAMin": "0", "amountBMin": "0", "to": "0x63056E00436Da25BcF48A40dfBbDcc7089351006", "deadline": "166978170", "from": "0x63056E00436Da25BcF48A40dfBbDcc7089351006", "gas": "230000" } ``` {% endtab %} {% tab title="Sample Response" %} ```json { "status": 200, "msg": "success", "data": { "chainId": "1", "from": "0x63056E00436Da25BcF48A40dfBbDcc7089351006", "to": "0x7a250d5630B4cF539739dF2C5dAcb4c659F2488D", "value": "0", "gas": "230000", "data": "0xe8e33700000000000000000000000000c02aaa39b223fe8d0a0e5c4f27ead9083c756cc20000000000000000000000006b175474e89094c44da98b954eedeac495271d0f00000000000000000000000000000000000000000000000000038d7ea4c68000000000000000000000000000000000000000000000000000127c734631fdc0820000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000063056e00436da25bcf48a40dfbbdcc70893510060000000000000000000000000000000000000000000000000000000009f3e27a", "estimationCheck": true, "referenceId": "a7fa313845d84addb36a61ae0cfed8fe" } } ``` {% endtab %} {% endtabs %} {% tabs %} {% tab title="Sample Request" %} **With gasPriority:** ```json { "dexId": "1000", "tokenA": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48", "tokenB": "0x6B175474E89094C44Da98b954EedeAC495271d0F", "amountADesired": "1000", "amountBDesired": "997726184637093", "amountAMin": "0", "amountBMin": "0", "poolFees":"3000", "from": "0x356dB816602c85e2075774bB77D13995c8Bab023", "to":"0x356dB816602c85e2075774bB77D13995c8Bab023", "deadline":"1699965863785", "gas": "0", "gasPriority":"medium" } ``` {% endtab %} {% tab title="Sample Response" %} **With gasPriority:** ```json { "status": 200, "msg": "success", "data": { "chainId": "1", "from": "0x356dB816602c85e2075774bB77D13995c8Bab023", "to": "0x7a250d5630B4cF539739dF2C5dAcb4c659F2488D", "value": "0", "gas": "0", "data": "0xe8e33700000000000000000000000000a0b86991c6218b36c1d19d4a2e9eb0ce3606eb480000000000000000000000006b175474e89094c44da98b954eedeac495271d0f00000000000000000000000000000000000000000000000000000000000003e800000000000000000000000000000000000000000000000000038b6d3ad182a500000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000356db816602c85e2075774bb77d13995c8bab0230000000000000000000000000000000000000000000000000000018bcddc8769", "gasPrice": "28418670209", "estimationCheck": true, "referenceId": "9aad6d0b4428499ca9247ea8ee76e63b" } } ``` {% endtab %} {% endtabs %} {% tabs %} {% tab title="Sample Request" %} **With Slippage:** ```json { "dexId": "1000", "tokenA": "0xdAC17F958D2ee523a2206206994597C13D831ec7", "tokenB": "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2", "amountADesired": "1000000", "amountBDesired": "640706397834636", "amountAMin": "100", "amountBMin": "100", "to": "0x22cf65Ae3fa16d6379E72F4B4c2401c1B7C69731", "deadline": "1712015780705", "from": "0x22cf65Ae3fa16d6379E72F4B4c2401c1B7C69731", "gas": "230000", "slippage": "5.00001" } ``` {% endtab %} {% tab title="Sample Response" %} **With Slippage:** ```json { "status": 200, "msg": "success", "data": { "chainId": "1", "from": "0x22cf65Ae3fa16d6379E72F4B4c2401c1B7C69731", "to": "0x7a250d5630B4cF539739dF2C5dAcb4c659F2488D", "value": "0", "gas": "230000", "data": "0xe8e33700000000000000000000000000dac17f958d2ee523a2206206994597c13d831ec7000000000000000000000000c02aaa39b223fe8d0a0e5c4f27ead9083c756cc200000000000000000000000000000000000000000000000000000000000f4240000000000000000000000000000000000000000000000000000246b8153f8d8c000000000000000000000000000000000000000000000000000000000000005f000000000000000000000000000000000000000000000000000000000000005f00000000000000000000000022cf65ae3fa16d6379e72f4b4c2401c1b7c697310000000000000000000000000000000000000000000000000000018e9c17ab61", "estimationCheck": true, "referenceId": "a451275a6d5f4f789ac6c09c2bfe55cb" } } ``` {% endtab %} {% endtabs %} ### /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](/ids/dex-ids.md) page for details. | | tokenA\* | String | Address of the first token being removed. | | tokenB\* | String | Address of the second token being removed. | | liquidity\* | String | Total amount of liquidity to be removed from the given pool. | | 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. | | 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": "1000", "tokenA": "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2", "tokenB": "0x6B175474E89094C44Da98b954EedeAC495271d0F", "liquidity": "20759430672661383", "amountAMin": "0", "amountBMin": "0", "to": "0x63056E00436Da25BcF48A40dfBbDcc7089351006", "deadline": "1669720626", "from": "0x63056E00436Da25BcF48A40dfBbDcc7089351006", "gas": "420000" } ``` {% endtab %} {% tab title="Sample Response" %} ```json { "status": 200, "msg": "success", "data": { "chainId": "1", "from": "0x63056E00436Da25BcF48A40dfBbDcc7089351006", "to": "0x7a250d5630B4cF539739dF2C5dAcb4c659F2488D", "value": "0", "gas": "420000", "data": "0xbaa2abde000000000000000000000000c02aaa39b223fe8d0a0e5c4f27ead9083c756cc20000000000000000000000006b175474e89094c44da98b954eedeac495271d0f0000000000000000000000000000000000000000000000000049c0979afbbb870000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000063056e00436da25bcf48a40dfbbdcc7089351006000000000000000000000000000000000000000000000000000000006385ea32", "estimationCheck": true, "referenceId": "6d8ff104b4e84b79a3d7a750e103be44" } } ``` {% endtab %} {% endtabs %} {% tabs %} {% tab title="Sample Request" %} **With gasPriority:** ```json { "dexId": "1000", "tokenA": "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2", "tokenB": "0x6B175474E89094C44Da98b954EedeAC495271d0F", "liquidity": "20759430672661383", "amountAMin": "0", "amountBMin": "0", "to": "0x63056E00436Da25BcF48A40dfBbDcc7089351006", "deadline": "1669720626", "from": "0x63056E00436Da25BcF48A40dfBbDcc7089351006", "gas": "420000", "gasPriority": "high" } ``` {% endtab %} {% tab title="Sample Response" %} **With gasPriority:** ```json { "status": 200, "msg": "success", "data": { "chainId": "1", "from": "0x63056E00436Da25BcF48A40dfBbDcc7089351006", "to": "0x7a250d5630B4cF539739dF2C5dAcb4c659F2488D", "value": "0", "gas": "420000", "data": "0xbaa2abde000000000000000000000000c02aaa39b223fe8d0a0e5c4f27ead9083c756cc20000000000000000000000006b175474e89094c44da98b954eedeac495271d0f0000000000000000000000000000000000000000000000000049c0979afbbb870000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000063056e00436da25bcf48a40dfbbdcc7089351006000000000000000000000000000000000000000000000000000000006385ea32", "gasPrice": "35169117159", "estimationCheck": true, "referenceId": "d92319bdba68444b8f52f01735ec6550" } } ``` {% endtab %} {% endtabs %} {% tabs %} {% tab title="Sample Request" %} **With slippage:** ```json { "dexId": "1000", "tokenA": "0x6B175474E89094C44Da98b954EedeAC495271d0F", "tokenB": "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2", "liquidity": "3834508059710445", "amountAMin": "100", "amountBMin": "100", "to": "0x4970798F8E5a77598CA4Da778eb6D12303AEefc9", "deadline": "1669720626", "from": "0x4970798F8E5a77598CA4Da778eb6D12303AEefc9", "gas": "420000", "slippage": "5.01" } ``` {% endtab %} {% tab title="Sample Response" %} **With slippage:** ```json { "status": 200, "msg": "success", "data": { "chainId": "1", "from": "0x4970798F8E5a77598CA4Da778eb6D12303AEefc9", "to": "0x7a250d5630B4cF539739dF2C5dAcb4c659F2488D", "value": "0", "gas": "420000", "data": "0xbaa2abde0000000000000000000000006b175474e89094c44da98b954eedeac495271d0f000000000000000000000000c02aaa39b223fe8d0a0e5c4f27ead9083c756cc2000000000000000000000000000000000000000000000000000d9f76fac993ed000000000000000000000000000000000000000000000000000000000000005f000000000000000000000000000000000000000000000000000000000000005f0000000000000000000000004970798f8e5a77598ca4da778eb6d12303aeefc9000000000000000000000000000000000000000000000000000000006385ea32", "estimationCheck": true, "referenceId": "4e1324d014cf4d8daab6a023fe3322cc" } } ``` {% endtab %} {% endtabs %} --- # Agent Instructions: 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-v2.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.