Connecting Equities

Guide to connecting US (Alpaca) and Vietnam (SSI) equity platforms through Hydra Connector.

Connecting Equities — Multi-Market Guide

Overview

Alpha Draconis Hydra Core supports connections to multiple equity platforms beyond traditional forex. This guide covers how to connect Alpaca (US equities) and SSI (Vietnam equities) through the Hydra Connector interface.

Terminology Note: We use "Platform" or "Liquidity Venue" to refer to trading venues. Each connection is encrypted and bound to your hardware.


Supported Platforms

| Platform | Market | Asset Types | Connection Method | |----------|--------|-------------|-------------------| | Alpaca | US Equities | Stocks, ETFs | API Key (OAuth2) | | SSI | Vietnam Equities | VN30, HNX | API Key | | MT5 Brokers | Forex, CFDs | Currencies, Metals, Indices | Login Credentials |


Connecting Alpaca (US Equities)

Step 1: Generate API Keys

  1. Log in to your Alpaca Dashboard
  2. Navigate to API Keys section
  3. Generate a new Live or Paper key pair
  4. Copy both the API Key ID and Secret Key

Step 2: Link to Hydra Connector

  1. Open your Alpha Draconis Dashboard → Terminal
  2. Select "Link Account" and choose platform type: Alpaca
  3. Enter your API Key ID and Secret Key
  4. The credentials are encrypted with AES-256 before transmission

Step 3: Verification

Once linked, Hydra will:

  • Validate the API key against Alpaca's servers
  • Pull your account balance and positions
  • Begin real-time equity monitoring

Status will transition: QUEUED → PENDING → CONNECTED


Connecting SSI (Vietnam Equities)

Step 1: Register for SSI API Access

  1. Contact SSI to enable API access on your account
  2. Receive your Consumer ID and Consumer Secret
  3. Note your Trading Account Number

Step 2: Link to Hydra Connector

  1. Open your Alpha Draconis Dashboard → Terminal
  2. Select "Link Account" → Platform: SSI
  3. Enter your Consumer ID, Secret, and Account Number
  4. Credentials encrypted with AES-256 before storage

Step 3: Market Hours Guard

SSI operates on Vietnam market hours (9:00 AM – 3:00 PM ICT, Mon–Fri). The Market Hours Guard plugin:

  • Auto-hibernates the connection when the market closes to save resources
  • Prevents false positives from gap signals at market open
  • Auto-resumes monitoring when the next session begins
  • Logs all hibernate/wake events to your Activity Log

Why Market Hours Guard matters: Without it, your risk firewall might react to stale data during off-hours, triggering unnecessary alerts or stop-loss events.


Security Architecture

All platform connections use the same security stack:

  • AES-256 encryption for credential storage at rest
  • TLS 1.3 for all data in transit
  • HWID binding — credentials only work from your authorized hardware
  • Zero-knowledge — Alpha Draconis never stores your credentials in plaintext

Troubleshooting

| Issue | Solution | |-------|----------| | Connection stuck on PENDING | Check your API key permissions — ensure "trading" scope is enabled | | Market Hours Guard not activating | Verify your system timezone matches the target market | | "Invalid credentials" error | Regenerate your API key and re-link | | Positions not syncing | Ensure your platform account has at least one open position |