Aelys Copilot is a next-generation NFT and crypto analytics platform, designed as an AI-powered conversational assistant that delivers personalized portfolio and market intelligence. Leveraging OpenAIโs large language models and bitsCrunch UnleashNFTs APIs (26 total endpoints), Aelys empowers NFT collectors, traders, and enthusiasts with seamless, real-time insights via an intuitive chat interface.
Built for clarity, speed, and depth, Aelys allows users to connect wallets securely and query a rich set of analyticsโfrom wallet-level risk to macro NFT market trendsโall powered by advanced AI reasoning and comprehensive blockchain data.
Created for: bitsCrunch x AI Builders Hack 2025
Developer: Nikhil Raikwar
GitHub / Source: Nikhil Raikwar
-
Personal NFT & Crypto Portfolio Assistant: Understand, track, and analyze your Web3 portfolio, DeFi holdings, and NFT assets.
-
Wallet & Risk Analysis: Instant breakdowns of token balances, NFT value, wallet reputation, and activity trends.
-
Risk and Fraud Detection
Detects suspicious wallet behavior, wash trading, and signals potential threats through detailed analytics. -
Conversational Analytics
Simply ask any question about your portfolio to get live data, natural explanations, and even risk warningsโall in a private, chat-based flow.
Key UnleashNFTs APIs Used:
/wallet/balance/defiโ DeFi portfolio breakdown/wallet/balance/nftโ NFT portfolio overview/wallet/balance/tokenโ ERC20/token holdings/wallet/labelโ Wallet label & status/wallet/scoreโ Wallet risk/reputation scoring/wallet/metricsโ Metrics, activity, and P&L/nft/wallet/analyticsโ NFT-specific wallet analytics/nft/wallet/washtradeโ Wallet-level fraud detection/nft/wallet/profileโ Detailed wallet profile/nft/wallet/scoresโ NFT wallet scoring metrics/nft/wallet/tradersโ Wallet trading analytics/nfts: Fetch NFT data for a specific wallet./wallet/analytics: Fetch wallet analytics including portfolio value and collection breakdown./collections/stats: Fetch market data for specific NFT collections./nft/collection/whales: Get insights into whale metrics for NFT collections./nft/floor-price: Get floor price data for NFT collections./nft/analytics: Get detailed analytics for NFT collections./nft/listings: Get current listings for NFT collections./wallet/token-balance: Get token balance for a wallet address./marketplace/metadata: Get metadata for marketplaces./marketplace/analytics: Get analytics data for marketplaces.
-
Market Trend Explorer: Get comprehensive trend charts, volume metrics, and aggregated market health.
-
Traders, Holders, Washtrading Reports: Analyze live metrics for active traders, whales, holders, and market manipulation/wash trading.
-
Easy, Visual Answers: When you ask about trends, see Area Charts and time-series analytics rendered instantly in the chat.
Key UnleashNFTs APIs Used:
/nft/market-insights/analyticsโ Market-wide NFT analytics (volume, sales, transactions)/nft/market-insights/holdersโ NFT holdersโ aggregation and trends/nft/market-insights/scoresโ Market-level score trends/nft/market-insights/tradersโ Trader activity analytics/nft/market-insights/washtradeโ Wash trade metrics over time
- Both copilots are powered by OpenAI LLMs for smart query understanding, answer generation, and education/explanation of NFT and crypto concepts.
- Intelligent routing dynamically queries bitsCrunch APIs based on user intent and parameters.
- Handles missing information gracefully, prompting users for clarifications when needed.
- Supports multilingual and context-aware dialogue to serve a diverse user base.
- Landing Page: Built with Framer โ sleek, interactive front door to the platform.
- Frontend: Next.js, React, and Tailwind CSS, creating a fast, responsive UI.
- Backend & AI: Next.js API routes integrating OpenAIโs GPT-4 for AI processing.
- Blockchain Data: Comprehensive NFT and wallet data from bitsCrunchโs UnleashNFTs APIs.
- UI Components: shadcn/ui & Magic UI for polished, accessible components.
- Visuals: Spline 3D animation adds engaging branding flair.
- ๐ "What is an NFT and how does it work?"
- ๐ "How do I secure my crypto wallet?"
- ๐ก "Explain what DeFi means in simple terms"
- ๐ "What is wash trading and how is it detected?"
- ๐ผ "Show me my complete portfolio breakdown"
โ ๏ธ "What's my wallet risk score and any suspicious activity?"- ๐ "Get wallet metrics for 0x742d3..."
- ๐ท๏ธ "What labels and tags are associated with this wallet?"
- ๐ฏ "Show me NFT wallet scores and trading patterns"
- ๐ "Analyze wallet for wash trading behavior"
- ๐ "Show NFT market volume trends for Ethereum"
- ๐ "What's the current wash trading activity on Polygon?"
- ๐ฅ "Display recent trader analytics and buyer/seller ratios"
- ๐ฐ "What's the floor price of Pudgy Penguins?"
- ๐ "Show me the top whale holders for BAYC collection"
- ๐ช "Compare marketplace performance: OpenSea vs Blur"
- ๐ "Get collection metadata for trending NFTs"
- ๐ธ "Floor price trends for top 10 NFT collections"
- ๐ "Show analytics for CryptoPunks collection"
- ๐ท๏ธ "Get current NFT listings on Ethereum"
- ๐ฅ "Which collections have the most trading activity today?"
- ๐จ "Detect wash trading across top marketplaces"
โ ๏ธ "Risk assessment for wallet 0x..."- ๐ต๏ธ "Show suspicious trading patterns in the market"
- ๐ "Analyze wallet for potential fraud indicators"
Aelys Copilot integrates with 26 bitsCrunch UnleashNFTs API endpoints to provide comprehensive Web3 analytics. Here's the complete list organized by functionality:
/wallet/balance/defiโ DeFi portfolio breakdown and protocol positions/wallet/balance/nftโ NFT portfolio overview with collection details/wallet/balance/tokenโ ERC20/token holdings and balances/token/balanceโ Token balance aggregation across chains
/wallet/labelโ Wallet labels, tags, and classification/wallet/scoreโ Wallet risk and reputation scoring/wallet/metricsโ Comprehensive wallet metrics, activity, and P&L
/nft/wallet/profileโ Detailed NFT wallet profile and history/nft/wallet/analyticsโ NFT-specific wallet analytics and trends/nft/wallet/scoresโ NFT wallet scoring and ranking metrics/nft/wallet/tradersโ Wallet trading patterns and behaviors/nft/wallet/washtradeโ Wallet-level fraud and wash trading detection
/nft/market-insights/analyticsโ Market-wide NFT analytics (volume, sales, transactions)/nft/market-insights/holdersโ NFT holders aggregation and distribution trends/nft/market-insights/scoresโ Market-level scoring trends and metrics/nft/market-insights/tradersโ Active trader analytics and market participation/nft/market-insights/washtradeโ Market-wide wash trading detection and metrics
/nft/floor_priceโ Real-time NFT floor prices across collections/nft/analyticsโ Comprehensive NFT collection analytics/nft/listingโ NFT listing data and marketplace activity/nft/collection/whalesโ Collection whale holders and major stakeholders/nft/collection/metadataโ Collection metadata, stats, and information
/nft/marketplace/metadataโ Marketplace information and details/nft/marketplace/analyticsโ Marketplace performance metrics and trends/nft/marketplace/washtradeโ Marketplace-specific wash trading analysis
Current API Status: 96% Success Rate (25/26 endpoints operational)
โ
Working Endpoints: All critical endpoints including floor prices, market analytics, and wallet data
๐ Last Tested: August 2025
- โ NFT Floor Price โ Core pricing data (Working)
- โ Market Analytics โ Market trend analysis (Working)
- โ Wallet Balances โ Portfolio tracking (Working)
- โ Fraud Detection โ Risk assessment (Working)
-
๐ค Unified General + Data Intelligence: Handles both real-time live analytics and all your NFT/crypto general questions in one chat.
-
๐ฎ Instant Visuals: See your data as trendlines, risk cards, or summary chartsโno dashboards required.
-
๐ก๏ธ Security by Design: All portfolio analysis is private; only you see your wallet data and risk scores.
-
๐ง OpenAI ร bitsCrunch: The best of generative AI and market analytics, merged for next-gen user experience.
Built for bitsCrunch x AI Builders Hack 2025
Developer: Nikhil Raikwar
This project is licensed under the MIT License - see the LICENSE.
Thank you for exploring Aelys Copilotโyour next-gen AI partner for NFTs and Web3 analytics.
Feel free to reach out for collaboration, feature requests, or feedback!
