mmontes11 / crypto-trade

Cryptocurrency trading PoC

crypto-trade

Simulates real time cryptocurrency tradings in a microservice ecosystem.

---

• Tech stack
• How it works
• Installation
• API
• Production environment

---

Tech stack

• Go
• Nats
• ClickHouse
• Docker
• Kubernetes
• Helm
• GitHub actions

How it works

It contists in 3 microservices:

• publisher: Generates random trades and sends them to Nats.
• subscriber: Receives trades and stores them in ClickHouse.
• api: Exposes a REST API with the trades from ClickHouse.

Installation

Local

1. Set up Nats and ClickHouse:

$ docker-compose -f docker-compose.services.yml up -d

2. Start each microservice in a different tab by manually running:

$ make run

Local + Tmux

Install tmux and then:

$ ./scripts/run-dev.sh

Docker

$ ./scripts/run-docker.sh

API

GET /health

Indicate the service is up and running.

Responses:

• 200 OK

GET /api/trades

Retrieves real time cryptocurrency trades.

Query params:

• groupBy: second | minute | hour
• crypto: btc | eth
• currency: eur | usd
• fromDate: 1970-01-01T00:00:00Z
• toDate: 2050-01-01T00:00:00Z
• limit: 100

Responses:

• 200 OK
• 404 Not Found

Body:

• Array of trades

Production environment

https://crypto-trade.mmontes-dev.duckdns.org/api/trades?groupBy=hour&crypto=btc&currency=eur&fromDate=2021-01-01T00:00:00Z