Cú Thông Thái

📡 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

1

Tạo API Key

2

Thử API

curl -H "x-api-key: YOUR_KEY" \
  https://vimo.cuthongthai.vn/api/mcp/ta-narrative?symbol=FPT
3

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_KEY

Tạ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

GET
/api/finance/market-data

VN-Index, HNX, sector performance

Free
GET
/api/finance/ta/signals/[ticker]

Technical analysis signals (RSI, MACD, Bollinger)

Free
GET
/api/finance/stock-market/daily

Daily stock prices for 1600+ stocks

Free

🧠 PHÂN TÍCH AI

GET
/api/finance/bctc/ratios/[ticker]

BCTC financial ratios + AI scoring

Free
GET
/api/finance/bctc/screener

13 screener strategies (Buffett, Graham, CAN-SLIM...)

Pro
GET
/api/finance/bctc/screener-check

Check watchlist × screener matches

Free
GET
/api/finance/ai/moat-scores

AI Moat scoring (brand, switching cost, network)

Pro
GET
/api/finance/ai/esg-scores

ESG scores for Vietnamese stocks

Pro

⚔️ VĨ MÔ & ĐỊA CHÍNH TRỊ

GET
/api/warwatch/impact-score

War impact composite score (0-100)

Free
GET
/api/finance/political/connections

Political Alpha — insider connections

Elite
GET
/api/finance/macro-data

GDP, CPI, interest rates, FX

Free

💼 GIAO DỊCH

GET
/api/finance/subscription

Current subscription tier + limits

Free
POST
/api/finance/subscription

Create payment order (VietQR)

Free
GET
/api/finance/ai/price-alerts

Price alert management

Pro

🤖 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.