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.

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

    caller
    string

    Filter by 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
    transaction_from
    string

    Filter by 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
    user
    string

    Filter by 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
    sender
    string

    Filter by 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
    recipient
    string

    Filter by 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
    input_contract
    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_contract
    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
    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