Getting Started

Prerequisites

• Docker with Docker Compose.
• Git.
• Optional: .NET 9 SDK if you want to build src/WebApi outside Docker. Docker builds use the repository Dockerfile’s .NET 10 SDK/runtime images while the project itself targets net9.0.

Clone and run

git clone https://github.com/jonathanperis/rinha2-back-end-dotnet.git
cd rinha2-back-end-dotnet
docker compose up nginx -d --build

The API is exposed through NGINX at:

http://localhost:9999

Smoke check

curl -i http://localhost:9999/healthz

A healthy stack returns HTTP/1.1 200 OK.

API endpoints

Example transaction

Credits use tipo: "c", debits use tipo: "d". Values are positive integer cents.

curl -X POST http://localhost:9999/clientes/1/transacoes \
  -H "Content-Type: application/json" \
  -d '{"valor": 1000, "tipo": "c", "descricao": "deposito"}'

The successful response returns the client ID, limit, and updated balance:

{
  "id": 1,
  "limite": 100000,
  "saldo": 1000
}

Invalid payloads return 422. Unknown client IDs return 404.

Example statement

curl http://localhost:9999/clientes/1/extrato

Example response:

{
  "saldo": {
    "total": 1000,
    "limite": 100000,
    "data_extrato": "2026-04-01T19:20:20.000000"
  },
  "ultimas_transacoes": [
    {
      "valor": 1000,
      "tipo": "c",
      "descricao": "deposito"
    }
  ]
}

For the full endpoint contract and the current over-limit debit behavior, see API Reference.

Run the load-test lane

The compose file includes the shared k6 runner and observability services. After the API stack is up, run:

docker compose up k6

By default, the k6 service runs with MODE=dev, exports data to InfluxDB, and exposes the k6 web dashboard on port 5665.

Useful local ports

Stop and clean up

docker compose down

Add -v only when you intentionally want to remove database and telemetry volumes:

docker compose down -v