Registro público
Informe de salud del softwareesquema 0.27.0 · métricas 1.13.0 · 2026-07-28 03:13 UTC

thinh-vu / vnstock

A beginner-friendly yet powerful Python toolkit for financial analysis and automation — built to make modern investing accessible to everyone

PythonLicencia propia★ 1358 estrellas⑂ 292 forksdesde feb 2022Ver en GitHub ↗

thinh-vu/vnstock tiene un índice de salud de 70 sobre 100, lo que lo sitúa en la banda Bueno. Su puntuación más alta es Vitality (85/100) y la más baja, Security (50/100). Se actualizó por última vez hace 3 días. Una sola persona concentra la mayor parte del trabajo reciente.

70
global / 100
Bueno

Índice de salud del software

Las métricas se agrupan en categorías ponderadas sobre una escala de 1 a 100. El resultado global parte de su media; cuando la evidencia pública activa la Política de Jurisdicciones de Alto Riesgo, la calificación se ajusta y recibe el límite 49 (En riesgo). Preparación para IA queda fuera.

70
Excelente85-100Ejemplar; cumple prácticamente todos los criterios evaluados
Bueno70-84Saludable; carencias menores
Moderado50-69Aceptable con carencias notables; se recomienda revisión
En riesgo30-49Debilidades significativas; su adopción exige cautela
Crítico1-29Problemas graves (proyecto abandonado, un solo mantenedor, sin higiene)
VitalidadComunidad yAdopciónSostenibilidady GobernanzaCalidad deIngenieríaSeguridadPreparaciónpara IA

Perfil de puntuación

Cada eje es una categoría. La forma importa más que la media: un proyecto sano llena toda la figura, mientras que un perfil de picos y cráteres indica que la fortaleza en una dimensión enmascara el riesgo en otra.

Titularidad

Thinh VuCuenta personal
289 seguidores26 repositorios públicosdesde may 2018Vnstock

Este repositorio pertenece a una cuenta personal. Un proyecto con un único propietario conlleva más riesgo de continuidad que uno respaldado por una organización.

Ecosistemas de paquetes

RegistroPaqueteVersiónDescargas / mesVersionesÚltima publicaciónEtiquetas
PyPIvnstock4.0.5-66hace 3 díasvnstockfinancevietnamstock-marketanalysisapi

Métricas por categoría

Vitalidad

¿Está vivo el proyecto: se escribe código y se publican versiones?

85Excelente · 22% del índice global
Cómo se puntúa
36/36Recencia de push — último push hace 3 días
15.9/36Cadencia de commits — 23/52 semanas con commits
17.8/18Volumen de commits — 95 commits en el último año
10/10OpenSSF Scorecard: Maintained — 11 commit(s) and 2 issue activity found in the last 90 days -- score normalized to 10
Datos de entrada utilizados
commits_last_year95
human_commit_share1
days_since_last_push3
active_weeks_last_year23
Cómo se puntúa
27/27Publica versiones — 9 versiones publicadas
36/36Recencia de las versiones — última versión hace 18 días
19.8/27Cadencia de publicación — una versión cada ~59,2 días
0/10OpenSSF Scorecard: Signed-Releases — sin datos
Datos de entrada utilizados
releases_count9
latest_release_tagv4.0.4
releases_from_tagsno
days_since_latest_release18
mean_days_between_releases59,2
Excluidos de la puntuación (sin datos o no aplicable): OpenSSF Scorecard: Signed-Releases. Los pesos restantes se han renormalizado.

Comunidad y Adopción

¿Tiene el proyecto usuarios, descargas, atención y unas condiciones acogedoras para quienes contribuyen?

64Moderado · 18% del índice global
Cómo se puntúa
50.8/60Estrellas — 1358 estrellas
20.5/25Forks — 292 forks
9.6/15Observadores — 54 observadores
Datos de entrada utilizados
forks292
stars1358
watchers54
growth_stateunverified
growth_factor_pct100
growth_unverified_reasonno_history
Cómo se puntúa
22.5/22.5README
16.9/22.5Licencia — archivo de licencia presente, no es una licencia reconocida
0/18Guía CONTRIBUTING
0/13.5Código de conducta
0/7.2Plantilla de issues
0/6.3Plantilla de PR
Datos de entrada utilizados
has_readme
has_license
has_contributingno
has_issue_templateno
has_code_of_conductno
has_pull_request_templateno

Sostenibilidad y Gobernanza

