{"openapi":"3.1.0","info":{"title":"BlackBox ETF Vietnam API (Hộp Đen ETF — etf.com.vn)","version":"1.0.0","description":"Public, unauthenticated read-only REST & Excel/CSV API for Vietnam-listed ETFs on HOSE (DCVFM, SSIAM, VinaCapital, KIM, Mirae Asset), international Vietnam ETFs (VNM, XFVT), stock-to-ETF holdings exposure, 139-fund institutional flows, and quarterly index rebalancing capping watchlists.","contact":{"name":"BlackBox ETF (etf.com.vn)","url":"https://etf.com.vn/mcp"}},"servers":[{"url":"https://etf.com.vn","description":"Production HTTPS Server"}],"paths":{"/api/excel/etfs":{"get":{"operationId":"listVietnamEtfs","summary":"List all Vietnam-listed ETFs with live price, VWAP, AUM, TER, and foreign net flow","parameters":[{"name":"format","in":"query","required":false,"schema":{"type":"string","enum":["json","csv"],"default":"json"},"description":"Set format=json for structured JSON or omit/csv for Excel UTF-8 BOM CSV."},{"name":"category","in":"query","required":false,"schema":{"type":"string","enum":["all","equity_vn","equity_vn_sector","equity_global","bond","commodity"]}},{"name":"issuer","in":"query","required":false,"schema":{"type":"string"}},{"name":"lang","in":"query","required":false,"schema":{"type":"string","enum":["en","vi"],"default":"en"}}],"responses":{"200":{"description":"Vietnam ETF directory payload","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/excel/holdings":{"get":{"operationId":"getEtfHoldings","summary":"Get constituent stock holdings and sector breakdown for one ETF or ALL ETFs","parameters":[{"name":"ticker","in":"query","required":false,"schema":{"type":"string","default":"FUEVFVND"},"description":"ETF ticker (e.g. FUEVFVND, E1VFVN30, FUESSVFL) or ALL."},{"name":"format","in":"query","required":false,"schema":{"type":"string","enum":["json","csv"],"default":"json"}},{"name":"lang","in":"query","required":false,"schema":{"type":"string","enum":["en","vi"],"default":"en"}}],"responses":{"200":{"description":"Constituent holdings breakdown","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/excel/stock-exposure":{"get":{"operationId":"lookupStockEtfExposure","summary":"Reverse lookup which Vietnam ETFs hold a HOSE stock symbol and implied foreign/AUM exposure","parameters":[{"name":"symbol","in":"query","required":false,"schema":{"type":"string","default":"FPT"},"description":"HOSE stock symbol such as FPT, ACB, TCB, HPG, MWG, or ALL."},{"name":"format","in":"query","required":false,"schema":{"type":"string","enum":["json","csv"],"default":"json"}},{"name":"lang","in":"query","required":false,"schema":{"type":"string","enum":["en","vi"],"default":"en"}}],"responses":{"200":{"description":"Stock ETF ownership and implied institutional exposure","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/excel/rebalancing":{"get":{"operationId":"getEtfRebalancingCalendar","summary":"Get quarterly index rebalancing schedules and live 10%/15% capping watchlist","parameters":[{"name":"section","in":"query","required":false,"schema":{"type":"string","enum":["all","watchlist","schedules"],"default":"all"}},{"name":"format","in":"query","required":false,"schema":{"type":"string","enum":["json","csv"],"default":"json"}},{"name":"lang","in":"query","required":false,"schema":{"type":"string","enum":["en","vi"],"default":"en"}}],"responses":{"200":{"description":"Index rebalancing schedules and capping watchlist","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/excel/flows":{"get":{"operationId":"getInstitutionalFundFlows","summary":"Get HOSE ETF daily foreign flows, implied stock/sector flows, and 139-fund Vietnam macro benchmark","parameters":[{"name":"format","in":"query","required":false,"schema":{"type":"string","enum":["json","csv"],"default":"json"}},{"name":"lang","in":"query","required":false,"schema":{"type":"string","enum":["en","vi"],"default":"en"}}],"responses":{"200":{"description":"Institutional flow and macro benchmark summary","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/excel/cell":{"get":{"operationId":"getExcelCellMetric","summary":"Return a single unformatted metric scalar for Microsoft Excel =WEBSERVICE()","parameters":[{"name":"ticker","in":"query","required":true,"schema":{"type":"string"}},{"name":"field","in":"query","required":true,"schema":{"type":"string","enum":["price","change","change_pct","vwap","open","high","low","prev_close","volume","foreign_net","foreign_buy","foreign_sell","aum","aum_bil","ter","listed_shares","vwap_diff_pct","spread_pct","benchmark","issuer","name","currency","as_of_date"]}}],"responses":{"200":{"description":"Plain text unformatted metric value","content":{"text/plain":{"schema":{"type":"string"}}}}}}},"/api/etf/{ticker}":{"get":{"operationId":"getEtfTickerQuote","summary":"Get live quote, price history, NAV history, or fund flow for a single ETF ticker","parameters":[{"name":"ticker","in":"path","required":true,"schema":{"type":"string"}},{"name":"type","in":"query","required":false,"schema":{"type":"string","enum":["all","history","nav","flow"]}},{"name":"period","in":"query","required":false,"schema":{"type":"string","enum":["1W","1M","3M","6M","1Y","3Y","MAX"]}}],"responses":{"200":{"description":"ETF market quote / series JSON","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/search":{"get":{"operationId":"searchVietnamEtfResearch","summary":"Search ETFs, HOSE stocks, academy tutorials, glossary formulas, and research articles","parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Search results JSON","content":{"application/json":{"schema":{"type":"object"}}}}}}}}}