Skip to content

README.md

Latest commit

 

History

History
106 lines (81 loc) · 2.67 KB

README.md

File metadata and controls

106 lines (81 loc) · 2.67 KB

AWARE

Don't bet on outcomes. Bet on the best traders being right.

AWARE turns prediction-market intelligence into an investable product layer. Instead of manually tracking markets, users can follow data-driven trader indices, monitor conviction signals, and plug into fund-style execution workflows.

What AWARE Does

  • Builds Smart Money Scores from real trading behavior
  • Creates PSI indices (PSI-10, category indices, etc.)
  • Runs a fund mirroring engine on top of Polybot execution infrastructure
  • Exposes everything via API + web dashboard

Product Stack

aware/
├── executor-service/        # Java: order execution
├── strategy-service/        # Java: strategies + fund mirroring
├── ingestor-service/        # Java: market/user trade ingestion
├── analytics-service/       # ClickHouse schema + analytics API service module
├── polybot-core/            # Shared Java core
├── aware-fund/
│   ├── services/analytics/  # Python scoring + ML jobs
│   ├── services/api/        # FastAPI product API
│   └── services/web/        # Next.js dashboard
├── docker-compose.local.yaml
└── Makefile

Run It In One Command

make local

Then:

make status
make logs
make down

Local Endpoints

Component URL
Dashboard http://localhost:3000
Product API http://localhost:8000
Executor http://localhost:8080
Strategy http://localhost:8081
Ingestor http://localhost:8083
ClickHouse http://localhost:8123

API Quick Hits

curl http://localhost:8000/api/health
curl http://localhost:8000/api/leaderboard
curl http://localhost:8000/api/indices/PSI-10
curl http://localhost:8000/api/fund/nav
curl http://localhost:8000/api/insider/alerts

Developer Commands

make help
make build
make local
make train
make train-all
make analytics

mvn clean package -DskipTests
mvn test

Documentation

  • Product vision: aware-fund/VISION.md
  • Execution roadmap: aware-fund/ACTION_PLAN.md
  • Design rationale: aware-fund/DESIGN_DECISIONS.md
  • ML strategy: aware-fund/ML_AI_STRATEGY.md
  • Research workflows: research/README.md
  • Deployment notes: DEPLOYMENT.md

Current Reality

  • Core ingestion/execution/scoring stack is operational.
  • Fund mirror logic is implemented in strategy service.
  • API + dashboard are working for local/dev operation.
  • Smart-contract custody/deposit flows are still pending before full public fund launch.

Security

  • Never commit private keys, API secrets, or real .env values.
  • Use .env.example as template only.
  • Keep secret scanning in release workflow.

License

MIT