Docs
Search⌘ K
  • Home
  • About The Graph
  • Supported Networks
  • Protocol Contracts
  • Subgraphs
    • Substreams
      • Token API
        • Hypergraph
          • AI Suite
            • Indexing
              • Graph Horizon
                • 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.

                  • Accepted pattern: ^(0[xX])?[0-9a-fA-F]{40}$
                  • Format: evm-address
                  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.

                    • Accepted pattern: ^(0[xX])?[0-9a-fA-F]{40}$
                    • Format: evm-address
                    output_token
                    string

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

                    • Accepted pattern: ^(0[xX])?[0-9a-fA-F]{40}$
                    • Format: evm-address
                    protocol
                    string

                    Protocol name

                    • Accepted values: uniswap_v1, uniswap_v2, uniswap_v3, uniswap_v4, curvefi, balancer, bancor, cow, aerodrome, dodo, woofi, traderjoe, kyber_elastic
                    uniswap_v3
                    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⁠

                    Supported DEXsPool OHLCV Data
                    Test this endpoint

                    1curl --request GET \2  --url 'https://token-api.thegraph.com/v1/evm/pools?network=mainnet&factory=0x1f98431c8ad98523631ae4a59f267346ea31f984&pool=0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640&input_token=0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48&output_token=0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2&protocol=uniswap_v3&limit=10&page=1' \3  --header 'Authorization: Bearer {token}'

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