Skip to main content

High level design

OpenKol is a single Next.js application that includes the UI, API routes, and scoring logic. The architecture favors deterministic computation and fast caching.

Core components

  • Client UI for input, dashboards, and shareable pages
  • API routes that normalize posts and fetch market data
  • Scoring modules implemented as pure functions
  • Storage for normalized posts and analysis snapshots
  • Caching for expensive lookups and reanalysis

Data flow

  1. User submits a post URL.
  2. API normalizes the post and extracts symbols.
  3. Market data and liquidity are pulled from a DEX analytics provider.
  4. Scoring modules compute social, chart, and overall scores.
  5. Results are stored and cached.
  6. The UI renders the scorecard and OG preview.

Rendering and sharing

OpenKol generates OG images on demand for social previews. Analysis pages are renderable for SEO and for clean share links.