![Finalytics](https://github.com/Nnamdi-sys/finalytics/raw/main/logo-color.png)

[![Crates.io](https://img.shields.io/crates/v/finalytics)](https://crates.io/crates/finalytics)
[![PyPI](https://img.shields.io/pypi/v/finalytics)](https://pypi.org/project/finalytics/)
[![NPM Version](https://img.shields.io/npm/v/finalytics)](https://www.npmjs.com/package/finalytics)
[![Go Reference](https://pkg.go.dev/badge/github.com/Nnamdi-sys/finalytics/go/finalytics.svg)](https://pkg.go.dev/github.com/Nnamdi-sys/finalytics/go/finalytics)
[![Docs.rs](https://docs.rs/finalytics/badge.svg)](https://docs.rs/finalytics/)
[![CodeFactor](https://www.codefactor.io/repository/github/nnamdi-sys/finalytics/badge)](https://www.codefactor.io/repository/github/nnamdi-sys/finalytics)
![License](https://img.shields.io/crates/l/finalytics)
[![Homepage](https://img.shields.io/badge/homepage-finalytics.rs-blue)](https://finalytics.rs/)
![Platform](https://img.shields.io/badge/Platform-Windows%20%7C%20Linux%20%7C%20MacOS-brightgreen)

---

**Finalytics** is a high-performance Rust library for security analysis and portfolio optimization, with bindings for Python, Node.js, Go, and a web application built with Dioxus.

- **Security Screening:** Filter and rank equities, cryptocurrencies, and other assets using advanced metrics and custom filters.
- **Security Analysis:** Retrieve and analyze financial data for equities, crypto, and more.
- **Portfolio Optimization:** Optimize and analyze portfolios using advanced objective functions and constraints.
- **Multi-language Support:** Use Finalytics from Python, Node.js, Go, or directly in Rust.
- **Web Application:** Interactive dashboards and analytics at [finalytics.rs](https://finalytics.rs).


---

## 📦 Bindings & Documentation

- **Rust Core:**
  [Rust README](./rust/README.md) | [API Docs](https://docs.rs/finalytics/)

- **Python Binding:**
  [Python README](./python/README.md) | [PyPI](https://pypi.org/project/finalytics/)

- **Node.js Binding:**
  [Node.js README](./js/README.md) | [npm](https://www.npmjs.com/package/finalytics)

- **Go Binding:**
  [Go README](./go/README.md) | [GoDoc](https://pkg.go.dev/github.com/Nnamdi-sys/finalytics/go/finalytics)

- **Web Application:**
  [Web README](./web/README.md) | [Live Demo](https://finalytics.rs)

---

## 🚀 Quick Start

### Rust

```toml
[dependencies]
finalytics = "*"
```
```bash
cargo add finalytics
```
[See Rust examples & docs →](./rust/README.md)

---

### Python

```bash
pip install finalytics
```
[See Python usage & docs →](./python/README.md)

---

### Node.js

```bash
npm install finalytics
```
[See Node.js usage & docs →](./js/README.md)

---

### Go

```bash
go get github.com/Nnamdi-sys/finalytics/go/finalytics
```
[See Go usage & docs →](./go/README.md)

---

### Web Application

Try the interactive dashboards at [finalytics.rs](https://finalytics.rs)
Or [run locally](./web/README.md):

```bash
cargo install dioxus-cli
git clone https://github.com/Nnamdi-sys/finalytics.git
cd finalytics/web
dx serve --platform web
```

---

## ⭐ Star History

[![Star History Chart](https://api.star-history.com/svg?repos=Nnamdi-sys/finalytics&type=Date)](https://www.star-history.com/#Nnamdi-sys/finalytics&Date)