Get the listing status of a single NFT.

Returns the listing status of a single NFT for a given NFT ID.

await api.query.getNftListingStatus(nftId);

tip

If you're checking the ID for a newly minted NFT, allow time for consensus to be achieved on the minted NFT.

You can get the AVN_GATEWAY_URL here.

Possible Results

• Not listed
• Fiat
• Ethereum

Example

const { AvnApi, SetupMode, SigningMode } = require("avn-api");
const AVN_GATEWAY_URL = "https://gateway.testnet.aventus.network";

const singleUserOptions = {
	suri: "0x5392ca60a61aea99fce14358798de93c1bc11c3696a905718738c71fae539c24", // this is from the generated example account
	setupMode: SetupMode.SingleUser,
	signingMode: SigningMode.SuriBased,
};

const avnSdk = new AvnApi(AVN_GATEWAY_URL, singleUserOptions);

//replace with the external ref set when minting the NFT.
const NFT_ID = "0xa6a...ae539";

async function main() {
	await avnSdk.init();
	const api = await avnSdk.apis();

	let request_id = await api.query.getNftListingStatus(NFT_ID);
	console.log(request_id);
}

(async () => {
	await main();
})();

Example Result

Not listed

JSON-RPC

REQUEST
POST https://AVN_GATEWAY_URL/query

HEADERS
Content-Type: application/json Authorization': bearer <awtToken>

REQUEST PARAMS

• NFT_ID [required] - a unique string representing the single NFT's ID.

JSON-RPC Example

curl https://AVN_GATEWAY_URL/query \
    -X POST \
    -H "Content-Type: application/json" \
    -H "Authorization: bearer <awtToken>" \
    -d '{"jsonrpc":"2.0", "method":"getNftListingStatus", "params":{"NFT_ID":"0xa6a...ae539"}, "id":1}'

note

result - a string value representing the single NFT's listing status'.

JSON-RPC Output

{
	"jsonrpc": "2.0",
	"id": 1,
	"result": "Not listed"
}

---

Production Example

Multiple NFTs have been minted on the AVN and HERE is a link to the AVN Explorer that provides more detail on the minted NFT. Click on the Advanced tab on the page to view more details on the transaction.