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 NFT Endpoints

                  NFT Sales

                  GET/v1/evm/nft/sales

                  Returns NFT marketplace sales with price, buyer, seller, and transaction data.

                  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.

                    contract
                    string

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

                      token_id
                      string

                      Token ID
                      Single value or array of values* (separate multiple values with ,)
                      *Plan restricted.

                        address
                        string

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

                          from_address
                          string

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

                            to_address
                            string

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

                              start_time
                              string

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

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

                              NFT Ownerships by AddressNFT Transfers
                              Test this endpoint

                              1curl --request GET \2  --url 'https://token-api.thegraph.com/v1/evm/nft/sales?network=mainnet&transaction_id=0x8cc8b83e7b7fec752bd689700156990e7ce4d6b890f7b5ab58adf2fb602a98b9&contract=0xbd3531da5cf5857e7cfaa92426877b022e612cf8&token_id=5712&address=0x355062b5d0e324815290b96370e87607a71d613d&from_address=0x355062b5d0e324815290b96370e87607a71d613d&to_address=0x7ccde43632b3287fda060719d802b2c4cb6f769b&start_time=2025-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": 22098625,5      "datetime": "2025-03-21 23:46:11",6      "timestamp": 1742600771,7      "transaction_id": "0x8cc8b83e7b7fec752bd689700156990e7ce4d6b890f7b5ab58adf2fb602a98b9",8      "contract": "0xbd3531da5cf5857e7cfaa92426877b022e612cf8",9      "token_id": "5712",10      "name": "PudgyPenguins",11      "symbol": "PPG",12      "offerer": "0x355062b5d0e324815290b96370e87607a71d613d",13      "recipient": "0x7ccde43632b3287fda060719d802b2c4cb6f769b",14      "sale_amount": 9.73,15      "sale_currency": "ETH",16      "network": "mainnet"17    }18  ]19}
                              The GraphStatusTestnetActifs de la MarqueForumSécuritéPolitique de confidentialitéConditions d'utilisation