# praketmehta/arbitrage-tracker architecture

> Architecture diagram of the GitHub repository praketmehta/arbitrage-tracker, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-01). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/praketmehta/arbitrage-tracker
- Repository: https://github.com/praketmehta/arbitrage-tracker

## Overview

This repository contains a small quantitative-finance prototype: it subscribes to Bloomberg market data, calculates covered-interest-parity arbitrage signals, sizes and simulates orders, and separately fits yield curves. The excerpts show no runtime handoff from ingestion to analytics or from signals to execution, so those links are omitted. The README is empty, and configuration contents and broader integration behavior were not shown.

Main entry points: [`data/ingestion.py`](https://github.com/praketmehta/arbitrage-tracker/blob/main/data/ingestion.py) (Live ingestion), [`models/interest_parity.py`](https://github.com/praketmehta/arbitrage-tracker/blob/main/models/interest_parity.py) (Arbitrage signals), [`config/settings.yaml`](https://github.com/praketmehta/arbitrage-tracker/blob/main/config/settings.yaml) (Settings), [`execution/router.py`](https://github.com/praketmehta/arbitrage-tracker/blob/main/execution/router.py) (Order simulation)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_market["Market data"]
  node_settings["Settings<br/>[settings.yaml]"]
  node_ingestion["Live ingestion<br/>[ingestion.py]"]
end

subgraph group_analytics["Quant analytics"]
  node_signals["Arbitrage signals<br/>[interest_parity.py]"]
  node_cip["CIP pricing<br/>[interest_parity.py]"]
  node_yieldcurve["Yield curve fit<br/>[yield_curve.py]"]
end

subgraph group_execution["Trade execution"]
  node_router["Order simulation<br/>[router.py]"]
  node_sizing["Position sizing<br/>[router.py]"]
end

node_bloomberg["Bloomberg API"]

node_ingestion -->|"loads"| node_settings
node_signals -->|"loads"| node_settings
node_ingestion -->|"subscribes"| node_bloomberg
node_signals -->|"calculates via"| node_cip
node_router -->|"sizes via"| node_sizing

click node_settings "https://github.com/praketmehta/arbitrage-tracker/blob/main/config/settings.yaml"
click node_ingestion "https://github.com/praketmehta/arbitrage-tracker/blob/main/data/ingestion.py"
click node_signals "https://github.com/praketmehta/arbitrage-tracker/blob/main/models/interest_parity.py"
click node_cip "https://github.com/praketmehta/arbitrage-tracker/blob/main/models/interest_parity.py"
click node_yieldcurve "https://github.com/praketmehta/arbitrage-tracker/blob/main/models/yield_curve.py"
click node_router "https://github.com/praketmehta/arbitrage-tracker/blob/main/execution/router.py"
click node_sizing "https://github.com/praketmehta/arbitrage-tracker/blob/main/execution/router.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_settings,node_ingestion toneBlue
class node_signals,node_cip,node_yieldcurve toneAmber
class node_router,node_sizing,node_bloomberg toneMint
```

## Components

### Market data

- [Settings](https://github.com/praketmehta/arbitrage-tracker/blob/main/config/settings.yaml): `config/settings.yaml`
- [Live ingestion](https://github.com/praketmehta/arbitrage-tracker/blob/main/data/ingestion.py): `data/ingestion.py`

### Quant analytics

- [Arbitrage signals](https://github.com/praketmehta/arbitrage-tracker/blob/main/models/interest_parity.py): `models/interest_parity.py`
- [CIP pricing](https://github.com/praketmehta/arbitrage-tracker/blob/main/models/interest_parity.py): `models/interest_parity.py`
- [Yield curve fit](https://github.com/praketmehta/arbitrage-tracker/blob/main/models/yield_curve.py): `models/yield_curve.py`

### Trade execution

- [Order simulation](https://github.com/praketmehta/arbitrage-tracker/blob/main/execution/router.py): `execution/router.py`
- [Position sizing](https://github.com/praketmehta/arbitrage-tracker/blob/main/execution/router.py): `execution/router.py`

### Other components

- **Bloomberg API**

## Connections

- Live ingestion → Settings: loads (evidence: `data/ingestion.py`)
- Arbitrage signals → Settings: loads (evidence: `models/interest_parity.py`)
- Live ingestion → Bloomberg API: subscribes (evidence: `data/ingestion.py`)
- Arbitrage signals → CIP pricing: calculates via (evidence: `models/interest_parity.py`)
- Order simulation → Position sizing: sizes via (evidence: `execution/router.py`)
