Skip to content

teemulinna/bloomberg-api-simulator

BranchesTags

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

9 Commits
docs
docs
 
 
src
src
 
 
tests
tests
 
 
.env.example
.env.example
 
 
.gitignore
.gitignore
 
 
README.md
README.md
 
 
demo.sh
demo.sh
 
 
package.json
package.json
 
 
tsconfig.json
tsconfig.json
 
 

Repository files navigation

🚀 Bloomberg Terminal API Simulator

AI-Powered Financial Data Generation with @ruvector/agentic-synth

A sophisticated Bloomberg Terminal API simulator that leverages @ruvector/agentic-synth for AI-powered synthetic data generation. Features real-time market data streaming, AI-generated news, and self-learning pattern recognition.

✨ Key Features

🤖 @ruvector/agentic-synth Integration

  • NPX-based architecture - No native dependencies to compile
  • Multi-provider AI - Gemini, OpenAI, Claude, OpenRouter (50+ models)
  • Smart cascade - AgenticSynth → Azure → Mock data fallback
  • Type-safe wrapper - Full TypeScript API for programmatic control

⚡ Performance

  • 10,000+ quotes/second throughput
  • Sub-50ms latency for real-time feeds
  • Memory efficient with intelligent LRU caching
  • Parallel processing for maximum throughput

📊 Comprehensive Data Types

  • Real-time quotes with bid/ask spreads
  • Trade execution with block/odd lot detection
  • AI-generated news with sentiment analysis
  • Market depth (Level II order book)
  • Technical indicators: RSI, MACD, Bollinger Bands
  • Market conditions: Bullish, bearish, volatile scenarios

🚀 Quick Start

Installation

# Clone the repository
git clone https://github.com/teemulinna/bloomberg-api-simulator.git
cd bloomberg-api-simulator

# Install dependencies
npm install

# Build the project
npm run build

Configuration

Create a .env file from the template:

cp .env.example .env

Add your API keys (choose at least one):

# Primary: Azure OpenAI (Enterprise-grade)
AZURE_OPENAI_API_KEY=your_azure_key_here
AZURE_OPENAI_ENDPOINT=https://your-resource.openai.azure.com/
AZURE_OPENAI_DEPLOYMENT=gpt-4

# Secondary: Gemini (Free tier available)
GEMINI_API_KEY=your_gemini_api_key_here

# Tertiary: Anthropic Claude
ANTHROPIC_API_KEY=your_anthropic_api_key_here

Get API Keys

📖 Usage

Run Live Demo

# Interactive Bloomberg Terminal simulation
npm run demo:bloomberg

Generate Synthetic Data

# Generate 1000 market data records
node dist/cli.js generate --count 1000 --symbols AAPL,MSFT,GOOGL

# Stream real-time data
node dist/cli.js stream --symbols AAPL,MSFT --interval 100

Programmatic Usage

import { BloombergSimulator } from './BloombergSimulator';

// Initialize simulator (auto-detects agentic-synth)
const simulator = new BloombergSimulator({
  symbols: ['AAPL', 'MSFT', 'GOOGL'],
  includeNews: true,
  interval: 100
});

// Listen for AI-generated news
simulator.on('news:flash', (news) => {
  console.log(`[${news.sentiment}] ${news.headline}`);
  console.log(`Source: ${news.source}`);  // Shows which AI generated it
});

// Listen for quotes
simulator.on('quote:update', (quote) => {
  console.log(`${quote.symbol}: $${quote.last} (${quote.changePercent}%)`);
});

// Start streaming
await simulator.startStreaming({ parallel: true });

Using AgenticSynth Directly

import { AgenticSynthWrapper } from './agenticSynthWrapper';

const synth = new AgenticSynthWrapper({
  provider: 'gemini',
  apiKey: process.env.GEMINI_API_KEY
});

// Generate financial news
const news = await synth.generateNews(['AAPL', 'MSFT'], 10);

// Generate time-series data
const timeSeries = await synth.generateTimeSeries({
  symbols: ['AAPL'],
  count: 1000,
  interval: '1min'
});

🏗️ Architecture

Provider Priority

The simulator uses Azure OpenAI as the primary AI provider, with agentic-synth as fallback:

  1. Azure OpenAI (Primary) - Enterprise-grade, configured via Azure
  2. Gemini (Secondary) - Via @ruvector/agentic-synth NPX wrapper
  3. Anthropic Claude (Tertiary) - Via @ruvector/agentic-synth NPX wrapper
  4. Mock Data (Always available) - Deterministic fallback

Multi-Provider AI Cascade

┌──────────────────────────────────────────┐
│ Bloomberg Simulator                      │
└──────────────────────────────────────────┘
                  │
                  ▼
    ┌─────────────────────────────┐
    │ PRIMARY: Azure OpenAI       │
    │ - Direct integration        │
    │ - Enterprise-grade          │
    └─────────────────────────────┘
                  │
              (fallback)
                  ▼
    ┌─────────────────────────────┐
    │ SECONDARY: agentic-synth    │
    │ - Gemini (preferred)        │
    │ - Via NPX                   │
    └─────────────────────────────┘
                  │
              (fallback)
                  ▼
    ┌─────────────────────────────┐
    │ TERTIARY: agentic-synth     │
    │ - Anthropic Claude          │
    │ - Via NPX                   │
    └─────────────────────────────┘
                  │
         (final fallback)
                  ▼
    ┌─────────────────────────────┐
    │ Mock Data Generator         │
    └─────────────────────────────┘