¿Sobrevivirá el proyecto a sus personas: factor bus, capacidad de respuesta, quién lo respalda y mantenimiento del paquete?

62Moderado · 24% del índice global
Cómo se puntúa
9/54Factor bus — la mitad de los commits recae en 1 contribuyente(s)
0.9/22.5Distribución de commits — el principal contribuyente firma el 96% de los commits
13.5/13.5Amplitud de contribuyentes — 12 contribuyentes
3/10OpenSSF Scorecard: Contributors — project has 1 contributing companies or organizations -- score normalized to 3
Datos de entrada utilizados
bus_factor1
contributors_sampled12
top_contributor_share0,961
Cómo se puntúa
46.8/46.8Resolución de issues — 100% de issues cerradas
28.6/38.3Aceptación de PR — 68/91 PR decididos fusionados
0/15OpenSSF Scorecard: Code-Review — Found 1/30 approved changesets -- score normalized to 0
Datos de entrada utilizados
merged_prs68
open_issues0
closed_issues132
issue_closed_ratio1
closed_unmerged_prs23
Cómo se puntúa
10/30Respaldo de la propiedad — cuenta personal (usuario)
0/20Dominio verificado — no aplicable a cuentas de usuario
17.7/25Alcance del propietario — 289 seguidores de thinh-vu
22.4/25Trayectoria — 26 repos públicos, cuenta de ~8 años
Datos de entrada utilizados
followers289
owner_typeUser
is_verified
owner_loginthinh-vu
public_repos26
account_age_days2981
Excluidos de la puntuación (sin datos o no aplicable): Dominio verificado. Los pesos restantes se han renormalizado.
Cómo se puntúa
25/25Publicado y resoluble — 1 paquete(s) en pypi
35/35Recencia de publicación — última publicación hace 3 días
20/20Historial de versiones — 66 versiones en el registro
20/20No obsoleto — activo, ni obsoleto ni retirado
Datos de entrada utilizados
packagesvnstock
ecosystemspypi
any_deprecatedno
min_days_since_publish3

Calidad de Ingeniería

¿Existen unas prácticas mínimas de ingeniería y documentación?

84Bueno · 20% del índice global
Cómo se puntúa
24/24Flujos de trabajo de CI — 5 flujo(s) de trabajo
24/24Pruebas presentes
16/16Configuración de linter — .flake8
9.6/9.6Hooks de pre-commit
0/6.4.editorconfig
0/20OpenSSF Scorecard: CI-Tests — 0 out of 1 merged PRs checked by a CI test -- score normalized to 0
Datos de entrada utilizados
has_ci
has_tests
has_editorconfigno
has_linter_config
has_precommit_config

Documentación

100Excelente
Cómo se puntúa
30/30README
25/25Directorio de documentación
15/15Sitio de documentación / página del proyecto — https://vnstocks.com
10/10Descripción del repositorio
10/10Topics — 6 topics
10/10Wiki
Datos de entrada utilizados
topicsstock-market, data-extraction, stock-screener, quantitative-finance, quantitative-analysis, quantitative-trading
has_wiki
homepagehttps://vnstocks.com
has_readme
has_docs_dir
has_description

Seguridad

¿Son sólidas las prácticas visibles de seguridad y de cadena de suministro, sin exposición jurisdiccional de alto riesgo sin resolver?

