StockPulse is a palm-sized, always-on financial companion that keeps investors connected to market movements without the distractions of smartphones or computers. This elegant device displays real-time stock prices and key metrics at a glance, helping you stay informed about your portfolio throughout the trading day.
Why StockPulse?In today's fast-paced financial markets, staying informed is crucial - but constant phone checking can be distracting and disruptive. StockPulse solves this problem by providing essential market data in a dedicated, glanceable format that fits seamlessly into your workspace or home.
Features- Real-time Market Data: Live stock prices pulled directly from the Tiingo financial API
- Multi-ticker Rotation: Automatically cycles through your selected stocks
- Comprehensive Metrics: Displays current price, daily change, volume, and high/low metrics
- Intuitive Color Coding: Green for gains, red for losses - instantly communicate market direction
- Sleek Circular Display: Beautiful 240x240 round LCD shows data clearly and elegantly
- No Subscriptions: One-time hardware cost with free-tier API access
- Energy Efficient: Designed for all-day use with minimal power consumption
- Customizable: Easily configure your personal watchlist of stocks
Components Required
- Seeed Studio XIAO ESP32S3 Sense
- Seeed Studio Round Display for XIAO (1.28" 240x240 GC9A01 LCD)
- USB-C cable for power
- Optional: 3D printed case (files included in project)
The XIAO ESP32S3 Sense offers an excellent balance of processing power, connectivity, and energy efficiency in an incredibly compact form factor. Paired with the stunning round display, it creates a visually appealing device that's perfect for at-a-glance information.
Build Process1. Hardware AssemblyShow Image
- Connect the Round Display to the XIAO ESP32S3 Sense board
- The display connects directly to the XIAO's pins - no soldering required!
- Optional: Install in 3D printed case for a finished look
- Download CircuitPython 8.x or newer from CircuitPython.org
- Put your board in bootloader mode (double-click the reset button)
- Drag and drop the CircuitPython UF2 file onto the board's drive
Download these libraries from the CircuitPython bundle:
- adafruit_display_text
- adafruit_requests
- adafruit_bus_device
- gc9a01.mpy
Copy them to the lib
folder on your CircuitPython device.
- Sign up for a free account at Tiingo
- Copy your API key from your account page
Update the configuration variables in code.py
:
API_KEY
: Your Tiingo API keyWIFI_SSID
: Your Wi-Fi network nameWIFI_PASSWORD
: Your Wi-Fi passwordtickers
: List of stock symbols you want to track- Update the configuration variables in
code.py
:API_KEY
: Your Tiingo API keyWIFI_SSID
: Your Wi-Fi network nameWIFI_PASSWORD
: Your Wi-Fi passwordtickers
: List of stock symbols you want to track
The complete project code is available in the attached GitHub repository. Here's a brief explanation of the key components:# Network connection handling
# Stock data fetching via Tiingo API
# Display rendering and animation
# Automatic data refresh and ticker rotation
Simply copy the modified code.py
file to your CircuitPython device, and StockPulse will start running automatically!
Show Image
- Connection: StockPulse connects to your Wi-Fi network on startup
- Data Fetching: It queries the Tiingo API for your selected stocks
- Display Processing: The code formats and color-codes the stock data
- Visualization: Data is presented on the round display with clear metrics
- Rotation: The display cycles through your stock list automatically
- Updates: Data refreshes at configurable intervals (default: 5 minutes)
The circular display shows:
- Stock symbol prominently in the center
- Current price and percentage change
- Daily high and low ranges
- Trading volume
StockPulse can be customized in several ways:
- Watchlist: Modify the
tickers
list to track your preferred stocks - Display Time: Adjust how long each stock is shown before rotating
- Update Frequency: Change how often StockPulse refreshes market data
- Visual Theme: Customize colors and layout for personal preference
- 3D Printed Case: Print the included case files in your preferred color
The completed StockPulse device provides a constant, glanceable connection to the market without the distractions of a smartphone. Its elegant design and intuitive color-coding make it immediately obvious when stocks are moving, while the detailed metrics offer context for those movements.
Future enhancements could include:
- Adding a battery for true portability
- Implementing touch controls for manual ticker navigation
- Incorporating alert functionality for significant price movements
- Adding cryptocurrency support alongside stocks
- GitHub Repository
- XIAO ESP32S3 3D Model Files
- Circuit Diagram (PDF)
- Demo Video
- 3D design files for the XIAO ESP32S3 provided by Seeed Studio
- Financial data provided by Tiingo API
- Hardware platform by Seeed Studio
This project is released under the Creative Commons Attribution-NonCommercial (CC BY-NC) license. This means you are free to:
- Share — copy and redistribute the material in any medium or format
- Adapt — remix, transform, and build upon the material
Under the following terms:
- Attribution — You must give appropriate credit, provide a link to the license, and indicate if changes were made. You may do so in any reasonable manner, but not in any way that suggests the licensor endorses you or your use.
- NonCommercial — You may not use the material for commercial purposes.
For more information about this license, visit Creative Commons BY-NC.
StockPulse by Zanna Finance - Financial awareness, simplified.
Comments