Why NPX Wrapper?

We use NPX to run agentic-synth without local installation because:

  • ✅ Avoids native dependency compilation issues (gl, sharp)
  • ✅ Works on all platforms (macOS ARM64, Linux, Windows)
  • ✅ Always gets latest version
  • ✅ No build tools required
  • ✅ Cleaner dependency tree

See AGENTIC_SYNTH_INTEGRATION.md for detailed implementation.

📚 Documentation

🧪 Testing

Quick CLI Test (No API Key Required)

# Verify NPX wrapper is working
node tests/test-simple-agentic-synth.js

Expected Output:

✅ NPX Availability: ✅
✅ Help Command: ✅
❌ Basic Generation: ❌ (requires API key)

This verifies the integration is working - generation requires a valid API key.

Full Integration Tests (Requires API Key)

# Test agentic-synth with AI generation
node tests/test-agentic-synth-integration.js

# Test Azure OpenAI integration
node tests/test-azure-integration.js

Expected Output (with valid API key):

🧪 Testing @ruvector/agentic-synth Integration

1️⃣ Testing AgenticSynth Wrapper...
   AgenticSynth available via NPX: ✅
   Testing news generation...
   Generated 2 news items:
   1. [BULLISH] Apple beats Q4 expectations, stock jumps 5%
   2. [BEARISH] Microsoft faces regulatory scrutiny in EU markets
   ✅ News generation successful

2️⃣ Testing BloombergSimulator Integration...
   ✅ @ruvector/agentic-synth integration enabled (NPX mode)
   🤖 News: [bullish] Apple stock jumps after strong iPhone sales
   📝 Source: Bloomberg Terminal (AgenticSynth AI)

✅ All integration tests completed!

Without API Key: Tests will show CLI is working but generation fails with "401 Unauthorized" - this is expected.

📊 Performance Benchmarks

Metric AgenticSynth Azure OpenAI Mock Data
Throughput 100-500 records/sec 50 records/sec 10,000 records/sec
Quality Excellent (AI) Excellent (AI) Good (templates)
Cost Pay-per-use Pay-per-use Free
Latency ~2s first run (NPX) ~500ms <1ms
Variety Very High High Limited

🔧 Project Structure

bloomberg-api-simulator/
├── src/
│   ├── BloombergSimulator.ts      # Main simulator class
│   ├── agenticSynthWrapper.ts     # @ruvector/agentic-synth NPX wrapper
│   ├── azureOpenAI.ts             # Azure OpenAI fallback
│   ├── indicators.ts              # Technical indicators
│   ├── cli.ts                     # Command-line interface
│   ├── types.ts                   # TypeScript definitions
│   └── index.ts                   # Main entry point
├── tests/
│   ├── test-agentic-synth-integration.js
│   └── test-azure-integration.js
├── docs/
│   ├── AGENTIC_SYNTH_INTEGRATION.md
│   └── AZURE_OPENAI_FIXES.md
└── dist/                          # Compiled JavaScript

🌟 Features in Detail

AI-Generated News

  • Real-time financial news headlines
  • Sentiment analysis (bullish/bearish/neutral)
  • Impact assessment (low/medium/high)
  • Multi-provider support
  • Contextually relevant to market conditions

Market Data Simulation

  • Realistic price movements with volatility
  • Bid/ask spreads and market depth
  • Trading volume patterns
  • Market conditions (bull/bear/volatile)
  • Corporate actions simulation

Technical Indicators

  • RSI (Relative Strength Index)
  • MACD (Moving Average Convergence Divergence)
  • Bollinger Bands
  • Stochastic Oscillator
  • Moving Averages (SMA, EMA)

Self-Learning

  • Pattern detection and recognition
  • Adaptive interval adjustment
  • Performance optimization
  • Cache hit rate tracking

🔐 Security & Privacy

  • ✅ API keys stored in .env (git-ignored)
  • ✅ No hardcoded credentials
  • ✅ Secure Azure OpenAI integration
  • ✅ Rate limiting support
  • ✅ Error handling and fallbacks

🤝 Contributing

Contributions are welcome! Please:

  1. Fork the repository
  2. Create a feature branch (git checkout -b feature/amazing-feature)
  3. Commit your changes (git commit -m 'Add amazing feature')
  4. Push to the branch (git push origin feature/amazing-feature)
  5. Open a Pull Request

📝 License

MIT License - see LICENSE file for details

🙏 Acknowledgments

📧 Support

🚀 What's Next?

  • DSPy.ts integration for self-improving prompts
  • Vector embeddings for RAG systems
  • Model benchmarking dashboard
  • WebSocket server implementation
  • Historical data replay
  • Multi-exchange support

Built with ❤️ using @ruvector/agentic-synth

About

No description, website, or topics provided.

Resources

Readme
Activity

Stars

0 stars

Watchers

0 watching

Forks

0 forks
Report repository

Releases

No releases published

Packages

 
 
 

Contributors

Languages