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 page for details.

path*

String

Comma separated values of token addresses whose price is to be fetched.

amountIn*

String

Amount of token.

https://api.expand.network/dex/getprice?dexId=1000&path=0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2,0xdac17f958d2ee523a2206206994597c13d831ec7&amountIn=10000000000000000000

{
    "status": 200,
    "msg": "success",
    "data": {
        "amountIn": "10000000000000000000",
        "path": [
            "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
            "0xdac17f958d2ee523a2206206994597c13d831ec7"
        ],
        "amountsOut": [
            "10000000000000000000",
            "15682130807"
        ]
    }
}

/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 page for details.

tokenB*

String

Address of token.

https://api.expand.network/dex/getuserliquidity?tokenA=0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2&tokenB=0x6b175474e89094c44da98b954eedeac495271d0f&address=0x6fb447ae94f5180254d436a693907a1f57696900&dexId=1000

{
    "status": 200,
    "msg": "success",
    "data": {
        "pairAddress": "0xA478c2975Ab1Ea89e8196811F51A7B7Ade33eB11",
        "liquidity": "2087379027763486",
        "tokenA": "91297717639957",
        "tokenB": "153006474077467970"
    }
}

/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 page for details.

https://api.expand.network/dex/getpoolliquidity?poolAddress=0x0d4a11d5eeaac28ec3f61d100daf4d40471f1852&dexId=1000

{
    "status": 200,
    "msg": "success",
    "data": {
        "totalLiquidity": "312219425553389289"
    }
}

/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 page for details.

https://api.expand.network/dex/gettokenliquidity?poolAddress=0x0d4a11d5eeaac28ec3f61d100daf4d40471f1852&dexId=1000

{
    "status": 200,
    "msg": "success",
    "data": {
        "WETH": "16984981267096993883931",
        "USDT": "31586831096555"
    }
}

/getliquidityholders

Returns the total number of liquidity holders in the specified pool.

GET https://api.expand.network/dex/getliquidityholders

Query Parameters

Name

Type

Description

rpc

String

Remote procedural call URL.

poolAddress*

String

The pool address.

dexId

String

Refer to page for details.

https://api.expand.network/dex/getliquidityholders?poolAddress=0x0d4a11d5eeaac28ec3f61d100daf4d40471f1852&dexId=1000

{
    "status": 200,
    "msg": "success",
    "data": {
        "totalTokenHolders": "2572"
    }
}

/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 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

https://api.expand.network/dex/getindividualposition?dexId=1000&address=0x6Fb447Ae94F5180254D436A693907a1f57696900

{
    "status": 200,
    "msg": "success",
    "data": {
        "aggregatedLiquidity": "2370404879481514",
        "poolAddresses": {
            "DAIWETH": {
                "0xA478c2975Ab1Ea89e8196811F51A7B7Ade33eB11": "2370404879481514"
            }
        }
    }
}

/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 page for details.

endPage

String

Index of the last page that user wants to query.

By default: startPage+9

startPage

String

Index of the start page that user wants to query.

By default: endPage-9

https://historicallp.api.expand.network/dex/getpoolindividualliquidity?startPage=211&endPage=212&poolAddress=0x0d4a11d5eeaac28ec3f61d100daf4d40471f1852&dexId=1000

{
  "status": 200,
  "msg": "success",
  "data": {
      "totalPages": "434",
      "currentPages": "211-212",
      "users": [
        {
          "userAddress": "0x5e34e63c37ce88e0d404c3ba149317ddf5f4ecaa",
          "liquidityData": [
              {
                  "blockNumber": "10975329",
                  "assets": {
                      "WETH": "87432734717490961",
                      "USDT": "30000000"
                  }
              }
          ]
      },
      {
          "userAddress": "0xf00a67934445876587ceda02728d493faa980b7a",
          "liquidityData": [
              {
                  "blockNumber": "10975289",
                  "assets": {
                      "WETH": "3494751089343567443",
                      "USDT": "1196562631"
                  }
              }
          ]
      },
      {
          "userAddress": "0xcd9410d3fe8916267f82dc13d7bbdba99e5643f7",
          "liquidityData": [
              {
                  "blockNumber": "10975229",
                  "assets": {
                      "WETH": "125975496436173808",
                      "USDT": "43126850"
                  }
              }
          ]
      },
      {
          "userAddress": "0xbffd0519e7bc626bf6ce4a31503bcb0a4075295b",
          "liquidityData": [
              {
                  "blockNumber": "10975228",
                  "assets": {
                      "WETH": "2999874086297596538",
                      "USDT": "1027021840"
                  }
              }
          ]
      },
      {
          "userAddress": "0x38d744e972419efe95df2aa6c047df9cd01579c5",
          "liquidityData": [
              {
                  "blockNumber": "10975194",
                  "assets": {
                      "WETH": "1425646890758547175",
                      "USDT": "488181735"
                  }
              }
          ]
      },
      {
          "userAddress": "0x40285fc5233fff0da4bf2c5f93e187fb4ab3306a",
          "liquidityData": [
              {
                  "blockNumber": "10975176",
                  "assets": {
                      "WETH": "1152868937561643841",
                      "USDT": "395000000"
                  }
              }
          ]
      }
      ]
  }
}

