{"id":13546959,"url":"https://github.com/ankitwasankar/mftool-java","last_synced_at":"2026-01-14T02:47:42.106Z","repository":{"id":57729576,"uuid":"385543797","full_name":"ankitwasankar/mftool-java","owner":"ankitwasankar","description":"Java Mutual Fund Library","archived":false,"fork":false,"pushed_at":"2023-11-06T16:26:10.000Z","size":204,"stargazers_count":46,"open_issues_count":3,"forks_count":40,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-07-24T18:53:13.329Z","etag":null,"topics":["java","mutual-fund-api","mutual-funds"],"latest_commit_sha":null,"homepage":"","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ankitwasankar.png","metadata":{"files":{"readme":"readme.md","changelog":null,"contributing":null,"funding":null,"license":"license.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null}},"created_at":"2021-07-13T09:09:28.000Z","updated_at":"2025-01-19T09:08:51.000Z","dependencies_parsed_at":"2024-01-24T06:49:26.481Z","dependency_job_id":null,"html_url":"https://github.com/ankitwasankar/mftool-java","commit_stats":null,"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/ankitwasankar/mftool-java","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ankitwasankar%2Fmftool-java","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ankitwasankar%2Fmftool-java/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ankitwasankar%2Fmftool-java/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ankitwasankar%2Fmftool-java/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ankitwasankar","download_url":"https://codeload.github.com/ankitwasankar/mftool-java/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ankitwasankar%2Fmftool-java/sbom","scorecard":{"id":197298,"data":{"date":"2025-08-11","repo":{"name":"github.com/ankitwasankar/mftool-java","commit":"19b017fda49845fd27006689f6c79296d2d3db38"},"scorecard":{"version":"v5.2.1-40-gf6ed084d","commit":"f6ed084d17c9236477efd66e5b258b9d4cc7b389"},"score":3.8,"checks":[{"name":"Maintained","score":0,"reason":"0 commit(s) and 0 issue activity found in the last 90 days -- score normalized to 0","details":null,"documentation":{"short":"Determines if the project is \"actively maintained\".","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#maintained"}},{"name":"Code-Review","score":0,"reason":"Found 1/28 approved changesets -- score normalized to 0","details":null,"documentation":{"short":"Determines if the project requires human code review before pull requests (aka merge requests) are merged.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#code-review"}},{"name":"Packaging","score":-1,"reason":"packaging workflow not detected","details":["Warn: no GitHub/GitLab publishing workflow detected."],"documentation":{"short":"Determines if the project is published as a package that others can easily download, install, easily update, and uninstall.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#packaging"}},{"name":"Dangerous-Workflow","score":10,"reason":"no dangerous workflow patterns detected","details":null,"documentation":{"short":"Determines if the project's GitHub Action workflows avoid dangerous patterns.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#dangerous-workflow"}},{"name":"Pinned-Dependencies","score":6,"reason":"dependency not pinned by hash detected -- score normalized to 6","details":["Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/codacy.yml:39: update your workflow using https://app.stepsecurity.io/secureworkflow/ankitwasankar/mftool-java/codacy.yml/master?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/codacy.yml:59: update your workflow using https://app.stepsecurity.io/secureworkflow/ankitwasankar/mftool-java/codacy.yml/master?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/maven.yml:23: update your workflow using https://app.stepsecurity.io/secureworkflow/ankitwasankar/mftool-java/maven.yml/master?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/maven.yml:25: update your workflow using https://app.stepsecurity.io/secureworkflow/ankitwasankar/mftool-java/maven.yml/master?enable=pin","Info:   0 out of   4 GitHub-owned GitHubAction dependencies pinned","Info:   2 out of   2 third-party GitHubAction dependencies pinned"],"documentation":{"short":"Determines if the project has declared and pinned the dependencies of its build process.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#pinned-dependencies"}},{"name":"Binary-Artifacts","score":10,"reason":"no binaries found in the repo","details":null,"documentation":{"short":"Determines if the project has generated executable (binary) artifacts in the source repository.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#binary-artifacts"}},{"name":"Token-Permissions","score":0,"reason":"detected GitHub workflow tokens with excessive permissions","details":["Info: jobLevel 'contents' permission set to 'read': .github/workflows/codacy.yml:31","Info: jobLevel 'actions' permission set to 'read': .github/workflows/codacy.yml:33","Info: topLevel 'contents' permission set to 'read': .github/workflows/codacy.yml:26","Warn: no topLevel permission defined: .github/workflows/maven.yml:1","Info: no jobLevel write permissions found"],"documentation":{"short":"Determines if the project's workflows follow the principle of least privilege.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#token-permissions"}},{"name":"CII-Best-Practices","score":0,"reason":"no effort to earn an OpenSSF best practices badge detected","details":null,"documentation":{"short":"Determines if the project has an OpenSSF (formerly CII) Best Practices Badge.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#cii-best-practices"}},{"name":"Security-Policy","score":0,"reason":"security policy file not detected","details":["Warn: no security policy file detected","Warn: no security file to analyze","Warn: no security file to analyze","Warn: no security file to analyze"],"documentation":{"short":"Determines if the project has published a security policy.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#security-policy"}},{"name":"Fuzzing","score":0,"reason":"project is not fuzzed","details":["Warn: no fuzzer integrations found"],"documentation":{"short":"Determines if the project uses fuzzing.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#fuzzing"}},{"name":"License","score":10,"reason":"license file detected","details":["Info: project has a license file: license.md:0","Info: FSF or OSI recognized license: MIT License: license.md:0"],"documentation":{"short":"Determines if the project has defined a license.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#license"}},{"name":"Signed-Releases","score":-1,"reason":"no releases found","details":null,"documentation":{"short":"Determines if the project cryptographically signs release artifacts.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#signed-releases"}},{"name":"Branch-Protection","score":-1,"reason":"internal error: error during branchesHandler.setup: internal error: githubv4.Query: Resource not accessible by integration","details":null,"documentation":{"short":"Determines if the default and release branches are protected with GitHub's branch protection settings.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#branch-protection"}},{"name":"SAST","score":0,"reason":"SAST tool is not run on all commits -- score normalized to 0","details":["Warn: 0 commits out of 3 are checked with a SAST tool"],"documentation":{"short":"Determines if the project uses static code analysis.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#sast"}},{"name":"Vulnerabilities","score":6,"reason":"4 existing vulnerabilities detected","details":["Warn: Project is vulnerable to: GHSA-h46c-h94j-95f3","Warn: Project is vulnerable to: GHSA-w33c-445m-f8w7","Warn: Project is vulnerable to: GHSA-2qp4-g3q3-f92w","Warn: Project is vulnerable to: GHSA-cqj8-47ch-rvvq"],"documentation":{"short":"Determines if the project has open, known unfixed vulnerabilities.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#vulnerabilities"}}]},"last_synced_at":"2025-08-16T22:03:53.491Z","repository_id":57729576,"created_at":"2025-08-16T22:03:53.492Z","updated_at":"2025-08-16T22:03:53.492Z"},"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28408737,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-14T01:52:23.358Z","status":"online","status_checked_at":"2026-01-14T02:00:06.678Z","response_time":107,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["java","mutual-fund-api","mutual-funds"],"created_at":"2024-08-01T12:00:48.775Z","updated_at":"2026-01-14T02:47:42.087Z","avatar_url":"https://github.com/ankitwasankar.png","language":"Java","funding_links":[],"categories":["Examples"],"sub_categories":[],"readme":"\u003ch1 align=\"center\"\u003e\n  \u003ca href=\"https://github.com/ankitwasankar/mftool-java\"\u003e\n    \u003cimg src=\"https://raw.githubusercontent.com/ankitwasankar/mftool-java/master/src/main/resources/icons/mf-tool-java-new.jpg\" alt=\"mftool-java\"\u003e\n  \u003c/a\u003e\n\u003c/h1\u003e\n\u003cp align=\"center\"\u003e\n\u003ca target=\"_blank\" href=\"https://search.maven.org/artifact/com.webencyclop.core/mftool-java\"\u003e\u003cimg src=\"https://img.shields.io/maven-central/v/com.webencyclop.core/mftool-java.svg?label=Maven%20Central\"/\u003e\u003c/a\u003e \n\u003ca target=\"_blank\" href=\"https://www.codacy.com/gh/ankitwasankar/mftool-java/dashboard?utm_source=github.com\u0026utm_medium=referral\u0026utm_content=ankitwasankar/mftool-java\u0026utm_campaign=Badge_Coverage\"\u003e\u003cimg src=\"https://app.codacy.com/project/badge/Coverage/0054db87ea0f426599c3a30b39291388\" /\u003e\u003c/a\u003e\n\u003ca href=\"https://www.codacy.com/gh/ankitwasankar/mftool-java/dashboard?utm_source=github.com\u0026amp;utm_medium=referral\u0026amp;utm_content=ankitwasankar/mftool-java\u0026amp;utm_campaign=Badge_Grade\"\u003e\u003cimg src=\"https://app.codacy.com/project/badge/Grade/0054db87ea0f426599c3a30b39291388\"/\u003e\u003c/a\u003e\n\u003ca target=\"_blank\" href=\"https://github.com/ankitwasankar/mftool-java/blob/master/license.md\"\u003e\u003cimg src=\"https://camo.githubusercontent.com/8298ac0a88a52618cd97ba4cba6f34f63dd224a22031f283b0fec41a892c82cf/68747470733a2f2f696d672e736869656c64732e696f2f707970692f6c2f73656c656e69756d2d776972652e737667\" /\u003e\u003c/a\u003e\n\u0026nbsp \u003ca target=\"_blank\" href=\"https://www.linkedin.com/in/ankitwasankar/\"\u003e\u003cimg height=\"20\" src=\"https://img.shields.io/badge/LinkedIn-0077B5?style=for-the-badge\u0026logo=linkedin\u0026logoColor=white\" /\u003e\u003c/a\u003e\n\u003c/p\u003e\n\u003cp align=\"center\"\u003e\n  This repository contains the \u003cstrong\u003eMF TOOL - JAVA\u003c/strong\u003e source code.\n  MF TOOL - JAVA is a Java library developed to ease the process of working with Indian Mutual Funds. It's powerful, actively maintained and easy to use.\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n\u003ca href=\"#introduction\"\u003eIntroduction\u003c/a\u003e \u0026nbsp;\u0026bull;\u0026nbsp;\n\u003ca href=\"#installation\"\u003eInstallation\u003c/a\u003e \u0026nbsp;\u0026bull;\u0026nbsp;\n\u003ca href=\"#usage\"\u003eUsage\u003c/a\u003e \u0026nbsp;\u0026bull;\u0026nbsp;\n\u003ca href=\"#documentation\"\u003eDocumentation\u003c/a\u003e \u0026nbsp;\u0026bull;\u0026nbsp;\n\u003ca href=\"#issue\"\u003eIssue?\u003c/a\u003e\n\u003c/p\u003e\n\n# Introduction\nThis \u003cb\u003emf-tool java\u003c/b\u003e library provides simple APIs/functions/methods to work with Indian Mutual Funds. You can:\n\n- Fetch a list of all mutual fund schemes.\n- Fetch a list of matching mutual fund schemes based on provided keywords.\n- Fetch historic or current NAV (Net Asset Value) for a fund.\n- Fetch details for a fund and fund house.\n- Integrate this with any Java project.\n\n## Installation\n##### Maven\n```\n\u003cdependency\u003e\n  \u003cgroupId\u003ecom.webencyclop.core\u003c/groupId\u003e\n  \u003cartifactId\u003emftool-java\u003c/artifactId\u003e\n  \u003cversion\u003e1.0.4\u003c/version\u003e\n\u003c/dependency\u003e\n```\n##### Graddle\n```\nimplementation 'com.webencyclop.core:mftool-java:1.0.4'\n```\nFor other dependency management tool, please visit\n\u003ca href=\"https://search.maven.org/artifact/com.webencyclop.core/mftool-java\"\u003ehttps://search.maven.org/artifact/com.webencyclop.core/mftool-java\u003c/a\u003e\n\n\n## Usage\nSample code that shows how to use the library:\u003cbr/\u003e\n```\nMFTool tool = new MFTool();\ntool.matchingScheme(\"Axis\");   //-- get a list of all schemes with Axis in its name\ntool.getCurrentNav(\"120503\");  //-- get current nav\n```\nThe other available methods are described in the next section.\n\n## Documentation\nMultiple methods provide ways to work with mutual funds and related data. Those are listed below in detail.\n\n### 1. How to initialize an MFTool object\n```\nMFTool tool = new MFTool();\n```\nThis will create the object for you, but it's recommended that you create this object as a \u003cb\u003esingleton\u003c/b\u003e object.\nThe object uses a caching mechanism, which under-the-hood caches the values of historic nav and other static information to improve the performance. \n\u003cbr/\u003eIf you are using the Spring project, you can create the bean in ``@Configuration`` configuration class.\n```\n@Configuration\npublic class MFToolConfig{\n    @Bean\n    public MFTool initializeMfTool() {\n        MFTool tool = new MFTool();\n        return tool;\n    }\n}\n```\nYou can use MFTool in other services using ``@Inject`` or ``@autowired`` annotation.\n```\n@Service\npublic class MyService {\n    \n    @Autowired\n    private MFTool tool;\n\n    public void getCurrentNav(String scheme) {\n        BigDecimal nav = tool.getCurrentNav(scheme);\n    }\n}\n```\n\n### 2. How to fetch a list of all mutual fund schemes\n```\n@Service\npublic class MyService {\n    \n    @Autowired\n    private MFTool tool;\n\n    public List\u003cSchemeNameCodePair\u003e fetchListOfAllMutualFundSchemes() {\n        List\u003cSchemeNameCodePair\u003e list = tool.allSchemes();\n    }\n}\n```\n\n### 3. How to fetch a list of all schemes matching a keyword\n```\n@Service\npublic class MyService {\n    \n    @Autowired\n    private MFTool tool;\n\n    public List\u003cSchemeNameCodePair\u003e getCurrentNav(String schemeCode) {\n        List\u003cSchemeNameCodePair\u003e list = tool.matchingScheme(\"Axis\"); \n        // This will fetch MF schemes that have \"Axis\" in the name.\n    }\n}\n```\n\n### 4. Current NAV for the mutual fund scheme\nAn example schemeCode is 120503 (_Axis Long Term Equity Fund - Direct Plan - Growth Option_).\u003cbr/\u003e\nWhen we fetch a list of mutual funds, we get the scheme-name, and its corresponding schemeCode.\u003cbr/\u003e\n\u003cb\u003eA scheme code uniquely identifies the mutual fund scheme.\u003c/b\u003e\n```\n@Service\npublic class MyService {\n    \n    @Autowired\n    private MFTool tool;\n\n    public List\u003cSchemeNameCodePair\u003e fetchListSchemes(String schemeCode) {\n        BigDecimal nav = tool.getCurrentNav(schemeCode);\n    }\n}\n```\n\n### 5. NAV on specific date for the scheme\nLocalDate is used to define the date. For example:\u003cbr/\u003e\n``LocalDate date = LocalDate.parse(\"2021-07-13\");``\n```\n@Service\npublic class MyService {\n    \n    @Autowired\n    private MFTool tool;\n\n    public List\u003cSchemeNameCodePair\u003e getNavOnDate(String schemeCode, LocalDate date) {\n        BigDecimal nav = tool.getNavFor(\"120503\", date);\n    }\n}\n```\n\n### 6. List of historic NAV for the scheme\nThis method provides a list of all the NAVs for the given scheme.\n```\n@Service\npublic class MyService {\n    \n    @Autowired\n    private MFTool tool;\n\n    public List\u003cSchemeNameCodePair\u003e getNavOnDate(String schemeCode) {\n        List\u003cData\u003e list = tool.historicNavForScheme(schemeCode);\n    }\n}\n```\n\n\n## Issue\nThis repository is maintained actively, so if you face any issue please \u003ca href=\"https://github.com/ankitwasankar/mftool-java/issues/new\"\u003eraise an issue\u003c/a\u003e.\n\n\u003ch4\u003eLiked the work ?\u003c/h4\u003e\nGive the repository a star :-)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fankitwasankar%2Fmftool-java","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fankitwasankar%2Fmftool-java","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fankitwasankar%2Fmftool-java/lists"}