Uniswap V3
Last updated
Last updated
Available on Ethereum Mainnet and Testnet, Arbitrum, Avalanche, Base, Binance Smart Chain, zkSync Era and Polygon.
Click on the endpoint to jump to the section with full details
GET
- Returns the swap quotation for a given token pair on Uniswap V3.
GET
- Returns the balance of a particular token pair of accounts.
GET
- Returns the total liquidity for a specified pool.
GET
- Returns the individual token liquidity within the specified liquidity pool.
GET
- Returns the total number of liquidity holders in a specified pool.
GET
- Returns the liquidity position for a specified user address across all the pools for a given DEX.
GET
- Returns all user addresses, block numbers, and token position details for a specified pool address.
GET
- Returns historical time series transactions for a specific pool address. Available on Ethereum only.
GET
- Returns historical transactions focusing on swaps associated with a specific pool address. Available on Ethereum only.
GET
- Returns OHCLV (Open, High, Close, Low, and Volume) data for a specified time interval. Available on Ethereum only.
GET
- Returns trade data for a specified pool, block range, and event type. Available on Ethereum only.
POST
- Initiate a swap transaction on a specified DEX.
POST
- Add liquidity to a specified pool in a specified DEX.
POST
- Remove liquidity from a specified pool in a specified DEX.
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 for a complete DEX ID list and more information.
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
Returns the swap quotation for a given token pair on Uniswap V3
GET
https://api.expand.network/dex/getprice
rpc
String
Remote procedural call URL.
dexId*
String
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.
https://api.expand.network/dex/getprice?dexId=1300&path=0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2,0xdac17f958d2ee523a2206206994597c13d831ec7&amountIn=10000000000000000000
{
"status": 200,
"msg": "success",
"data": {
"amountIn": "10000000000000000000",
"path": [
"0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
"0xdac17f958d2ee523a2206206994597c13d831ec7"
],
"amountsOut": [
"10000000000000000000",
"15671654661"
]
}
}
Returns the balance of a particular token pair of an account.
GET
https://api.expand.network/dex/getuserliquidity
rpc
String
Remote procedural call URL.
tokenId*
String
The token ID for uniswap V3 liquidity position.
dexId*
String
https://api.expand.network/dex/getuserliquidity?dexId=1300&tokenId=3238
{
"status": 200,
"msg": "success",
"data": {
"liquidity": "0",
"tokenV3": "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2"
}
}
Returns the total liquidity for a specified pool.
GET
https://api.expand.network/dex/getpoolliquidity
rpc
String
Remote procedural call URL.
poolAddress*
String
Pool address whose liquidity is to be fetched.
dexId*
String
https://api.expand.network/dex/getpoolliquidity?dexId=1300&poolAddress=0xC12aF0C4AA39D3061c56cD3CB19f5e62dEeaeBdE
{
"status": 200,
"msg": "success",
"data": {
"totalLiquidity": "3560688052732075"
}
}
Returns the individual token liquidity within the specified liquidity pool.
GET
https://api.expand.network/dex/gettokenliquidity
rpc
String
Remote procedural call URL.
poolAddress*
String
The pool address.
dexId*
String
https://api.expand.network/dex/gettokenliquidity?dexId=1300&poolAddress=0xC12aF0C4AA39D3061c56cD3CB19f5e62dEeaeBdE
{
"status": 200,
"msg": "success",
"data": {
"wstETH": "1464524814018114",
"WETH": "586998274859845123"
}
}
Returns the total number of liquidity holders in a specified pool.
GET
https://api.expand.network/dex/getliquidityholders
rpc
String
Remote procedural call URL.
poolAddress*
String
The pool address.
dexId*
String
https://api.expand.network/dex/getliquidityholders?dexId=1300&poolAddress=0xC2e9F25Be6257c210d7Adf0D4Cd6E3E881ba25f8
{
"status": 200,
"msg": "success",
"data": {
"totalTokenHolders": "9032"
}
}
Returns the liquidity position for a specified user address across all the pools for a given DEX.
GET
https://api.expand.network/dex/getindividualposition
rpc
String
Remote procedural call URL.
address*
String
The public address of the liquidity holder.
dexId*
String
poolAddresses
String
The pool Addresses whose liquidity is to be fetched. (Comma-separated vaules)
https://api.expand.network/dex/getindividualposition?address=0xc36442b4a4522e871399cd717abdd847ab11fe88&poolAddresses=0x971194A53Dddc8Ccfa96d5DD1E42Cd9d15746827&dexId=1300
{
"status": 200,
"msg": "success",
"data": {
"aggregatedLiquidity": "21292566467643316140077",
"poolAddresses": {
"JBUCKETSWETH": {
"0x971194A53Dddc8Ccfa96d5DD1E42Cd9d15746827": "21292566467643316140077"
}
}
}
}
Returns all user addresses, block numbers, and token position details for a specified pool address.
GET
https://historicallp.api.expand.network/dex/getpoolindividualliquidity
rpc
String
Remote procedural call URL.
poolAddress*
String
The pool address.
dexId*
String
endBlock
String
Last block of the range.
startBlock
String
Starting block of the range.
https://historicallp.api.expand.network/dex/getpoolindividualliquidity?poolAddress=0xa6cc3c2531fdaa6ae1a3ca84c2855806728693e8&dexId=1300&startBlock=21372439&endBlock=21372539
{
"status": 200,
"msg": "success",
"data": [
{
"userAddress": "0xee41d6528b3e1fdb71ddb214a771a28f25d8b206",
"liquidityData": [
{
"blockNumber": "21372539",
"transactionHash": "0xf24fd919f93cf4777433473c5ae67001d8633797a373f54a566334a61ef37750",
"assets": {
"LINK": "774232304240452363065",
"WETH": "7078087636696543717"
}
}
]
}
]
}
Get historical time series transactions for a specific pool address. Available on Ethereum only.
GET
https://historicaltrade.api.expand.network/dex/gethistoricaltimeseries
dexId*
String
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.
https://historicaltrade.api.expand.network/dex/gethistoricaltimeseries?dexId=1300&poolAddress=0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640
{
"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
}
]
}
}
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
dexId*
String
endBlock
String
Last block of the range.
startBlock
String
Starting block of the range.
poolAddress*
String
Pool address whose transactions is to be fetched.
https://historicaltrade.api.expand.network/dex/gethistoricaltransactions?poolAddress=0x8ad599c3a0ff1de082011efddc58f1908eb6e6d8&dexId=1300&startBlock=18709774&endBlock=18711525
{
"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"
}
}
]
}
}
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
dexId*
String
interval
String
15 mins(by default), 30 mins, 60 mins, and 90 mins.
limit
String
No of iteration. Start limit is 100 and maximum limit is 500.
poolAddress*
String
Pool address whose transactions is to be fetched.
rpc
String
Remote procedural call URL.
https://api.expand.network/dex/gethistoricalpoolchartdata?dexId=1300&poolAddress=0xCBCdF9626bC03E24f779434178A73a0B4bad62eD&interval=15m&limit=100
{
"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"
}
}
]
}
}
Returns trade data for a specified pool, block range, and event type. Available on Ethereum only.
GET
https://historicaltrade.api.expand.network/dex/getpooltradedata
dexId*
String
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).
https://historicaltrade.api.expand.network/dex/getpooltradedata?poolAddress=0x5777d92f208679db4b9778590fa3cab3ac9e2168&dexId=1300&eventType=Swap
{
"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"
]
}
}
]
}
}
Initiate a swap transaction on a specified DEX.
POST
https://api.expand.network/dex/swap
rpc
String
Remote procedural call URL.
dexId*
String
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 a result of swap.
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.
involveBaseToken
String
If a base token is involved in the swap;
0
for erc20 -> erc20,
1
for base -> erc20 ("from" address should be of equivalent wrapped token),
2
for erc20 -> base ("to" address should be of equivalent wrapped token).
By default, 0.
poolFees
String
Different pool based on the fees. By default, it is selected as 3000.
gasPriority
String
low, medium, or high.
slippage
String
Percentage of total swap value. By default, 1.
0 <= slippage value <= 100
ofacCheck
Boolean
if true,
provides insights of the contract and tokens involved in the transaction.
By Default, false
Available on Ethereum, Polygon, BSC, Avalanche, Arbitrum and Optimism Mainnet
{
"dexId": "1300",
"amountIn": "1000000000000000",
"amountOutMin": "0",
"path": ["0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2","0x6B175474E89094C44Da98b954EedeAC495271d0F"],
"to": "0x63056E00436Da25BcF48A40dfBbDcc7089351006",
"poolFees": "2975",
"from": "0x63056E00436Da25BcF48A40dfBbDcc7089351006",
"gas": "173376"
}
{
"status": 200,
"msg": "success",
"data": {
"chainId": "1",
"from": "0x63056E00436Da25BcF48A40dfBbDcc7089351006",
"to": "0x68b3465833fb72a70ecdf485e0e4c7bd8665fc45",
"value": "0",
"gas": "173376",
"data": "0xac9650d800000000000000000000000000000000000000000000000000000000000000200000000000000000000000000000000000000000000000000000000000000001000000000000000000000000000000000000000000000000000000000000002000000000000000000000000000000000000000000000000000000000000000e4472b43f300000000000000000000000000000000000000000000000000038d7ea4c680000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000008000000000000000000000000063056e00436da25bcf48a40dfbbdcc70893510060000000000000000000000000000000000000000000000000000000000000002000000000000000000000000c02aaa39b223fe8d0a0e5c4f27ead9083c756cc20000000000000000000000006b175474e89094c44da98b954eedeac495271d0f00000000000000000000000000000000000000000000000000000000",
"estimationCheck": true,
"referenceId": "6b615dd983bd4033b12096c6a5a4b46c"
}
}
With gasPriority (medium):
{
"dexId": "1300",
"amountIn": "1000000000",
"amountOutMin": "0",
"path": [
"0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2",
"0x6B175474E89094C44Da98b954EedeAC495271d0F"
],
"to": "0x6Fb447Ae94F5180254D436A693907a1f57696900",
"from": "0x6Fb447Ae94F5180254D436A693907a1f57696900",
"gas": "173376",
"gasPriority": "medium"
}
With gasPriority:
{
"status": 200,
"msg": "success",
"data": {
"chainId": "1",
"from": "0x6Fb447Ae94F5180254D436A693907a1f57696900",
"to": "0x68b3465833fb72a70ecdf485e0e4c7bd8665fc45",
"value": "0",
"gas": "173376",
"data": "0xac9650d800000000000000000000000000000000000000000000000000000000000000200000000000000000000000000000000000000000000000000000000000000001000000000000000000000000000000000000000000000000000000000000002000000000000000000000000000000000000000000000000000000000000000e4472b43f3000000000000000000000000000000000000000000000000000000003b9aca00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000800000000000000000000000006fb447ae94f5180254d436a693907a1f576969000000000000000000000000000000000000000000000000000000000000000002000000000000000000000000c02aaa39b223fe8d0a0e5c4f27ead9083c756cc20000000000000000000000006b175474e89094c44da98b954eedeac495271d0f00000000000000000000000000000000000000000000000000000000",
"gasPrice": "24931859242",
"estimationCheck": true,
"referenceId": "1a6c539d892c4b5ea107a6e2823ec8fd"
}
}
With Slippage:
{
"dexId": "1300",
"amountIn": "1000000",
"amountOutMin": "999831028599930500",
"path": [
"0xdAC17F958D2ee523a2206206994597C13D831ec7",
"0x6B175474E89094C44Da98b954EedeAC495271d0F"
],
"to": "0x22cf65ae3fa16d6379e72f4b4c2401c1b7c69731",
"deadline": "1711931771",
"from": "0x22cf65ae3fa16d6379e72f4b4c2401c1b7c69731",
"gas": "933376",
"gasPriority": "high",
"slippage": "1"
}
With Slippage:
{
"status": 200,
"msg": "success",
"data": {
"chainId": "1",
"from": "0x22cf65ae3fa16d6379e72f4b4c2401c1b7c69731",
"to": "0x68b3465833fb72a70ecdf485e0e4c7bd8665fc45",
"value": "0",
"gas": "933376",
"data": "0xac9650d800000000000000000000000000000000000000000000000000000000000000200000000000000000000000000000000000000000000000000000000000000001000000000000000000000000000000000000000000000000000000000000002000000000000000000000000000000000000000000000000000000000000000e4472b43f300000000000000000000000000000000000000000000000000000000000f42400000000000000000000000000000000000000000000000000dbcd290b8de3080000000000000000000000000000000000000000000000000000000000000008000000000000000000000000022cf65ae3fa16d6379e72f4b4c2401c1b7c697310000000000000000000000000000000000000000000000000000000000000002000000000000000000000000dac17f958d2ee523a2206206994597c13d831ec70000000000000000000000006b175474e89094c44da98b954eedeac495271d0f00000000000000000000000000000000000000000000000000000000",
"gasPrice": "34222375359",
"estimationCheck": true,
"referenceId": "98f1fa52694740038103132f0abe72e6"
}
}
With ofacCheck:
{
"dexId": "1300",
"amountIn": "1000000",
"amountOutMin": "999831028599930500",
"path": [
"0xdAC17F958D2ee523a2206206994597C13D831ec7",
"0x6B175474E89094C44Da98b954EedeAC495271d0F"
],
"to": "0x22cf65ae3fa16d6379e72f4b4c2401c1b7c69731",
"deadline": "1711931771",
"from": "0x22cf65ae3fa16d6379e72f4b4c2401c1b7c69731",
"gas": "933376",
"gasPriority": "high",
"slippage": "1",
"ofacCheck": true
}
With ofacCheck:
{
"status": 200,
"msg": "success",
"data": {
"chainId": "1",
"from": "0xfAE7D9854995E28BEB1B1da864ee2A1E2EC17f07",
"to": "0x3d9819210a31b4961b30ef54be2aed79b9c9cd3b",
"value": "0",
"gas": "40000",
"data": "0xede4edd00000000000000000000000005d3a536e4d6dbd6114cc1ead35777bab948e3643",
"gasPrice": "499498318",
"estimationCheck": true,
"insights": {
"asset": {
"issues": [],
"verdict": {
"code": 0,
"label": "NO_ISSUES"
}
},
"to": {
"issues": [],
"verdict": {
"code": 0,
"label": "NO_ISSUES"
}
}
},
"referenceId": "e9bfe6229a844227a92a2f6669aa1da0"
}
}
Add liquidity to a specified pool in a specified DEX.
POST
https://api.expand.network/dex/addliquidity
dexId*
String
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
ofacCheck
Boolean
if true,
provides insights of the contract and tokens involved in the transaction.
By Default, false
Available on Ethereum, Polygon, BSC, Avalanche, Arbitrum and Optimism Mainnet
{
"dexId": "1300",
"tokenA": "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2",
"tokenB": "0x6B175474E89094C44Da98b954EedeAC495271d0F",
"poolFees": "3000",
"amountADesired": "1000000000000000",
"amountBDesired": "1294471768449933344",
"amountAMin": "0",
"amountBMin": "0",
"deadline": "1666193668",
"to": "0x63056E00436Da25BcF48A40dfBbDcc7089351006",
"from": "0x63056E00436Da25BcF48A40dfBbDcc7089351006",
"gas": "5446762"
}
{
"status": 200,
"msg": "success",
"data": {
"chainId": "1",
"from": "0x63056E00436Da25BcF48A40dfBbDcc7089351006",
"to": "0xC36442b4a4522E871399CD717aBDD847Ab11FE88",
"value": "0",
"gas": "5446762",
"data": "0xac9650d800000000000000000000000000000000000000000000000000000000000000200000000000000000000000000000000000000000000000000000000000000002000000000000000000000000000000000000000000000000000000000000004000000000000000000000000000000000000000000000000000000000000001e0000000000000000000000000000000000000000000000000000000000000016488316456000000000000000000000000c02aaa39b223fe8d0a0e5c4f27ead9083c756cc20000000000000000000000006b175474e89094c44da98b954eedeac495271d0f0000000000000000000000000000000000000000000000000000000000000bb8fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffece24fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffecf1400000000000000000000000000000000000000000000000000038d7ea4c6800000000000000000000000000000000000000000000000000011f6e3370a3ae0200000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000063056e00436da25bcf48a40dfbbdcc7089351006000000000000000000000000000000000000000000000000000000006350190400000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000412210e8a00000000000000000000000000000000000000000000000000000000",
"estimationCheck": true,
"referenceId": "7fa6a06af5f041c18204e3daa95f48bb"
}
}
With gasPriority (medium):
{
"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"
}
With gasPriority:
{
"status": 200,
"msg": "success",
"data": {
"chainId": "1",
"from": "0x356dB816602c85e2075774bB77D13995c8Bab023",
"to": "0xC36442b4a4522E871399CD717aBDD847Ab11FE88",
"value": "0",
"gas": "123444",
"data": "0xac9650d800000000000000000000000000000000000000000000000000000000000000200000000000000000000000000000000000000000000000000000000000000002000000000000000000000000000000000000000000000000000000000000004000000000000000000000000000000000000000000000000000000000000001e00000000000000000000000000000000000000000000000000000000000000164883164560000000000000000000000006b175474e89094c44da98b954eedeac495271d0f000000000000000000000000a0b86991c6218b36c1d19d4a2e9eb0ce3606eb480000000000000000000000000000000000000000000000000000000000000bb8fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffbc800fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffbc8f000000000000000000000000000000000000000000000000000038d7ea4c6800000000000000000000000000000000000000000000000000000000000000003e700000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000356db816602c85e2075774bb77d13995c8bab0230000000000000000000000000000000000000000000000000000018bcde9da9e00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000412210e8a00000000000000000000000000000000000000000000000000000000",
"gasPrice": "28313536592",
"estimationCheck": true,
"referenceId": "17a42397a3214f8f9ebb83c88bef723f"
}
}
With Slippage:
{
"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"
}
With Slippage:
{
"status": 200,
"msg": "success",
"data": {
"chainId": "1",
"from": "0x63056E00436Da25BcF48A40dfBbDcc7089351006",
"to": "0xC36442b4a4522E871399CD717aBDD847Ab11FE88",
"value": "0",
"gas": "5446762",
"data": "0xac9650d800000000000000000000000000000000000000000000000000000000000000200000000000000000000000000000000000000000000000000000000000000002000000000000000000000000000000000000000000000000000000000000004000000000000000000000000000000000000000000000000000000000000001e0000000000000000000000000000000000000000000000000000000000000016488316456000000000000000000000000c02aaa39b223fe8d0a0e5c4f27ead9083c756cc20000000000000000000000006b175474e89094c44da98b954eedeac495271d0f0000000000000000000000000000000000000000000000000000000000000bb8fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffece24fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffecf1400000000000000000000000000000000000000000000000000038d7ea4c6800000000000000000000000000000000000000000000000000011f6e3370a3ae0200000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000063056e00436da25bcf48a40dfbbdcc7089351006000000000000000000000000000000000000000000000000000000006350190400000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000412210e8a00000000000000000000000000000000000000000000000000000000",
"estimationCheck": true,
"referenceId": "d77137490d89447e82922330352d5b85"
}
}
With ofacCheck:
{
"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",
"ofacCheck": true
}
With ofacCheck:
{
"status": 200,
"msg": "success",
"data": {
"chainId": "1",
"from": "0xfAE7D9854995E28BEB1B1da864ee2A1E2EC17f07",
"to": "0x3d9819210a31b4961b30ef54be2aed79b9c9cd3b",
"value": "0",
"gas": "40000",
"data": "0xede4edd00000000000000000000000005d3a536e4d6dbd6114cc1ead35777bab948e3643",
"gasPrice": "499498318",
"estimationCheck": true,
"insights": {
"asset": {
"issues": [],
"verdict": {
"code": 0,
"label": "NO_ISSUES"
}
},
"to": {
"issues": [],
"verdict": {
"code": 0,
"label": "NO_ISSUES"
}
}
},
"referenceId": "e9bfe6229a844227a92a2f6669aa1da0"
}
}
Remove liquidity from a specified pool for a specified DEX.
POST
https://api.expand.network/dex/removeliquidity
dexId*
String
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
ofacCheck
Boolean
if true,
provides insights of the contract and tokens involved in the transaction.
By Default, false
Available on Ethereum, Polygon, BSC, Avalanche, Arbitrum and Optimism Mainnet
{
"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"
}
{
"status": 200,
"msg": "success",
"data": {
"chainId": "1",
"from": "0x63056E00436Da25BcF48A40dfBbDcc7089351006",
"to": "0xC36442b4a4522E871399CD717aBDD847Ab11FE88",
"value": "0",
"gas": "2421200",
"data": "0xac9650d80000000000000000000000000000000000000000000000000000000000000020000000000000000000000000000000000000000000000000000000000000000400000000000000000000000000000000000000000000000000000000000000800000000000000000000000000000000000000000000000000000000000000160000000000000000000000000000000000000000000000000000000000000022000000000000000000000000000000000000000000000000000000000000002a000000000000000000000000000000000000000000000000000000000000000a40c49ccbe000000000000000000000000000000000000000000000000000000000000952100000000000000000000000000000000000000000000001b173e970df1700cc300000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000006917fe14000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000084fc6f78650000000000000000000000000000000000000000000000000000000000009521000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000ffffffffffffffffffffffffffffffff00000000000000000000000000000000ffffffffffffffffffffffffffffffff00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000004449404b7c000000000000000000000000000000000000000000000000000000000000000000000000000000000000000063056e00436da25bcf48a40dfbbdcc7089351006000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000064df2ab5bb000000000000000000000000c02aaa39b223fe8d0a0e5c4f27ead9083c756cc2000000000000000000000000000000000000000000000000000000000000000000000000000000000000000063056e00436da25bcf48a40dfbbdcc708935100600000000000000000000000000000000000000000000000000000000",
"estimationCheck": true,
"referenceId": "00bdfa2223af4b21ac8ecad90acbebec"
}
}
With gasPriority:
{
"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"
}
With gasPriority:
{
"status": 200,
"msg": "success",
"data": {
"chainId": "1",
"from": "0x4C99D660A51D41bE5D47D66a3d89d5B83D92f27E",
"to": "0xC36442b4a4522E871399CD717aBDD847Ab11FE88",
"value": "0",
"gas": "80000",
"data": "0xac9650d80000000000000000000000000000000000000000000000000000000000000020000000000000000000000000000000000000000000000000000000000000000400000000000000000000000000000000000000000000000000000000000000800000000000000000000000000000000000000000000000000000000000000160000000000000000000000000000000000000000000000000000000000000022000000000000000000000000000000000000000000000000000000000000002a000000000000000000000000000000000000000000000000000000000000000a40c49ccbe0000000000000000000000000000000000000000000000000000000000094bbe00000000000000000000000000000000000000000000000002d01daa7e99eb02000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000018bf6344a84000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000084fc6f78650000000000000000000000000000000000000000000000000000000000094bbe000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000ffffffffffffffffffffffffffffffff00000000000000000000000000000000ffffffffffffffffffffffffffffffff00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000004449404b7c00000000000000000000000000000000000000000000000000000000000000000000000000000000000000004c99d660a51d41be5d47d66a3d89d5b83d92f27e000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000064df2ab5bb0000000000000000000000009813037ee2218799597d83d4a5b6f3b6778218d900000000000000000000000000000000000000000000000000000000000000000000000000000000000000004c99d660a51d41be5d47d66a3d89d5b83d92f27e00000000000000000000000000000000000000000000000000000000",
"gasPrice": "31358145710",
"estimationCheck": true,
"referenceId": "f5e038c02dfb469fb0427f23e3cc1730"
}
}
With slippage:
{
"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"
}
With slippage:
{
"status": 200,
"msg": "success",
"data": {
"chainId": "1",
"from": "0x63056E00436Da25BcF48A40dfBbDcc7089351006",
"to": "0xC36442b4a4522E871399CD717aBDD847Ab11FE88",
"value": "0",
"gas": "2421200",
"data": "0xac9650d80000000000000000000000000000000000000000000000000000000000000020000000000000000000000000000000000000000000000000000000000000000400000000000000000000000000000000000000000000000000000000000000800000000000000000000000000000000000000000000000000000000000000160000000000000000000000000000000000000000000000000000000000000022000000000000000000000000000000000000000000000000000000000000002a000000000000000000000000000000000000000000000000000000000000000a40c49ccbe000000000000000000000000000000000000000000000000000000000000952100000000000000000000000000000000000000000000001b173e970df1700cc300000000000000000000000000000000000000000000000000000000008a179000000000000000000000000000000000000000000000000000000000008a1790000000000000000000000000000000000000000000000000000000006917fe14000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000084fc6f78650000000000000000000000000000000000000000000000000000000000009521000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000ffffffffffffffffffffffffffffffff00000000000000000000000000000000ffffffffffffffffffffffffffffffff00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000004449404b7c00000000000000000000000000000000000000000000000000000000008a179000000000000000000000000063056e00436da25bcf48a40dfbbdcc7089351006000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000064df2ab5bb000000000000000000000000c02aaa39b223fe8d0a0e5c4f27ead9083c756cc200000000000000000000000000000000000000000000000000000000008a179000000000000000000000000063056e00436da25bcf48a40dfbbdcc708935100600000000000000000000000000000000000000000000000000000000",
"estimationCheck": true,
"referenceId": "73e42929b7ea42d08b3aee4416191b47"
}
}
With ofacCheck:
{
"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",
"ofacCheck": true
}
With ofacCheck:
{
"status": 200,
"msg": "success",
"data": {
"chainId": "1",
"from": "0xfAE7D9854995E28BEB1B1da864ee2A1E2EC17f07",
"to": "0x3d9819210a31b4961b30ef54be2aed79b9c9cd3b",
"value": "0",
"gas": "40000",
"data": "0xede4edd00000000000000000000000005d3a536e4d6dbd6114cc1ead35777bab948e3643",
"gasPrice": "499498318",
"estimationCheck": true,
"insights": {
"asset": {
"issues": [],
"verdict": {
"code": 0,
"label": "NO_ISSUES"
}
},
"to": {
"issues": [],
"verdict": {
"code": 0,
"label": "NO_ISSUES"
}
}
},
"referenceId": "e9bfe6229a844227a92a2f6669aa1da0"
}
}
See the page for a list of all DEX IDs. The DEX ID for Uniswap V3 on Ethereum is 1300.
Refer to page for details.
Refer to page for details.
Refer to page for details.
Refer to page for details.
Refer to page for details.
Refer to page for details.
Refer to page for details.
Refer to page for details.
Refer to page for details.
Refer to page for details.
Refer to the page for details.
Refer to the page for details.
Refer to the page for details.