Live Sri Lanka fuel price intelligence — built by Ardeno Studio

---

Octane tracks CPC fuel prices daily the moment they're revised, and presents them with historical charts, a world comparison, a trip cost calculator, email price alerts, an embeddable widget, and a free public API.

Features

• Live prices — scraped daily at 8am from CPC and LIOC
• Price history — up to 10 years of revision events with delta indicators
• World comparison — Sri Lanka vs global average and regional neighbours
• Trip calculator — distance + efficiency → exact cost at today's prices
• Price alerts — one email the moment a fuel crosses your threshold
• Embed widget — drop a live price badge into any site, no key needed
• Free API — open REST endpoints, no auth required for reads

Stack

Layer	Tech
Backend	FastAPI · PostgreSQL · Fly.io
Scrapers	httpx + BeautifulSoup · daily 8am cron
Frontend	React 18 · Vite · Tailwind CSS · Recharts
Hosting	Vercel (frontend) · Fly.io (backend + DB)
Sources	ceypetco.gov.lk · lankaiocoil.lk · globalpetrolprices.com

Project layout

octane/
├── .github/        GitHub Actions — CI, deploy, scrape, digest
├── backend/        FastAPI app, scrapers, DB schema, alert mailer
└── frontend/       React dashboard, embed widget, Fly/Vercel configs

Local dev

# Backend
cd backend
python -m venv .venv
source .venv/bin/activate   # Windows: .venv\Scripts\activate
pip install -r requirements.txt
cp .env.example .env          # set DATABASE_URL
python -m app.db.init         # create tables
python -m app.scrapers.run    # seed prices
uvicorn app.main:app --reload --port 8000

# Frontend
cd frontend
npm install
npm run dev                   # → http://localhost:5173

API endpoints

All endpoints are free to use with no API key.

Method	Endpoint	Description
GET	/v1/prices/latest	Current prices for all fuel types
GET	/v1/prices/history?fuel=92&days=730	Historical revisions for charting
GET	/v1/prices/changes	All revision events with price deltas
GET	/v1/comparison/world?fuel=95	Sri Lanka vs world average + neighbours
GET	/v1/calculator/trip?distance=30&efficiency=12&fuel=92	Trip cost at today's prices
POST	/v1/alerts/subscribe	Subscribe to a price threshold alert
GET	/v1/embed/widget?fuel=92&theme=light	Embeddable HTML price widget

Interactive docs available at /docs (Swagger UI).

---

_{An Ardeno Studio production · octane.lk}