{"id":22618768,"url":"https://github.com/samya-s/tokentrackr","last_synced_at":"2026-04-29T04:40:30.720Z","repository":{"id":254001757,"uuid":"843710388","full_name":"Samya-S/TokenTrackr","owner":"Samya-S","description":"A simple crypto portfolio app that simplifies tracking your assets","archived":false,"fork":false,"pushed_at":"2024-09-05T17:51:48.000Z","size":692,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-02-03T11:33:27.935Z","etag":null,"topics":["blockchain","crypto-portfolio-app","crypto-wallet","cryptocurrency","nextjs"],"latest_commit_sha":null,"homepage":"https://tokentrackr-ss.vercel.app","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Samya-S.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-08-17T07:18:35.000Z","updated_at":"2024-09-05T17:51:51.000Z","dependencies_parsed_at":null,"dependency_job_id":"830713a1-5bcf-409d-8dae-2d0c1396667c","html_url":"https://github.com/Samya-S/TokenTrackr","commit_stats":null,"previous_names":["samya-s/tokentrackr"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Samya-S%2FTokenTrackr","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Samya-S%2FTokenTrackr/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Samya-S%2FTokenTrackr/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Samya-S%2FTokenTrackr/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Samya-S","download_url":"https://codeload.github.com/Samya-S/TokenTrackr/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246124898,"owners_count":20727333,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["blockchain","crypto-portfolio-app","crypto-wallet","cryptocurrency","nextjs"],"created_at":"2024-12-08T21:09:31.160Z","updated_at":"2026-04-29T04:40:25.701Z","avatar_url":"https://github.com/Samya-S.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# TokenTrackr\n\n## Overview\nTokenTrackr, a Crypto-Portfolio app, is a single-page application (SPA) that allows users to manage their cryptocurrency tokens. It provides functionalities such as adding tokens to a watch list, viewing current and historical balances, checking token allowances, and performing token transfers. The app integrates with blockchain technology to provide real-time data and interact with smart contracts.\n\n## Features\n\n1. **Wallet Connection**\n   - Users can connect their Metamask wallet or input a wallet address manually.\n\n2. **Watch List**\n   - Users can add tokens to a watch list and view the current balance, price and other details for each token.\n\n3. **Historical Data**\n   - Users can fetch and display the historical balance of any token with a date picker for date range selection.\n\n4. **Allowance**\n   - User can check token allowances for different smart contracts.\n\n5. **Token Allow/Transfer**\n   - User can allow or transfer tokens to another address with fields for recipient address and amount.\n\n6. **Visual Representations**\n   - Utilized tables and charts to display token balances and historical data.\n\n## Technical Stack\n\n- **Frontend**: `React.js` with `Next.js`\n- **Blockchain Interaction**: `Ethers.js` with `Metamask`\n\n## External APIs\n\n- **CoinGecko**: Used to fetch token history in the application. Also provides other cryptocurrency data like market capitalization, and trading volume. For details please refer [CoinGecko API Documentation](https://coingecko.com/en/api)\n\n- **CryptoCompare**: Used to fetch cryptocurrency prices in the application. Also offers data on historical data, and market trends. For details please refer [CryptoCompare API Documentation](https://min-api.cryptocompare.com/documentation)\n\n\n## Important Packages\n\n- **@metamask/sdk-react**: `^0.11.2` - For Metamask integration.\n- **ethers**: `^6.0.0` - For interacting with the Ethereum blockchain.\n- **react-datepicker**: `^7.3.0` - For date selection in historical data.\n- **recharts**: `^2.12.7` - For charts and graphical representations.\n- **react-toastify**: `^10.0.5` - For notifications.\n\n## Setup Instructions\n\n1. **Clone the Repository**\n\n   ```bash\n   git clone https://github.com/Samya-S/TokenTrackr.git\n   cd TokenTrackr\n   ```\n\n2. **Install Dependencies**\n\n    ```bash\n    npm install\n    ```\n\n3. **Environment Variables**\n\n    Create a `.env.local` file in the root directory and add the following environment variables.\n\n    ```bash\n    INFURA_API_KEY=your_infura_api_key\n    ```\n\n4. **Run the Application**\n\n    ```bash\n    npm run dev\n    ```\n\n    Open your browser and go to http://localhost:3000 to view the application.\n\n## Usage\n\n- **Connect Wallet**: Click on the button to connect Metamask or input a wallet address.\n- **Add Tokens**: Use the watch list feature to add and manage tokens.\n- **View Balances**: Check current and historical token balances.\n- **Check Allowance**: Verify token allowances for smart contracts.\n- **Transfer Tokens**: Enter recipient address and amount to transfer tokens.\n\n## Visual Representations\n\nThe app includes various visual elements:\n\n- **Tables**: Display token balances, price and other data.\n- **Charts**: Represent historical data of tokens for dynamic time frame.\n\n## Deployment\n\nThe application is deployed on Netlify (or another hosting service). You can access the live demo here: https://tokentrackr-ss.vercel.app.\n\n## Contributing\n\nContributions are welcome! Please fork the repository and submit a pull request with your changes.\n\n## License\n\nThis project is licensed under the MIT License.\n\n## References\n\n- [Ethers.js Documentation](https://docs.ethers.io/v5/)\n- [Next.js Documentation](https://nextjs.org/docs)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsamya-s%2Ftokentrackr","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsamya-s%2Ftokentrackr","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsamya-s%2Ftokentrackr/lists"}