Practical overview
When it fits
Use Luckyscan when you want to examine its divination-based interpretations alongside token data, or when evaluating the repository as a starting point for a similar web application.
Who it is for
- Crypto investors who want to explore divination-based interpretations alongside token price information.
- Developers looking for an MIT-licensed TypeScript project with documented crypto-data and divination components.
Documented uses
- Look up token price and 24-hour trend information for supported Solana and EVM-chain tokens.
- Generate and compare four kinds of divination-based token readings and their combined score.
- Save query history or favorites and compare tokens.
- Query token readings through the documented Telegram bot.
Requirements & limits
- The combined rating weights six-line divination at 35%, Meihua Yishu at 25%, tarot at 20% and astrology dice at 20%.
- The README lists DexScreener for price data and support for Solana and EVM-chain tokens.
- Local setup requires Node.js 22+, pnpm 8+ and MySQL 8+ or TiDB, plus database and secret configuration.
- OAuth and Telegram integrations require their respective credentials when enabled.
Check current requirements in the official documentation. Source-based guidance does not mean OpenViST has run or independently tested this project.
Set up Luckyscan locally
Install the project, configure required environment values, initialize its database and start the development server.
Before you start
- Node.js 22+
- pnpm 8+
- MySQL 8+ or TiDB
- A DATABASE_URL, SESSION_SECRET and JWT_SECRET
Steps
Clone the LuckyScan repository and enter its project directory.
Install dependencies with pnpm install.
Copy .env.example to .env and provide the database URL and session and JWT secrets.
Initialize the database with pnpm db:push, then start the development server with pnpm dev.
Expected outcome
The README specifies that the development server is accessed at http://localhost:3000.
Guide limitations
- The guide describes the README setup path; it does not verify a successful installation.
- OAuth, Telegram and third-party API credentials are listed as optional for enabling those integrations.
Sources & review
Source record details
- Source availability
- Active
- Sources checked
- 14 October 2026
- Original website title
- 0xChris-Defi/LuckyScan · Official homepage title · retained in its source language

