JSON-Rohbericht maschinenlesbar
{
"data": {
"repo": {
"topics": [
"stock-market",
"data-extraction",
"stock-screener",
"quantitative-finance",
"quantitative-analysis",
"quantitative-trading"
],
"is_fork": false,
"size_kb": 68018,
"has_wiki": true,
"homepage": "https://vnstocks.com",
"languages": {
"Python": 1109972,
"Makefile": 1471
},
"pushed_at": "2026-07-24T10:59:32Z",
"created_at": "2022-02-27T02:44:34Z",
"owner_type": "User",
"updated_at": "2026-07-27T19:26:00Z",
"description": "A beginner-friendly yet powerful Python toolkit for financial analysis and automation — built to make modern investing accessible to everyone",
"is_archived": false,
"is_disabled": false,
"license_spdx": null,
"default_branch": "main",
"license_spdx_raw": "NOASSERTION",
"primary_language": "Python",
"significant_languages": [
"Python"
]
},
"owner": {
"blog": "vnstocks.com",
"name": "Thinh Vu",
"type": "User",
"login": "thinh-vu",
"company": "Vnstock",
"location": "Ho Chi Minh City, Vietnam",
"followers": 289,
"avatar_url": "https://avatars.githubusercontent.com/u/39723360?v=4",
"created_at": "2018-05-29T06:57:44Z",
"is_verified": null,
"public_repos": 26,
"account_age_days": 2981
},
"license": {
"state": "custom",
"spdx_id": null,
"raw_spdx": "NOASSERTION",
"file_present": true,
"scorecard_found": true,
"profile_has_license": true
},
"activity": {
"releases": [
{
"tag": "v4.0.4",
"kind": "patch",
"published_at": "2026-07-09T23:31:08Z"
},
{
"tag": "v4.0.2",
"kind": "patch",
"published_at": "2026-04-30T08:52:53Z"
},
{
"tag": "v3.5.0",
"kind": "minor",
"published_at": "2026-03-11T15:12:59Z"
},
{
"tag": "v3.4.0",
"kind": "minor",
"published_at": "2026-01-23T02:15:10Z"
},
{
"tag": "v3.3.0",
"kind": "minor",
"published_at": "2025-11-11T17:43:50Z"
},
{
"tag": "v3.2.7",
"kind": "patch",
"published_at": "2025-11-10T02:17:28Z"
},
{
"tag": "v2.2.3",
"kind": "patch",
"published_at": "2025-03-27T17:42:17Z"
},
{
"tag": "v3.2.2",
"kind": "patch",
"published_at": "2025-03-24T14:44:27Z"
},
{
"tag": "v3.2.1",
"kind": "patch",
"published_at": "2025-03-23T13:32:23Z"
}
],
"recent_commits": [
{
"oid": "72e6a75016da96173fd7dd26f1011e14fb3dfbf7",
"body": "…kground initialization",
"is_bot": false,
"headline": "feat: implement dynamic AI agent environment setup with automated bac…",
"author_name": "thinh-vu",
"author_login": "thinh-vu",
"committed_at": "2026-07-24T10:59:27Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "859870379127f9dc10824bf0d17d603836adbdee",
"body": null,
"is_bot": false,
"headline": "chore: remove changelog entry for automated JSON schema formatting",
"author_name": "Thinh Vu",
"author_login": "thinh-vu",
"committed_at": "2026-07-23T03:11:34Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "8c2f4d7ec0da6044e01930c7907d860cb5b6879b",
"body": "…nal skill loader, and enable integration test skips",
"is_bot": false,
"headline": "refactor: unify parameter handling for OHLCV methods, introduce inter…",
"author_name": "Thinh Vu",
"author_login": "thinh-vu",
"committed_at": "2026-07-09T23:29:14Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "60d469c6bf180d09b6483e364f80a384198b59df",
"body": "…n README.md",
"is_bot": false,
"headline": "docs: update installation instructions and repository documentation i…",
"author_name": "Thinh Vu",
"author_login": "thinh-vu",
"committed_at": "2026-06-26T13:11:23Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "e411bb33cb98ac765fff9897b0b3af11dd5bc953",
"body": "…shots, and improve data fetching robustness",
"is_bot": false,
"headline": "refactor: update developer guidelines, standardize documentation snap…",
"author_name": "Thinh Vu",
"author_login": "thinh-vu",
"committed_at": "2026-06-26T13:07:20Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "5bf05e3e494b1d109750c143e964945ed7be3f7d",
"body": null,
"is_bot": false,
"headline": "Merge branch 'main' of https://github.com/thinh-vu/vnstock",
"author_name": "Thinh Vu",
"author_login": "thinh-vu",
"committed_at": "2026-05-16T02:29:16Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "c196bc599fd71471686df77334725dc42302b1f8",
"body": "…e MSN data resolution logic",
"is_bot": false,
"headline": "feat: add bond market support, improve VCI symbol handling, and updat…",
"author_name": "Thinh Vu",
"author_login": "thinh-vu",
"committed_at": "2026-05-16T02:29:05Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "c62449db8ed489466cbbe574ecbe9f15545d3a25",
"body": "…on to interval across all market domains",
"is_bot": false,
"headline": "refactor: standardize historical data parameters by renaming resoluti…",
"author_name": "thinh-vu",
"author_login": "thinh-vu",
"committed_at": "2026-05-13T00:23:02Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "d129a7f31739f8378b5741547f98264dd463ae9d",
"body": null,
"is_bot": false,
"headline": "chore: remove tracked .DS_Store files and ignore them",
"author_name": "thinh-vu",
"author_login": "thinh-vu",
"committed_at": "2026-05-02T10:19:44Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "2e38cbd583f1413b880f50c92b6b6b14642d1e32",
"body": "…ipt for data validation",
"is_bot": false,
"headline": "feat: add comprehensive data schema snapshots and generate helper scr…",
"author_name": "thinh-vu",
"author_login": "thinh-vu",
"committed_at": "2026-05-02T07:43:23Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "c4d2c3b4d81df0b54ad708b51ad2b3cb6f9b23af",
"body": "…nded test coverage, and cleanup of legacy assets.",
"is_bot": false,
"headline": "refactor: overhaul codebase structure with unified UI framework, expa…",
"author_name": "thinh-vu",
"author_login": "thinh-vu",
"committed_at": "2026-05-01T23:57:46Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "ad78af0a4b57fa5bd0f550e0f2958267049e1851",
"body": "…ation logic in common module",
"is_bot": false,
"headline": "refactor: remove redundant UI info methods and centralize index valid…",
"author_name": "thinh-vu",
"author_login": "thinh-vu",
"committed_at": "2026-04-28T21:14:58Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "2e1b6fdcb430c8f7c6bdfa7a76d6fd0e85a79c0f",
"body": null,
"is_bot": false,
"headline": "chore: update Colab and Codespaces links in documentation notebooks",
"author_name": "Thinh Vu",
"author_login": "thinh-vu",
"committed_at": "2026-04-28T11:10:59Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "12c6547e914091f376b21db32f8192bedead253d",
"body": "…orator and enhance MSN historical data timezone handling",
"is_bot": false,
"headline": "refactor: standardize provider execution using optimize_execution dec…",
"author_name": "Thinh Vu",
"author_login": "thinh-vu",
"committed_at": "2026-04-28T05:53:48Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "dc7eca00c12f5d3e5469dcafa47714a834025320",
"body": "feat: implement modular domain-driven UI layer for market, reference, fundamental, and broker data services",
"is_bot": false,
"headline": "release: Vnstock 4.0",
"author_name": "Thinh Vu",
"author_login": "thinh-vu",
"committed_at": "2026-04-28T00:46:36Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "3bf3519b9770daa38e2138f135109b8bb1843c72",
"body": "… filtering, custom limits, and transposed output format",
"is_bot": false,
"headline": "refactor: update VCI financial report data fetching to support period…",
"author_name": "thinh-vu",
"author_login": "thinh-vu",
"committed_at": "2026-04-27T01:26:44Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "d87da7be4c9612b6a272a5d74e87ed9e65e437d9",
"body": "…y detection logic",
"is_bot": false,
"headline": "refactor: update VCI API endpoints to REST and improve sponsor librar…",
"author_name": "thinh-vu",
"author_login": "thinh-vu",
"committed_at": "2026-04-26T15:40:30Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "fd510b94fc1342d41bc0ab7a7798f51b07cc7c29",
"body": null,
"is_bot": false,
"headline": "chore: update project dependencies and metadata in pyproject.toml",
"author_name": "thinh-vu",
"author_login": "thinh-vu",
"committed_at": "2026-04-05T20:14:31Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "b71b79b84a98f441eb979961c96bc76b023c3a8c",
"body": null,
"is_bot": false,
"headline": "refactor: remove TCBS source support and update test parameters to KBS",
"author_name": "thinh-vu",
"author_login": "thinh-vu",
"committed_at": "2026-04-05T20:06:04Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "cc12a093df9f6d5b90587efbc0583d5e4fe64d66",
"body": "…introduce sponsor migration utilities",
"is_bot": false,
"headline": "refactor: align KBS price board schema, add AI agent guardrails, and …",
"author_name": "thinh-vu",
"author_login": "thinh-vu",
"committed_at": "2026-04-05T19:38:27Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "db3609169d9ce8e8d0e8fbf59c4294c2b28ace8b",
"body": "…oject.toml.",
"is_bot": false,
"headline": "refactor: rename market-events.py to market_events.py and update pypr…",
"author_name": "Thinh Vu",
"author_login": "thinh-vu",
"committed_at": "2026-03-11T15:10:20Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "9d5bf9dca816e64e473276b353788ac5e61e4971",
"body": null,
"is_bot": false,
"headline": "feat: Add market events module and enhance upgrade suggestion messages.",
"author_name": "Thinh Vu",
"author_login": "thinh-vu",
"committed_at": "2026-03-08T15:16:02Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "c0ca6963761dddb027b019913da3bc115db289e3",
"body": null,
"is_bot": false,
"headline": "chore: bump version to 3.4.3 in pyproject.toml",
"author_name": "Thinh Vu",
"author_login": "thinh-vu",
"committed_at": "2026-03-07T01:01:33Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "5039406065c623e1042d37b9bedf68cad8d2a775",
"body": "… commands",
"is_bot": false,
"headline": "feat: Enhance upgrade process with environment detection and tailored…",
"author_name": "Thinh Vu",
"author_login": "thinh-vu",
"committed_at": "2026-03-07T01:01:14Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "e27b4c8964fa3fbee0ba93edef90c255def1ccc1",
"body": null,
"is_bot": false,
"headline": "feat: Add market events utility module.",
"author_name": "Thinh Vu",
"author_login": "thinh-vu",
"committed_at": "2026-03-06T22:30:39Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "100e84091ecb6ad5b6b7a828b657dabb118a9d65",
"body": null,
"is_bot": false,
"headline": "Remove TCBS data provider and Screener API.",
"author_name": "Thinh Vu",
"author_login": "thinh-vu",
"committed_at": "2026-03-05T16:18:01Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "1d33198eac5a92f2219fc5480e399e1b1491864e",
"body": "…ng in data processing",
"is_bot": false,
"headline": "feat: add pandas compatibility utilities and enhance frequency handli…",
"author_name": "Thinh Vu",
"author_login": "thinh-vu",
"committed_at": "2026-03-02T09:14:43Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "613e1ced572fdb4e1d51444714ad29cc8bb39dd7",
"body": "… verification",
"is_bot": false,
"headline": "fix: update Python script execution method in CI workflow for API key…",
"author_name": "Thinh Vu",
"author_login": "thinh-vu",
"committed_at": "2026-03-02T08:47:16Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "f02ac5bb9396396350ae855f765d07bf6e54d669",
"body": "…ve linting and testing configurations",
"is_bot": false,
"headline": "feat: enhance CI workflows with API key setup and verification, impro…",
"author_name": "Thinh Vu",
"author_login": "thinh-vu",
"committed_at": "2026-03-02T08:42:59Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "dd675bb32705ae088d6f21d0171ab8552b004215",
"body": "* fix(deps): add pytz to project dependencies\n\n* chore: remove lockfile",
"is_bot": false,
"headline": "fix(deps): add pytz to project dependencies (#217)",
"author_name": "Minh Dang Hoang",
"author_login": "HMDank",
"committed_at": "2026-02-27T15:40:04Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "4917ae00485ac26c544155b1b6d67fd00a8a87bb",
"body": "…d Windows.",
"is_bot": false,
"headline": "docs: update agent guide file copying instructions for macOS/Linux an…",
"author_name": "Thinh Vu",
"author_login": "thinh-vu",
"committed_at": "2026-02-02T04:37:34Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "88e69706449f316d38e01ce9de78447e3d5e7814",
"body": "… lacks an exchange column.",
"is_bot": false,
"headline": "fix: Add fallback to fetch symbols by exchange if the initial listing…",
"author_name": "thinh-vu",
"author_login": "thinh-vu",
"committed_at": "2026-02-01T08:27:16Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "9c6f21bfe2764d0cd3263cbb917e952919784e30",
"body": null,
"is_bot": false,
"headline": "Merge branch 'main' of https://github.com/thinh-vu/vnstock",
"author_name": "thinh-vu",
"author_login": "thinh-vu",
"committed_at": "2026-02-01T07:15:23Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "ac0cd77f4adf44df95c4445be67a6bf8f8bf7c08",
"body": "…KBS field mappings, and update related API, utility, and test files.",
"is_bot": false,
"headline": "Refactor test documentation into a dedicated subdirectory, introduce …",
"author_name": "thinh-vu",
"author_login": "thinh-vu",
"committed_at": "2026-02-01T04:02:13Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "25bdfd95935318d15de1e6bb652115f45bc3b863",
"body": "…ex support, and refactor field normalization with built-in mappings.",
"is_bot": false,
"headline": "feat: Introduce derivative symbol conversion, enhance KBS and VCI ind…",
"author_name": "Thinh Vu",
"author_login": "thinh-vu",
"committed_at": "2026-01-27T16:39:32Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "e334389ba1b9cbcfd69ffe402948e530b484508a",
"body": "…ve redundant index methods",
"is_bot": false,
"headline": "refactor: update Listing class to enforce source requirement and remo…",
"author_name": "Thinh Vu",
"author_login": "thinh-vu",
"committed_at": "2026-01-23T07:11:57Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "3b01b33a1ca794ebebdfce154f4a66535c967358",
"body": "…and update Python version",
"is_bot": false,
"headline": "docs: enhance quickstart guide with Vnstock Agent Guide instructions …",
"author_name": "thinh-vu",
"author_login": "thinh-vu",
"committed_at": "2026-01-22T17:51:11Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "ab8cbc84dfb72253c3384e04c5ef5fe3e5b39259",
"body": "…file loading warnings",
"is_bot": false,
"headline": "refactor: update FieldHandler to use built-in KBS mappings and avoid …",
"author_name": "thinh-vu",
"author_login": "thinh-vu",
"committed_at": "2026-01-22T16:56:16Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "b8be61a2edfb065adade13502c7bc8397911a969",
"body": "…t.toml",
"is_bot": false,
"headline": "chore: update vnai dependency version from 2.3.0 to 2.3.9 in pyprojec…",
"author_name": "thinh-vu",
"author_login": "thinh-vu",
"committed_at": "2026-01-22T16:00:33Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "e7f698dde131f0800a2353a5745de5e63891271e",
"body": "… with 1,326 standardized field definitions\n\n- Replaced external JSON file loading with built-in dictionary containing comprehensive KBS financial field mappings\n- Added _load_builtin_mappings() method to initialize 1,326+ standardized field mappings internally\n- Included Vietnamese/English field names, snake_case conversions, and conflict resolution flags\n- Covers complete financial statement fields: income statement, balance sheet, cash flow statement",
"is_bot": false,
"headline": "refactor: convert KBSFieldMapper from file-based to built-in mappings…",
"author_name": "Thinh Vu",
"author_login": "thinh-vu",
"committed_at": "2026-01-22T15:56:33Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "ed56f0716c6febccdf80d41a6ff4f235e3a8510e",
"body": "…) method\n\n- Reordered df.attrs assignments to group interval/length before start/end dates\n- Removed count_back and get_all attributes from DataFrame metadata\n- Cleaned up inline comment for start attribute assignment",
"is_bot": false,
"headline": "refactor: reorganize DataFrame attributes order in KBS Quote.history(…",
"author_name": "Thinh Vu",
"author_login": "thinh-vu",
"committed_at": "2026-01-22T13:30:07Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "73d506fb8968ae33e9d31bf5117e4dd050934971",
"body": "…l workflows\n\n- Updated actions/upload-artifact from v3 to v4 in code-quality.yml (security report)\n- Updated actions/upload-artifact from v3 to v4 in coverage-report.yml (coverage artifacts)\n- Updated actions/upload-artifact from v3 to v4 in performance.yml (performance report)\n- Updated actions/upload-artifact from v3 to v4 in test.yml (distribution artifacts)",
"is_bot": false,
"headline": "chore: upgrade GitHub Actions upload-artifact from v3 to v4 across al…",
"author_name": "Thinh Vu",
"author_login": "thinh-vu",
"committed_at": "2026-01-22T06:05:37Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "6ee781823183453f99bafe68ea2a5b9b73e02b8b",
"body": "…ed TCBS comprehensive tests\n\n- Updated test coverage data (.coverage binary)\n- Added comprehensive CI/CD pipeline documentation in CHANGELOG (GitHub Actions, multi-platform testing, code quality checks)\n- Changed default source from VCI to KBS in integration and unit tests\n- Updated Vnstock.SUPPORTED_SOURCES to include KBS as first option\n- Removed 262-line test_tcbs_quote_comprehensive.py with legacy TCBS Quote tests\n- Removed 247",
"is_bot": false,
"headline": "chore: update test suite with KBS as default source and remove outdat…",
"author_name": "Thinh Vu",
"author_login": "thinh-vu",
"committed_at": "2026-01-22T06:02:03Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "826ec6c101b616d4f989ec1df45b716114275c23",
"body": "…k_ezchart fallback\n\n- Implemented automatic backend selection prioritizing vnstock_chart (professional) over vnstock_ezchart (fallback)\n- Added Chart class backend parameter for explicit charting library selection\n- Implemented vnstock_chart methods: line(), bar(), candle(), scatter(), boxplot(), heatmap()\n- Maintained vnstock_ezchart fallback support for all existing chart types\n- Added automatic chart rendering in Jupyter/IPython environments\n- Improve",
"is_bot": false,
"headline": "feat: add dual charting backend support with vnstock_chart and vnstoc…",
"author_name": "Thinh Vu",
"author_login": "thinh-vu",
"committed_at": "2026-01-22T05:49:46Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "9098665ca7bf336755e3a66d798d9111f3782db8",
"body": "…, advanced options, and helper functions for robust snake_case conversion.",
"is_bot": false,
"headline": "feat: Overhaul Vietnamese text normalization with a new character map…",
"author_name": "Thinh Vu",
"author_login": "thinh-vu",
"committed_at": "2026-01-20T15:25:29Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "8c64c963f86b82734bca09812a5811a2b836efc7",
"body": "- Added comprehensive AI-powered coding guide with step-by-step setup instructions\n- Documented support for 7 AI agents (Google Antigravity, Cursor, Windsurf, Claude Code, VS Code Copilot, Google Colab)\n- Added direct API key registration example with api_key parameter\n- Reorganized manual coding section under \"Traditional Usage\" heading\n- Fixed indentation for tier list items (Guest/Community/Sponsor) for better markdown rendering",
"is_bot": false,
"headline": "docs: add AI-powered vibe coding section and improve README formatting",
"author_name": "thinh-vu",
"author_login": "thinh-vu",
"committed_at": "2026-01-17T17:10:01Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "b36b255598cabd24376b9b4db8488b7b2f94c074",
"body": "- Added optional api_key parameter to register_user() function for programmatic registration\n- Implemented _register_api_key_directly() for non-interactive API key setup\n- Refactored interactive registration into separate _register_interactive() function\n- Added API key validation (minimum 10 characters) for direct registration\n- Display masked API key and tier information after successful direct registration\n- Added vnai module",
"is_bot": false,
"headline": "feat: add direct API key registration support with non-interactive mode",
"author_name": "thinh-vu",
"author_login": "thinh-vu",
"committed_at": "2026-01-17T17:09:51Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "f1103e388cb53cf3dbabd6a759e023a9673c05a0",
"body": null,
"is_bot": false,
"headline": "code optimized",
"author_name": "thinh-vu",
"author_login": "thinh-vu",
"committed_at": "2026-01-17T08:29:39Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "bc65d94e88e8acf28e97d168da3c10c5d9bda755",
"body": null,
"is_bot": false,
"headline": "code optimized",
"author_name": "thinh-vu",
"author_login": "thinh-vu",
"committed_at": "2026-01-17T08:22:08Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "638a51b9b35c87dcd316cda107d425517d868558",
"body": "- Changed registration URL from https://vnstocks.com/account to https://vnstocks.com/login in README\n- Updated Vietnamese and English documentation sections with new login endpoint\n- Modified quickstart notebook to reflect new registration URL\n- Updated auth.py registration instructions with corrected URL",
"is_bot": false,
"headline": "docs: update API key registration URL from /account to /login endpoint",
"author_name": "Thinh Vu",
"author_login": "thinh-vu",
"committed_at": "2026-01-16T16:52:40Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "3a7ba9fae8838b2eb41e7da6440e8d3aaaa340f7",
"body": "- Deleted 5_visualization_data_exploration_vnstock3.ipynb containing 2029 lines of legacy notebook content\n- Removed comprehensive examples covering data visualization and exploration techniques\n- Cleaned up outdated Colab and GitHub Codespaces references\n- Removed sample code demonstrating Quote.history, intraday data, and financial statement visualizations",
"is_bot": false,
"headline": "chore: remove outdated visualization and data exploration notebook",
"author_name": "Thinh Vu",
"author_login": "thinh-vu",
"committed_at": "2026-01-16T16:03:44Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "ebd9a9e9bf22ac99c8a35893ebe0f3335026a258",
"body": "- Added blank lines after blockquotes for better markdown rendering\n- Improved list item formatting with consistent spacing throughout document\n- Added comprehensive user authentication section documenting tier system (Guest/Community/Sponsor)\n- Updated code examples to use KBS as default data source and simplified parameters\n- Removed duplicate Company class import example\n- Fixed screener section to indicate TCBS API deprecation\n-",
"is_bot": false,
"headline": "docs: improve README formatting and add user authentication section",
"author_name": "Thinh Vu",
"author_login": "thinh-vu",
"committed_at": "2026-01-16T15:57:07Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "5ae7960cf359172f2a3bdb1a4a593001cfb18078",
"body": "… source migration\n\n- Added new section for 2026-01-16 release documenting KBS as default data source\n- Documented authentication utilities and lazy loading mechanism implementation\n- Listed removal of outdated Vietnam stock notebook and dev utilities\n- Updated Listing class default source change from VCI to KBS\n- Added tier and limits information display for API key registration\n- Fixed trailing newline in CHANGELOG.md",
"is_bot": false,
"headline": "chore: update CHANGELOG with version 3.4.0 release notes and KBS data…",
"author_name": "Thinh Vu",
"author_login": "thinh-vu",
"committed_at": "2026-01-16T15:42:35Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "d75127de6628e05819a67e90d125afbe693796bb",
"body": "- Deleted 1_vietnam_stock_vnstock3.ipynb containing 6497 lines of legacy notebook content\n- Removed outdated Colab and Deepnote references, Google Colab IP blocking warnings\n- Cleaned up comprehensive examples covering Listing, Quote, Company, Finance, and Trading modules\n- Updated .DS_Store binary file",
"is_bot": false,
"headline": "chore: remove outdated Vietnam stock notebook and update .DS_Store",
"author_name": "Thinh Vu",
"author_login": "thinh-vu",
"committed_at": "2026-01-16T15:14:43Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "259e6660dfebbb05bfb90769e3280bdddd7a667e",
"body": "…formation\n\n- Display masked API key (first 4 + last 4 chars with *** in middle) when checking existing registration\n- Show tier and limits information for registered users before prompting for key change\n- Simplify registration flow by removing unnecessary \"Press Enter\" step\n- Update registration success message to show masked key and tier details\n- Improve registration instructions with clearer formatting and emoji indicators\n-",
"is_bot": false,
"headline": "feat: enhance API key registration UX with masked display and tier in…",
"author_name": "Thinh Vu",
"author_login": "thinh-vu",
"committed_at": "2026-01-16T12:42:18Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "d07d12cc0a4fd39109b9b6d8481dd24d4f3c6d66",
"body": "…urce\n\n- Updated cell execution counts to reflect sequential notebook run\n- Refreshed listing data outputs showing different stock symbols and company names\n- Updated row counts from 1733 to 1565 for basic listing and 3210 to 1952 for all symbols\n- Modified column structure in all_symbols output to match KBS data format (removed product_grp_id and icb_code2, added id and en_organ_name)\n- Updated industry listing output to show new",
"is_bot": false,
"headline": "chore: update notebook execution outputs with latest data from KBS so…",
"author_name": "Thinh Vu",
"author_login": "thinh-vu",
"committed_at": "2026-01-16T12:17:12Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "12431ee3a294b64bb8a3af5822a3cdbb8a9feacf",
"body": "- Removed cleanup.py utility script and VCI finance mapping Excel file from dev directory\n- Updated Listing class to use KBS as default data source instead of VCI\n- Modified StockComponents to initialize listing with KBS source\n- Updated error message to include KBS in valid source options\n- Cleaned up notebook documentation removing outdated Deepnote reference and simplifying setup instructions\n- Updated notebook outputs to reflect",
"is_bot": false,
"headline": "chore: remove dev utilities and update data source configuration",
"author_name": "Thinh Vu",
"author_login": "thinh-vu",
"committed_at": "2026-01-16T11:37:07Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "f398acd1498002e9c4840d2ba052d7f063321820",
"body": "- Updated version from 3.3.2 to 3.4.0\n- Added KBS as new default data source, replacing VCI as primary source\n- Added authentication utilities for public uses with the Vnstock API key\n- Implemented lazy loading mechanism to prevent circular import deadlocks across multiple modules",
"is_bot": false,
"headline": "chore: bump version to 3.4.0 and add KBS data source support",
"author_name": "Thinh Vu",
"author_login": "thinh-vu",
"committed_at": "2026-01-16T10:13:02Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "8b9e679475d64344ec4b090d8c56f1284ea225a5",
"body": null,
"is_bot": false,
"headline": "Delete .DS_Store (#208)",
"author_name": "Thinh Vu",
"author_login": "thinh-vu",
"committed_at": "2026-01-06T16:53:19Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "ae3e76405984c104cde0bfa0e91678b69a58072d",
"body": "…files",
"is_bot": false,
"headline": "fix: add .DS_Store to .gitignore to prevent tracking of macOS system …",
"author_name": "Thinh Vu",
"author_login": "thinh-vu",
"committed_at": "2026-01-06T16:52:15Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "973689ea3c2aa00aa958dcb356ff3a53ad7b1a07",
"body": "- Added support for flexible lookback periods using 'length' parameter in Quote.history for both VCI and TCBS modules.\n- Introduced new utility functions in lookback.py for parsing lookback lengths and calculating start dates based on various criteria.\n- Updated history method to handle optional sta\n[…]\nng issues.\n- Refactored request handling in Quote and Trading classes to utilize centralized client.send_request for improved proxy management.\n- Updated CHANGELOG to reflect new features and changes.",
"is_bot": false,
"headline": "feat: Implement Smart Lookback feature in Quote.history",
"author_name": "Thinh Vu",
"author_login": "thinh-vu",
"committed_at": "2026-01-06T16:46:36Z",
"body_truncated": true,
"is_coding_agent": false
},
{
"oid": "c140d46bf6a47b3b7f270e9eb40a725a72f23b4d",
"body": null,
"is_bot": false,
"headline": "Update pyproject.toml",
"author_name": "Thinh Vu",
"author_login": "thinh-vu",
"committed_at": "2026-01-06T06:38:11Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "95b33df86a26942721e0a3acb89f2b082e715c78",
"body": "Co-authored-by: kaestrl <kaestreldev@gmail.com>",
"is_bot": false,
"headline": "add VN30 derivative quarter pattern (#207)",
"author_name": "Do Tuan Anh",
"author_login": "anhtuan23",
"committed_at": "2026-01-04T03:41:16Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "c95cdb2e147527002fd9b6351ab40d74948cc43f",
"body": "… versions and improve version parsing",
"is_bot": false,
"headline": "fix: enhance update_notice function to check for subscription package…",
"author_name": "Thinh Vu",
"author_login": "thinh-vu",
"committed_at": "2025-12-21T17:07:19Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "e4a30e5fc3ee9ac8394afa8ba912ecbc5a7b7de0",
"body": null,
"is_bot": false,
"headline": "Update upgrade.py (#202)",
"author_name": "Thinh Vu",
"author_login": "thinh-vu",
"committed_at": "2025-12-08T09:43:55Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "985116cd0085126ee25a7b7a911968408ef5fa85",
"body": "…ion (#193)",
"is_bot": false,
"headline": "fix: add price_vs_sma200 column for multi-language dictionary extract…",
"author_name": "Nguyễn Minh Đức",
"author_login": "nguyenminhduc24396",
"committed_at": "2025-11-14T03:07:50Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "7ed0f06ea2f9f7ad6a2e33071d0e1332326efbd8",
"body": "…notebook",
"is_bot": false,
"headline": "fix: Remove outdated Google Colab setup instructions from quickstart …",
"author_name": "thinh-vu",
"author_login": "thinh-vu",
"committed_at": "2025-11-12T00:44:22Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "0369c61b37bff2ce864ff4d1486b80651711ada2",
"body": "…ironment configuration",
"is_bot": false,
"headline": "fix: Update Google Colab setup in quickstart notebook, streamline env…",
"author_name": "thinh-vu",
"author_login": "thinh-vu",
"committed_at": "2025-11-12T00:33:53Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "4ff2813610ab4007f33cb5efee31173b1d55c884",
"body": "…and improve proxy guide",
"is_bot": false,
"headline": "chore: Update CHANGELOG.md for version 3.3.0, enhance documentation, …",
"author_name": "thinh-vu",
"author_login": "thinh-vu",
"committed_at": "2025-11-12T00:33:06Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "d410593f211a3f528e7e1db21fd105042b938789",
"body": "…art notebook links",
"is_bot": false,
"headline": "fix: Update .gitignore to include .DS_Store files and enhance quickst…",
"author_name": "thinh-vu",
"author_login": "thinh-vu",
"committed_at": "2025-11-11T18:01:41Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "97fab6a3cec94e26494f9a8da51e41501834a547",
"body": null,
"is_bot": false,
"headline": "fix: Update Google Colab instructions and remove Deepnote references",
"author_name": "thinh-vu",
"author_login": "thinh-vu",
"committed_at": "2025-11-11T17:51:02Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "b79ee4ba11ddfb8ead1b50db964f4f76b044f9c7",
"body": "…VCI proxy demo script",
"is_bot": false,
"headline": "feat: Update Proxy Management Guide, enhance proxy handling, and add …",
"author_name": "thinh-vu",
"author_login": "thinh-vu",
"committed_at": "2025-11-11T17:41:28Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "2c021e91d13e2157c7f99f0b4e97c0d49fd813a5",
"body": "…modules\n\n- Implemented extensive unit and integration tests for VCI Company and Finance, covering various methods and parameters.\n- Created comprehensive tests for VCI Listing, ensuring functionality across all methods and parameters.\n- Developed unit tests for VCI Quote, validating data fetching a\n[…]\nith proxy support, including proxy management and configuration.\n- Introduced a ProxyManager class for fetching and managing proxies, with functionality for testing proxy connectivity and performance.",
"is_bot": false,
"headline": "Add comprehensive tests for VCI Company, Finance, Listing, and Quote …",
"author_name": "thinh-vu",
"author_login": "thinh-vu",
"committed_at": "2025-11-11T17:22:48Z",
"body_truncated": true,
"is_coding_agent": false
},
{
"oid": "aaa0872f6f3e77a01764e0f6815eab4213cf447e",
"body": "…andardize interval formats\n\n- Updated FMPConfig and XNOConfig to raise errors when API keys are not found, providing clear instructions for setting environment variables.\n- Standardized interval formats across the codebase to use '1D', '1H', '1W', '1M' for daily, hourly, weekly, and monthly interva\n[…]\nAdjusted quote modules for MSN, TCBS, and VCI to utilize standardized interval formats and improve error handling.\n- Removed deprecated code and cleaned up unnecessary comments for better readability.",
"is_bot": false,
"headline": "Refactor FMP and XNO API key handling, improve error messages, and st…",
"author_name": "Thinh Vu",
"author_login": "thinh-vu",
"committed_at": "2025-11-10T23:44:56Z",
"body_truncated": true,
"is_coding_agent": false
},
{
"oid": "7bc8ec5eeda5c107995975d985306405ccbc512e",
"body": null,
"is_bot": false,
"headline": "Implement feature X to enhance user experience and optimize performance",
"author_name": "Thinh Vu",
"author_login": "thinh-vu",
"committed_at": "2025-11-08T17:18:43Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "96aebb2f9690883df65aa7b15a0de4b4c3375124",
"body": "… modules in VCI and TCBS",
"is_bot": false,
"headline": "feat: Register providers for listing, company, financial, and trading…",
"author_name": "Thinh Vu",
"author_login": "thinh-vu",
"committed_at": "2025-11-08T17:13:02Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "ca612b4d7461096b1bb6326c3110394247b2e133",
"body": "… improve docstrings",
"is_bot": false,
"headline": "feat: Refactor DNSE Trade class to use BASE_URL for API endpoints and…",
"author_name": "Thinh Vu",
"author_login": "thinh-vu",
"committed_at": "2025-11-08T17:00:43Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "b87bb1c5fab5b1e5db1438da0a17fdc8b1386e51",
"body": "- Added ProviderRegistry class to manage data providers.\n- Implemented methods for registering, retrieving, and listing providers.\n- Included debug information and clear functionality for testing.\n- Supports multiple provider types and source names.",
"is_bot": false,
"headline": "feat: Implement Provider Registry System for vnstock",
"author_name": "Thinh Vu",
"author_login": "thinh-vu",
"committed_at": "2025-11-08T16:37:05Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "22188dde6c50bb2509b49ad8bfaf1e4ce3612a67",
"body": "…oạ mới\n\n---\nRefactor code structure for improved readability and maintainability",
"is_bot": false,
"headline": "Sửa lỗi quote cho khung thời gian nhỏ hơn 1D, bổ sung notebook minh h…",
"author_name": "Thinh Vu",
"author_login": "thinh-vu",
"committed_at": "2025-11-08T14:55:16Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "b99a6ec1d3d01de199c1d7440cc1800cebfd855f",
"body": "… module",
"is_bot": false,
"headline": "update dependencies and add standardized market constants and indices…",
"author_name": "Thinh Vu",
"author_login": "thinh-vu",
"committed_at": "2025-11-08T14:00:02Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "468df38e589cadaefa20936fe861cbc85c4b147c",
"body": null,
"is_bot": false,
"headline": "add vnstock_ezchart as a dependency in pyproject.toml",
"author_name": "Thinh Vu",
"author_login": "thinh-vu",
"committed_at": "2025-11-08T09:41:23Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "2cbdc2ec03e5febe2666b3b3cdc08610db5ea621",
"body": null,
"is_bot": false,
"headline": "remove vnai.setup() call to prevent circular import issues",
"author_name": "Thinh Vu",
"author_login": "thinh-vu",
"committed_at": "2025-11-08T03:44:24Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "4a5159206025f5a46b8efd2a07279863127d83ad",
"body": null,
"is_bot": false,
"headline": "cập nhật phiên bản vnstock, chuẩn hoá các hàm utils",
"author_name": "Thinh Vu",
"author_login": "thinh-vu",
"committed_at": "2025-11-08T02:06:20Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "660c943fd70d7eb775b8fb52f539f129f22cbd41",
"body": null,
"is_bot": false,
"headline": "sửa lỗi quote history tcbs",
"author_name": "Thinh Vu",
"author_login": "thinh-vu",
"committed_at": "2025-10-25T21:46:09Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "c5260a160736917919f8dac5c8e8774f79484e5c",
"body": null,
"is_bot": false,
"headline": "sửa lỗi xử lý dữ liệu api",
"author_name": "Thinh Vu",
"author_login": "thinh-vu",
"committed_at": "2025-10-25T21:41:35Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "fa16d031eba132862af387b7b4460962a7f4821c",
"body": null,
"is_bot": false,
"headline": "cập nhật sửa lỗi validation input cho interval",
"author_name": "Thinh Vu",
"author_login": "thinh-vu",
"committed_at": "2025-10-25T21:10:40Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "b7a31624a996d031b3c185932807208837fb15d2",
"body": null,
"is_bot": false,
"headline": "cập nhật requirements",
"author_name": "Thinh Vu",
"author_login": "thinh-vu",
"committed_at": "2025-10-25T20:02:33Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "c724e5247436e4d0aba2a3c96c8408fd2bd274a5",
"body": "… các api official",
"is_bot": false,
"headline": "cập nhật kiến trúc mới nhất cho vnstock 3.2.7 tích hợp fmp và xno như…",
"author_name": "Thinh Vu",
"author_login": "thinh-vu",
"committed_at": "2025-10-25T20:01:17Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "be7ef46c1ca68a9cd0cef562d125cf0d235cd17e",
"body": null,
"is_bot": false,
"headline": "Cập nhật readme, docs, context7",
"author_name": "Thinh Vu",
"author_login": "thinh-vu",
"committed_at": "2025-10-22T00:49:42Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "81939cd08e167dd257a543935c98ff0b5ae94300",
"body": null,
"is_bot": false,
"headline": "Bổ sung nguồn FMP & XNO - User cần lấy API KEY từ nguồn để sử dụng",
"author_name": "Thinh Vu",
"author_login": "thinh-vu",
"committed_at": "2025-10-22T00:21:57Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "551d6d1a02bc25e39f5e809ee29f37ea1753c428",
"body": null,
"is_bot": false,
"headline": "Fix directory deletion to handle read-only files",
"author_name": "Thinh Vu",
"author_login": "thinh-vu",
"committed_at": "2025-09-17T06:01:37Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "12778bb537d7c7cc62aeb7fa5fcf42ac2a7eb98a",
"body": null,
"is_bot": false,
"headline": "tinh chỉnh code & thêm bộ constant",
"author_name": "thinh-vu",
"author_login": "thinh-vu",
"committed_at": "2025-09-06T01:51:28Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "9ba1725026017237dce2c2d6d50a2c11e4846f8e",
"body": null,
"is_bot": false,
"headline": "cập nhật screenshot",
"author_name": "thinh-vu",
"author_login": "thinh-vu",
"committed_at": "2025-08-03T17:10:16Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "30da6191fdbe370e8e7bbcddd60b432da2800977",
"body": "…hiều platform thay thế colab",
"is_bot": false,
"headline": "sửa lỗi chức năng visualization, thêm badge mở notebook minh hoạ từ n…",
"author_name": "thinh-vu",
"author_login": "thinh-vu",
"committed_at": "2025-08-03T17:08:19Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "f0f0751d1a3db0f1a13c5004cb35c820874861f8",
"body": null,
"is_bot": false,
"headline": "changes updated to v3.2.7",
"author_name": "thinh-vu",
"author_login": "thinh-vu",
"committed_at": "2025-08-03T16:19:00Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "b12314f46d80fe550a78c68046a88cabf69d8853",
"body": null,
"is_bot": false,
"headline": "sửa lỗi import thư viện",
"author_name": "thinh-vu",
"author_login": "thinh-vu",
"committed_at": "2025-07-26T14:20:26Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "bdc23e82e0d14ff723632dbb17e5d815e7f05103",
"body": null,
"is_bot": false,
"headline": "cập nhật module & utils",
"author_name": "Thinh Vu",
"author_login": "thinh-vu",
"committed_at": "2025-07-24T00:31:15Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "9bbb6b62e8789b2ea08b7ef3003a6af625444fb2",
"body": "…port",
"is_bot": false,
"headline": "chore: migrate from setup.py to pyproject.toml and add ProxyConfig im…",
"author_name": "thinh-vu",
"author_login": "thinh-vu",
"committed_at": "2025-07-15T13:36:56Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "0d8a585bd3a6bbef5e56a6070b2ccf81131f7c15",
"body": "…tion and proxy list",
"is_bot": false,
"headline": "feat: improve HuggingFace proxy error message with Vietnamese transla…",
"author_name": "thinh-vu",
"author_login": "thinh-vu",
"committed_at": "2025-07-15T13:30:18Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "e8fe10d48da1cdb0a61c00e79941f18b7be76bb6",
"body": null,
"is_bot": false,
"headline": "feat: add proxy configuration support to VCI Quote class",
"author_name": "thinh-vu",
"author_login": "thinh-vu",
"committed_at": "2025-07-15T13:27:22Z",
"body_truncated": false,
"is_coding_agent": false
}
],
"releases_count": 9,
"commits_last_year": 95,
"latest_release_at": "2026-07-09T23:31:08Z",
"latest_release_tag": "v4.0.4",
"releases_from_tags": false,
"days_since_last_push": 3,
"active_weeks_last_year": 23,
"days_since_latest_release": 18,
"mean_days_between_releases": 59.2
},
"community": {
"has_readme": true,
"has_license": true,
"has_description": true,
"has_contributing": false,
"health_percentage": 42,
"has_issue_template": false,
"has_code_of_conduct": false,
"has_pull_request_template": false
},
"ecosystem": {
"packages": [
{
"name": "vnstock",
"exists": true,
"license": null,
"keywords": [
"vnstock",
"finance",
"vietnam",
"stock market",
"analysis",
"API",
"Development Status :: 5 - Production/Stable",
"Intended Audience :: Developers",
"Intended Audience :: Education",
"Intended Audience :: Financial and Insurance Industry",
"License :: Other/Proprietary License",
"Natural Language :: English",
"Natural Language :: Vietnamese",
"Operating System :: OS Independent",
"Programming Language :: Python :: 3",
"Programming Language :: Python :: 3.10",
"Programming Language :: Python :: 3.11",
"Programming Language :: Python :: 3.12",
"Programming Language :: Python :: 3.13",
"Programming Language :: Python :: 3.14",
"Topic :: Office/Business :: Financial :: Investment",
"Topic :: Software Development :: Libraries"
],
"ecosystem": "pypi",
"matches_repo": true,
"registry_url": "https://pypi.org/project/vnstock/",
"is_deprecated": false,
"latest_version": "4.0.5",
"repository_url": "https://github.com/thinh-vu/vnstock",
"versions_count": 66,
"total_downloads": null,
"dependents_count": null,
"deprecation_note": null,
"maintainers_count": null,
"monthly_downloads": null,
"first_published_at": "2022-02-26T17:07:08.414648Z",
"latest_published_at": "2026-07-24T10:58:04.064541Z",
"latest_version_yanked": null,
"days_since_latest_publish": 3
}
]
},
"popularity": {
"forks": 292,
"stars": 1358,
"watchers": 54,
"fork_history": {
"days": [
{
"date": "2022-08-30",
"count": 1
},
{
"date": "2022-09-06",
"count": 1
},
{
"date": "2022-10-06",
"count": 1
},
{
"date": "2022-10-18",
"count": 1
},
{
"date": "2022-11-23",
"count": 1
},
{
"date": "2022-11-30",
"count": 1
},
{
"date": "2022-12-15",
"count": 1
},
{
"date": "2022-12-25",
"count": 1
},
{
"date": "2023-01-17",
"count": 1
},
{
"date": "2023-01-20",
"count": 1
},
{
"date": "2023-01-23",
"count": 1
},
{
"date": "2023-01-29",
"count": 1
},
{
"date": "2023-02-01",
"count": 1
},
{
"date": "2023-02-03",
"count": 1
},
{
"date": "2023-02-17",
"count": 1
},
{
"date": "2023-03-05",
"count": 1
},
{
"date": "2023-03-08",
"count": 1
},
{
"date": "2023-03-09",
"count": 1
},
{
"date": "2023-03-18",
"count": 1
},
{
"date": "2023-04-01",
"count": 1
},
{
"date": "2023-04-02",
"count": 1
},
{
"date": "2023-04-06",
"count": 1
},
{
"date": "2023-04-09",
"count": 2
},
{
"date": "2023-04-19",
"count": 1
},
{
"date": "2023-04-30",
"count": 1
},
{
"date": "2023-05-07",
"count": 1
},
{
"date": "2023-05-10",
"count": 1
},
{
"date": "2023-05-17",
"count": 1
},
{
"date": "2023-05-18",
"count": 1
},
{
"date": "2023-05-21",
"count": 1
},
{
"date": "2023-05-26",
"count": 1
},
{
"date": "2023-05-29",
"count": 2
},
{
"date": "2023-05-31",
"count": 1
},
{
"date": "2023-06-14",
"count": 1
},
{
"date": "2023-06-19",
"count": 1
},
{
"date": "2023-06-22",
"count": 1
},
{
"date": "2023-06-27",
"count": 1
},
{
"date": "2023-06-28",
"count": 1
},
{
"date": "2023-06-30",
"count": 2
},
{
"date": "2023-07-03",
"count": 1
},
{
"date": "2023-07-05",
"count": 1
},
{
"date": "2023-07-17",
"count": 2
},
{
"date": "2023-07-18",
"count": 1
},
{
"date": "2023-07-24",
"count": 1
},
{
"date": "2023-07-26",
"count": 2
},
{
"date": "2023-07-27",
"count": 1
},
{
"date": "2023-07-28",
"count": 1
},
{
"date": "2023-08-09",
"count": 1
},
{
"date": "2023-08-14",
"count": 1
},
{
"date": "2023-08-20",
"count": 1
},
{
"date": "2023-08-22",
"count": 1
},
{
"date": "2023-08-25",
"count": 1
},
{
"date": "2023-08-27",
"count": 1
},
{
"date": "2023-09-26",
"count": 1
},
{
"date": "2023-09-27",
"count": 1
},
{
"date": "2023-10-01",
"count": 1
},
{
"date": "2023-10-03",
"count": 2
},
{
"date": "2023-10-12",
"count": 1
},
{
"date": "2023-10-15",
"count": 2
},
{
"date": "2023-10-21",
"count": 1
},
{
"date": "2023-10-29",
"count": 2
},
{
"date": "2023-11-03",
"count": 1
},
{
"date": "2023-11-07",
"count": 1
},
{
"date": "2023-11-10",
"count": 1
},
{
"date": "2023-11-11",
"count": 1
},
{
"date": "2023-12-02",
"count": 1
},
{
"date": "2023-12-07",
"count": 1
},
{
"date": "2023-12-21",
"count": 1
},
{
"date": "2023-12-22",
"count": 1
},
{
"date": "2023-12-26",
"count": 1
},
{
"date": "2023-12-27",
"count": 1
},
{
"date": "2023-12-29",
"count": 1
},
{
"date": "2024-01-02",
"count": 1
},
{
"date": "2024-01-09",
"count": 1
},
{
"date": "2024-01-18",
"count": 1
},
{
"date": "2024-01-28",
"count": 1
},
{
"date": "2024-01-30",
"count": 1
},
{
"date": "2024-02-05",
"count": 1
},
{
"date": "2024-02-15",
"count": 1
},
{
"date": "2024-02-18",
"count": 1
},
{
"date": "2024-02-20",
"count": 1
},
{
"date": "2024-02-21",
"count": 1
},
{
"date": "2024-02-22",
"count": 1
},
{
"date": "2024-02-25",
"count": 1
},
{
"date": "2024-03-04",
"count": 1
},
{
"date": "2024-03-16",
"count": 1
},
{
"date": "2024-03-20",
"count": 1
},
{
"date": "2024-03-30",
"count": 1
},
{
"date": "2024-04-08",
"count": 1
},
{
"date": "2024-04-16",
"count": 1
},
{
"date": "2024-05-17",
"count": 1
},
{
"date": "2024-05-25",
"count": 1
},
{
"date": "2024-05-26",
"count": 1
},
{
"date": "2024-05-31",
"count": 1
},
{
"date": "2024-06-06",
"count": 1
},
{
"date": "2024-06-07",
"count": 1
},
{
"date": "2024-06-10",
"count": 1
},
{
"date": "2024-06-19",
"count": 1
},
{
"date": "2024-06-29",
"count": 1
},
{
"date": "2024-07-05",
"count": 1
},
{
"date": "2024-07-09",
"count": 1
},
{
"date": "2024-07-21",
"count": 1
},
{
"date": "2024-07-28",
"count": 1
},
{
"date": "2024-08-08",
"count": 1
},
{
"date": "2024-08-21",
"count": 1
},
{
"date": "2024-09-01",
"count": 1
},
{
"date": "2024-09-12",
"count": 1
},
{
"date": "2024-09-15",
"count": 1
},
{
"date": "2024-09-23",
"count": 2
},
{
"date": "2024-10-03",
"count": 1
},
{
"date": "2024-10-10",
"count": 1
},
{
"date": "2024-10-17",
"count": 1
},
{
"date": "2024-10-21",
"count": 1
},
{
"date": "2024-11-01",
"count": 2
},
{
"date": "2024-11-06",
"count": 1
},
{
"date": "2024-11-12",
"count": 1
},
{
"date": "2024-11-13",
"count": 1
},
{
"date": "2024-11-16",
"count": 1
},
{
"date": "2024-11-25",
"count": 1
},
{
"date": "2024-12-17",
"count": 1
},
{
"date": "2025-01-02",
"count": 1
},
{
"date": "2025-01-12",
"count": 1
},
{
"date": "2025-01-24",
"count": 1
},
{
"date": "2025-01-25",
"count": 2
},
{
"date": "2025-02-04",
"count": 1
},
{
"date": "2025-02-19",
"count": 1
},
{
"date": "2025-02-22",
"count": 1
},
{
"date": "2025-02-24",
"count": 2
},
{
"date": "2025-02-25",
"count": 1
},
{
"date": "2025-03-02",
"count": 1
},
{
"date": "2025-03-09",
"count": 1
},
{
"date": "2025-03-10",
"count": 1
},
{
"date": "2025-03-12",
"count": 1
},
{
"date": "2025-03-14",
"count": 1
},
{
"date": "2025-03-21",
"count": 3
},
{
"date": "2025-03-22",
"count": 1
},
{
"date": "2025-03-25",
"count": 1
},
{
"date": "2025-03-27",
"count": 1
},
{
"date": "2025-03-28",
"count": 1
},
{
"date": "2025-04-05",
"count": 1
},
{
"date": "2025-04-10",
"count": 1
},
{
"date": "2025-04-15",
"count": 1
},
{
"date": "2025-04-16",
"count": 1
},
{
"date": "2025-04-24",
"count": 1
},
{
"date": "2025-04-26",
"count": 1
},
{
"date": "2025-05-07",
"count": 2
},
{
"date": "2025-05-10",
"count": 1
},
{
"date": "2025-05-11",
"count": 1
},
{
"date": "2025-05-23",
"count": 1
},
{
"date": "2025-05-28",
"count": 1
},
{
"date": "2025-06-05",
"count": 1
},
{
"date": "2025-06-06",
"count": 3
},
{
"date": "2025-06-08",
"count": 1
},
{
"date": "2025-06-18",
"count": 1
},
{
"date": "2025-07-04",
"count": 2
},
{
"date": "2025-07-15",
"count": 1
},
{
"date": "2025-07-16",
"count": 1
},
{
"date": "2025-07-18",
"count": 1
},
{
"date": "2025-07-23",
"count": 1
},
{
"date": "2025-07-24",
"count": 1
},
{
"date": "2025-07-26",
"count": 1
},
{
"date": "2025-07-27",
"count": 1
},
{
"date": "2025-08-06",
"count": 1
},
{
"date": "2025-08-08",
"count": 1
},
{
"date": "2025-08-15",
"count": 1
},
{
"date": "2025-08-17",
"count": 1
},
{
"date": "2025-08-18",
"count": 1
},
{
"date": "2025-08-26",
"count": 2
},
{
"date": "2025-08-31",
"count": 1
},
{
"date": "2025-09-04",
"count": 2
},
{
"date": "2025-09-14",
"count": 1
},
{
"date": "2025-09-24",
"count": 1
},
{
"date": "2025-09-25",
"count": 1
},
{
"date": "2025-10-06",
"count": 2
},
{
"date": "2025-10-11",
"count": 1
},
{
"date": "2025-10-12",
"count": 1
},
{
"date": "2025-10-14",
"count": 1
},
{
"date": "2025-10-15",
"count": 1
},
{
"date": "2025-10-19",
"count": 1
},
{
"date": "2025-10-21",
"count": 1
},
{
"date": "2025-10-24",
"count": 1
},
{
"date": "2025-10-27",
"count": 1
},
{
"date": "2025-10-29",
"count": 1
},
{
"date": "2025-11-02",
"count": 1
},
{
"date": "2025-11-04",
"count": 2
},
{
"date": "2025-11-08",
"count": 1
},
{
"date": "2025-11-19",
"count": 1
},
{
"date": "2025-11-24",
"count": 1
},
{
"date": "2025-12-12",
"count": 1
},
{
"date": "2025-12-15",
"count": 2
},
{
"date": "2025-12-21",
"count": 1
},
{
"date": "2025-12-23",
"count": 1
},
{
"date": "2025-12-30",
"count": 1
},
{
"date": "2025-12-31",
"count": 2
},
{
"date": "2026-01-03",
"count": 1
},
{
"date": "2026-01-06",
"count": 1
},
{
"date": "2026-01-11",
"count": 1
},
{
"date": "2026-01-17",
"count": 1
},
{
"date": "2026-01-22",
"count": 1
},
{
"date": "2026-01-24",
"count": 1
},
{
"date": "2026-01-29",
"count": 1
},
{
"date": "2026-02-07",
"count": 1
},
{
"date": "2026-02-08",
"count": 1
},
{
"date": "2026-02-25",
"count": 1
},
{
"date": "2026-02-26",
"count": 1
},
{
"date": "2026-02-28",
"count": 1
},
{
"date": "2026-03-03",
"count": 1
},
{
"date": "2026-03-06",
"count": 1
},
{
"date": "2026-03-11",
"count": 3
},
{
"date": "2026-03-12",
"count": 1
},
{
"date": "2026-03-13",
"count": 1
},
{
"date": "2026-03-18",
"count": 2
},
{
"date": "2026-03-23",
"count": 1
},
{
"date": "2026-03-29",
"count": 2
},
{
"date": "2026-03-31",
"count": 1
},
{
"date": "2026-04-01",
"count": 1
},
{
"date": "2026-04-02",
"count": 5
},
{
"date": "2026-04-03",
"count": 2
},
{
"date": "2026-04-08",
"count": 1
},
{
"date": "2026-04-10",
"count": 1
},
{
"date": "2026-04-13",
"count": 2
},
{
"date": "2026-04-14",
"count": 1
},
{
"date": "2026-04-15",
"count": 1
},
{
"date": "2026-04-17",
"count": 1
},
{
"date": "2026-04-20",
"count": 1
},
{
"date": "2026-04-21",
"count": 2
},
{
"date": "2026-04-22",
"count": 2
},
{
"date": "2026-04-23",
"count": 1
},
{
"date": "2026-04-26",
"count": 1
},
{
"date": "2026-04-27",
"count": 1
},
{
"date": "2026-04-29",
"count": 3
},
{
"date": "2026-04-30",
"count": 1
},
{
"date": "2026-05-08",
"count": 1
},
{
"date": "2026-05-09",
"count": 1
},
{
"date": "2026-05-11",
"count": 1
},
{
"date": "2026-05-14",
"count": 1
},
{
"date": "2026-05-17",
"count": 1
},
{
"date": "2026-05-19",
"count": 1
},
{
"date": "2026-05-21",
"count": 1
},
{
"date": "2026-05-24",
"count": 1
},
{
"date": "2026-05-27",
"count": 1
},
{
"date": "2026-05-29",
"count": 1
},
{
"date": "2026-06-03",
"count": 1
},
{
"date": "2026-06-06",
"count": 1
},
{
"date": "2026-06-08",
"count": 1
},
{
"date": "2026-06-13",
"count": 1
},
{
"date": "2026-06-24",
"count": 2
},
{
"date": "2026-06-27",
"count": 1
},
{
"date": "2026-07-09",
"count": 1
},
{
"date": "2026-07-17",
"count": 1
},
{
"date": "2026-07-23",
"count": 1
}
],
"complete": true,
"collected": 290,
"total_forks": 292
},
"star_history": null,
"open_issues_and_prs": 0
},
"ai_readiness": {
"has_nix": false,
"example_dirs": [
"examples",
"notebooks"
],
"has_llms_txt": false,
"has_dockerfile": false,
"has_mcp_signal": false,
"bootstrap_files": [
"Makefile"
],
"api_schema_files": [],
"has_devcontainer": true,
"typecheck_configs": [],
"toolchain_manifests": [],
"largest_source_bytes": 55284,
"source_files_sampled": 151,
"oversized_source_files": 0,
"agent_instruction_files": [
"AGENTS.md"
],
"agent_instruction_max_bytes": 3903
},
"dependencies": {
"manifests": [
"pyproject.toml",
"requirements.txt"
],
"advisories": {
"error": null,
"scope": "published_package",
"source": "osv",
"findings": [],
"collected": true,
"malicious": [],
"truncated": false,
"by_severity": {},
"advisory_count": 0,
"affected_count": 0,
"assessed_count": 38,
"malicious_count": 0,
"assessed_package": "pypi:vnstock@4.0.5",
"unassessed_count": 0,
"direct_affected_count": 0
},
"ecosystems": [
"pypi"
],
"dependencies": [
{
"name": "requests",
"manifest": "pyproject.toml",
"ecosystem": "pypi",
"version_constraint": null
},
{
"name": "beautifulsoup4",
"manifest": "pyproject.toml",
"ecosystem": "pypi",
"version_constraint": null
},
{
"name": "pandas",
"manifest": "pyproject.toml",
"ecosystem": "pypi",
"version_constraint": null
},
{
"name": "seaborn",
"manifest": "pyproject.toml",
"ecosystem": "pypi",
"version_constraint": null
},
{
"name": "openpyxl",
"manifest": "pyproject.toml",
"ecosystem": "pypi",
"version_constraint": null
},
{
"name": "pydantic",
"manifest": "pyproject.toml",
"ecosystem": "pypi",
"version_constraint": null
},
{
"name": "psutil",
"manifest": "pyproject.toml",
"ecosystem": "pypi",
"version_constraint": null
},
{
"name": "packaging",
"manifest": "pyproject.toml",
"ecosystem": "pypi",
"version_constraint": ">=20.0"
},
{
"name": "importlib-metadata",
"manifest": "pyproject.toml",
"ecosystem": "pypi",
"version_constraint": ">=1.0"
},
{
"name": "tenacity",
"manifest": "pyproject.toml",
"ecosystem": "pypi",
"version_constraint": null
},
{
"name": "vnai",
"manifest": "pyproject.toml",
"ecosystem": "pypi",
"version_constraint": ">=2.5.2"
},
{
"name": "vnstock_ezchart",
"manifest": "pyproject.toml",
"ecosystem": "pypi",
"version_constraint": ">=1.0.1"
},
{
"name": "pytz",
"manifest": "pyproject.toml",
"ecosystem": "pypi",
"version_constraint": null
}
],
"all_dependencies": {
"error": null,
"source": "github-sbom",
"packages": [
{
"name": "beautifulsoup4",
"direct": true,
"version": null,
"ecosystem": "pypi"
},
{
"name": "importlib-metadata",
"direct": true,
"version": null,
"ecosystem": "pypi"
},
{
"name": "openpyxl",
"direct": true,
"version": null,
"ecosystem": "pypi"
},
{
"name": "openpyxl",
"direct": true,
"version": "3.1.2",
"ecosystem": "pypi"
},
{
"name": "packaging",
"direct": true,
"version": null,
"ecosystem": "pypi"
},
{
"name": "pandas",
"direct": true,
"version": null,
"ecosystem": "pypi"
},
{
"name": "psutil",
"direct": true,
"version": null,
"ecosystem": "pypi"
},
{
"name": "psutil",
"direct": true,
"version": "6.0.0",
"ecosystem": "pypi"
},
{
"name": "pydantic",
"direct": true,
"version": null,
"ecosystem": "pypi"
},
{
"name": "pytz",
"direct": true,
"version": null,
"ecosystem": "pypi"
},
{
"name": "requests",
"direct": true,
"version": null,
"ecosystem": "pypi"
},
{
"name": "seaborn",
"direct": true,
"version": null,
"ecosystem": "pypi"
},
{
"name": "seaborn",
"direct": true,
"version": "0.13.2",
"ecosystem": "pypi"
},
{
"name": "tenacity",
"direct": true,
"version": null,
"ecosystem": "pypi"
},
{
"name": "vnai",
"direct": true,
"version": null,
"ecosystem": "pypi"
},
{
"name": "vnstock-ezchart",
"direct": true,
"version": null,
"ecosystem": "pypi"
},
{
"name": "bs4",
"direct": false,
"version": "0.0.2",
"ecosystem": "pypi"
},
{
"name": "cryptography",
"direct": false,
"version": "42.0.5",
"ecosystem": "pypi"
},
{
"name": "fake-useragent",
"direct": false,
"version": "1.5.1",
"ecosystem": "pypi"
},
{
"name": "mkdocs-glightbox",
"direct": false,
"version": null,
"ecosystem": "pypi"
},
{
"name": "mkdocs-material",
"direct": false,
"version": null,
"ecosystem": "pypi"
},
{
"name": "mkdocs-rss-plugin",
"direct": false,
"version": null,
"ecosystem": "pypi"
},
{
"name": "pytest",
"direct": false,
"version": null,
"ecosystem": "pypi"
},
{
"name": "pytest-cov",
"direct": false,
"version": null,
"ecosystem": "pypi"
},
{
"name": "setuptools",
"direct": false,
"version": null,
"ecosystem": "pypi"
}
],
"collected": true,
"truncated": false,
"total_count": 25,
"direct_count": 16,
"indirect_count": 9
}
},
"maintainership": {
"issues": {
"open_prs": 0,
"merged_prs": 68,
"open_issues": 0,
"closed_ratio": 1,
"closed_issues": 132,
"closed_unmerged_prs": 23
},
"bus_factor": 1,
"bot_contributors": 0,
"top_contributors": [
{
"type": "User",
"login": "thinh-vu",
"commits": 448,
"avatar_url": "https://avatars.githubusercontent.com/u/39723360?v=4"
},
{
"type": "User",
"login": "tinktink23",
"commits": 5,
"avatar_url": "https://avatars.githubusercontent.com/u/144011136?v=4"
},
{
"type": "User",
"login": "nguyenminhduc24396",
"commits": 3,
"avatar_url": "https://avatars.githubusercontent.com/u/39340764?v=4"
},
{
"type": "User",
"login": "nvh95",
"commits": 2,
"avatar_url": "https://avatars.githubusercontent.com/u/8603085?v=4"
},
{
"type": "User",
"login": "phuocnt3110",
"commits": 1,
"avatar_url": "https://avatars.githubusercontent.com/u/46475398?v=4"
},
{
"type": "User",
"login": "anhtuan23",
"commits": 1,
"avatar_url": "https://avatars.githubusercontent.com/u/7277399?v=4"
},
{
"type": "User",
"login": "hieutrtr",
"commits": 1,
"avatar_url": "https://avatars.githubusercontent.com/u/7941154?v=4"
},
{
"type": "User",
"login": "HMDank",
"commits": 1,
"avatar_url": "https://avatars.githubusercontent.com/u/109755535?v=4"
},
{
"type": "User",
"login": "andrey-jef",
"commits": 1,
"avatar_url": "https://avatars.githubusercontent.com/u/81280428?v=4"
},
{
"type": "User",
"login": "hungdoit",
"commits": 1,
"avatar_url": "https://avatars.githubusercontent.com/u/13359053?v=4"
}
],
"contributors_sampled": 12,
"top_contributor_share": 0.961
},
"quality_signals": {
"has_ci": true,
"has_tests": true,
"ci_workflows": [
"code-quality.yml",
"coverage-report.yml",
"performance.yml",
"test.yml",
"verify-api-key.yml"
],
"has_docs_dir": true,
"linter_configs": [
".flake8"
],
"has_editorconfig": false,
"has_linter_config": true,
"has_precommit_config": true
},
"security_signals": {
"lockfiles": [],
"scorecard": {
"checks": [
{
"name": "Binary-Artifacts",
"score": 10,
"reason": "no binaries found in the repo",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#binary-artifacts"
},
{
"name": "Branch-Protection",
"score": 3,
"reason": "branch protection is not maximal on development and all release branches",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#branch-protection"
},
{
"name": "CI-Tests",
"score": 0,
"reason": "0 out of 1 merged PRs checked by a CI test -- score normalized to 0",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#ci-tests"
},
{
"name": "CII-Best-Practices",
"score": 0,
"reason": "no effort to earn an OpenSSF best practices badge detected",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#cii-best-practices"
},
{
"name": "Code-Review",
"score": 0,
"reason": "Found 1/30 approved changesets -- score normalized to 0",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#code-review"
},
{
"name": "Contributors",
"score": 3,
"reason": "project has 1 contributing companies or organizations -- score normalized to 3",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#contributors"
},
{
"name": "Dangerous-Workflow",
"score": 10,
"reason": "no dangerous workflow patterns detected",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#dangerous-workflow"
},
{
"name": "Dependency-Update-Tool",
"score": 0,
"reason": "no update tool detected",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#dependency-update-tool"
},
{
"name": "Fuzzing",
"score": 0,
"reason": "project is not fuzzed",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#fuzzing"
},
{
"name": "License",
"score": 9,
"reason": "license file detected",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#license"
},
{
"name": "Maintained",
"score": 10,
"reason": "11 commit(s) and 2 issue activity found in the last 90 days -- score normalized to 10",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#maintained"
},
{
"name": "Packaging",
"score": null,
"reason": "packaging workflow not detected",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#packaging"
},
{
"name": "Pinned-Dependencies",
"score": 0,
"reason": "dependency not pinned by hash detected -- score normalized to 0",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#pinned-dependencies"
},
{
"name": "SAST",
"score": 0,
"reason": "SAST tool is not run on all commits -- score normalized to 0",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#sast"
},
{
"name": "Security-Policy",
"score": 0,
"reason": "security policy file not detected",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#security-policy"
},
{
"name": "Signed-Releases",
"score": null,
"reason": "no releases found",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#signed-releases"
},
{
"name": "Token-Permissions",
"score": 0,
"reason": "detected GitHub workflow tokens with excessive permissions",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#token-permissions"
},
{
"name": "Vulnerabilities",
"score": 5,
"reason": "5 existing vulnerabilities detected",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#vulnerabilities"
}
],
"commit": "72e6a75016da96173fd7dd26f1011e14fb3dfbf7",
"ran_at": "2026-07-28T03:13:12Z",
"aggregate_score": 3.7,
"scorecard_version": "v5.5.0"
},
"has_codeql_workflow": false,
"has_security_policy": false,
"has_dependabot_config": false
},
"contribution_flow": {
"collected": true,
"ci_last_run_at": "2026-07-27T06:29:42Z",
"oldest_open_prs": [],
"last_merged_pr_at": "2026-02-27T15:40:05Z",
"ci_last_conclusion": "SUCCESS",
"oldest_open_issues": []
}
},
"config": {
"disabled_metrics": [],
"disabled_categories": [],
"disabled_components": {}
},
"source": {
"url": "https://github.com/thinh-vu/vnstock",
"host": "github.com",
"name": "vnstock",
"owner": "thinh-vu"
},
"metrics": {
"overall": {
"key": "overall",
"band": "good",
"name": "Overall health",
"note": null,
"notes": [],
"value": 70,
"inputs": {
"security": 50,
"vitality": 85,
"community": 64,
"governance": 62,
"engineering": 84
},
"components": []
},
"categories": [
{
"key": "vitality",
"band": "excellent",
"name": "Vitality",
"value": 85,
"weight": 0.22,
"metrics": [
{
"key": "development_activity",
"band": "good",
"name": "Development activity",
"note": null,
"notes": [],
"value": 80,
"inputs": {
"commits_last_year": 95,
"human_commit_share": 1,
"days_since_last_push": 3,
"active_weeks_last_year": 23
},
"components": [
{
"key": "push_recency",
"name": "Push recency",
"detail": "last push 3 days ago",
"points": 36,
"status": "met",
"details": [
{
"code": "push_recency",
"params": {
"days": 3
}
}
],
"max_points": 36
},
{
"key": "commit_cadence",
"name": "Commit cadence",
"detail": "23/52 weeks with commits",
"points": 15.9,
"status": "partial",
"details": [
{
"code": "commit_cadence_weeks",
"params": {
"weeks": 23
}
}
],
"max_points": 36
},
{
"key": "commit_volume",
"name": "Commit volume",
"detail": "95 commits in the last year",
"points": 17.8,
"status": "partial",
"details": [
{
"code": "commits_last_year",
"params": {
"count": 95
}
}
],
"max_points": 18
},
{
"key": "openssf_scorecard_maintained",
"name": "OpenSSF Scorecard: Maintained",
"detail": "11 commit(s) and 2 issue activity found in the last 90 days -- score normalized to 10",
"points": 10,
"status": "met",
"details": [],
"max_points": 10
}
]
},
{
"key": "release_discipline",
"band": "excellent",
"name": "Release discipline",
"note": "Excluded from scoring (no data or not applicable): OpenSSF Scorecard: Signed-Releases. Remaining weights renormalized.",
"notes": [
{
"code": "excluded_no_data",
"params": {
"components": [
"openssf_scorecard_signed_releases"
]
}
},
{
"code": "weights_renormalized",
"params": {}
}
],
"value": 92,
"inputs": {
"releases_count": 9,
"latest_release_tag": "v4.0.4",
"releases_from_tags": false,
"days_since_latest_release": 18,
"mean_days_between_releases": 59.2
},
"components": [
{
"key": "ships_releases",
"name": "Ships releases",
"detail": "9 releases published",
"points": 27,
"status": "met",
"details": [
{
"code": "releases_published",
"params": {
"count": 9
}
}
],
"max_points": 27
},
{
"key": "release_recency",
"name": "Release recency",
"detail": "latest release 18 days ago",
"points": 36,
"status": "met",
"details": [
{
"code": "release_recency",
"params": {
"days": 18
}
}
],
"max_points": 36
},
{
"key": "release_cadence",
"name": "Release cadence",
"detail": "a release every ~59.2 days",
"points": 19.8,
"status": "partial",
"details": [
{
"code": "release_cadence",
"params": {
"gap": 59.2
}
}
],
"max_points": 27
},
{
"key": "openssf_scorecard_signed_releases",
"name": "OpenSSF Scorecard: Signed-Releases",
"detail": "no releases found",
"points": 0,
"status": "excluded",
"details": [
{
"code": "no_data",
"params": {}
}
],
"max_points": 10
}
]
},
{
"key": "abandonment",
"band": "excellent",
"name": "Abandonment",
"note": null,
"notes": [],
"value": 100,
"inputs": {
"cap": null,
"state": "maintained",
"guards": [],
"signals": [],
"red_flag": false,
"multiplier_pct": 100,
"declared_reason": null,
"unverified_reason": null,
"unanswered_open_prs": null,
"unanswered_open_issues": null,
"days_since_last_merged_pr": null,
"days_since_last_human_commit": 3,
"days_since_last_human_commit_is_floor": false
},
"components": [
{
"key": "project_is_still_maintained",
"name": "Project is still maintained",
"detail": "last human commit 3 days ago",
"points": 100,
"status": "met",
"details": [
{
"code": "abandonment_maintained",
"params": {
"days": 3
}
}
],
"max_points": 100
}
]
}
],
"description": "Is the project alive — is code being written and are releases shipping?"
},
{
"key": "community",
"band": "moderate",
"name": "Community & Adoption",
"value": 64,
"weight": 0.18,
"metrics": [
{
"key": "popularity",
"band": "good",
"name": "Popularity & adoption",
"note": null,
"notes": [],
"value": 81,
"inputs": {
"forks": 292,
"stars": 1358,
"watchers": 54,
"growth_state": "unverified",
"growth_factor_pct": 100,
"growth_unverified_reason": "no_history"
},
"components": [
{
"key": "stars",
"name": "Stars",
"detail": "1,358 stars",
"points": 50.8,
"status": "partial",
"details": [
{
"code": "stars",
"params": {
"count": 1358
}
}
],
"max_points": 60
},
{
"key": "forks",
"name": "Forks",
"detail": "292 forks",
"points": 20.5,
"status": "partial",
"details": [
{
"code": "forks",
"params": {
"count": 292
}
}
],
"max_points": 25
},
{
"key": "watchers",
"name": "Watchers",
"detail": "54 watchers",
"points": 9.6,
"status": "partial",
"details": [
{
"code": "watchers",
"params": {
"count": 54
}
}
],
"max_points": 15
}
]
},
{
"key": "community_health",
"band": "at_risk",
"name": "Community health",
"note": null,
"notes": [],
"value": 44,
"inputs": {
"has_readme": true,
"has_license": true,
"has_contributing": false,
"has_issue_template": false,
"has_code_of_conduct": false,
"has_pull_request_template": false
},
"components": [
{
"key": "readme",
"name": "README",
"detail": null,
"points": 22.5,
"status": "met",
"details": [],
"max_points": 22.5
},
{
"key": "license",
"name": "License",
"detail": "license file present, not a recognized license",
"points": 16.9,
"status": "partial",
"details": [
{
"code": "license_custom",
"params": {}
}
],
"max_points": 22.5
},
{
"key": "contributing_guide",
"name": "CONTRIBUTING guide",
"detail": null,
"points": 0,
"status": "missed",
"details": [],
"max_points": 18
},
{
"key": "code_of_conduct",
"name": "Code of conduct",
"detail": null,
"points": 0,
"status": "missed",
"details": [],
"max_points": 13.5
},
{
"key": "issue_template",
"name": "Issue template",
"detail": null,
"points": 0,
"status": "missed",
"details": [],
"max_points": 7.2
},
{
"key": "pr_template",
"name": "PR template",
"detail": null,
"points": 0,
"status": "missed",
"details": [],
"max_points": 6.3
}
]
}
],
"description": "Does the project have users, downloads, attention, and a welcoming setup for contributors?"
},
{
"key": "governance",
"band": "moderate",
"name": "Sustainability & Governance",
"value": 62,
"weight": 0.24,
"metrics": [
{
"key": "maintainer_resilience",
"band": "critical",
"name": "Maintainer resilience (bus factor)",
"note": null,
"notes": [],
"value": 26,
"inputs": {
"bus_factor": 1,
"contributors_sampled": 12,
"top_contributor_share": 0.961
},
"components": [
{
"key": "bus_factor",
"name": "Bus factor",
"detail": "1 contributor(s) cover half of all commits",
"points": 9,
"status": "partial",
"details": [
{
"code": "bus_factor",
"params": {
"count": 1
}
}
],
"max_points": 54
},
{
"key": "commit_distribution",
"name": "Commit distribution",
"detail": "top contributor authored 96% of commits",
"points": 0.9,
"status": "partial",
"details": [
{
"code": "top_contributor_share",
"params": {
"share": 96
}
}
],
"max_points": 22.5
},
{
"key": "contributor_breadth",
"name": "Contributor breadth",
"detail": "12 contributors",
"points": 13.5,
"status": "met",
"details": [
{
"code": "contributors_sampled",
"params": {
"count": 12
}
}
],
"max_points": 13.5
},
{
"key": "openssf_scorecard_contributors",
"name": "OpenSSF Scorecard: Contributors",
"detail": "project has 1 contributing companies or organizations -- score normalized to 3",
"points": 3,
"status": "partial",
"details": [],
"max_points": 10
}
]
},
{
"key": "responsiveness",
"band": "good",
"name": "Issue & PR responsiveness",
"note": null,
"notes": [],
"value": 75,
"inputs": {
"merged_prs": 68,
"open_issues": 0,
"closed_issues": 132,
"issue_closed_ratio": 1,
"closed_unmerged_prs": 23
},
"components": [
{
"key": "issue_resolution",
"name": "Issue resolution",
"detail": "100% of issues closed",
"points": 46.8,
"status": "met",
"details": [
{
"code": "issues_closed_share",
"params": {
"share": 100
}
}
],
"max_points": 46.75
},
{
"key": "pr_acceptance",
"name": "PR acceptance",
"detail": "68/91 decided PRs merged",
"points": 28.6,
"status": "partial",
"details": [
{
"code": "decided_prs_merged",
"params": {
"merged": 68,
"decided": 91
}
}
],
"max_points": 38.25
},
{
"key": "openssf_scorecard_code_review",
"name": "OpenSSF Scorecard: Code-Review",
"detail": "Found 1/30 approved changesets -- score normalized to 0",
"points": 0,
"status": "missed",
"details": [],
"max_points": 15
}
]
},
{
"key": "stewardship",
"band": "moderate",
"name": "Ownership & stewardship",
"note": "Excluded from scoring (no data or not applicable): Verified domain. Remaining weights renormalized.",
"notes": [
{
"code": "excluded_no_data",
"params": {
"components": [
"verified_domain"
]
}
},
{
"code": "weights_renormalized",
"params": {}
}
],
"value": 63,
"inputs": {
"followers": 289,
"owner_type": "User",
"is_verified": null,
"owner_login": "thinh-vu",
"public_repos": 26,
"account_age_days": 2981
},
"components": [
{
"key": "ownership_backing",
"name": "Ownership backing",
"detail": "personal (user) account",
"points": 10,
"status": "partial",
"details": [
{
"code": "owner_personal",
"params": {}
}
],
"max_points": 30
},
{
"key": "verified_domain",
"name": "Verified domain",
"detail": "not applicable to user accounts",
"points": 0,
"status": "excluded",
"details": [
{
"code": "not_applicable_to_user_accounts",
"params": {}
}
],
"max_points": 20
},
{
"key": "owner_reach",
"name": "Owner reach",
"detail": "289 followers of thinh-vu",
"points": 17.7,
"status": "partial",
"details": [
{
"code": "owner_followers",
"params": {
"count": 289,
"login": "thinh-vu"
}
}
],
"max_points": 25
},
{
"key": "track_record",
"name": "Track record",
"detail": "26 public repos, account ~8 yr old",
"points": 22.4,
"status": "partial",
"details": [
{
"code": "public_repos",
"params": {
"count": 26
}
},
{
"code": "account_age_years",
"params": {
"years": 8
}
}
],
"max_points": 25
}
]
},
{
"key": "package_maintenance",
"band": "excellent",
"name": "Package maintenance",
"note": null,
"notes": [],
"value": 100,
"inputs": {
"packages": [
"vnstock"
],
"ecosystems": "pypi",
"any_deprecated": false,
"min_days_since_publish": 3
},
"components": [
{
"key": "published_resolvable",
"name": "Published & resolvable",
"detail": "1 package(s) on pypi",
"points": 25,
"status": "met",
"details": [
{
"code": "packages_published",
"params": {
"count": 1,
"ecosystems": "pypi"
}
}
],
"max_points": 25
},
{
"key": "publish_recency",
"name": "Publish recency",
"detail": "latest publish 3 days ago",
"points": 35,
"status": "met",
"details": [
{
"code": "publish_recency",
"params": {
"days": 3
}
}
],
"max_points": 35
},
{
"key": "version_history",
"name": "Version history",
"detail": "66 published versions",
"points": 20,
"status": "met",
"details": [
{
"code": "published_versions",
"params": {
"count": 66
}
}
],
"max_points": 20
},
{
"key": "not_deprecated",
"name": "Not deprecated",
"detail": "active, not deprecated or yanked",
"points": 20,
"status": "met",
"details": [
{
"code": "package_not_deprecated",
"params": {}
}
],
"max_points": 20
}
]
}
],
"description": "Will the project survive its people — bus factor, responsiveness, who backs it, and package upkeep?"
},
{
"key": "engineering",
"band": "good",
"name": "Engineering Quality",
"value": 84,
"weight": 0.2,
"metrics": [
{
"key": "engineering_practices",
"band": "good",
"name": "Engineering practices",
"note": null,
"notes": [],
"value": 74,
"inputs": {
"has_ci": true,
"has_tests": true,
"has_editorconfig": false,
"has_linter_config": true,
"has_precommit_config": true
},
"components": [
{
"key": "ci_workflows",
"name": "CI workflows",
"detail": "5 workflow(s)",
"points": 24,
"status": "met",
"details": [
{
"code": "ci_workflows",
"params": {
"count": 5
}
}
],
"max_points": 24
},
{
"key": "tests_present",
"name": "Tests present",
"detail": null,
"points": 24,
"status": "met",
"details": [],
"max_points": 24
},
{
"key": "linter_config",
"name": "Linter config",
"detail": ".flake8",
"points": 16,
"status": "met",
"details": [
{
"code": "file_list",
"params": {
"files": ".flake8"
}
}
],
"max_points": 16
},
{
"key": "pre_commit_hooks",
"name": "Pre-commit hooks",
"detail": null,
"points": 9.6,
"status": "met",
"details": [],
"max_points": 9.6
},
{
"key": "editorconfig",
"name": ".editorconfig",
"detail": null,
"points": 0,
"status": "missed",
"details": [],
"max_points": 6.4
},
{
"key": "openssf_scorecard_ci_tests",
"name": "OpenSSF Scorecard: CI-Tests",
"detail": "0 out of 1 merged PRs checked by a CI test -- score normalized to 0",
"points": 0,
"status": "missed",
"details": [],
"max_points": 20
}
]
},
{
"key": "documentation",
"band": "excellent",
"name": "Documentation",
"note": null,
"notes": [],
"value": 100,
"inputs": {
"topics": [
"stock-market",
"data-extraction",
"stock-screener",
"quantitative-finance",
"quantitative-analysis",
"quantitative-trading"
],
"has_wiki": true,
"homepage": "https://vnstocks.com",
"has_readme": true,
"has_docs_dir": true,
"has_description": true
},
"components": [
{
"key": "readme",
"name": "README",
"detail": null,
"points": 30,
"status": "met",
"details": [],
"max_points": 30
},
{
"key": "documentation_directory",
"name": "Documentation directory",
"detail": null,
"points": 25,
"status": "met",
"details": [],
"max_points": 25
},
{
"key": "documentation_homepage_site",
"name": "Documentation / homepage site",
"detail": "https://vnstocks.com",
"points": 15,
"status": "met",
"details": [],
"max_points": 15
},
{
"key": "repository_description",
"name": "Repository description",
"detail": null,
"points": 10,
"status": "met",
"details": [],
"max_points": 10
},
{
"key": "topics",
"name": "Topics",
"detail": "6 topics",
"points": 10,
"status": "met",
"details": [
{
"code": "topics_count",
"params": {
"count": 6
}
}
],
"max_points": 10
},
{
"key": "wiki",
"name": "Wiki",
"detail": null,
"points": 10,
"status": "met",
"details": [],
"max_points": 10
}
]
}
],
"description": "Are baseline engineering and documentation practices in place?"
},
{
"key": "security",
"band": "moderate",
"name": "Security",
"value": 50,
"weight": 0.16,
"metrics": [
{
"key": "security_posture",
"band": "at_risk",
"name": "Security posture",
"note": "Excluded from scoring (no data or not applicable): Packaging, Signed-Releases. Remaining weights renormalized.",
"notes": [
{
"code": "excluded_no_data",
"params": {
"components": [
"packaging",
"signed_releases"
]
}
},
{
"code": "weights_renormalized",
"params": {}
}
],
"value": 37,
"inputs": {
"source": "openssf_scorecard",
"checks_evaluated": 16,
"scorecard_version": "v5.5.0",
"checks_inconclusive": 2,
"scorecard_aggregate": 3.7
},
"components": [
{
"key": "binary_artifacts",
"name": "Binary-Artifacts",
"detail": "no binaries found in the repo",
"points": 7.5,
"status": "met",
"details": [],
"max_points": 7.5
},
{
"key": "branch_protection",
"name": "Branch-Protection",
"detail": "branch protection is not maximal on development and all release branches",
"points": 2.2,
"status": "partial",
"details": [],
"max_points": 7.5
},
{
"key": "ci_tests",
"name": "CI-Tests",
"detail": "0 out of 1 merged PRs checked by a CI test -- score normalized to 0",
"points": 0,
"status": "missed",
"details": [],
"max_points": 2.5
},
{
"key": "cii_best_practices",
"name": "CII-Best-Practices",
"detail": "no effort to earn an OpenSSF best practices badge detected",
"points": 0,
"status": "missed",
"details": [],
"max_points": 2.5
},
{
"key": "code_review",
"name": "Code-Review",
"detail": "Found 1/30 approved changesets -- score normalized to 0",
"points": 0,
"status": "missed",
"details": [],
"max_points": 7.5
},
{
"key": "contributors",
"name": "Contributors",
"detail": "project has 1 contributing companies or organizations -- score normalized to 3",
"points": 0.8,
"status": "partial",
"details": [],
"max_points": 2.5
},
{
"key": "dangerous_workflow",
"name": "Dangerous-Workflow",
"detail": "no dangerous workflow patterns detected",
"points": 10,
"status": "met",
"details": [],
"max_points": 10
},
{
"key": "dependency_update_tool",
"name": "Dependency-Update-Tool",
"detail": "no update tool detected",
"points": 0,
"status": "missed",
"details": [],
"max_points": 7.5
},
{
"key": "fuzzing",
"name": "Fuzzing",
"detail": "project is not fuzzed",
"points": 0,
"status": "missed",
"details": [],
"max_points": 5
},
{
"key": "license",
"name": "License",
"detail": "license file detected",
"points": 2.2,
"status": "partial",
"details": [],
"max_points": 2.5
},
{
"key": "maintained",
"name": "Maintained",
"detail": "11 commit(s) and 2 issue activity found in the last 90 days -- score normalized to 10",
"points": 7.5,
"status": "met",
"details": [],
"max_points": 7.5
},
{
"key": "packaging",
"name": "Packaging",
"detail": "packaging workflow not detected",
"points": 0,
"status": "excluded",
"details": [
{
"code": "no_data",
"params": {}
}
],
"max_points": 5
},
{
"key": "pinned_dependencies",
"name": "Pinned-Dependencies",
"detail": "dependency not pinned by hash detected -- score normalized to 0",
"points": 0,
"status": "missed",
"details": [],
"max_points": 5
},
{
"key": "sast",
"name": "SAST",
"detail": "SAST tool is not run on all commits -- score normalized to 0",
"points": 0,
"status": "missed",
"details": [],
"max_points": 5
},
{
"key": "security_policy",
"name": "Security-Policy",
"detail": "security policy file not detected",
"points": 0,
"status": "missed",
"details": [],
"max_points": 5
},
{
"key": "signed_releases",
"name": "Signed-Releases",
"detail": "no releases found",
"points": 0,
"status": "excluded",
"details": [
{
"code": "no_data",
"params": {}
}
],
"max_points": 7.5
},
{
"key": "token_permissions",
"name": "Token-Permissions",
"detail": "detected GitHub workflow tokens with excessive permissions",
"points": 0,
"status": "missed",
"details": [],
"max_points": 7.5
},
{
"key": "vulnerabilities",
"name": "Vulnerabilities",
"detail": "5 existing vulnerabilities detected",
"points": 3.8,
"status": "partial",
"details": [],
"max_points": 7.5
}
]
},
{
"key": "dependency_advisories",
"band": "excellent",
"name": "Dependency advisories",
"note": "Excluded from scoring (no data or not applicable): No advisories left outstanding. Remaining weights renormalized. Matched the pypi:vnstock@4.0.5 runtime dependency closure — what installing the published package pulls in — 38 packages. Reachability is not analyzed.",
"notes": [
{
"code": "excluded_no_data",
"params": {
"components": [
"no_advisories_left_outstanding"
]
}
},
{
"code": "weights_renormalized",
"params": {}
},
{
"code": "advisories_scope_published",
"params": {
"package": "pypi:vnstock@4.0.5",
"assessed": 38
}
},
{
"code": "advisories_reachability",
"params": {}
}
],
"value": 100,
"inputs": {
"source": "osv",
"advisories": 0,
"affected_packages": 0,
"assessed_packages": 38,
"unassessed_packages": 0,
"affected_by_severity": "none",
"direct_affected_packages": 0
},
"components": [
{
"key": "direct_dependencies_free_of_known_advisories",
"name": "Direct dependencies free of known advisories",
"detail": "no direct dependency carries a known advisory",
"points": 35,
"status": "met",
"details": [
{
"code": "no_direct_advisories",
"params": {}
}
],
"max_points": 35
},
{
"key": "indirect_dependencies_free_of_known_advisories",
"name": "Indirect dependencies free of known advisories",
"detail": "no indirect dependency carries a known advisory",
"points": 25,
"status": "met",
"details": [
{
"code": "no_indirect_advisories",
"params": {}
}
],
"max_points": 25
},
{
"key": "no_advisories_left_outstanding",
"name": "No advisories left outstanding",
"detail": "no advisory carries a publication date",
"points": 0,
"status": "excluded",
"details": [
{
"code": "advisories_no_publication_date",
"params": {}
}
],
"max_points": 40
}
]
},
{
"key": "malicious_dependencies",
"band": "excellent",
"name": "Malicious dependencies",
"note": null,
"notes": [],
"value": 100,
"inputs": {
"source": "osv",
"meaning": "reported as a malicious package by the OpenSSF corpus; the remedy is removal or moving off the compromised name, never an upgrade of the same artifact. Versions the registry has since pulled are listed but not scored",
"packages": [],
"red_flag": false,
"assessed_packages": 38,
"malicious_packages": 0,
"direct_malicious_packages": 0,
"withdrawn_malicious_packages": 0,
"installable_malicious_packages": 0
},
"components": [
{
"key": "no_dependency_reported_as_a_malicious_package",
"name": "No dependency reported as a malicious package",
"detail": "no dependency is reported as a malicious package",
"points": 100,
"status": "met",
"details": [
{
"code": "no_malicious_dependencies",
"params": {}
}
],
"max_points": 100
}
]
},
{
"key": "high_risk_jurisdiction_exposure",
"band": "excellent",
"name": "High-Risk Jurisdiction Exposure",
"note": "Only high-confidence self-published location evidence affects this multiplier. Ambiguous matches are review-only; country evidence is not proof of nationality, citizenship, legal registration, malicious intent, or sanctions status.",
"notes": [
{
"code": "jurisdiction_evidence_limits",
"params": {}
}
],
"value": 100,
"inputs": {
"meaning": "self-published location evidence; not nationality or citizenship",
"red_flag": false,
"exposures": [],
"policy_countries": [
"Russia",
"Iran",
"North Korea"
],
"review_only_matches": 0,
"assessed_self_published_locations": 8
},
"components": [
{
"key": "policy_exposure_multiplier",
"name": "Policy exposure multiplier",
"detail": "no confirmed policy-scope location match",
"points": 100,
"status": "met",
"details": [
{
"code": "jurisdiction_no_match",
"params": {}
}
],
"max_points": 100
}
]
}
],
"description": "Are visible security and supply-chain practices strong, with no malicious dependency and no unresolved high-risk jurisdiction exposure?"
},
{
"key": "ai_readiness",
"band": "moderate",
"name": "AI Readiness",
"value": 64,
"weight": 0,
"metrics": [
{
"key": "ai_agent_context",
"band": "good",
"name": "Agent context & guidance",
"note": null,
"notes": [],
"value": 84,
"inputs": {
"has_llms_txt": false,
"legible_history_share": 0.74,
"agent_instruction_files": [
"AGENTS.md"
],
"agent_instruction_max_bytes": 3903
},
"components": [
{
"key": "agent_instructions",
"name": "Agent instructions",
"detail": "AGENTS.md",
"points": 45,
"status": "met",
"details": [
{
"code": "file_list",
"params": {
"files": "AGENTS.md"
}
}
],
"max_points": 45
},
{
"key": "machine_readable_docs_llms_txt",
"name": "Machine-readable docs (llms.txt)",
"detail": null,
"points": 0,
"status": "missed",
"details": [],
"max_points": 15
},
{
"key": "legible_commit_history",
"name": "Legible commit history",
"detail": "74 of 100 human commits state their intent (structured subject or explanatory body)",
"points": 39.5,
"status": "partial",
"details": [
{
"code": "legible_history",
"params": {
"legible": 74,
"sampled": 100
}
}
],
"max_points": 40
}
]
},
{
"key": "ai_verify_loop",
"band": "moderate",
"name": "Verify loop (build / test / typecheck)",
"note": null,
"notes": [],
"value": 61,
"inputs": {
"has_nix": false,
"has_tests": true,
"lockfiles": [],
"has_dockerfile": false,
"typed_language": false,
"bootstrap_files": [
"Makefile"
],
"has_devcontainer": true,
"has_linter_config": true,
"typecheck_configs": [],
"agent_commit_share": 0,
"toolchain_manifests": [],
"dependency_bot_commit_share": 0
},
"components": [
{
"key": "one_command_bootstrap",
"name": "One-command bootstrap",
"detail": "Makefile",
"points": 18,
"status": "met",
"details": [
{
"code": "file_list",
"params": {
"files": "Makefile"
}
}
],
"max_points": 18
},
{
"key": "automated_tests",
"name": "Automated tests",
"detail": null,
"points": 22,
"status": "met",
"details": [],
"max_points": 22
},
{
"key": "lint_format_config",
"name": "Lint / format config",
"detail": ".flake8",
"points": 11,
"status": "met",
"details": [
{
"code": "file_list",
"params": {
"files": ".flake8"
}
}
],
"max_points": 11
},
{
"key": "static_type_checking",
"name": "Static type checking",
"detail": null,
"points": 0,
"status": "missed",
"details": [],
"max_points": 11
},
{
"key": "reproducible_environment",
"name": "Reproducible environment",
"detail": "devcontainer",
"points": 10,
"status": "met",
"details": [
{
"code": "file_list",
"params": {
"files": "devcontainer"
}
}
],
"max_points": 10
},
{
"key": "demonstrated_agent_practice",
"name": "Demonstrated agent practice",
"detail": "no agent-authored commits among the last 100",
"points": 0,
"status": "missed",
"details": [
{
"code": "no_agent_authored_commits",
"params": {
"sampled": 100
}
}
],
"max_points": 10
},
{
"key": "automated_maintenance",
"name": "Automated maintenance",
"detail": "no automated dependency updates observed",
"points": 0,
"status": "missed",
"details": [
{
"code": "no_dependency_automation",
"params": {}
}
],
"max_points": 8
},
{
"key": "openssf_scorecard_pinned_dependencies",
"name": "OpenSSF Scorecard: Pinned-Dependencies",
"detail": "dependency not pinned by hash detected -- score normalized to 0",
"points": 0,
"status": "missed",
"details": [],
"max_points": 10
}
]
},
{
"key": "ai_code_legibility",
"band": "moderate",
"name": "Code legibility for models",
"note": null,
"notes": [],
"value": 55,
"inputs": {
"primary_language": "Python",
"largest_source_bytes": 55284,
"source_files_sampled": 151,
"oversized_source_files": 0
},
"components": [
{
"key": "type_checkable_code",
"name": "Type-checkable code",
"detail": "Python without a type-check config",
"points": 0,
"status": "missed",
"details": [
{
"code": "no_typecheck_config_language",
"params": {
"language": "Python"
}
}
],
"max_points": 45
},
{
"key": "manageable_file_sizes",
"name": "Manageable file sizes",
"detail": "0/151 source files over 60KB",
"points": 55,
"status": "met",
"details": [
{
"code": "oversized_source_files",
"params": {
"kb": 60,
"sampled": 151,
"oversized": 0
}
}
],
"max_points": 55
}
]
},
{
"key": "ai_interfaces",
"band": "at_risk",
"name": "Machine-readable interfaces",
"note": null,
"notes": [],
"value": 40,
"inputs": {
"example_dirs": [
"examples",
"notebooks"
],
"has_mcp_signal": false,
"api_schema_files": []
},
"components": [
{
"key": "api_schema_openapi_graphql_proto",
"name": "API schema (OpenAPI/GraphQL/proto)",
"detail": null,
"points": 0,
"status": "missed",
"details": [],
"max_points": 40
},
{
"key": "mcp_server",
"name": "MCP server",
"detail": null,
"points": 0,
"status": "missed",
"details": [],
"max_points": 20
},
{
"key": "runnable_examples",
"name": "Runnable examples",
"detail": "examples, notebooks",
"points": 40,
"status": "met",
"details": [
{
"code": "file_list",
"params": {
"files": "examples, notebooks"
}
}
],
"max_points": 40
}
]
}
],
"description": "How well is the repo equipped to be developed and maintained with AI coding agents? An independent, experimental badge — weight 0.0, so it is surfaced on its own and does not affect the overall health score."
}
],
"metrics_version": "1.13.0"
},
"warnings": [
"Star history unavailable: GitHub GraphQL error: Resource not accessible by personal access token"
],
"report_type": "repository",
"generated_at": "2026-07-28T03:13:23.525355Z",
"schema_version": "0.27.0",
"badge_url": "https://raw.githubusercontent.com/inspect-software/badges/main/v1/t/thinh-vu/vnstock.svg",
"full_name": "thinh-vu/vnstock",
"license_state": "custom",
"license_spdx": null
}