Contributing

Your contributions are always welcome! Please ensure your pull request meets the following guidelines.

Entry Format

Each entry must follow one of these formats:

GitHub project

- [Project Name](https://github.com/owner/repo) - Short description ending with a period.

Project with website and GitHub repo

For projects that have a dedicated website, link to the site and append the GitHub repo in the description:

- [Project Name](https://project-site.com) - Short description ending with a period. [GitHub](https://github.com/owner/repo)

CRAN project

Link to the CRAN package page. If the project has a GitHub repo, append it after the description:

- [Package Name](https://cran.r-project.org/package=pkgname) - Short description ending with a period.
- [Package Name](https://cran.r-project.org/package=pkgname) - Short description ending with a period. [GitHub](https://github.com/owner/repo)

PyPI project

Link to the PyPI package page. If the project has a GitHub repo, append it after the description:

- [package-name](https://pypi.org/project/package-name/) - Short description ending with a period.
- [package-name](https://pypi.org/project/package-name/) - Short description ending with a period. [GitHub](https://github.com/owner/repo)

General rules

Use https:// URLs only.
GitHub repository URLs are strongly preferred. Projects with GitHub repos get automated tracking of stars, activity, and archive status on awesome-quant.com.
The description must end with a period (before the [GitHub] link, if present).
Keep descriptions concise — one sentence.

Quality Requirements

Active: Project must show recent activity (commits within the last 12 months).
Documented: Clear README with usage examples.

Commercial & Proprietary Projects

Commercial and proprietary projects are welcome. They will be placed under the Commercial & Proprietary Services section. Include a link to the product website and a brief description of what it offers.

Section Placement

Add your entry under the correct language heading (##) and category subheading (###). If the project is a Python backtesting library, it goes under ## Python → ### Trading & Backtesting, not under ### Indicators.

If no existing category fits, suggest a new one in your PR description.

Preferred: One project per pull request for clarity and focused reviews.

Acceptable: Multiple closely related projects in a single PR if they share a common theme or data source. Examples:

Multiple data sources from the same market or exchange (e.g., all NSE/BSE tools for Indian markets)
Multiple tools from the same author with complementary functionality
Multiple APIs/SDKs for the same service or data provider
Related packages addressing a specific domain gap (e.g., UK company identifier validators)

When submitting multiple projects:

Explain the relationship and rationale in the PR description
Ensure each entry is placed in the correct section
Avoid creating duplicate entries within the same README file
All entries must meet quality and format requirements independently

Before Submitting

Search the existing list to make sure the project is not already included.
Search previous Pull Requests (open and closed) to avoid duplicates.
Make sure the entry format matches exactly — our parser relies on it.

Automatic Rejection

PRs will be closed if:

Multiple projects added in a single PR.
Entry format does not match the required pattern.
Duplicate of an existing entry or a recently closed PR.
Project is archived or abandoned.
Empty PR description.

3.7 KiB Raw Blame History