Docs
Search⌘ K
  • Home
  • About The Graph
  • Supported Networks
  • Protocol Contracts
  • Subgraphs
    • Substreams
      • Token API
        • Hypergraph
          • AI Suite
            • Indexing
              • Resources
                Token API > EVM DEX Endpoints

                Liquidity Pools

                GET/v1/evm/pools

                Returns Uniswap liquidity pool metadata including token pairs, fees, and protocol versions.

                Query Parameters

                ParameterDescriptionValue
                network
                string

                The Graph Network ID for EVM networks https://thegraph.com/networks

                • Accepted values: arbitrum-one, avalanche, base, bsc, mainnet, optimism, polygon, unichain
                Required
                mainnet
                factory
                string

                Filter by factory address
                Single value or array of values* (separate multiple values with ,)
                *Plan restricted.

                  pool
                  string

                  Filter by pool address
                  Single value or array of values* (separate multiple values with ,)
                  *Plan restricted.

                    input_token
                    string

                    Filter by contract address
                    Single value or array of values* (separate multiple values with ,)
                    *Plan restricted.

                      output_token
                      string

                      Filter by contract address
                      Single value or array of values* (separate multiple values with ,)
                      *Plan restricted.

                        protocol
                        string

                        Protocol name

                        • Accepted values: uniswap_v2, uniswap_v3, uniswap_v4
                        limit
                        integer

                        Number of items* returned in a single request.
                        *Plan restricted.

                        • Default value: 10
                        • Minimum value: 1
                        • Maximum value: 1000
                        page
                        integer

                        Page number to fetch.
                        Empty data array signifies end of results.

                        • Default value: 1
                        • Minimum value: 1
                        • Maximum value: 767465558638

                        Potential Responses

                        StatusDescription
                        200

                        Successful Response

                        400

                        Client side error

                        401

                        Authentication failed

                        403

                        Forbidden

                        404

                        Not found

                        500

                        Server side error

                        ⁠Edit on GitHub⁠

                        Pool OHLCV DataSwap Events
                        Test this endpoint

                        1curl --request GET \2  --url 'https://token-api.thegraph.com/v1/evm/pools?network=mainnet&limit=10&page=1' \3  --header 'Authorization: Bearer {token}'

                        1{2  "data": [3    {4      "factory": "0x1f98431c8ad98523631ae4a59f267346ea31f984",5      "pool": "0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640",6      "input_token": {7        "address": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",8        "symbol": "USDC",9        "decimals": 610      },11      "output_token": {12        "address": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",13        "symbol": "WETH",14        "decimals": 1815      },16      "fee": 500,17      "protocol": "uniswap_v3",18      "network": "mainnet"19    }20  ]21}
                        The GraphStatusTestnetBrand AssetsForumSecurityPrivacy PolicyTerms of Service