⚡DEX & DEX Aggregators
Provides connectivity across the various decentralized exchanges available on the EVM and Non-EVM chains.
Below are descriptions of the endpoints we support for DEXs and DEX Aggregators:
Please see the attached document for information about error messages you may encounter when transacting using these endpoints:https://docs.google.com/document/d/1SuBJwPOmvJtUUf-9QJiBcTr0l2zbWlusMTUOGfC8S50/edit?usp=sharing
/gettokenlist
Retrieves the details of token mapping for the top 100 trending tokens by default or retrieves the detail of specific token mapping by token address.Available for Uniswap V2, Uniswap V3, SushiSwap V2
GET
https://api.expand.network/dex/gettokenlist
Query Parameter
https://api.expand.network/dex/gettokenlist
{
"status": 200,
"msg": "success",
"data": {
"tokenList": [
{
"contract_address": "0x99411eb6c3ff2a37a0e8c48d0c44b900e13710b4",
"token_name": "Disdainful The Bear",
"token_symbol": "DISDAIN",
"decimals": "9",
"logo_url": "https://assetlogo.expand.network/ethereum/DISDAIN.png",
"availableDex": {
"uniswapV2": [
"0xc4201bfeefd9a08f58c5e2d0877f788167e07666"
]
}
},
{
"contract_address": "0x7ce0b3878bc54bfc989d2b3f9583a39ce7ad1b27",
"token_name": "Megadeth by 𝓜𝓪𝓽𝓽 𝓕𝓾𝓻𝓲𝓮",
"token_symbol": "MEGADETH",
"decimals": "9",
"logo_url": "https://assetlogo.expand.network/ethereum/MEGADETH.png",
"availableDex": {
"uniswapV2": [
"0x18aa074ca80ffaf28aa0353a6dd2e528c9d6fc6b"
]
}
},
{
"contract_address": "0x63c5b611ee5b1f24a64aa0c423bc57eedc46a194",
"token_name": "Pecky",
"token_symbol": "PECKY",
"decimals": "9",
"logo_url": "https://assetlogo.expand.network/ethereum/PECKY.png",
"availableDex": {
"uniswapV2": [
"0x8e07824021b06956f7bfb224bd3b11fb7c38c57b"
]
}
}
]
}
}
/getpools
Returns a list of all the quotes for a pool on different DEXs.
GET
https://api.expand.network/dex/getpools
Query Parameters
https://api.expand.network/dex/getpools?dexId=1500,1400,1300&path=0x6b175474e89094c44da98b954eedeac495271d0f,0xdac17f958d2ee523a2206206994597c13d831ec7&amountIn=100000000000000000
{
"status": 200,
"msg": "success",
"data": [
{
"dexId": "1300",
"value": "99431"
},
{
"dexId": "1400",
"value": "130999"
},
{
"dexId": "1500",
"value": "99977"
}
]
}
/gethistoricalpoolchartdata
Source OHCLV (Open, High, Close, Low, Volume) data for a specified pool address for a particular time interval (15, 30, 60, or 90 minutes). Available for Uniswap V2 and V3, Balancer, Curve V2, and Sushiswap.
/quoteaggregator
Returns a list of all the quotes for a pool on different DEXs.
GET
https://api.expand.network/dex/quoteaggregator
Query Parameters
https://api.expand.network/dex/quoteaggregator?path=0xdac17f958d2ee523a2206206994597c13d831ec7%2C0x6B175474E89094C44Da98b954EedeAC495271d0F&amountIn=1000000&chainId=1&excludedDexes=1000,1100,1400
{
"status": 200,
"msg": "success",
"data": [
{
"dexName": "UniswapV3",
"dexId": "1300",
"amountIn": "1000000",
"path": [
"0xdac17f958d2ee523a2206206994597c13d831ec7",
"0x6B175474E89094C44Da98b954EedeAC495271d0F"
],
"amountsOut": [
"1000000",
"992453714315716405"
]
},
{
"dexName": "CurveV2",
"dexId": "1500",
"amountIn": "1000000",
"path": [
"0xdac17f958d2ee523a2206206994597c13d831ec7",
"0x6B175474E89094C44Da98b954EedeAC495271d0F"
],
"amountsOut": [
"1000000",
"1000311335077777268"
]
},
{
"dexName": "0x",
"dexId": "1600",
"amountIn": "1000000",
"path": [
"0xdac17f958d2ee523a2206206994597c13d831ec7",
"0x6B175474E89094C44Da98b954EedeAC495271d0F"
],
"amountsOut": [
"1000000",
"1015039771697507808"
]
},
{
"dexName": "1inch",
"dexId": "1700",
"amountIn": "1000000",
"path": [
"0xdac17f958d2ee523a2206206994597c13d831ec7",
"0x6B175474E89094C44Da98b954EedeAC495271d0F"
],
"amountsOut": [
"1000000",
"994152586419056980"
]
}
]
}
/getwalletposition
Get detailed information for user transactions on various DEXs, including transaction type, block-related details, decoded parameters and more. Available for Uniswap V2, Uniswap V3, SushiSwap V2, Curve V2, and Balancer V2.
GET
https://historicallp.api.expand.network/dex/getwalletposition
Query Parameters
https://historicallp.api.expand.network/dex/getwalletposition?address=0xEf1B32354C3d8A273331Cd532D1576bB819B6E36&pageToken=3
{
"status": 200,
"msg": "success",
"data": {
"currentPage": "3",
"totalPages": "3",
"transactions": {
"UniswapV3": [
{
"block_signed_at": "2024-02-18T14:02:11Z",
"block_height": 19255151,
"tx_offset": 249,
"log_offset": 402,
"tx_hash": "0x98ff38d750c787d0c34d7aa51051be6034943659a575e55d088ed0c3ad255a9e",
"raw_log_topics": [
"0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",
"0x00000000000000000000000073ea3d8ba3d7380201b270ec504b33ed5e478542",
"0x000000000000000000000000e37e799d5077682fa0a244d46e5649f71457bd09"
],
"sender_contract_decimals": 6,
"sender_name": "USD Coin",
"sender_contract_ticker_symbol": "USDC",
"sender_address": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
"sender_address_label": null,
"raw_log_data": "0x000000000000000000000000000000000000000000000000000000023a5e3b6f",
"decoded": {
"name": "Transfer",
"signature": "Transfer(indexed address from, indexed address to, uint256 value)",
"params": [
{
"name": "from",
"type": "address",
"indexed": true,
"decoded": true,
"value": "0x73ea3d8ba3d7380201b270ec504b33ed5e478542"
},
{
"name": "to",
"type": "address",
"indexed": true,
"decoded": true,
"value": "0xe37e799d5077682fa0a244d46e5649f71457bd09"
},
{
"name": "value",
"type": "uint256",
"indexed": false,
"decoded": true,
"value": "9569188719"
}
]
}
}
],
"UniswapV2": [
{
"block_signed_at": "2024-01-14T12:17:47Z",
"block_height": 19005074,
"tx_offset": 79,
"log_offset": 1167,
"tx_hash": "0xbea1249137babc68449502e14c293fc02bd4679711231a241e4475c53261624f",
"raw_log_topics": [
"0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",
"0x000000000000000000000000de0b295669a9fd93d5f28d9ec85e40f4cb697bae",
"0x00000000000000000000000052e2e6b3ba385ed9690eef11f72b2fe27ba1f8ca"
],
"sender_contract_decimals": 0,
"sender_name": "# UsdcLB.com",
"sender_contract_ticker_symbol": "# UsdcLB.com - Visit to claim bonus",
"sender_address": "0xbbac5b019876534c3c399f56e150684c5015f670",
"sender_address_label": null,
"raw_log_data": "0x000000000000000000000000000000000000000000000000000000000000204f",
"decoded": {
"name": "Transfer",
"signature": "Transfer(indexed address from, indexed address to, uint256 value)",
"params": [
{
"name": "from",
"type": "address",
"indexed": true,
"decoded": true,
"value": "0xde0b295669a9fd93d5f28d9ec85e40f4cb697bae"
},
{
"name": "to",
"type": "address",
"indexed": true,
"decoded": true,
"value": "0x52e2e6b3ba385ed9690eef11f72b2fe27ba1f8ca"
},
{
"name": "value",
"type": "uint256",
"indexed": false,
"decoded": true,
"value": "8271"
}
]
}
}
],
"SushiSwapV2": [
{
"block_signed_at": "2024-01-14T12:17:47Z",
"block_height": 19005074,
"tx_offset": 79,
"log_offset": 1264,
"tx_hash": "0xbea1249137babc68449502e14c293fc02bd4679711231a241e4475c53261624f",
"raw_log_topics": [
"0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",
"0x000000000000000000000000de0b295669a9fd93d5f28d9ec85e40f4cb697bae",
"0x0000000000000000000000001e888882d0f291dd88c5605108c72d414f29d460"
],
"sender_contract_decimals": 0,
"sender_name": "# UsdcLB.com",
"sender_contract_ticker_symbol": "# UsdcLB.com - Visit to claim bonus",
"sender_address": "0xbbac5b019876534c3c399f56e150684c5015f670",
"sender_address_label": null,
"raw_log_data": "0x000000000000000000000000000000000000000000000000000000000000204f",
"decoded": {
"name": "Transfer",
"signature": "Transfer(indexed address from, indexed address to, uint256 value)",
"params": [
{
"name": "from",
"type": "address",
"indexed": true,
"decoded": true,
"value": "0xde0b295669a9fd93d5f28d9ec85e40f4cb697bae"
},
{
"name": "to",
"type": "address",
"indexed": true,
"decoded": true,
"value": "0x1e888882d0f291dd88c5605108c72d414f29d460"
},
{
"name": "value",
"type": "uint256",
"indexed": false,
"decoded": true,
"value": "8271"
}
]
}
}
],
"BalancerV2": [],
"PancakeV2": [],
"CurveV2": [],
"extraTransactions": []
}
}
}
/swapaggregator
Returns the aggregated prepared swap quotes for every DEX, in which the pair address is present.
POST
https://api.expand.network/dex/swapaggregator
Request Body
{
"path": [
"0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE",
"0x6B175474E89094C44Da98b954EedeAC495271d0F"
],
"amountIn": "1000000",
"gas": "800000",
"from": "0xdAe2F6EdDdA6fb4fb60cc02633DE27e2b431B402",
"to": "0xdAe2F6EdDdA6fb4fb60cc02633DE27e2b431B402",
"cheapestSwap": true,
"bestSwap": true,
"chainId": "1"
}
{
"status": 200,
"msg": "success",
"data": [
{
"dexName": "1inch",
"amountsOut": "2729153702",
"from": "0xdae2f6eddda6fb4fb60cc02633de27e2b431b402",
"to": "0x1111111254eeb25477b68fb85ed929f73a960582",
"data": "0x0502b1c5000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000f424000000000000000000000000000000000000000000000000000000000a1e3e3cb0000000000000000000000000000000000000000000000000000000000000080000000000000000000000000000000000000000000000000000000000000000180000000000000003b6d034060a26d69263ef43e9a68964ba141263f19d71d51caefa361",
"value": "1000000",
"gas": "135556",
"estimationCheck": true,
"referenceId": "4a6ed6907daa46caa17153f1c697db72"
},
{
"dexName": "UniswapV2",
"amountsOut": "2735900139",
"from": "0xdAe2F6EdDdA6fb4fb60cc02633DE27e2b431B402",
"to": "0x7a250d5630B4cF539739dF2C5dAcb4c659F2488D",
"value": "1000000",
"gas": "152672",
"data": "0x7ff36ab500000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000080000000000000000000000000dae2f6eddda6fb4fb60cc02633de27e2b431b40200000000000000000000000000000000000000000000000000000191509281000000000000000000000000000000000000000000000000000000000000000002000000000000000000000000c02aaa39b223fe8d0a0e5c4f27ead9083c756cc20000000000000000000000006b175474e89094c44da98b954eedeac495271d0f",
"estimationCheck": true,
"referenceId": "4a6ed6907daa46caa17153f1c697db72"
},
{
"dexName": "SushiswapV2",
"amountsOut": "2735900094",
"from": "0xdAe2F6EdDdA6fb4fb60cc02633DE27e2b431B402",
"to": "0xd9e1cE17f2641f24aE83637ab66a2cca9C378B9F",
"value": "1000000",
"gas": "153832",
"data": "0x7ff36ab500000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000080000000000000000000000000dae2f6eddda6fb4fb60cc02633de27e2b431b40200000000000000000000000000000000000000000000000000000191509281000000000000000000000000000000000000000000000000000000000000000002000000000000000000000000c02aaa39b223fe8d0a0e5c4f27ead9083c756cc20000000000000000000000006b175474e89094c44da98b954eedeac495271d0f",
"estimationCheck": true,
"referenceId": "4a6ed6907daa46caa17153f1c697db72"
},
{
"dexName": "UniswapV3",
"amountsOut": "2736011386",
"from": "0xdAe2F6EdDdA6fb4fb60cc02633DE27e2b431B402",
"to": "0x68b3465833fb72a70ecdf485e0e4c7bd8665fc45",
"value": "1000000",
"gas": "156302",
"data": "0xac9650d8000000000000000000000000000000000000000000000000000000000000002000000000000000000000000000000000000000000000000000000000000000020000000000000000000000000000000000000000000000000000000000000040000000000000000000000000000000000000000000000000000000000000016000000000000000000000000000000000000000000000000000000000000000e404e45aaf000000000000000000000000c02aaa39b223fe8d0a0e5c4f27ead9083c756cc20000000000000000000000006b175474e89094c44da98b954eedeac495271d0f0000000000000000000000000000000000000000000000000000000000000bb8000000000000000000000000dae2f6eddda6fb4fb60cc02633de27e2b431b40200000000000000000000000000000000000000000000000000000000000f42400000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000412210e8a00000000000000000000000000000000000000000000000000000000",
"estimationCheck": true,
"referenceId": "4a6ed6907daa46caa17153f1c697db72"
},
{
"dexName": "0x",
"amountsOut": "2731837328",
"from": "0xdAe2F6EdDdA6fb4fb60cc02633DE27e2b431B402",
"to": "0xdef1c0ded9bec7f1a1670819833240f027b25eff",
"value": "1000000",
"gas": "332502",
"data": "0x415565b0000000000000000000000000eeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee0000000000000000000000006b175474e89094c44da98b954eedeac495271d0f00000000000000000000000000000000000000000000000000000000000f424000000000000000000000000000000000000000000000000000000000a133107600000000000000000000000000000000000000000000000000000000000000a000000000000000000000000000000000000000000000000000000000000000040000000000000000000000000000000000000000000000000000000000000080000000000000000000000000000000000000000000000000000000000000012000000000000000000000000000000000000000000000000000000000000004c000000000000000000000000000000000000000000000000000000000000005c0000000000000000000000000000000000000000000000000000000000000000600000000000000000000000000000000000000000000000000000000000000400000000000000000000000000000000000000000000000000000000000000040000000000000000000000000eeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee00000000000000000000000000000000000000000000000000000000000f424000000000000000000000000000000000000000000000000000000000000000210000000000000000000000000000000000000000000000000000000000000040000000000000000000000000000000000000000000000000000000000000034000000000000000000000000000000000000000000000000000000000000000200000000000000000000000000000000000000000000000000000000000000000000000000000000000000000c02aaa39b223fe8d0a0e5c4f27ead9083c756cc20000000000000000000000006b175474e89094c44da98b954eedeac495271d0f00000000000000000000000000000000000000000000000000000000000001400000000000000000000000000000000000000000000000000000000000000300000000000000000000000000000000000000000000000000000000000000030000000000000000000000000000000000000000000000000000000000000002c000000000000000000000000000000000000000000000000000000000000f4240000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000003000000000000000000000000000000000000000000000000000000000000000001000000000000000000000000000000000000000000000000000000000000002000000000000000000000000000000002556e697377617056320000000000000000000000000000000000000000000000000000000000000000000000000f424000000000000000000000000000000000000000000000000000000000a1710ed1000000000000000000000000000000000000000000000000000000000000008000000000000000000000000000000000000000000000000000000000000000a0000000000000000000000000f164fc0ec4e93095b804a4795bbe1e041497b92a00000000000000000000000000000000000000000000000000000000000000400000000000000000000000000000000000000000000000000000000000000002000000000000000000000000c02aaa39b223fe8d0a0e5c4f27ead9083c756cc20000000000000000000000006b175474e89094c44da98b954eedeac495271d0f000000000000000000000000000000000000000000000000000000000000000100000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000001b000000000000000000000000000000000000000000000000000000000000004000000000000000000000000000000000000000000000000000000000000000a0000000000000000000000000000000000000000000000000000000000000002000000000000000000000000000000000000000000000000000000000000000010000000000000000000000006b175474e89094c44da98b954eedeac495271d0f00000000000000000000000000000000000000000000000000000000003dfe5b000000000000000000000000ad01c20d5886137e056775af56915de824c8fce5000000000000000000000000000000000000000000000000000000000000001c000000000000000000000000000000000000000000000000000000000000004000000000000000000000000000000000000000000000000000000000000000e00000000000000000000000000000000000000000000000000000000000000020000000000000000000000000000000000000000000000000000000000000004000000000000000000000000000000000000000000000000000000000000000a00000000000000000000000000000000000000000000000000000000000000002000000000000000000000000c02aaa39b223fe8d0a0e5c4f27ead9083c756cc2000000000000000000000000eeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee0000000000000000000000000000000000000000000000000000000000000000869584cd000000000000000000000000100000000000000000000000000000000000001100000000000000000000000000000000000000007f61021dd0350024dd8b7904",
"estimationCheck": true,
"referenceId": "4a6ed6907daa46caa17153f1c697db72"
}
]
}
With gasPriority:
{
"path": [
"0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE",
"0x6B175474E89094C44Da98b954EedeAC495271d0F"
],
"amountIn": "1000000",
"gas": "800000",
"from": "0xdAe2F6EdDdA6fb4fb60cc02633DE27e2b431B402",
"to": "0xdAe2F6EdDdA6fb4fb60cc02633DE27e2b431B402",
"cheapestSwap": true,
"bestSwap": true,
"chainId": "1",
"gasPriority": "medium"
}
With gasPriority:
{
"status": 200,
"msg": "success",
"data": [
{
"dexName": "1inch",
"amountsOut": "2722973476",
"from": "0xdae2f6eddda6fb4fb60cc02633de27e2b431b402",
"to": "0x1111111254eeb25477b68fb85ed929f73a960582",
"data": "0x0502b1c5000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000f424000000000000000000000000000000000000000000000000000000000a1e3e3cb0000000000000000000000000000000000000000000000000000000000000080000000000000000000000000000000000000000000000000000000000000000180000000000000003b6d034060a26d69263ef43e9a68964ba141263f19d71d51caefa361",
"value": "1000000",
"gas": "135556",
"gasPrice": "2537407307",
"estimationCheck": true,
"referenceId": "7e54a22466b34205895563f636a5e59a"
},
{
"dexName": "SushiswapV2",
"amountsOut": "2727068499",
"from": "0xdAe2F6EdDdA6fb4fb60cc02633DE27e2b431B402",
"to": "0xd9e1cE17f2641f24aE83637ab66a2cca9C378B9F",
"value": "1000000",
"gas": "140987",
"data": "0x7ff36ab500000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000080000000000000000000000000dae2f6eddda6fb4fb60cc02633de27e2b431b40200000000000000000000000000000000000000000000000000000191509586350000000000000000000000000000000000000000000000000000000000000002000000000000000000000000c02aaa39b223fe8d0a0e5c4f27ead9083c756cc20000000000000000000000006b175474e89094c44da98b954eedeac495271d0f",
"gasPrice": "2533607308",
"estimationCheck": true,
"referenceId": "7e54a22466b34205895563f636a5e59a"
},
{
"dexName": "UniswapV2",
"amountsOut": "2727068867",
"from": "0xdAe2F6EdDdA6fb4fb60cc02633DE27e2b431B402",
"to": "0x7a250d5630B4cF539739dF2C5dAcb4c659F2488D",
"value": "1000000",
"gas": "152687",
"data": "0x7ff36ab500000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000080000000000000000000000000dae2f6eddda6fb4fb60cc02633de27e2b431b40200000000000000000000000000000000000000000000000000000191509586350000000000000000000000000000000000000000000000000000000000000002000000000000000000000000c02aaa39b223fe8d0a0e5c4f27ead9083c756cc20000000000000000000000006b175474e89094c44da98b954eedeac495271d0f",
"gasPrice": "2533607308",
"estimationCheck": true,
"referenceId": "7e54a22466b34205895563f636a5e59a"
},
{
"dexName": "UniswapV3",
"amountsOut": "2727666213",
"from": "0xdAe2F6EdDdA6fb4fb60cc02633DE27e2b431B402",
"to": "0x68b3465833fb72a70ecdf485e0e4c7bd8665fc45",
"value": "1000000",
"gas": "157484",
"data": "0xac9650d8000000000000000000000000000000000000000000000000000000000000002000000000000000000000000000000000000000000000000000000000000000020000000000000000000000000000000000000000000000000000000000000040000000000000000000000000000000000000000000000000000000000000016000000000000000000000000000000000000000000000000000000000000000e404e45aaf000000000000000000000000c02aaa39b223fe8d0a0e5c4f27ead9083c756cc20000000000000000000000006b175474e89094c44da98b954eedeac495271d0f0000000000000000000000000000000000000000000000000000000000000bb8000000000000000000000000dae2f6eddda6fb4fb60cc02633de27e2b431b40200000000000000000000000000000000000000000000000000000000000f42400000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000412210e8a00000000000000000000000000000000000000000000000000000000",
"gasPrice": "2533607308",
"estimationCheck": true,
"referenceId": "7e54a22466b34205895563f636a5e59a"
},
{
"dexName": "0x",
"amountsOut": "2723019170",
"from": "0xdAe2F6EdDdA6fb4fb60cc02633DE27e2b431B402",
"to": "0xdef1c0ded9bec7f1a1670819833240f027b25eff",
"value": "1000000",
"gas": "332516",
"data": "0x415565b0000000000000000000000000eeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee0000000000000000000000006b175474e89094c44da98b954eedeac495271d0f00000000000000000000000000000000000000000000000000000000000f424000000000000000000000000000000000000000000000000000000000a0addb8100000000000000000000000000000000000000000000000000000000000000a000000000000000000000000000000000000000000000000000000000000000040000000000000000000000000000000000000000000000000000000000000080000000000000000000000000000000000000000000000000000000000000012000000000000000000000000000000000000000000000000000000000000004c000000000000000000000000000000000000000000000000000000000000005c0000000000000000000000000000000000000000000000000000000000000000600000000000000000000000000000000000000000000000000000000000000400000000000000000000000000000000000000000000000000000000000000040000000000000000000000000eeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee00000000000000000000000000000000000000000000000000000000000f424000000000000000000000000000000000000000000000000000000000000000210000000000000000000000000000000000000000000000000000000000000040000000000000000000000000000000000000000000000000000000000000034000000000000000000000000000000000000000000000000000000000000000200000000000000000000000000000000000000000000000000000000000000000000000000000000000000000c02aaa39b223fe8d0a0e5c4f27ead9083c756cc20000000000000000000000006b175474e89094c44da98b954eedeac495271d0f00000000000000000000000000000000000000000000000000000000000001400000000000000000000000000000000000000000000000000000000000000300000000000000000000000000000000000000000000000000000000000000030000000000000000000000000000000000000000000000000000000000000002c000000000000000000000000000000000000000000000000000000000000f4240000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000003000000000000000000000000000000000000000000000000000000000000000001000000000000000000000000000000000000000000000000000000000000002000000000000000000000000000000002556e697377617056320000000000000000000000000000000000000000000000000000000000000000000000000f424000000000000000000000000000000000000000000000000000000000a0eba6a2000000000000000000000000000000000000000000000000000000000000008000000000000000000000000000000000000000000000000000000000000000a0000000000000000000000000f164fc0ec4e93095b804a4795bbe1e041497b92a00000000000000000000000000000000000000000000000000000000000000400000000000000000000000000000000000000000000000000000000000000002000000000000000000000000c02aaa39b223fe8d0a0e5c4f27ead9083c756cc20000000000000000000000006b175474e89094c44da98b954eedeac495271d0f000000000000000000000000000000000000000000000000000000000000000100000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000001b000000000000000000000000000000000000000000000000000000000000004000000000000000000000000000000000000000000000000000000000000000a0000000000000000000000000000000000000000000000000000000000000002000000000000000000000000000000000000000000000000000000000000000010000000000000000000000006b175474e89094c44da98b954eedeac495271d0f00000000000000000000000000000000000000000000000000000000003dcb21000000000000000000000000ad01c20d5886137e056775af56915de824c8fce5000000000000000000000000000000000000000000000000000000000000001c000000000000000000000000000000000000000000000000000000000000004000000000000000000000000000000000000000000000000000000000000000e00000000000000000000000000000000000000000000000000000000000000020000000000000000000000000000000000000000000000000000000000000004000000000000000000000000000000000000000000000000000000000000000a00000000000000000000000000000000000000000000000000000000000000002000000000000000000000000c02aaa39b223fe8d0a0e5c4f27ead9083c756cc2000000000000000000000000eeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee0000000000000000000000000000000000000000000000000000000000000000869584cd000000000000000000000000100000000000000000000000000000000000001100000000000000000000000000000000000000000d1887adb5ec883592cc6d8e",
"gasPrice": "2533607308",
"estimationCheck": true,
"referenceId": "7e54a22466b34205895563f636a5e59a"
}
]
}
/dex/screen
This endpoint provides data on top activity pools across multiple DEXs (Uni V2, Uni V3, and Sushiswap V2) on Ethereum, offering key metrics like transactions, makers, buyers, sellers, volume, market cap, and liquidity with time intervals from 5 minutes to 24 hours. By default, this endpoint supports top 30 pools ranked by TVL, but the set can be customized.
GET
https://historicallp.api.expand.network/dex/screen
Query Parameters
https://historicallp.api.expand.network/dex/screen
{
"status": 200,
"msg": "success",
"data": [
{
"dex": "sushiswapV2",
"chain": "1",
"poolAddress": "0xfb3cd0b8a5371fe93ef92e3988d30df7931e2820",
"pool": "WETH/INJ",
"txns": {
"m15": {
"sells": 0,
"buys": 0
},
"m5": {
"sells": 0,
"buys": 0
},
"h1": {
"sells": 0,
"buys": 1
},
"h24": {
"sells": 37,
"buys": 44
},
"m30": {
"sells": 0,
"buys": 1
},
"h4": {
"sells": 2,
"buys": 5
},
"h6": {
"sells": 3,
"buys": 6
}
},
"makers": {
"m15": 0,
"m5": 0,
"h1": 1,
"h24": 32,
"m30": 0,
"h4": 1,
"h6": 6
},
"buyers": {
"m15": 0,
"m5": 0,
"h1": 1,
"h24": 21,
"m30": 1,
"h4": 5,
"h6": 6
},
"sellers": {
"m15": 0,
"m5": 0,
"h1": 0,
"h24": 15,
"m30": 0,
"h4": 1,
"h6": 1
},
"volume": {
"m15": {
"sell_vol": "0.00",
"buy_vol": "0.00"
},
"m5": {
"sell_vol": "0.00",
"buy_vol": "0.00"
},
"h1": {
"sell_vol": "0.00",
"buy_vol": "29.10"
},
"h24": {
"sell_vol": "11.91",
"buy_vol": "1610.16"
},
"m30": {
"sell_vol": "0.00",
"buy_vol": "29.10"
},
"h4": {
"sell_vol": "0.55",
"buy_vol": "50.73"
},
"h6": {
"sell_vol": "0.72",
"buy_vol": "94.88"
}
},
"avg_buy_size": "36.594545454545454",
"avg_sell_size": "0.3218918918918919",
"pair_age": "1608184117",
"liquidity": {
"INJ": "16593.04",
"WETH": "109.68"
},
"poolLiquidity": "808559948466546211397",
"price": "149.4748031907699",
"marketCap": "2847630.82",
"holders": "null",
"fdv": "2847630.82"
}
........and many more
]
}
/swapwithapproval
Returns the approve and swap transaction on a DEX supported by Expand.
POST
https://api.expand.network/dex/swapwithapproval
Request Body
{
"dexId":"1000",
"amountIn": "1000000000000000",
"amountOutMin": "0",
"path": ["0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2","0x6B175474E89094C44Da98b954EedeAC495271d0F"],
"to": "0x63056E00436Da25BcF48A40dfBbDcc7089351006",
"deadline": "1665990894",
"from": "0x63056E00436Da25BcF48A40dfBbDcc7089351006",
"gas": "173376"
}
{
"status": 200,
"msg": "success",
"data": [
{
"chainId": "1",
"from": "0x63056E00436Da25BcF48A40dfBbDcc7089351006",
"to": "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2",
"value": "0",
"gas": "173376",
"data": "0x095ea7b30000000000000000000000007a250d5630b4cf539739df2c5dacb4c659f2488d00000000000000000000000000000000000000000000000000038d7ea4c68000",
"nonce": 0,
"referenceId": "497ef8cb1f224ab3ac8ee68211237298"
},
{
"chainId": "1",
"from": "0x63056E00436Da25BcF48A40dfBbDcc7089351006",
"to": "0x7a250d5630B4cF539739dF2C5dAcb4c659F2488D",
"value": "0",
"gas": "173376",
"data": "0x38ed173900000000000000000000000000000000000000000000000000038d7ea4c68000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000a000000000000000000000000063056e00436da25bcf48a40dfbbdcc708935100600000000000000000000000000000000000000000000000000000000634d00ee0000000000000000000000000000000000000000000000000000000000000002000000000000000000000000c02aaa39b223fe8d0a0e5c4f27ead9083c756cc20000000000000000000000006b175474e89094c44da98b954eedeac495271d0f",
"nonce": 1,
"referenceId": "497ef8cb1f224ab3ac8ee68211237298"
}
]
}
/getliquiditybytick
This endpoint provides the amount of liquidity distributed across different ticks for UniswapV3, TraderJoe, and PancakeswapV3. Currently available for Ethereum,Avalanche, Binance and Polygon. The response includes the liquidity for the ticks.
GET
https://api.expand.network/dex/getliquiditybytick
Request Body
https://api.expand.network/dex/getliquiditybytick?dexId=1300&poolAddress=0xCBCdF9626bC03E24f779434178A73a0B4bad62eD&tickRange=10
{
"status": 200,
"msg": "success",
"data": [
{
"tick": "261660",
"statePrice": "23.07710169474025",
"liquidityGross": "2088991794836583",
"liquidityNet": "-2042224526402287"
},
{
"tick": "261720",
"statePrice": "23.21597356043368",
"liquidityGross": "6974876750931033",
"liquidityNet": "-6409350811824255"
},
{
"tick": "261780",
"statePrice": "23.355681120112255",
"liquidityGross": "17871875557359149",
"liquidityNet": "8050121886876293"
},
{
"tick": "261840",
"statePrice": "23.49622940276033",
"liquidityGross": "7449619978944243",
"liquidityNet": "-2807424305176141"
},
{
"tick": "261900",
"statePrice": "23.637623467625318",
"liquidityGross": "4306574319379346",
"liquidityNet": "-133236027504128"
},
{
"tick": "261960",
"statePrice": "23.779868404399853",
"liquidityGross": "61382057256100049",
"liquidityNet": "-61356936216172091"
},
{
"tick": "262020",
"statePrice": "23.922969333404982",
"liquidityGross": "6853452663474539",
"liquidityNet": "-6851833245620381"
},
{
"tick": "262080",
"statePrice": "24.066931405774483",
"liquidityGross": "5194197044038903",
"liquidityNet": "496182904817303"
},
{
"tick": "262140",
"statePrice": "24.211759803640295",
"liquidityGross": "65313806222184665",
"liquidityNet": "-51791915298023631"
},
{
"tick": "262200",
"statePrice": "24.35745974031904",
"liquidityGross": "17658403088342035",
"liquidityNet": "10701533324826677"
},
{
"tick": "262260",
"statePrice": "24.504036460499695",
"liquidityGross": "93295807752567938",
"liquidityNet": "-26007256525835326"
},
{
"tick": "262320",
"statePrice": "24.6514952404324",
"liquidityGross": "50177483835798246",
"liquidityNet": "-50177483835798246"
},
{
"tick": "262380",
"statePrice": "24.79984138811834",
"liquidityGross": "8414397923715812",
"liquidityNet": "-8414397923715812"
},
{
"tick": "262440",
"statePrice": "24.949080243500863",
"liquidityGross": "13082790306573556",
"liquidityNet": "-13082790306573556"
},
{
"tick": "262500",
"statePrice": "25.09921717865765",
"liquidityGross": "9792211900358146",
"liquidityNet": "-9792211900358146"
},
{
"tick": "262560",
"statePrice": "25.250257597994153",
"liquidityGross": "5972517694145393",
"liquidityNet": "-5972517694145393"
},
{
"tick": "262620",
"statePrice": "25.40220693843807",
"liquidityGross": "1488673159010214",
"liquidityNet": "-1488673159010214"
},
{
"tick": "262680",
"statePrice": "25.555070669635104",
"liquidityGross": "1178498774422354",
"liquidityNet": "-1178498774422354"
},
{
"tick": "262740",
"statePrice": "25.70885429414582",
"liquidityGross": "6812295667100567",
"liquidityNet": "-6812295667100567"
},
{
"tick": "262800",
"statePrice": "25.86356334764374",
"liquidityGross": "138040237635655",
"liquidityNet": "-138040237635655"
},
{
"tick": "262860",
"statePrice": "26.019203399114584",
"liquidityGross": "1644971628284598",
"liquidityNet": "-1644971628284598"
}
]
}
Following is a sequence diagram for swap() process:-
Following is a sequence diagram for addLiquidity() process:-
Following is a sequence diagram for removeLiquidity() process:-
Last updated