/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 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.

https://historicaltrade.api.expand.network/dex/gethistoricaltimeseries?poolAddress=0x517f9dd285e75b599234f7221227339478d0fcc8&dexId=1000

{
    "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"
            }
        ]
    }
}

/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 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.

https://historicaltrade.api.expand.network/dex/gethistoricaltransactions?poolAddress=0xb4e16d0168e52d35cacd2c6185b44281ec28c9dc&dexId=1000

{
    "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"
                }
            }
        ]
    }
}

/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 page for details.

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?limit=100&interval=15m&dexId=1000&poolAddress=0x517F9dD285e75b599234F7221227339478d0FcC8

{
    "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"
                }
            },
        ]
    }
}

/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 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.

https://historicaltrade.api.expand.network/dex/getpoolchartdata?dexId=1000&poolAddress=0xb4e16d0168e52d35cacd2c6185b44281ec28c9dc&interval=60

{
    "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"
                            }
                        }
                    ]
                }
            ]
        }
    }
}

/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 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).

https://historicaltrade.api.expand.network/dex/getpooltradedata?poolAddress=0xb4e16d0168e52d35cacd2c6185b44281ec28c9dc&dexId=1000&eventType=Burn

{
    "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"
                    ]
                }
            }
        ]
    }
}

/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 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.

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 .

gasPriority

String

low, medium, or high.

slippage

String

Percentage of total swap value. By default, 1.

0 <= slippage value <= 100

{
    "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": "0x7a250d5630B4cF539739dF2C5dAcb4c659F2488D",
        "value": "0",
        "gas": "173376",
        "data": "0x38ed173900000000000000000000000000000000000000000000000000038d7ea4c68000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000a000000000000000000000000063056e00436da25bcf48a40dfbbdcc708935100600000000000000000000000000000000000000000000000000000000634d00ee0000000000000000000000000000000000000000000000000000000000000002000000000000000000000000c02aaa39b223fe8d0a0e5c4f27ead9083c756cc20000000000000000000000006b175474e89094c44da98b954eedeac495271d0f",
        "estimationCheck": true,
        "referenceId": "f6e53dc2b6404645bf503e547811a0d4"
    }
}

With gasPriority:

{
    "dexId": "1000",
    "amountIn": "10000000000",
    "amountOutMin": "0",
    "path": [
        "0x6B175474E89094C44Da98b954EedeAC495271d0F",
        "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2"
    ],
    "to": "0x356dB816602c85e2075774bB77D13995c8Bab023",
    "deadline": "1765990894",
    "from": "0x356dB816602c85e2075774bB77D13995c8Bab023",
    "gas": "273376",
    "gasPriority": "high"
}

With gasPriority:

{
    "status": 200,
    "msg": "success",
    "data": {
        "chainId": "1",
        "from": "0x356dB816602c85e2075774bB77D13995c8Bab023",
        "to": "0x7a250d5630B4cF539739dF2C5dAcb4c659F2488D",
        "value": "0",
        "gas": "273376",
        "data": "0x38ed173900000000000000000000000000000000000000000000000000000002540be400000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000a0000000000000000000000000356db816602c85e2075774bb77d13995c8bab023000000000000000000000000000000000000000000000000000000006942e1ee00000000000000000000000000000000000000000000000000000000000000020000000000000000000000006b175474e89094c44da98b954eedeac495271d0f000000000000000000000000c02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
        "gasPrice": "35333757810",
        "estimationCheck": true,
        "referenceId": "c65d3c66ac72477786f5aa4a3b7dd192"
    }
}

With Slippage:

{
    "dexId": "1000",
    "amountIn": "10000000000000",
    "amountOutMin": "0",
    "path": [
        "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2",
        "0x6B175474E89094C44Da98b954EedeAC495271d0F"
    ],
    "to": "0x22cf65ae3fa16d6379e72f4b4c2401c1b7c69731",
    "deadline": "1701931771",
    "from": "0x22cf65ae3fa16d6379e72f4b4c2401c1b7c69731",
    "gas": "173376",
    "slippage": "10"
}

