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.
​

Solana APIs - Previous

NFT API

NFT Collection Mintlists

Last modified 1mo ago