{"id":26678226,"url":"https://github.com/telexintegrations/crypto-price-tracker","last_synced_at":"2025-03-26T05:15:15.614Z","repository":{"id":279051758,"uuid":"937579806","full_name":"telexintegrations/crypto-price-tracker","owner":"telexintegrations","description":null,"archived":false,"fork":false,"pushed_at":"2025-02-23T12:34:44.000Z","size":29,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-02-23T13:33:07.481Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://crypto-price-tracker-eight.vercel.app","language":"JavaScript","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/telexintegrations.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":"2025-02-23T12:15:42.000Z","updated_at":"2025-02-23T12:34:51.000Z","dependencies_parsed_at":"2025-02-23T13:33:08.970Z","dependency_job_id":null,"html_url":"https://github.com/telexintegrations/crypto-price-tracker","commit_stats":null,"previous_names":["telexintegrations/crypto-price-tracker"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/telexintegrations%2Fcrypto-price-tracker","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/telexintegrations%2Fcrypto-price-tracker/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/telexintegrations%2Fcrypto-price-tracker/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/telexintegrations%2Fcrypto-price-tracker/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/telexintegrations","download_url":"https://codeload.github.com/telexintegrations/crypto-price-tracker/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":245591533,"owners_count":20640692,"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":[],"created_at":"2025-03-26T05:15:14.509Z","updated_at":"2025-03-26T05:15:15.587Z","avatar_url":"https://github.com/telexintegrations.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Telex Crypto Price Tracker\n\n## 📌 Overview\nThe **Telex Crypto Price Tracker** is a Telex Interval Integration that automatically posts real-time cryptocurrency price updates to a Telex channel at regular intervals. It fetches crypto prices from the **CoinGecko API** and sends updates to a Telex webhook.\n\nThis integration is useful for **crypto traders, enthusiasts, and communities** who want to stay updated on market movements without manually checking prices.\n\n---\n\n## 🚀 Features\n- Tracks the **real-time prices** of Bitcoin (BTC), Ethereum (ETH), and Solana (SOL).\n- Includes **24-hour percentage change** for each tracked cryptocurrency.\n- Sends **formatted messages** to the Telex platform via /tick enpoint return_url.\n- Provides a **REST API** for fetching integration details and triggering updates.\n- Designed for **automated interval execution**.\n\n---\n\n## ⚙️ Tech Stack\n- **Backend:** Node.js, Express.js\n- **External API:** CoinGecko API\n- **Deployment:** Vercel\n- **Package Manager:** npm\n\n---\n\n## 📂 Project Structure\n```sh\n📁 telex-crypto-price-tracker\n├── 📄 src                  # Main Express server\n    ├── 📄 app.js \n    ├── 📄 telex-func.js               # Crypto fetching and webhook handler\n    ├── 📄 telex-integration.js      # Integration metadata\n    ├── 📄 .env                        # Environment variables\n    ├── 📄 package.json                # Dependencies and scripts\n    ├── 📄 .gitignore                  # Dependencies and scripts\n├── 📄 vercel.json                     # Vercel configuration\n└── 📄 README.md                   # Project documentation\n```\n\n---\n\n## 🚀 Getting Started\n\n### 1️⃣ Clone the Repository\n```sh\ngit clone https://github.com/your-repo/telex-crypto-price-tracker.git\ncd telex-crypto-price-tracker/src\n```\n\n### 2️⃣ Install Dependencies\n```sh\nnpm install\n```\n\n### 3️⃣ Set Up Environment Variables\nCreate a `.env` file in the project root and add:\n```sh\nCOIN_GECKO_API_KEY=\u003cYour_CoinGecko_API_Key\u003e\n```\n\n### 4️⃣ Run the Server\n```sh\nnode app.js\n```\nThe server will start on `http://localhost:3300`\n\n---\n\n## 🛠 API Endpoints\n\n### 🔹 Fetch Integration Details\n**GET** `/integration.json`\n#### **Response:**\n```json\n{\n  \"data\": {\n    \"app_name\": \"Telex Crypto App\",\n    \"app_description\": \"Automatically posts real-time cryptocurrency price updates\",\n    \"key_features\": [\n      \"Tracks BTC, ETH, SOL prices\",\n      \"Includes 24-hour price changes\",\n      \"Sends updates to Telex platform\"\n    ],\n    \"author\": \"James Kehinde\",\n    \"version\": \"1.0.0\",\n    \"tick_url\": \"https://telex-crypto-price-tracker.vercel.app/tick\"\n  }\n}\n```\n\n### 🔹 Trigger Crypto Price Update\n**POST** `/tick`\n#### **Request Body:**\n```json\n{\n  \"channel_id\": \"12345\",\n  \"return_url\": \"https://your-telex-webhook.com\",\n  \"settings\": {}\n}\n```\n#### **Response:**\n```json\n{\n  \"status\": \"success\",\n  \"message\": \"Crypto price update sent to Telex\"\n}\n```\n\n---\n\n## 🛠 Deployment\n### **1️⃣ Deploying to Vercel**\nThis project is set up with GitHub Actions to automatically deploy to **Vercel** when new changes are pushed to `main`.\n\nIf deploying manually:\n```sh\nnpm install -g vercel\nvercel --prod\n```\n\n---\n\n## 👨‍💻 Contributing\n1. Fork the repository\n2. Create a new branch (`git checkout -b feature-branch`)\n3. Make your changes and commit (`git commit -m \"Added new feature\"`)\n4. Push to the branch (`git push origin feature-branch`)\n5. Open a **Pull Request**\n\n---\n\n## 📝 License\nThis project is licensed under the **MIT License**.\n\n---\n\n## 📬 Contact\n📧 **Email:** jameskehinde101@gmail.com  \n🔗 **GitHub:** [github.com/Jhamis-hack](https://github.com/Jhamis-hack)  \n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftelexintegrations%2Fcrypto-price-tracker","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftelexintegrations%2Fcrypto-price-tracker","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftelexintegrations%2Fcrypto-price-tracker/lists"}