With Slippage:

{
    "status": 200,
    "msg": "success",
    "data": {
        "chainId": "1",
        "from": "0x22cf65ae3fa16d6379e72f4b4c2401c1b7c69731",
        "to": "0x7a250d5630B4cF539739dF2C5dAcb4c659F2488D",
        "value": "0",
        "gas": "173376",
        "data": "0x38ed1739000000000000000000000000000000000000000000000000000009184e72a000000000000000000000000000000000000000000000000000004f2c564cb7cb0000000000000000000000000000000000000000000000000000000000000000a000000000000000000000000022cf65ae3fa16d6379e72f4b4c2401c1b7c697310000000000000000000000000000000000000000000000000000000065716afb0000000000000000000000000000000000000000000000000000000000000002000000000000000000000000c02aaa39b223fe8d0a0e5c4f27ead9083c756cc20000000000000000000000006b175474e89094c44da98b954eedeac495271d0f",
        "estimationCheck": true,
        "referenceId": "431c127d298b4a8484ced40bc34a55ab"
    }
}

/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 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

{
    "dexId": "1000",
    "tokenA": "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2", 
    "tokenB": "0x6B175474E89094C44Da98b954EedeAC495271d0F", 
    "amountADesired": "1000000000000000",
    "amountBDesired": "1332066335118442626",
    "amountAMin": "0",
    "amountBMin": "0",
    "to": "0x63056E00436Da25BcF48A40dfBbDcc7089351006",  
    "deadline": "166978170",
    "from": "0x63056E00436Da25BcF48A40dfBbDcc7089351006",  
    "gas": "230000"
}

{
    "status": 200,
    "msg": "success",
    "data": {
        "chainId": "1",
        "from": "0x63056E00436Da25BcF48A40dfBbDcc7089351006",
        "to": "0x7a250d5630B4cF539739dF2C5dAcb4c659F2488D",
        "value": "0",
        "gas": "230000",
        "data": "0xe8e33700000000000000000000000000c02aaa39b223fe8d0a0e5c4f27ead9083c756cc20000000000000000000000006b175474e89094c44da98b954eedeac495271d0f00000000000000000000000000000000000000000000000000038d7ea4c68000000000000000000000000000000000000000000000000000127c734631fdc0820000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000063056e00436da25bcf48a40dfbbdcc70893510060000000000000000000000000000000000000000000000000000000009f3e27a",
        "estimationCheck": true,
        "referenceId": "a7fa313845d84addb36a61ae0cfed8fe"
    }
}

With gasPriority:

{
    "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"
}

With gasPriority:

{
    "status": 200,
    "msg": "success",
    "data": {
        "chainId": "1",
        "from": "0x356dB816602c85e2075774bB77D13995c8Bab023",
        "to": "0x7a250d5630B4cF539739dF2C5dAcb4c659F2488D",
        "value": "0",
        "gas": "0",
        "data": "0xe8e33700000000000000000000000000a0b86991c6218b36c1d19d4a2e9eb0ce3606eb480000000000000000000000006b175474e89094c44da98b954eedeac495271d0f00000000000000000000000000000000000000000000000000000000000003e800000000000000000000000000000000000000000000000000038b6d3ad182a500000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000356db816602c85e2075774bb77d13995c8bab0230000000000000000000000000000000000000000000000000000018bcddc8769",
        "gasPrice": "28418670209",
        "estimationCheck": true,
        "referenceId": "9aad6d0b4428499ca9247ea8ee76e63b"
    }
}

With Slippage:

{
    "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"
}

With Slippage:

{
    "status": 200,
    "msg": "success",
    "data": {
        "chainId": "1",
        "from": "0x22cf65Ae3fa16d6379E72F4B4c2401c1B7C69731",
        "to": "0x7a250d5630B4cF539739dF2C5dAcb4c659F2488D",
        "value": "0",
        "gas": "230000",
        "data": "0xe8e33700000000000000000000000000dac17f958d2ee523a2206206994597c13d831ec7000000000000000000000000c02aaa39b223fe8d0a0e5c4f27ead9083c756cc200000000000000000000000000000000000000000000000000000000000f4240000000000000000000000000000000000000000000000000000246b8153f8d8c000000000000000000000000000000000000000000000000000000000000005f000000000000000000000000000000000000000000000000000000000000005f00000000000000000000000022cf65ae3fa16d6379e72f4b4c2401c1b7c697310000000000000000000000000000000000000000000000000000018e9c17ab61",
        "estimationCheck": true,
        "referenceId": "a451275a6d5f4f789ac6c09c2bfe55cb"
    }
}

