{"id":47968166,"url":"https://github.com/5queezer/lunarcrush-pairlist","last_synced_at":"2026-04-04T10:40:01.975Z","repository":{"id":276864412,"uuid":"923785729","full_name":"5queezer/lunarcrush-pairlist","owner":"5queezer","description":"LunarCrush data cache with FastAPI layer for Freqtrade pairlists","archived":false,"fork":false,"pushed_at":"2025-02-15T09:18:26.000Z","size":180,"stargazers_count":0,"open_issues_count":1,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2026-04-04T10:39:59.554Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/5queezer.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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}},"created_at":"2025-01-28T20:26:30.000Z","updated_at":"2026-03-31T05:52:53.000Z","dependencies_parsed_at":"2025-02-10T21:34:09.724Z","dependency_job_id":"6ec5bdef-6e97-426a-92f7-948773041cb6","html_url":"https://github.com/5queezer/lunarcrush-pairlist","commit_stats":null,"previous_names":["5queezer/lunarcrush-pairlist"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/5queezer/lunarcrush-pairlist","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/5queezer%2Flunarcrush-pairlist","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/5queezer%2Flunarcrush-pairlist/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/5queezer%2Flunarcrush-pairlist/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/5queezer%2Flunarcrush-pairlist/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/5queezer","download_url":"https://codeload.github.com/5queezer/lunarcrush-pairlist/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/5queezer%2Flunarcrush-pairlist/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31397055,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-04T10:20:44.708Z","status":"ssl_error","status_checked_at":"2026-04-04T10:20:06.846Z","response_time":60,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"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":[],"created_at":"2026-04-04T10:40:01.909Z","updated_at":"2026-04-04T10:40:01.963Z","avatar_url":"https://github.com/5queezer.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# LunarCrush Pairlist API for Freqtrade\n\n## For Freqtrade\n\n## Installation\n\n### Prerequisites\n- **Bun** (\u003e=1.x recommended)\n- **Docker** (optional)\n- **LunarCrush Subscription Plan Required**\n\n### Setup\n1. Clone the repository:\n   ```sh\n   git clone \u003crepo-url\u003e\n   cd \u003crepo-directory\u003e\n   ```\n2. Install dependencies:\n   ```sh\n   bun install\n   ```\n3. Create a `.env` file and configure it:\n   ```sh\n   PORT=8080\n   LUNARCRUSH_TOKEN=\u003cyour-lunarcrush-token\u003e\n   PLAN_LUNARCRUSH=discover   # Options: discover, pro\n   API_PREFIX=\"/api\"\n   CACHE_DIR=\"./cache\"\n   CACHE_TTL_EXCHANGE=3600000\n   ```\n\n## Running the API\n### Locally\n```sh\nbun run start\n```\n\n### With Docker\n```sh\ndocker build -t crypto-api .\ndocker run -p 8080:8080 --env-file .env crypto-api\n```\n\n## API Endpoints\n\n### Health Check\n```\nGET /api/health\nResponse: { \"status\": \"OK\" }\n```\n\n### Get LunarCrush Trading Pairs\n```\nGET /api/pairlist/lunar/:exchange/:marketType/:lunarMode\n\nQuery Params:\n- limit (optional, default: 50)\n- min (optional)\n- max (optional)\n- sort (asc/desc, default: asc)\n- quoteAsset (optional, default: USDT)\n```\n\nExample:\nAlt Rank: smaller is better, thus asc\n```sh\nGET /api/pairlist/lunar/binance/futures/alt_rank?limit=100\u0026sort=asc\n```\n\nGalaxy score: bigger is better, thus desc\n```sh\nGET /api/pairlist/lunar/binance/futures/galaxy_score?limit=100\u0026sort=desc\n```\n\n\n## LunarCrush API Response Example\n```json\n{\n  \"id\": 169,\n  \"symbol\": \"FET\",\n  \"name\": \"Fetch\",\n  \"price\": 0.7107922567775068,\n  \"price_btc\": 0.000007451327247342504,\n  \"volume_24h\": 124655937.65,\n  \"volatility\": 0.0267,\n  \"circulating_supply\": 2390224782.5,\n  \"max_supply\": 2719493897,\n  \"percent_change_1h\": -1.735105198471,\n  \"percent_change_24h\": -7.26300805892,\n  \"percent_change_7d\": -28.874032450156,\n  \"market_cap\": 1698953267.36,\n  \"market_cap_rank\": 71,\n  \"interactions_24h\": 764785,\n  \"social_volume_24h\": 6246,\n  \"social_dominance\": 1.0931830950418213,\n  \"market_dominance\": 0.054706720805704614,\n  \"market_dominance_prev\": 0.053308437993835875,\n  \"galaxy_score\": 45,\n  \"galaxy_score_previous\": 43,\n  \"alt_rank\": 850,\n  \"alt_rank_previous\": 41,\n  \"sentiment\": 79,\n  \"categories\": \"nft,ai,ai-agents\",\n  \"blockchains\": [\n    [Object ...], [Object ...], [Object ...]\n  ],\n  \"percent_change_30d\": -46.45966230155,\n  \"last_updated_price\": 1739031694,\n  \"last_updated_price_by\": \"cmc_stream\",\n  \"topic\": \"fet fetch\",\n  \"logo\": \"https://cdn.lunarcrush.com/fetch.png\"\n}\n```\n\nRegarding to this response, marketType can be one of the following:\n- volume_24h\n- volatility\n- percent_change_1h, percent_change_24h, percent_change_7d\n- market_cap, market_cap_rank\n- interactions_24h, social_volume_24h\n- galaxy_score, galaxy_score_previous\n- alt_rank, alt_rank_previous\n- sentiment\n- percent_change_30d\n\n## Environment Variables\n| Variable           | Description                                | Default |\n|-------------------|--------------------------------|---------|\n| `PORT`           | Server port                  | `8080`  |\n| `LUNARCRUSH_TOKEN` | API token for LunarCrush      | Required |\n| `PLAN_LUNARCRUSH` | Subscription plan (discover/pro) | `discover` |\n| `API_PREFIX`     | API URL prefix                 | `\"\"` |\n| `CACHE_DIR`     | Directory for cache storage    | `./cache` |\n| `CACHE_TTL_EXCHANGE` | Exchange data cache duration (ms) | `3600000` |\n\n## Error Handling\n- If the **LunarCrush API limit** is reached, cached data is returned.\n- API errors return JSON responses with appropriate HTTP status codes.\n- Missing required environment variables will cause the app to throw errors.\n\n## Deployment\n- Can be deployed using **Docker**\n- Compatible with **Kubernetes** and **AWS Lambda**\n- Works with **Reverse Proxy (Nginx, Traefik, etc.)**\n\n## License\nMIT License\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2F5queezer%2Flunarcrush-pairlist","html_url":"https://awesome.ecosyste.ms/projects/github.com%2F5queezer%2Flunarcrush-pairlist","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2F5queezer%2Flunarcrush-pairlist/lists"}