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.

          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, bancor, curvefi, balancer
                  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