{"id":34499639,"url":"https://github.com/akarazhev/crypto-scout-client","last_synced_at":"2026-05-27T12:31:31.486Z","repository":{"id":318839232,"uuid":"1074275348","full_name":"akarazhev/crypto-scout-client","owner":"akarazhev","description":"Production-ready Java microservice that collects crypto market data from Bybit and metrics from CoinMarketCap, then publishes structured events to RabbitMQ Streams. Built on ActiveJ for fully async I/O. This project was authored with AI-driven tools.","archived":false,"fork":false,"pushed_at":"2026-02-12T09:31:16.000Z","size":261,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-02-12T17:53:24.325Z","etag":null,"topics":["activej","crypto","cryptocurrencies","cryptocurrency","java","maven","podman","rabbimq","rabbitmq-stream"],"latest_commit_sha":null,"homepage":"","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/akarazhev.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null}},"created_at":"2025-10-11T13:34:04.000Z","updated_at":"2026-02-12T09:31:19.000Z","dependencies_parsed_at":"2025-10-16T16:27:15.837Z","dependency_job_id":"7b5ec228-e418-48ff-8ed1-3001d87bf75f","html_url":"https://github.com/akarazhev/crypto-scout-client","commit_stats":null,"previous_names":["akarazhev/crypto-scout-client"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/akarazhev/crypto-scout-client","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/akarazhev%2Fcrypto-scout-client","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/akarazhev%2Fcrypto-scout-client/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/akarazhev%2Fcrypto-scout-client/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/akarazhev%2Fcrypto-scout-client/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/akarazhev","download_url":"https://codeload.github.com/akarazhev/crypto-scout-client/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/akarazhev%2Fcrypto-scout-client/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33566872,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-05-27T02:00:06.184Z","response_time":53,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["activej","crypto","cryptocurrencies","cryptocurrency","java","maven","podman","rabbimq","rabbitmq-stream"],"created_at":"2025-12-24T01:59:51.217Z","updated_at":"2026-05-27T12:31:31.481Z","avatar_url":"https://github.com/akarazhev.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"# crypto-scout-client\n\nJava 25 microservice that collects crypto market data from Bybit and CoinMarketCap, publishing to RabbitMQ Streams. Built on ActiveJ for async I/O.\n\n**Status:** ✅ Production Ready\n\n## Features\n\n- **Bybit Streams**: Spot (PMST) and Linear (PML) market data for BTCUSDT/ETHUSDT (tickers, trades, order books, klines)\n- **CoinMarketCap**: Fear \u0026 Greed Index, BTC/USD quotes (1D, 1W)\n- **AMQP Publishing**: Routes data to RabbitMQ Streams based on provider/source\n- **Health Endpoint**: `GET /health` returns `ok` (200) when ready, 503 otherwise\n\n## Quick Start\n\n### Build\n```bash\nmvn clean package -DskipTests\n```\n\n### Run\n```bash\njava -jar target/crypto-scout-client-0.0.1.jar\n```\n\n### Health Check\n```bash\ncurl http://localhost:8081/health\n```\n\n## Configuration\n\nConfigure via environment variables (recommended) or system properties:\n\n| Property | Env Var | Default | Description |\n|----------|---------|---------|-------------|\n| `server.port` | `SERVER_PORT` | 8081 | HTTP server port |\n| `amqp.rabbitmq.host` | `AMQP_RABBITMQ_HOST` | localhost | RabbitMQ host |\n| `amqp.rabbitmq.username` | `AMQP_RABBITMQ_USERNAME` | crypto_scout_mq | RabbitMQ user |\n| `amqp.rabbitmq.password` | `AMQP_RABBITMQ_PASSWORD` | - | **Required** |\n| `amqp.stream.port` | `AMQP_STREAM_PORT` | 5552 | RabbitMQ Streams port |\n| `cmc.api.key` | `CMC_API_KEY` | - | CoinMarketCap API key |\n| `bybit.api.key` | `BYBIT_API_KEY` | - | Bybit API key |\n| `bybit.api.secret` | `BYBIT_API_SECRET` | - | Bybit API secret |\n| `cmc.parser.module.enabled` | `CMC_PARSER_MODULE_ENABLED` | true | Enable CMC parser |\n| `bybit.stream.module.enabled` | `BYBIT_STREAM_MODULE_ENABLED` | false | Enable Bybit streams |\n\n### Example\n```bash\nexport AMQP_RABBITMQ_PASSWORD=\"secure-password\"\nexport CMC_API_KEY=\"your-cmc-key\"\njava -jar target/crypto-scout-client-0.0.1.jar\n```\n\n## Security\n\n**Critical:** Never commit credentials to version control.\n\n- Credentials must be provided via environment variables or system properties\n- `application-local.properties` is gitignored for local development\n- All sensitive fields in `application.properties` have warning comments\n- Configuration is validated at startup (hostname, port ranges, required fields)\n\n## Architecture\n\n```\n┌─────────────────────────────────────────────────────────────┐\n│                        Client Launcher                       │\n├─────────────┬─────────────┬──────────────┬──────────────────┤\n│ CoreModule  │ WebModule   │ ClientModule │ Bybit/CMC Modules│\n│ (reactor)   │ (HTTP/API)  │ (publisher)  │ (consumers)      │\n└─────────────┴─────────────┴──────────────┴──────────────────┘\n                            │\n                    ┌───────┴───────┐\n                    ▼               ▼\n            Bybit WebSocket    CMC HTTP API\n                    │               │\n                    └───────┬───────┘\n                            ▼\n                    AmqpPublisher\n                            │\n                            ▼\n                    RabbitMQ Streams\n```\n\n**Key Components:**\n- `AmqpPublisher` - Thread-safe publisher to RabbitMQ Streams with consistent health checks\n- `AbstractBybitStreamConsumer` - Base class for Bybit stream consumers\n- `CmcParserConsumer` - Processes CMC data with null-safe quote selection\n- `ConfigValidator` - Validates all config at startup with descriptive errors\n\n## Container Deployment\n\n```bash\n# Build image\npodman build -t crypto-scout-client:0.0.1 .\n\n# Run with compose\npodman-compose up -d\n```\n\nFeatures:\n- Non-root user (UID 10001)\n- Read-only rootfs with tmpfs\n- `cap_drop: ALL`, `no-new-privileges`\n- Resource limits configured\n- Health checks enabled\n\n## Testing\n\n```bash\nmvn test\n```\n\n## License\n\nMIT License. See `LICENSE`.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fakarazhev%2Fcrypto-scout-client","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fakarazhev%2Fcrypto-scout-client","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fakarazhev%2Fcrypto-scout-client/lists"}