50Moderado · 16% del índice global
Cómo se puntúa
7.5/7.5Binary-Artifacts — no binaries found in the repo
2.2/7.5Branch-Protection — branch protection is not maximal on development and all release branches
0/2.5CI-Tests — 0 out of 1 merged PRs checked by a CI test -- score normalized to 0
0/2.5CII-Best-Practices — no effort to earn an OpenSSF best practices badge detected
0/7.5Code-Review — Found 1/30 approved changesets -- score normalized to 0
0.8/2.5Contributors — project has 1 contributing companies or organizations -- score normalized to 3
10/10Dangerous-Workflow — no dangerous workflow patterns detected
0/7.5Dependency-Update-Tool — no update tool detected
0/5Fuzzing — project is not fuzzed
2.2/2.5Licencia — license file detected
7.5/7.5Maintained — 11 commit(s) and 2 issue activity found in the last 90 days -- score normalized to 10
0/5Packaging — sin datos
0/5Pinned-Dependencies — dependency not pinned by hash detected -- score normalized to 0
0/5SAST — SAST tool is not run on all commits -- score normalized to 0
0/5Security-Policy — security policy file not detected
0/7.5Signed-Releases — sin datos
0/7.5Token-Permissions — detected GitHub workflow tokens with excessive permissions
3.8/7.5Vulnerabilities — 5 existing vulnerabilities detected
Datos de entrada utilizados
sourceopenssf_scorecard
checks_evaluated16
scorecard_versionv5.5.0
checks_inconclusive2
scorecard_aggregate3,7
Excluidos de la puntuación (sin datos o no aplicable): packaging, signed_releases. Los pesos restantes se han renormalizado.
Cómo se puntúa
35/35Dependencias directas libres de avisos conocidos — ninguna dependencia directa tiene un aviso conocido
25/25Dependencias indirectas libres de avisos conocidos — ninguna dependencia indirecta tiene un aviso conocido
0/40Sin avisos pendientes — ningún aviso tiene fecha de publicación
Datos de entrada utilizados
sourceosv
advisories0
affected_packages0
assessed_packages38
unassessed_packages0
affected_by_severitynone
direct_affected_packages0
Excluidos de la puntuación (sin datos o no aplicable): Sin avisos pendientes. Los pesos restantes se han renormalizado. Se cotejó el cierre de dependencias en tiempo de ejecución de pypi:vnstock@4.0.5 —lo que arrastra la instalación del paquete publicado—: 38 paquetes. No se analiza la alcanzabilidad.

Preparación para IA

¿Hasta qué punto está el repositorio preparado para desarrollarse y mantenerse con agentes de codificación de IA? Es una insignia independiente y experimental — peso 0,0, de modo que se presenta por separado y no afecta a la puntuación de salud global.

64Moderado · 0% del índice global
Cómo se puntúa
45/45Instrucciones para agentes — AGENTS.md
0/15Documentación legible por máquinas (llms.txt)
39.5/40Historial de commits legible — 74 de 100 commits humanos declaran su intención (asunto estructurado o cuerpo explicativo)
Datos de entrada utilizados
has_llms_txtno
legible_history_share0,74
agent_instruction_filesAGENTS.md
agent_instruction_max_bytes3903
Cómo se puntúa
18/18Arranque con un solo comando — Makefile
22/22Pruebas automatizadas
11/11Configuración de lint / formato — .flake8
0/11Verificación estática de tipos
10/10Entorno reproducible — devcontainer
0/10Práctica demostrada con agentes — ningún commit con autoría de agente entre los últimos 100
0/8Mantenimiento automatizado — no se observan actualizaciones automáticas de dependencias
0/10OpenSSF Scorecard: Pinned-Dependencies — dependency not pinned by hash detected -- score normalized to 0
Datos de entrada utilizados
has_nixno
has_tests
lockfiles
has_dockerfileno
typed_languageno
bootstrap_filesMakefile
has_devcontainer
has_linter_config
typecheck_configs
agent_commit_share0
toolchain_manifests
dependency_bot_commit_share0
Cómo se puntúa
0/45Código verificable por tipos — Python sin configuración de verificación de tipos
55/55Tamaños de archivo manejables — 0/151 archivos fuente de más de 60 KB
Datos de entrada utilizados
primary_languagePython
largest_source_bytes55.284
source_files_sampled151
oversized_source_files0
Cómo se puntúa
0/40Esquema de API (OpenAPI/GraphQL/proto)
0/20Servidor MCP
40/40Ejemplos ejecutables — examples, notebooks
Datos de entrada utilizados
example_dirsexamples, notebooks
has_mcp_signalno
api_schema_files

Datos clave

1358estrellas de GitHub
12contribuidores
95commits en los últimos 12 meses
3días desde el último push
9versiones publicadas
1factor bus
0issues abiertas
PyPIecosistemas de paquetes

Advertencias de recopilación de datos

  • Star history unavailable: GitHub GraphQL error: Resource not accessible by personal access token

Más detalle

Historial de estrellas y forks 0 ★ / 292 ⇿
0Estrellas
292Forks
9Versiones

Cuándo se añadió cada estrella y fork, recopilado de GitHub y agrupado por día. El crecimiento acumulado se sitúa justo encima de las adiciones diarias que lo componen, de modo que ambos se leen en conjunto: la acumulación orgánica sostenida no se parece en nada a un pico abrupto y efímero. Cuando esa diferencia es medible, se informa como autenticidad del crecimiento.

05010015020025030029072022-082024-082026-07
Mayor 0Menor 3Parche 6

Cada punto abarca 4 días.

OpenSSF Scorecard 3.7 / 10
3.7agregado

