Docs
⌘ K

Swap Events

GET/v1/evm/swaps

Returns DEX swap transactions from Uniswap protocols with token amounts and prices.

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
transaction_id
string

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

    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.

        caller
        string

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

          transaction_from
          string

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

            user
            string

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

              sender
              string

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

                recipient
                string

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

                  input_contract
                  string

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

                    output_contract
                    string

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

                      protocol
                      string

                      Protocol name

                      • Accepted values: uniswap_v1, uniswap_v2, uniswap_v3, uniswap_v4, curvefi, balancer, bancor, cow, aerodrome, dodo, woofi, traderjoe, kyber_elastic
                      null
                      start_time
                      string

                      UNIX timestamp in seconds or date string (e.g. "2025-01-01T00:00:00Z", "2025-01-01", ...).

                        end_time
                        string

                        UNIX timestamp in seconds or date string (e.g. "2025-01-01T00:00:00Z", "2025-01-01", ...).

                          start_block
                          integer

                          Filter by block number

                          • Minimum value: 0
                          • Maximum value: 9007199254740991
                          end_block
                          integer

                          Filter by block number

                          • Minimum value: 0
                          • Maximum value: 9007199254740991
                          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