System Overview

What is FastConnect API?

FastConnect API is SSI's trading connectivity platform that allows clients and partners to access the trading system directly via standardized APIs. It supports building and operating automated investment and trading systems with low latency and high security.

API Groups

FastConnect API provides 5 main feature groups:

1. Authentication

Authenticate with API Key and API Secret to obtain a Bearer token (JWT). The token controls access permissions:

• Market Data Token: Call /api/v3/auth/token with apiKey + apiSecret
• Trading Token: Include the otp field for trading-enabled tokens
• Refresh Token: Renew tokens via /api/v3/auth/refresh
• Request OTP: Get OTP via SMS/Email with /api/v3/auth/requestOtp

2. Market Data

Access Vietnamese stock market data via REST API:

• Securities List: Look up securities by exchange (HOSE, HNX, UPCOM) or index
• Trading Summary: Daily aggregated trading data (price, volume, value)
• OHLCV Candlestick Data: Candle data across multiple timeframes (1m, 5m, 15m, 30m, 1h, 1d)
• Market Indices: List and summary of indices (VNINDEX, VN30, HNXIndex...)
• Corporate Actions: Look up dividends, bonus shares, additional issuance, ... by securities symbol and time range
• Data File Download: Download CSV market data files by date

3. Trading

Place orders and manage trading accounts:

• Place Orders: Buy/sell with order types LO, ATO, ATC, MP, MAK, MOK, MTL, PLO
• Modify/Cancel Orders: Change price, quantity, or cancel pending orders
• Batch Order: Place or cancel up to 50 orders in a single call
• Order Book: Query order history by account, status, time range
• Positions: Current equity and derivative holdings
• Account Balance: Cash, buying power, debt, pending settlement (T+0/T+1/T+2)
• PP/MMR: Buying power and margin ratio information
• Max Buy/Sell Quantity: Check maximum order quantity

4. WebSocket Streaming (Real-time Data)

Receive real-time data via WebSocket connection at wss://stream.ssi.com.vn:

• Market Data: Subscribe by symbol (topics trade, quote, room, put, oddlot, market)
• Trading Data: Order status, matched orders, account updates (topics order, portfolio)
• Indices: Realtime index values (trade.index, tick/1m/5m candles) and index summary information (indexsummary)
• Heartbeat: Client sends ping_pong periodically to check and renew the connection (the server acks immediately); the server also broadcasts a periodic heartbeat message

5. WebSocket API (Trading over WebSocket)

Send orders directly over a persistent WebSocket connection, with lower latency than calling REST for every order:

• Place/Amend/Cancel Orders: order.place, order.amend, order.cancel
• Batch Place/Cancel: order.batchNew, order.batchCancel
• Conditional orders (FCO) and account queries (positions, balances, order book)
• Notifications: Subscribe to order status and account changes on the same connection
• Requires a separate scope with the tradingws:*:* prefix

---

Who Should Use FastConnect API?

---

Supported Technologies

• Protocols: REST API (JSON), WebSocket
• Authentication: API Key + Secret, Bearer JWT
• Data Format: JSON, CSV (via data file download endpoint)
• SDKs: Node.js, Python, Java, C#, Go
• Rate Limits: Controlled via response headers X-RATELIMIT-LIMIT, X-RATELIMIT-REMAINING, X-RATELIMIT-RESET

---

Next Steps

Continue with Registration Process to create an API account.