{"id":13408151,"url":"https://github.com/multiversx/mx-exchange-service","last_synced_at":"2025-10-06T14:04:18.277Z","repository":{"id":65645312,"uuid":"354647611","full_name":"multiversx/mx-exchange-service","owner":"multiversx","description":"Decentralized Exchange Service based on GraphQL","archived":false,"fork":false,"pushed_at":"2024-10-29T08:58:13.000Z","size":32588,"stargazers_count":11,"open_issues_count":12,"forks_count":9,"subscribers_count":15,"default_branch":"main","last_synced_at":"2024-10-29T10:06:19.498Z","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":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/multiversx.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":".github/CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":".github/CODE_OF_CONDUCT.md","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":"2021-04-04T21:11:18.000Z","updated_at":"2024-07-15T13:50:23.000Z","dependencies_parsed_at":"2024-05-20T14:34:13.382Z","dependency_job_id":"352b78ab-9132-4f86-b571-1857dbd2f23b","html_url":"https://github.com/multiversx/mx-exchange-service","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/multiversx%2Fmx-exchange-service","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/multiversx%2Fmx-exchange-service/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/multiversx%2Fmx-exchange-service/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/multiversx%2Fmx-exchange-service/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/multiversx","download_url":"https://codeload.github.com/multiversx/mx-exchange-service/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243578552,"owners_count":20313848,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":"2024-07-30T20:00:51.063Z","updated_at":"2025-10-06T14:04:18.264Z","avatar_url":"https://github.com/multiversx.png","language":"TypeScript","funding_links":[],"categories":["MultiversX official"],"sub_categories":["Dev dApps"],"readme":"GraphQl service to provide backend environment for xExchange\n\n## Dependencies\n\n1. Node.js \u003e @18.x.x is required to be installed [docs](https://nodejs.org/en/)\n2. Redis Server is required to be installed [docs](https://redis.io/).\n3. RabbitMQ Server is required to be installed [docs](https://www.rabbitmq.com/download.html).\n4. MongoDB Server is required to be installed [docs](https://www.mongodb.com/docs/manual/installation).\n\nYou can use `docker-compose up` in a separate terminal to use a local docker container for all these dependencies.\n\nAfter running the sample, you can stop the Docker container with `docker-compose down`\n\n## Available Scripts\n\nThis is an MultiversX project built on Nest.js framework.\n\n### `npm run start`\n\nRuns the app in the production mode.\nMake requests to [http://localhost:3005/graphql](http://localhost:3005/graphql).\n\n## Running the app\n\n1. At the root folder run (make sure you have node v16.x.x)\n\n```bash\n$ npm install\n```\n\n2. Proper config .env.example based on desired configuration\n\n3. Start the app\n\n```bash\n# development debug mode\n$ npm run start:debug\n# development mode\n$ npm run start:dev\n# production mode\n$ npm run start\n```\n\n4. Disable SSL for TimescaleDB in `timescaledb.module.ts`:\n\n```\n// ssl: true,\n// extra: {\n//     ssl: {\n//         rejectUnauthorized: false,\n//     },\n// },\n```\n\nIt depends on the following external systems:\n\n-   gateway:\n    -   docs: [https://docs.multiversx.com/sdk-and-tools/proxy/](https://docs.multiversx.com/sdk-and-tools/proxy/)\n-   index:\n    -   to gather information for some statistics\n    -   docs: [https://docs.multiversx.com/sdk-and-tools/elastic-search/](https://docs.multiversx.com/sdk-and-tools/elastic-search/)\n-   api:\n    -   to get information regarding tokens, metaesdts and user balances\n    -   docs: [https://docs.multiversx.com/sdk-and-tools/rest-api/multiversx-api/](https://docs.multiversx.com/sdk-and-tools/rest-api/multiversx-api/)\n        It uses on the following internal systems:\n-   redis: used to cache various data, for performance purposes\n-   rabbitmq:\n    -   fetching events from blockchain emitted events via notifier\n\nA service instance can be started with the following behavior:\n\n-   public API: provides graphQL queries for the consumers\n-   private API: used to report prometheus metrics \u0026 health checks\n-   rabbitMQ: used to fetch events in real time and create analytics data\n-   cache warmer: used to proactively fetch data \u0026 pushes it to cache, to improve performance \u0026 scalability\n\nIt depends on the following optional external systems:\n\n-   events notifier rabbitmq: queue that pushes logs \u0026 events which are handled internally e.g. to store token prices\n-   AWS Timestream: used to store time based metrics such as prices, volumes, fees\n\nIt uses the following optional internal systems:\n\n-   mongo database: used to store configs and addresses\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmultiversx%2Fmx-exchange-service","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmultiversx%2Fmx-exchange-service","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmultiversx%2Fmx-exchange-service/lists"}