Aavegotchi Traits

Retrieve Aavegotchi NFT data by gotchi ID or name on Base. Returns traits, wearables, rarity scores, kinship, XP, level, and owner data.

Fetch Aavegotchi data on Base by ID or name.

Usage

cd scripts
node get-gotchi.js 9638
node get-gotchi.js aaigotchi
./gotchi-info.sh 9638

What it returns

• Token ID, name, owner, haunt
• BRS / modified BRS
• Kinship, XP, level
• Base + modified traits
• Equipped wearables with names
• Collateral, staked amount, last interaction
• JSON output for automation

Environment

• AAVEGOTCHI_RPC_URL (optional)
• AAVEGOTCHI_SUBGRAPH_URL (optional; default Goldsky Base subgraph)
• AAVEGOTCHI_SEARCH_BATCH_SIZE (optional)
• AAVEGOTCHI_RPC_RETRIES (optional)
• AAVEGOTCHI_RPC_RETRY_DELAY_MS (optional)

Reliability

• Name lookup uses subgraph first for speed.
• If subgraph fails, script scans on-chain with RPC retry/backoff to handle rate limits.