{"id":46765,"library":"vnai","title":"Vnstock Analytics Interface (vnai)","description":"vnai (Vnstock Analytics Interface) is a Python library for Vietnamese stock market data analysis. It provides tools to fetch stock prices, financial statements, and market indices, targeting quantitative analysis and automated trading. Current version 2.4.8, release cadence monthly. Requires Python 3.10+.","status":"active","version":"2.4.8","language":"python","source_language":"en","source_url":"https://github.com/thinhvu1995/vnai","tags":["stock","finance","vietnam","data-analysis"],"install":[{"cmd":"pip install vnai","lang":"bash","label":"PyPI install"}],"dependencies":[{"reason":"Data manipulation","package":"pandas","optional":false},{"reason":"Numerical computation","package":"numpy","optional":false},{"reason":"HTTP requests to Vnstock's API","package":"requests","optional":false}],"imports":[{"wrong":"from vnai import Vnstock","symbol":"Vnstock","correct":"import vnai"}],"quickstart":{"code":"from vnai import Vnstock\nimport os\n\nstock = Vnstock()\n# Use API token from environment variable\ntoken = os.environ.get('VNSTOCK_API_TOKEN', 'demo_token')\ndata = stock.fetch_stock_data('VNM', token=token)\nprint(data.head())","lang":"python","description":"Initialize Vnstock, fetch stock data for VNM (Vinamilk) using an API token."},"warnings":[{"fix":"Use `from vnai import Vnstock` instead of `import vnstock`.","message":"Version 2.x changed import paths. `vnai.Vnstock` replaces `vnstock.Vnstock` (v1.x).","severity":"breaking","affected_versions":">=2.0.0"},{"fix":"Set the token via environment variable `VNSTOCK_API_TOKEN` or pass it directly to method calls.","message":"The library requires an API token (Vnstock API key). If omitted, many methods fail with 401.","severity":"gotcha","affected_versions":"all"},{"fix":"Use `fetch_stock_data` or `fetch_market_data` with appropriate parameters.","message":"Method `fetch_all` is deprecated since 2.3.0, will be removed in 3.0.","severity":"deprecated","affected_versions":"2.3.0+"}],"env_vars":null,"search_vec":"'2.4.8':39 '3.10':45 'analysi':18,33,51 'analyt':2,7 'autom':35 'cadenc':41 'current':37 'data':17,50 'data-analysi':49 'fetch':23 'financ':47 'financi':26 'indic':30 'interfac':3,8 'librari':12 'market':16,29 'month':42 'price':25 'provid':20 'python':11,44 'quantit':32 'releas':40 'requir':43 'statement':27 'stock':15,24,46 'target':31 'tool':21 'trade':36 'version':38 'vietnam':48 'vietnames':14 'vnai':4,5 'vnstock':1,6","created_at":"2026-06-07T13:01:31.809316+00:00","updated_at":"2026-06-07T13:01:31.809316+00:00","problems":{"verify_error":"Traceback (most recent call last):\n  File \"<string>\", line 1, in <module>\n  File \"/tmp/tmptvblrxo2/venv/lib/python3.12/site-packages/vnai/__init__.py\", line 9, in <module>\n    import pandas as pd\nModuleNotFoundError: No module named 'pandas'"},"ecosystem":"pypi","meta_description":null,"install_score":null,"quickstart_score":null,"quickstart_tag":null,"pypi_latest":null,"cli_name":null,"cli_version":null,"type":"library","homepage":null,"github":null,"docs":null,"changelog":null,"pypi":null,"npm":null,"openapi_spec":null,"status_page":null,"smithery":null,"categories":["analytics"],"base_url":null,"auth_type":null,"provenance":{"verified_status":"import_fail","verified_at":"2026-07-03","last_verified":"2026-07-03","next_check":"2026-07-10","install_tag":null}}