{"id":35225752,"url":"https://github.com/major/vl-tv-bridge","last_synced_at":"2026-01-25T21:59:11.339Z","repository":{"id":328853645,"uuid":"1111865765","full_name":"major/vl-tv-bridge","owner":"major","description":null,"archived":false,"fork":false,"pushed_at":"2025-12-31T23:34:08.000Z","size":439,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-01-02T04:42:43.487Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/major.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":null,"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,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-12-07T19:23:06.000Z","updated_at":"2025-12-31T23:34:10.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/major/vl-tv-bridge","commit_stats":null,"previous_names":["major/vl-tv-bridge"],"tags_count":11,"template":false,"template_full_name":null,"purl":"pkg:github/major/vl-tv-bridge","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/major%2Fvl-tv-bridge","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/major%2Fvl-tv-bridge/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/major%2Fvl-tv-bridge/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/major%2Fvl-tv-bridge/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/major","download_url":"https://codeload.github.com/major/vl-tv-bridge/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/major%2Fvl-tv-bridge/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28399896,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-13T14:36:09.778Z","status":"ssl_error","status_checked_at":"2026-01-13T14:35:19.697Z","response_time":56,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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":[],"created_at":"2025-12-30T01:05:13.530Z","updated_at":"2026-01-13T20:34:24.260Z","avatar_url":"https://github.com/major.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# VL TradingView Bridge\n\nA Firefox extension that automatically draws [VolumeLeaders](https://www.volumeleaders.com/) trade levels on your [TradingView](https://www.tradingview.com/) charts.\n\n## What Does It Do?\n\nThis extension bridges VolumeLeaders and TradingView, allowing you to:\n\n- **Automatically fetch** top trade levels from VolumeLeaders for any stock\n- **Visualize levels** as horizontal lines directly on TradingView charts\n- **Cache levels** for offline viewing and quick access\n- **One-click workflow** - just click \"Fetch \u0026 Draw VL Levels\"\n\nNo more manually copying price levels between platforms!\n\n## Features\n\n- **Automatic Symbol Detection** - Detects which stock you're viewing on TradingView\n- **One-Click Drawing** - Fetches and draws all levels with a single click\n- **Smart Caching** - Stores previously fetched levels for offline access\n- **Color-Coded Labels** - Each level shows rank, dollar volume, and date range\n- **Manual Entry** - Add custom levels for analysis\n- **Easy Cleanup** - Clear all drawn levels with one click\n- **Debug Mode** - Troubleshoot issues with detailed logging\n\n## Requirements\n\n- **Firefox** (version 48.0 or later)\n- **VolumeLeaders Account** - You must be logged into volumeleaders.com\n- **TradingView Account** - Free or paid account works\n\n## Installation\n\n### Option 1: Install from Firefox Add-ons (Recommended)\n\n*Coming soon - extension is currently in unlisted mode*\n\n### Option 2: Install Signed XPI\n\n1. Download the latest signed `.xpi` file from the [Releases](https://github.com/major/vl-tv-bridge/releases) page\n2. Open Firefox\n3. Drag the `.xpi` file into Firefox window\n4. Click \"Add\" when prompted to install\n\n### Option 3: Temporary Installation (Development)\n\n1. Download or clone this repository\n2. Open Firefox and navigate to `about:debugging#/runtime/this-firefox`\n3. Click \"Load Temporary Add-on\"\n4. Navigate to the `firefox/` folder and select `manifest.json`\n\n**Note:** Temporary installations are removed when Firefox closes.\n\n## Usage\n\n### First Time Setup\n\n1. **Authenticate with VolumeLeaders**\n   - Open a new tab and log into [volumeleaders.com](https://www.volumeleaders.com/)\n   - Keep the browser session active (don't log out)\n\n2. **Open TradingView**\n   - Navigate to [tradingview.com](https://www.tradingview.com/)\n   - Open any chart (e.g., AAPL, TSLA, SPY)\n\n### Fetching and Drawing Levels\n\n1. **Click the Extension Icon**\n   - The VL-TV Bridge icon appears in your Firefox toolbar\n   - The popup shows authentication status and current symbol\n\n2. **Verify the Detected Symbol**\n   - The extension automatically detects the chart symbol\n   - Confirm it shows the correct ticker (e.g., \"AAPL\")\n\n3. **Click \"Fetch \u0026 Draw VL Levels\"**\n   - The extension fetches the top 5 trade levels from VolumeLeaders\n   - Horizontal lines appear on your chart automatically\n   - Each line shows:\n     - VL rank (#1, #2, etc.)\n     - Dollar volume (e.g., $1.6B)\n     - Date range when the level was active\n\n4. **View Cached Levels**\n   - Previously fetched levels are stored locally\n   - Click \"Show/Hide Cached Levels\" to view all cached symbols\n   - Click any cached symbol to draw its levels\n\n### Managing Levels\n\n**Clear Drawn Levels**\n- Click \"Clear Drawn Levels\" to remove all VL lines from the chart\n- This doesn't delete cached data, just clears the visualization\n\n**Add Manual Level**\n- Enter a price in the \"Manual Price\" field\n- Click \"Add Manual Level\" to draw a custom line\n- Useful for adding your own support/resistance levels\n\n**Clear Cache**\n- Click \"Clear Cache\" to delete all stored levels\n- This removes all cached data (cannot be undone)\n\n**Debug Mode**\n- Enable debug mode for detailed console logging\n- Useful for troubleshooting issues\n\n## Understanding the Levels\n\nEach VL trade level represents a price where significant institutional trading occurred:\n\n- **VL #1** - Highest dollar volume trade level (most significant)\n- **VL #2-5** - Decreasing significance\n- **Dollar Volume** - Total money transacted at that level\n- **Date Range** - When the level was active (up to 5 years of history)\n\nThe extension fetches levels with:\n- Minimum $10M dollar volume\n- Top 5 ranked levels\n- Up to 5 years of historical data\n\n## Troubleshooting\n\n### \"Not authenticated with VolumeLeaders\"\n\n**Solution:**\n1. Open a new tab and go to [volumeleaders.com](https://www.volumeleaders.com/)\n2. Log in with your credentials\n3. Return to TradingView and try again\n\n### \"Could not detect symbol\"\n\n**Solution:**\n1. Make sure you're on a TradingView chart page (not homepage)\n2. Try refreshing the page\n3. Click directly on the chart to ensure it's active\n\n### Levels not drawing on chart\n\n**Solution:**\n1. Enable debug mode in the extension popup\n2. Open browser console (F12 → Console tab)\n3. Look for error messages starting with `[VL-TV]`\n4. Try refreshing the TradingView page\n5. Ensure you're on the main chart view (not symbol overview)\n\n### \"Failed to fetch levels\"\n\n**Solution:**\n1. Check your VolumeLeaders authentication (see above)\n2. Verify the symbol exists on VolumeLeaders\n3. Check your internet connection\n4. Look at debug console for specific error messages\n\n### Cached levels showing wrong symbol\n\n**Solution:**\n1. Clear the cache using \"Clear Cache\" button\n2. Re-fetch levels for the correct symbol\n\n## Privacy \u0026 Permissions\n\nThis extension requires the following permissions:\n\n- **webRequest \u0026 webRequestBlocking** - To intercept VolumeLeaders API calls and extract trade levels\n- **storage** - To cache trade levels locally in your browser\n- **cookies** - To verify you're logged into VolumeLeaders\n- **Access to all websites** - To work on TradingView and VolumeLeaders domains\n\n**Your data:**\n- Trade levels are cached locally in your browser only\n- No data is sent to external servers (except the original VolumeLeaders API)\n- Your VolumeLeaders credentials are never accessed or stored by this extension\n\n## Support\n\n- **Issues** - Report bugs at [GitHub Issues](https://github.com/major/vl-tv-bridge/issues)\n- **Documentation** - See [CONTRIBUTING.md](CONTRIBUTING.md) for technical details\n\n## License\n\nMIT License - See [LICENSE](LICENSE) file for details\n\n## Credits\n\nCreated by [major](https://github.com/major)\n\nThis extension is not affiliated with or endorsed by VolumeLeaders or TradingView.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmajor%2Fvl-tv-bridge","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmajor%2Fvl-tv-bridge","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmajor%2Fvl-tv-bridge/lists"}