Evaluación de seguridad independiente y agnóstica en cuanto a herramientas, procedente del proyecto de código abierto OpenSSF Scorecard. Cada comprobación premia una práctica de seguridad, no la herramienta de un proveedor concreto. Las comprobaciones que Scorecard no pudo determinar se marcan como n/d y se excluyen de la puntuación de seguridad (nunca se cuentan como cero).Scorecard v5.5.0 · 2026-07-28 03:13 UTC

10Binary-Artifactsno binaries found in the repo
3Branch-Protectionbranch protection is not maximal on development and all release branches
0CI-Tests0 out of 1 merged PRs checked by a CI test -- score normalized to 0
0CII-Best-Practicesno effort to earn an OpenSSF best practices badge detected
0Code-ReviewFound 1/30 approved changesets -- score normalized to 0
3Contributorsproject has 1 contributing companies or organizations -- score normalized to 3
10Dangerous-Workflowno dangerous workflow patterns detected
0Dependency-Update-Toolno update tool detected
0Fuzzingproject is not fuzzed
9Licenselicense file detected
10Maintained11 commit(s) and 2 issue activity found in the last 90 days -- score normalized to 10
n/dPackagingpackaging workflow not detected
0Pinned-Dependenciesdependency not pinned by hash detected -- score normalized to 0
0SASTSAST tool is not run on all commits -- score normalized to 0
0Security-Policysecurity policy file not detected
n/dSigned-Releasesno releases found
0Token-Permissionsdetected GitHub workflow tokens with excessive permissions
5Vulnerabilities5 existing vulnerabilities detected
Dependencias directas 13
RegistroPaqueteRestricción de versiónManifiesto
PyPIrequestspyproject.toml
PyPIbeautifulsoup4pyproject.toml
PyPIpandaspyproject.toml
PyPIseabornpyproject.toml
PyPIopenpyxlpyproject.toml
PyPIpydanticpyproject.toml
PyPIpsutilpyproject.toml
PyPIpackaging>=20.0pyproject.toml
PyPIimportlib-metadata>=1.0pyproject.toml
PyPItenacitypyproject.toml
PyPIvnai>=2.5.2pyproject.toml
PyPIvnstock_ezchart>=1.0.1pyproject.toml
PyPIpytzpyproject.toml
Todas las dependencias 25

Conjunto completo de dependencias resueltas según el grafo de dependencias de GitHub: 16 paquetes directos y 9 indirectos (transitivos). El cierre transitivo es completo cuando el repositorio incluye un lockfile.

RegistroPaqueteVersiónRelación
PyPIbeautifulsoup4directa
PyPIimportlib-metadatadirecta
PyPIopenpyxldirecta
PyPIopenpyxl3.1.2directa
PyPIpackagingdirecta
PyPIpandasdirecta
PyPIpsutildirecta
PyPIpsutil6.0.0directa
PyPIpydanticdirecta
PyPIpytzdirecta
PyPIrequestsdirecta
PyPIseaborndirecta
PyPIseaborn0.13.2directa
PyPItenacitydirecta
PyPIvnaidirecta
PyPIvnstock-ezchartdirecta
PyPIbs40.0.2indirecta
PyPIcryptography42.0.5indirecta
PyPIfake-useragent1.5.1indirecta
PyPImkdocs-glightboxindirecta
PyPImkdocs-materialindirecta
PyPImkdocs-rss-pluginindirecta
PyPIpytestindirecta
PyPIpytest-covindirecta
PyPIsetuptoolsindirecta
Avisos de dependencias 0

Instalar pypi:vnstock@4.0.5 arrastra 38 paquetes, directos y transitivos: 0 tienen avisos conocidos, de los cuales 0 son dependencias directas.

Ningún aviso conocido afecta a las dependencias evaluadas.

Un aviso significa que la versión registrada en el grafo de dependencias cae dentro del rango afectado de un aviso. No se analiza la alcanzabilidad, y el grafo incluye fijaciones de desarrollo y prueba: un hallazgo puede referirse al utillaje y no al software distribuido.

Informe JSON sin procesar legible por máquina
{
  "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
}

Las puntuaciones son señales, no garantías. Reflejan prácticas públicamente visibles en GitHub; no son una auditoría de código ni una garantía de seguridad.

Los datos ausentes se excluyen y los pesos se renormalizan; nunca se puntúan como cero. La metodología es versionada y abierta: métricas v1.13.0, esquema v0.27.0 — metodología completa · wiki de métricas.

Cómo se sitúa un resultado dentro del registro general: estadísticas agregadasPyPI.