🍭 SugarSugar API

An easy to host, easy to use webservice to get and display your Dexcom CGM blood glucose data

---

•  • •• Live Demo •• •  •

---

📊 API Endpoints

Endpoint	Description
GET /glucose	Latest glucose reading in a simple format
GET /graph	List of all glucose readings for the last 2 hours (default)
GET /graph?hours=12	Get up to an entire day of glucose readings by adding the query parameter hours (0.1 - 24.0)
GET /health	Service health check and status

---

📦 Native Web Component

circle-trendicator.js

Easily display glucose trends on your own web app with this responsive CGM trendicator

📱 Amazon Echo Viewer

alexa.html

⌗ API Response Data

/glucose   returns your latest blood sugar reading

{
  "time": "2025-08-20T00:13:29.000Z",
  "value": 146,
  "previous_value": 163,
  "value_difference": -17,
  "trend": {
    "id": "FortyFiveDown",
    "symbol": "↘",
    "name": "Falling Slowly",
    "trendRate": -1
  },
  "status": "IN RANGE",
  "minutes_ago": 3,
  "last_reading": "last checked 3 minutes ago"
}

/graph   returns a list of readings for the last 2 hours

{
  "count": 8,
  "hours": 2,
  "readings": [
    {
      "time": "2025-08-20T01:13:28.000Z",
      "value": 143,
      "trend": {
        "id": "NotComputable",
        "symbol": "?",
        "name": "Not Computable",
        "trendRate": 0
      }
    },
    {
      "time": "2025-08-20T00:13:29.000Z",
      "value": 163,
      "trend": {
        "id": "NotComputable",
        "symbol": "?",
        "name": "Not Computable",
        "trendRate": 0
      }
    },
    {
      "time": "2025-08-19T23:53:28.000Z",
      "value": 146,
      "trend": {
        "id": "DoubleDown",
        "symbol": "⇊",
        "name": "Falling Rapidly",
        "trendRate": -3
      }
    },
    {
      "time": "2025-08-19T23:48:28.000Z",
      "value": 220,
      "trend": {
        "id": "FortyFiveDown",
        "symbol": "↘",
        "name": "Falling Slowly",
        "trendRate": -1
      }
    },
    {
      "time": "2025-08-19T23:43:28.000Z",
      "value": 203,
      "trend": {
        "id": "NotComputable",
        "symbol": "?",
        "name": "Not Computable",
        "trendRate": 0
      }
    },
    {
      "time": "2025-08-19T23:38:28.000Z",
      "value": 241,
      "trend": {
        "id": "NotComputable",
        "symbol": "?",
        "name": "Not Computable",
        "trendRate": 0
      }
    },
    {
      "time": "2025-08-19T23:33:29.000Z",
      "value": 235,
      "trend": {
        "id": "NotComputable",
        "symbol": "?",
        "name": "Not Computable",
        "trendRate": 0
      }
    },
    {
      "time": "2025-08-19T23:28:29.000Z",
      "value": 252,
      "trend": {
        "id": "NotComputable",
        "symbol": "?",
        "name": "Not Computable",
        "trendRate": 0
      }
    }
  ]
}

/health   returns the status of the web service

{
  "status": "ok",
  "timestamp": "2025-08-20T01:14:41.234Z",
  "service": "SugarSugar Dexcom API"
}

---

🚀 Quick Start

git clone https://github.com/run-time/sugarsugar.git
cd sugarsugar
npm install
npm run setup
# add your Dexcom share credentials to .env.vercel (message me if you need help finding these)
npm start

---

🛠 Scripts

• npm start – Start local development server
• npm run dev – Start with file watching
• npm test – Run tests
• npm run build – Build for production
• npm run vercel-build – Vercel build command
• npm run lint – Check code style
• npm run format – Check formatting
• npm run verify - Run this before making a PR

---

📚 Documentation

TODO: Looking for helpers to add complete documentation on the GitHub repository for how to run your own SugarSugar webservice and connect your own Amazon Echo devices to it for free using vercel.

---

❤️ Author

Hello, I'm Dave Alger 👋

Many years ago I stumbled upon Sugarmate and got it linked with my Amazon Echo device to tell me my latest glucose reading. I messaged the creator of Sugarmate a few times and he made it so I could get my glucose data from a webservice URL.

I used this data to do things like change the light bulb colors in my room to yellow when too high or red when too low, and add my current reading to the touchbar on the MacBook so it was always visible while coding. 🎉

Needless to say, I was sad when that service was taken down a few years ago. 😢

I missed it so much that I decided to build my own webservice and my own Amazon skill. That's how SugarSugar was born — an open-source way of running and hosting everything so it is accessible to all my devices. I put all my code in this repo for other diabetic developers to use in their own ways.

I am in-range and happy now. 😊

---

⚠️ Disclaimer

This project is not affiliated with Dexcom, Inc. Use of the Dexcom Share API is subject to Dexcom's terms of service.