Skip to content

Aelys Copilot: AI-powered NFT portfolio and market analytics chatbot combining OpenAI's LLM with bitsCrunch blockchain data for real-time, personalized Web3 insights.

License

Notifications You must be signed in to change notification settings

NikhilRaikwar/Aelys

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

65 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

imagess

Aelys Copilot | Powered by bitsCrunch APIs

Revolutionizing NFT analytics with AI-driven intelligence and real-time Web3 insights


๐Ÿ“– Project Overview

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.


๐Ÿ—๏ธ Project Details

Created for: bitsCrunch x AI Builders Hack 2025
Developer: Nikhil Raikwar
GitHub / Source: Nikhil Raikwar


โœจ Features

๐Ÿš€ Aelys Copilot โ€“ NFT Portfolio Intelligence

  • 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 Alpha Copilot โ€“ NFT Market Insight

  • 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

๐Ÿค– Unified AI Agents

  • 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.

๐Ÿ› ๏ธ Technology Stack

  • 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.

๐Ÿ’ฌ Example Queries to Try

๐Ÿ“š Educational Queries

  • ๐ŸŽ“ "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?"

๐Ÿš€ Aelys Copilot (Wallet & Portfolio)

  • ๐Ÿ’ผ "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"

๐Ÿ“Š Market Alpha Copilot (Market Analytics)

  • ๐Ÿ“ˆ "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"

๐Ÿ’Ž NFT Collection Queries

  • ๐Ÿ’ธ "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?"

๐Ÿ›ก๏ธ Risk & Fraud Detection

  • ๐Ÿšจ "Detect wash trading across top marketplaces"
  • โš ๏ธ "Risk assessment for wallet 0x..."
  • ๐Ÿ•ต๏ธ "Show suspicious trading patterns in the market"
  • ๐Ÿ” "Analyze wallet for potential fraud indicators"

๐Ÿ”Œ Complete API Endpoints Reference

Aelys Copilot integrates with 26 bitsCrunch UnleashNFTs API endpoints to provide comprehensive Web3 analytics. Here's the complete list organized by functionality:

๐Ÿ’ฐ Wallet Balance & Holdings

  • /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 Identity & Reputation

  • /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 Analytics

  • /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

๐Ÿ“Š Market Intelligence & Insights

  • /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 Collection & Floor Prices

  • /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

๐Ÿช Marketplace Analytics

  • /nft/marketplace/metadata โ€” Marketplace information and details
  • /nft/marketplace/analytics โ€” Marketplace performance metrics and trends
  • /nft/marketplace/washtrade โ€” Marketplace-specific wash trading analysis

๐Ÿ“ˆ API Health Status

Current API Status: 96% Success Rate (25/26 endpoints operational)

โœ… Working Endpoints: All critical endpoints including floor prices, market analytics, and wallet data
โš ๏ธ Known Issues: NFT Listings endpoint experiencing timeout issues
๐Ÿ”„ Last Tested: August 2025

๐ŸŽฏ Priority Endpoints for Core Features

  • โœ… NFT Floor Price โ€” Core pricing data (Working)
  • โœ… Market Analytics โ€” Market trend analysis (Working)
  • โœ… Wallet Balances โ€” Portfolio tracking (Working)
  • โœ… Fraud Detection โ€” Risk assessment (Working)

๐ŸŒŸ Why Aelys Copilot Stands Out

  • ๐Ÿค 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.


๐Ÿ‘จโ€๐Ÿ’ป Project Credits

Built for bitsCrunch x AI Builders Hack 2025
Developer: Nikhil Raikwar


๐Ÿ“„ License

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!

About

Aelys Copilot: AI-powered NFT portfolio and market analytics chatbot combining OpenAI's LLM with bitsCrunch blockchain data for real-time, personalized Web3 insights.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published