Get NFT Info

Get information about NFTs

Retrieves information about NFT contracts, with optional filtering by contract address, chain ID, and game ID.

Endpoint: /game/nft/info Method: GET

Request Parameters

{
    nft?: string;          // Optional NFT contract address to filter by
    chainId?: string;      // Optional chain ID
    gameId?: string;       // Optional game ID
}

Success Response

{
  nfts: [
    {
      address: string;      // NFT contract address
      name: string;         // NFT contract name
      symbol: string;       // NFT contract symbol
      chainId: string;      // Chain ID where the NFT exists
      gameId?: string;      // Optional associated game ID
      image?: string;       // Optional URL to the collection image
    }
  ]
}

Error Response

{
  error: string;
  details?: any;
}

Example Usage

// Setup request parameters
const timestamp = Date.now().toString();
const nftAddress = '0x1234567890123456789012345678901234567890'; // Optional
const chainId = '43114'; // Optional, Avalanche C-Chain
const gameId = 'game456'; // Optional

// For GET requests with no body, pass null as the body for HMAC
const hmac = generateHmacSignature(timestamp, null, secretKey);

// Make the API request with optional filters
let url = apiEndpoint + `/game/nft/info?chainId=${chainId}&nft=${nftAddress}&gameId=${gameId}`;

const response = await axios.get(url, {
	headers: {
		apikey: apiKey,
		signature: hmac,
		timestamp: timestamp
	}
});

// Process the response
console.log(`Found ${response.data.nfts.length} NFT contracts`);
response.data.nfts.forEach((nft) => {
	console.log(`NFT Address: ${nft.address}`);
	console.log(`Name: ${nft.name}`);
	console.log(`Symbol: ${nft.symbol}`);
	console.log(`Chain ID: ${nft.chainId}`);
	if (nft.gameId) console.log(`Game ID: ${nft.gameId}`);
	if (nft.image) console.log(`Image URL: ${nft.image}`);
	console.log('---');
});