WealthRadar Vietnam

API Documentation

WealthRadar mở một số endpoint công khai trả về JSON. Dùng cho fintech, app cá nhân hoặc agent AI muốn tích hợp.

Public endpoints không cần auth. Rate limit ~60 req/phút/IP. Liên hệ partner@wealthradar.vn nếu cần tier cao hơn.

Base URL

https://wealthradar.vermeil.net

GET /api/brief

Trả về daily brief tổng hợp (24h gần nhất) — top 5 tin + phân nhóm theo category.

curl https://wealthradar.vermeil.net/api/brief

GET /api/articles

Latest articles. Query params: limit (default 30, max 200), category (news|macro|stock|fund|rate|crypto|realestate|gold|fx|policy).

curl 'https://wealthradar.vermeil.net/api/articles?limit=10&category=stock'

GET /api/articles/:id

Một article cụ thể với toàn bộ AI enrichment + cluster info.

curl https://wealthradar.vermeil.net/api/articles/5234

GET /api/sectors

Sentiment + volume cho 15 ngành.

curl https://wealthradar.vermeil.net/api/sectors

GET /api/sectors/:slug

Tin theo ngành. Slug values: bank, securities, insurance, realestate, steel, materials, chemicals, oil_gas, utilities, consumer, retail, tech, transport, manufacturing, healthcare.

curl 'https://wealthradar.vermeil.net/api/sectors/bank?limit=20'

GET /api/search

FTS5 full-text search, Vietnamese-aware (unicode61 + remove_diacritics).

curl 'https://wealthradar.vermeil.net/api/search?q=l%C3%A3i%20su%E1%BA%A5t'

GET /api/trending-tickers

Top tickers mentioned trong N ngày gần nhất.

curl 'https://wealthradar.vermeil.net/api/trending-tickers?days=7&limit=10'

GET /api/watchlist?tickers=VCB,HPG,FPT

Articles mentioning any of the provided tickers (max 30).

curl 'https://wealthradar.vermeil.net/api/watchlist?tickers=VCB,HPG,FPT&limit=20'

GET /api/market/tape

Live ticker tape: VN30 Avg + USD/VND + Vàng + BTC. Cached 5 phút.

curl https://wealthradar.vermeil.net/api/market/tape

GET /api/market/movers

VN30 top gainers + losers. Query: top (default 5).

curl 'https://wealthradar.vermeil.net/api/market/movers?top=10'

GET /api/quote/:symbol

Single quote. Symbols: VN30 tickers với suffix .VN (VCB.VN, HPG.VN, …), FX (VND=X), commodities (GC=F), crypto (BTC-USD).

curl https://wealthradar.vermeil.net/api/quote/VCB.VN

GET /api/sources

Danh sách nguồn tin đang crawl. Query ?enabled=1 để chỉ lấy nguồn active.

curl 'https://wealthradar.vermeil.net/api/sources?enabled=1'

POST /api/subscribe

Đăng ký nhận daily brief. Body JSON: { "email": "...", "source": "homepage" }.

Response schema (article)

{
  "id": 5234,
  "title": "...",
  "url": "https://...",
  "source_name": "VPBank",
  "source_category": "rate",
  "published_at": "2026-05-17T...",
  "image_url": "https://...",
  "summary_vi": "Lãi suất VPBank tháng 5/2026 ...",
  "affected_assets_json": "[\"savings\"]",
  "affected_sectors_json": "[\"bank\"]",
  "mentioned_tickers_json": "[\"VPB\"]",
  "impact_direction": "negative",
  "impact_score": 4,
  "risk_tone": "cautious",
  "why_it_matters": "...",
  "view_count": 12
}

Errors

Compliance

Dữ liệu trả về có disclaimer ngầm: chỉ mang tính tham khảo, không phải khuyến nghị đầu tư. Nếu redistribute, ghi nguồn "WealthRadar Vietnam · wealthradar.vermeil.net".

B2B / Enterprise tier? Liên hệ partner@wealthradar.vn.