Docs
⌘ K

NFT Sales

GET/v1/evm/nft/sales

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

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.

    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", ...).

                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