Get NFT transactions for contract

Commonly used to get all transactions of an NFT token. Useful for building a transaction history table or price chart.

^{Credit Cost: 0.1 per item.
Processing: Realtime}

Related guides

Mastering NFT Indexing: GoldRush’s Advanced API for Comprehensive NFT Data

How to Block NFT Spam

How to Get All Transfers for an NFT

Path Parameters

chainName

string

required

The chain name eg: eth-mainnet.

contractAddress

string

required

The requested contract address. Passing in an ENS, RNS, Lens Handle, or an Unstoppable Domain resolves automatically.

tokenId

string

required

The requested token ID.

Query Parameters

no-spam

boolean

If true, the suspected spam tokens are removed. Supports eth-mainnet and matic-mainnet.

Response

200 - application/json

chain_id

integer

The requested chain ID eg: 1.

chain_name

string

The requested chain name eg: eth-mainnet.

items

object[]

List of response items.

Show child attributes

items.contract_address

string

Use the relevant contract_address to lookup prices, logos, token transfers, etc.

items.contract_decimals

integer

Use contract decimals to format the token balance for display purposes - divide the balance by 10^{contract_decimals}.

items.contract_name

string

The string returned by the name() method.

items.contract_ticker_symbol

string

The ticker symbol for this contract. This field is set by a developer and non-unique across a network.

items.is_spam

boolean

Denotes whether the token is suspected spam. Supports eth-mainnet and matic-mainnet.

items.logo_url

string

The contract logo URL.

items.nft_transactions

object[]

Show child attributes

items.nft_transactions.block_height

integer

The height of the block.

items.nft_transactions.block_signed_at

string

The block signed timestamp in UTC.

items.nft_transactions.fees_paid

string

b;The total transaction fees (gas_price * gas_spent) paid for this tx, denoted in wei.

items.nft_transactions.from_address

string

The sender's wallet address.

items.nft_transactions.from_address_label

string

The label of from address.

items.nft_transactions.gas_offered

integer

items.nft_transactions.gas_price

integer

The gas price at the time of this tx.

items.nft_transactions.gas_quote

number

The gas spent in quote-currency denomination.

items.nft_transactions.gas_quote_rate

number

items.nft_transactions.gas_spent

integer

The gas spent for this tx.

items.nft_transactions.log_events

object[]

The log events.

Show child attributes

items.nft_transactions.log_events.block_height

integer

The height of the block.

items.nft_transactions.log_events.block_signed_at

string

The block signed timestamp in UTC.

items.nft_transactions.log_events.decoded

object

The decoded item.

Show child attributes

items.nft_transactions.log_events.decoded.name

string

items.nft_transactions.log_events.decoded.params

object[]

Show child attributes

items.nft_transactions.log_events.decoded.signature

string

items.nft_transactions.log_events.log_offset

integer

The offset is the position of the log entry within an event log.

items.nft_transactions.log_events.raw_log_data

string

The log events in raw.

items.nft_transactions.log_events.raw_log_topics

string[]

The log topics in raw data.

items.nft_transactions.log_events.sender_address

string

The address of the sender.

items.nft_transactions.log_events.sender_address_label

string

The label of the sender address.

items.nft_transactions.log_events.sender_contract_decimals

integer

Use contract decimals to format the token balance for display purposes - divide the balance by 10^{contract_decimals}.

items.nft_transactions.log_events.sender_contract_ticker_symbol

string

items.nft_transactions.log_events.sender_factory_address

string

The address of the deployed UniswapV2 like factory contract for this DEX.

items.nft_transactions.log_events.sender_logo_url

string

The contract logo URL.

items.nft_transactions.log_events.sender_name

string

The name of the sender.

items.nft_transactions.log_events.supports_erc

string[]

A list of supported standard ERC interfaces, eg: ERC20 and ERC721.

items.nft_transactions.log_events.tx_hash

string

The requested transaction hash.

items.nft_transactions.log_events.tx_offset

integer

The offset is the position of the tx in the block.

items.nft_transactions.pretty_gas_quote

string

A prettier version of the quote for rendering purposes.

items.nft_transactions.pretty_value_quote

string

A prettier version of the quote for rendering purposes.

items.nft_transactions.successful

boolean

Whether or not transaction is successful.

items.nft_transactions.to_address

string

The receiver's wallet address.

items.nft_transactions.to_address_label

string

The label of to address.

items.nft_transactions.tx_hash

string

The requested transaction hash.

items.nft_transactions.tx_offset

integer

The offset is the position of the tx in the block.

items.nft_transactions.value

string

b;The value attached to this tx.

items.nft_transactions.value_quote

number

The value attached in quote-currency to this tx.

items.supports_erc

string[]

A list of supported standard ERC interfaces, eg: ERC20 and ERC721.

updated_at

string

The timestamp when the response was generated. Useful to show data staleness to users.