Docs
La Recherche⌘ K
  • Accueil
  • À propos de The Graph
  • Réseaux pris en charge
  • Contrats du Protocole
  • Subgraphs
    • Substreams
      • Token API
        • Hypergraph
          • AI Suite
            • Indexing
              • Graph Horizon
                • Resources
                  Token API > EVM DEX Endpoints

                  Swap Events

                  GET/v1/evm/swaps

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

                  Paramètres de requête

                  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.

                    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.

                            protocol
                            string

                            Protocol name

                            • Accepted values: uniswap_v2, uniswap_v3, uniswap_v4
                            start_time
                            string

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

                            • Default value: 2015-01-01
                            end_time
                            string

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

                            • Default value: 2050-01-01
                            start_block
                            integer

                            Filter by block number

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

                            Filter by block number

                            • Default value: 9999999999
                            • 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

                            ⁠Edit on GitHub⁠

                            Liquidity PoolsNFT Collection
                            Test this endpoint

                            1curl --request GET \2  --url 'https://token-api.thegraph.com/v1/evm/swaps?network=mainnet&transaction_id=0xf6374799c227c9db38ff5ac1d5bebe8b607a1de1238cd861ebd1053ec07305ca&pool=0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640&caller=0xa69babef1ca67a37ffaf7a485dfff3382056e78c&sender=0xa69babef1ca67a37ffaf7a485dfff3382056e78c&recipient=0xa69babef1ca67a37ffaf7a485dfff3382056e78c&start_time=2015-01-01&end_time=2050-01-01&start_block=0&end_block=9999999999&limit=10&page=1' \3  --header 'Authorization: Bearer {token}'

                            1{2  "data": [3    {4      "block_num": 23590326,5      "datetime": "2025-10-16 12:48:47",6      "timestamp": 1760618927,7      "transaction_id": "0xf6374799c227c9db38ff5ac1d5bebe8b607a1de1238cd861ebd1053ec07305ca",8      "factory": "0x1f98431c8ad98523631ae4a59f267346ea31f984",9      "pool": "0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640",10      "input_token": {11        "address": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",12        "symbol": "USDC",13        "decimals": 614      },15      "output_token": {16        "address": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",17        "symbol": "WETH",18        "decimals": 1819      },20      "caller": "0xa69babef1ca67a37ffaf7a485dfff3382056e78c",21      "sender": "0xa69babef1ca67a37ffaf7a485dfff3382056e78c",22      "recipient": "0xa69babef1ca67a37ffaf7a485dfff3382056e78c",23      "input_amount": "40735537734",24      "input_value": 40735.537734,25      "output_amount": "10042247631260591234",26      "output_value": 10.042247631260592,27      "price": 246517483.4798306,28      "price_inv": 4.0565074163667475e-9,29      "protocol": "uniswap_v3",30      "summary": "Swap 40.74 thousand USDC for 10.042247631260592 WETH on Uniswap V3",31      "network": "mainnet"32    }33  ]34}
                            The GraphStatusTestnetActifs de la MarqueForumSécuritéPolitique de confidentialitéConditions d'utilisation