Uniswap V3 Pools

Fetch USDC-WETH 5 bps pool at pool_address 0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640.

curl -s --location --request GET \
    "https://app.pangea.foundation/v1/api/uniswap/v3/pools?chains=ETH&from_block=0&pool_address__in=0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640" \
    --header "Accept: application/jsonstream" \
    --header "Accept-Encoding: gzip" --compressed \
    --header "Authorization: Basic $PANGEA_AUTH" | jq

Response

[
  {
    "chain": 1,
    "block_number": 12376729,
    "block_hash": "0x3496d03e6efd9a02417c713fa0de00915b78581a2eaf0e8b3fce435a96ab02c7",
    "transaction_hash": "0x125e0b641d4a4b08806bf52c0c6757648c9963bcda8681e4f996f09e00d4c2cc",
    "transaction_index": 59,
    "log_index": 101,
    "factory": "0x1f98431c8ad98523631ae4a59f267346ea31f984",
    "token0_address": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
    "token0_decimals": 6,
    "token0_name": "USD//C",
    "token0_symbol": "USDC",
    "token1_address": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
    "token1_decimals": 18,
    "token1_name": "Wrapped Ether",
    "token1_symbol": "WETH",
    "pool_address": "0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640",
    "fee": 500,
    "tick_spacing": 10,
    "timestamp": 1620250931
  }
]

Filter by token address

Fetch pools for blocks 21000000 to 21010000 with USDC 0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48 as either token0 or token1.

curl -s --location --request GET \
    "https://app.pangea.foundation/v1/api/uniswap/v3/pools?chains=ETH&from_block=21000000&to_block=21010000&tokens__in=0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48" \
    --header "Accept: application/jsonstream" \
    --header "Accept-Encoding: gzip" --compressed \
    --header "Authorization: Basic $PANGEA_AUTH" | jq

Response

[
  ...
  {
    "chain": 1,
    "block_number": 21003722,
    "block_hash": "0xaf02d6d7dcfe57bb7a2958ccd497561a231ca482a5f30a0700b8fafdbf67102a",
    "transaction_hash": "0x6c8df40ff22e8bded22339122ab4115df2c011dcd105cecea9a350828a5b0ae9",
    "transaction_index": 1,
    "log_index": 4,
    "factory": "0x1f98431c8ad98523631ae4a59f267346ea31f984",
    "token0_address": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
    "token0_decimals": 6,
    "token0_name": "USD//C",
    "token0_symbol": "USDC",
    "token1_address": "0xcd1bc8580468f9278771e96894ad087ebeac778f",
    "token1_decimals": 6,
    "token1_name": "UnicoinĖ£ USD",
    "token1_symbol": "usdĖ£",
    "pool_address": "0x53d8c010bd9ff116d2e8aa912a17a9a08dd56208",
    "fee": 500,
    "tick_spacing": 10,
    "timestamp": 1729390355
  }
]

Query Parameters

v1/api/uniswap/v3/pools

  • chains: Filters the data by specific blockchain networks.
  • from_block: Filters the data by a starting block number.
  • to_block: Filters the data by an ending block number.
  • pool_address__in: Filters the data by a list of pool_address.
  • factory_address__in: Filters the data by a list of pool factory_address.
  • token0__in / token0_address__in: Filters the data by a list of token0_address.
  • token1__in / token1_address__in: Filters the data by a list of token1_address.
  • tokens__in: Filters the data by a list of both token0_address and token1_address.
  • fee__gte: Filters the data by fee using the greater than or equal to operator.
  • fee__lte: Filters the data by fee using the less than or equal to operator.
  • tick_spacing__gte: Filters the data by tick_spacing using the greater than or equal to operator.
  • tick_spacing__lte: Filters the data by tick_spacing using the less than or equal to operator.