Links

NFT Events (Historical Querying)

Query historical NFT transactions by type, address, collection, and time.
Note: for our first (beta) release — we are NOT including NFT AMMs in the API.

v1/nft-events

Query NFT events by associated accounts, marketplaces, event types, and/or by NFT collections. The query can be optionally limited to specific slot or time ranges.
An NFT event is any transaction with a type equal to an NFTEvent. For a comprehensive list of NFT Events, please see Definitions.
For more information on working with NFT collections, please read Working with NFT Collections on Solana— or keep reading to see various usage examples.
We recommend filtering time ranges by slot for optimal performance.
Oops, something is missing.
We could not find the original source to display this content.

Examples

Basic example

const axios = require('axios')
​
const url = `https://api.helius.xyz/v1/nft-events?api-key=<api_key>`
​
const getNftEvents = async () => {
const { data } = await axios.post(url, {
query: {
accounts: ["BAAzgRGWY2v5AJBNZNFd2abiRXAUo56UxywKEjoCZW2"],
}
});
console.log("events: ", data.result);
};
getNftEvents();

Query for y00ts sales on MagicEden

const axios = require('axios')
​
const url = `https://api.helius.xyz/v1/nft-events?api-key=<api_key>`
​
const getSales = async () => {
const { data } = await axios.post(url, {
query: {
sources: ["MAGIC_EDEN"],
types: ["NFT_SALE"],
nftCollectionFilters: {
// y00ts collection address
verifiedCollectionAddress: ["4mKSoDDqApmF1DqXvVTSL6tu2zixrSSNjqMxUnwvVzy2"]
}
}
});
console.log("y00ts sales: ", data.result);
};
getSales();

Get all DeGods listings in October 2022

const axios = require('axios')
​
const url = `https://api.helius.xyz/v1/nft-events?api-key=<api_key>`
​
const getListings = async () => {
const { data } = await axios.post(url, {
query: {
types: ["NFT_LISTING"],
startTime: 1664607600, // Beginning of Oct 2022
endTime: 1667285999, // End of Oct 22
nftCollectionFilters: {
// DeGods collection address
verifiedCollectionAddress: ["6XxjKYFbcndh2gDcsUrmZgVEsoDxXMnfsaGY6fpTJzNr"]
}
}
});
console.log("deGods listings: ", data.result);
};
getListings();

Get all NFTs minted by a wallet

const axios = require('axios')
​
const url = `https://api.helius.xyz/v1/nft-events?api-key=<api_key>`
​
const getMintsForWallet = async () => {
const { data } = await axios.post(url, {
query: {
accounts: ["add_wallet"],
types: ["NFT_MINT"]
}
});
console.log("mints: ", data.result);
};
getMintsForWallet();

Suggested Use Cases

NFT Events can help power virtually any functionality related to NFTs. Here are some examples for inspiration:
  • Sales bot
  • Listings bot/sniper
  • A social feed
  • A wallet tracker
  • Transaction history for a wallet
  • NFT portfolio viewer
  • NFT search Engine
  • NFT-specific blockchain explorer
  • NFT floor price alerts
  • NFT analytics

v0/addresses/:address/nft-events (deprecated)

Returns all NFT events given an address.
Oops, something is missing.
We could not find the original source to display this content.
​