/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 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

{
    "dexId": "1000",
    "tokenA": "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2",
    "tokenB": "0x6B175474E89094C44Da98b954EedeAC495271d0F",
    "liquidity": "20759430672661383",
    "amountAMin": "0",
    "amountBMin": "0",
    "to": "0x63056E00436Da25BcF48A40dfBbDcc7089351006",
    "deadline": "1669720626",
    "from": "0x63056E00436Da25BcF48A40dfBbDcc7089351006",
    "gas": "420000"
}

{
    "status": 200,
    "msg": "success",
    "data": {
        "chainId": "1",
        "from": "0x63056E00436Da25BcF48A40dfBbDcc7089351006",
        "to": "0x7a250d5630B4cF539739dF2C5dAcb4c659F2488D",
        "value": "0",
        "gas": "420000",
        "data": "0xbaa2abde000000000000000000000000c02aaa39b223fe8d0a0e5c4f27ead9083c756cc20000000000000000000000006b175474e89094c44da98b954eedeac495271d0f0000000000000000000000000000000000000000000000000049c0979afbbb870000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000063056e00436da25bcf48a40dfbbdcc7089351006000000000000000000000000000000000000000000000000000000006385ea32",
        "estimationCheck": true,
        "referenceId": "6d8ff104b4e84b79a3d7a750e103be44"
    }
}

With gasPriority:

{
    "dexId": "1000",
    "tokenA": "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2",
    "tokenB": "0x6B175474E89094C44Da98b954EedeAC495271d0F",
    "liquidity": "20759430672661383",
    "amountAMin": "0",
    "amountBMin": "0",
    "to": "0x63056E00436Da25BcF48A40dfBbDcc7089351006",
    "deadline": "1669720626",
    "from": "0x63056E00436Da25BcF48A40dfBbDcc7089351006",
    "gas": "420000",
    "gasPriority": "high"
}

With gasPriority:

{
    "status": 200,
    "msg": "success",
    "data": {
        "chainId": "1",
        "from": "0x63056E00436Da25BcF48A40dfBbDcc7089351006",
        "to": "0x7a250d5630B4cF539739dF2C5dAcb4c659F2488D",
        "value": "0",
        "gas": "420000",
        "data": "0xbaa2abde000000000000000000000000c02aaa39b223fe8d0a0e5c4f27ead9083c756cc20000000000000000000000006b175474e89094c44da98b954eedeac495271d0f0000000000000000000000000000000000000000000000000049c0979afbbb870000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000063056e00436da25bcf48a40dfbbdcc7089351006000000000000000000000000000000000000000000000000000000006385ea32",
        "gasPrice": "35169117159",
        "estimationCheck": true,
        "referenceId": "d92319bdba68444b8f52f01735ec6550"
    }
}

With slippage:

{
    "dexId": "1000",
    "tokenA": "0x6B175474E89094C44Da98b954EedeAC495271d0F",
    "tokenB": "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2",
    "liquidity": "3834508059710445",
    "amountAMin": "100",
    "amountBMin": "100",
    "to": "0x4970798F8E5a77598CA4Da778eb6D12303AEefc9",
    "deadline": "1669720626",
    "from": "0x4970798F8E5a77598CA4Da778eb6D12303AEefc9",
    "gas": "420000",
    "slippage": "5.01"
}

With slippage:

{
    "status": 200,
    "msg": "success",
    "data": {
        "chainId": "1",
        "from": "0x4970798F8E5a77598CA4Da778eb6D12303AEefc9",
        "to": "0x7a250d5630B4cF539739dF2C5dAcb4c659F2488D",
        "value": "0",
        "gas": "420000",
        "data": "0xbaa2abde0000000000000000000000006b175474e89094c44da98b954eedeac495271d0f000000000000000000000000c02aaa39b223fe8d0a0e5c4f27ead9083c756cc2000000000000000000000000000000000000000000000000000d9f76fac993ed000000000000000000000000000000000000000000000000000000000000005f000000000000000000000000000000000000000000000000000000000000005f0000000000000000000000004970798f8e5a77598ca4da778eb6d12303aeefc9000000000000000000000000000000000000000000000000000000006385ea32",
        "estimationCheck": true,
        "referenceId": "4e1324d014cf4d8daab6a023fe3322cc"
    }
}

PreviousDEX & DEX Aggregators NextUniswap V3

Last updated 20 days ago