📡 Cú AI Public API
REST API cho quant traders và developers. Truy cập data thị trường VN, AI scoring, screener strategies, và macro indicators.
🚀 Quick Start — 3 Bước
Tạo API Key
Thử API
curl -H "x-api-key: YOUR_KEY" \ https://vimo.cuthongthai.vn/api/mcp/ta-narrative?symbol=FPT
Tích hợp vào app
Dùng x-api-key header cho REST hoặc cài MCP server cho Claude/ChatGPT.
🔐 XÁC THỰC
Tất cả API requests cần header:
x-api-key: YOUR_API_KEYTạo API key tại Pricing. Free: 100/ngày. Pro: 1,000. Elite: unlimited.
⏱️ GIỚI HẠN TẦN SUẤT
100/ngày
Free
1,000/ngày
Pro
Unlimited
Elite
📊 DỮ LIỆU THỊ TRƯỜNG
/api/finance/market-dataVN-Index, HNX, sector performance
/api/finance/ta/signals/[ticker]Technical analysis signals (RSI, MACD, Bollinger)
/api/finance/stock-market/dailyDaily stock prices for 1600+ stocks
🧠 PHÂN TÍCH AI
/api/finance/bctc/ratios/[ticker]BCTC financial ratios + AI scoring
/api/finance/bctc/screener13 screener strategies (Buffett, Graham, CAN-SLIM...)
/api/finance/bctc/screener-checkCheck watchlist × screener matches
/api/finance/ai/moat-scoresAI Moat scoring (brand, switching cost, network)
/api/finance/ai/esg-scoresESG scores for Vietnamese stocks
⚔️ VĨ MÔ & ĐỊA CHÍNH TRỊ
/api/warwatch/impact-scoreWar impact composite score (0-100)
/api/finance/political/connectionsPolitical Alpha — insider connections
/api/finance/macro-dataGDP, CPI, interest rates, FX
💼 GIAO DỊCH
/api/finance/subscriptionCurrent subscription tier + limits
/api/finance/subscriptionCreate payment order (VietQR)
/api/finance/ai/price-alertsPrice alert management
🤖 GIAO THỨC MCP
Cú AI hỗ trợ Model Context Protocol (JSON-RPC 2.0) cho Claude, GPT, và Gemini.
Discovery: GET /.well-known/mcp.json
Endpoint: POST /api/mcp-server
Tools: screen_stocks, get_ta_signals, get_bctc_profile, get_ai_analysis,
get_war_risk, get_political_alpha, get_macro, compare_deposit_rates,
compare_funds, get_market_sentiment📜 Terms of Service
By using VIMO API, you agree to:
- ❌NOT train AI/ML models using VIMO API output data
- ❌NOT redistribute data in any format (raw, transformed, aggregated)
- ❌NOT build competing financial analysis products using VIMO data
- ✅Personal use, editorial/journalism (with "Source: VIMO" citation)
- ✅Academic research (with proper citation)
Violation may result in immediate API key revocation. All API responses contain cryptographic trace IDs for usage tracking.