Get Zoo Genes

Get ZooGenes NFTs for a user

Retrieves ZooGenes NFTs owned by a specified username.

Endpoint: /nft/{chainName}/zoogenes/{username} Method: GET

Request Parameters

{
	username: string; // The username to query
	chainName: string; // Chain name (avalanche or fuji)
}

Success Response

[
  {
    id: string;            // Zoo Gene ID
    name: string;          // Zoo Gene name
    description: string;   // Zoo Gene description
    image: string;         // Zoo Gene image URL
    generation: number;    // Zoo Gene generation
    attributes: Array<{    // Zoo Gene attributes
      trait_type: string;
      value: string | number;
    }>;
    owner: string;         // Owner address
    tokenId: string;       // Token ID
    contract: string;      // Contract address
  }
]

Error Response

{
  error: string;
  details?: any;
}

Example Usage

// Setup request parameters
const timestamp = Date.now().toString();
const username = 'player123';
const chainName = 'avalanche'; // or 'fuji' for testnet

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

// Make the API request
const response = await axios.get(apiEndpoint + `/nft/${chainName}/zoogenes/${username}`, {
	headers: {
		apikey: apiKey,
		signature: hmac,
		timestamp: timestamp
	}
});

// Process the response
console.log(`Found ${response.data.length} ZooGenes NFTs`);
response.data.forEach((zooGene) => {
	console.log(`ID: ${zooGene.id}`);
	console.log(`Name: ${zooGene.name}`);
	console.log(`Generation: ${zooGene.generation}`);
	console.log(`Image: ${zooGene.image}`);
	console.log(`Token ID: ${zooGene.tokenId}`);
	console.log('---');
});