Docs
Search⌘ K
  • Home
  • حول The Graph
  • الشبكات المدعومة
  • Protocol Contracts
  • Subgraphs
    • متعدد-السلاسل
      • Token API
        • Hypergraph
          • AI Suite
            • Indexing
              • Resources
                Token API > EVM Endpoints

                NFT Sales

                GET/nft/sales/evm

                Provides latest NFT marketplace sales.

                Query Parameters

                ParameterالوصفValue
                network_id
                string

                The Graph Network ID for EVM networks https://thegraph.com/networks

                • Default value: mainnet
                • Accepted values: arbitrum-one, avalanche, base, bsc, mainnet, matic, optimism, unichain
                Required
                mainnet
                contract
                string

                Filter by NFT contract address

                  Required
                  token_id
                  string

                  NFT token ID

                    anyAddress
                    string

                    Filter by address

                      offererAddress
                      string

                      Filter by address

                        recipientAddress
                        string

                        Filter by address

                          startTime
                          integer

                          UNIX timestamp in seconds.

                          • Default value: 1735689600
                          • Minimum value: -9007199254740991
                          • Maximum value: 9007199254740991
                          endTime
                          integer

                          UNIX timestamp in seconds.

                          • Default value: 9999999999
                          • Minimum value: -9007199254740991
                          • Maximum value: 9007199254740991
                          orderBy
                          string

                          The field by which to order the results.

                          • Default value: timestamp
                          • Accepted values: timestamp
                          timestamp
                          orderDirection
                          string

                          The order in which to return the results: Ascending (asc) or Descending (desc).

                          • Default value: desc
                          • Accepted values: asc, desc
                          desc
                          limit
                          integer

                          The maximum number of items returned in a single request.

                          • Default value: 10
                          • Minimum value: 1
                          • Maximum value: 1000
                          page
                          integer

                          The page number of the results to return.

                          • Default value: 1
                          • Minimum value: 1
                          • Maximum value: 767465558638

                          Potential Responses

                          Statusالوصف
                          200Successful Response
                          400Client side error
                          401Authentication failed
                          403Forbidden
                          404Not found
                          500Server side error
                          ⁠Edit on GitHub⁠

                          NFT OwnershipsBalances
                          Test this endpoint

                          1curl --request GET \2  --url 'https://token-api.thegraph.com/nft/sales/evm?network_id=mainnet&startTime=1735689600&endTime=9999999999&orderBy=timestamp&orderDirection=desc&limit=10&page=1' \3  --header 'Authorization: Bearer {token}'

                          1{2  "data": [3    {4      "timestamp": "2025-05-29 07:52:47",5      "block_num": 22587041,6      "tx_hash": "0x6755df1514a066150357d454254e1ce6c1e043f873193125dc98d4c4417861ff",7      "token": "0xbd3531da5cf5857e7cfaa92426877b022e612cf8",8      "token_id": "6398",9      "symbol": "PPG",10      "name": "PudgyPenguins",11      "offerer": "0xf671888173bf2fe28d71fba3106cf36d10f470fe",12      "recipient": "0x43bf952762b087195b8ea70cf81cb6715b6bf5a9",13      "sale_amount": 10.0667234,14      "sale_currency": "ETH"15    }16  ]17}
                          The GraphStatusTestnetBrand AssetsForumSecurityPrivacy PolicyTerms of Service