Quickstart

pip install python-socketio[asyncio-client]

npm install socket.io-client

import asyncio
import socketio


# Replace with your actual API key
API_KEY = 'byul_api_key'

sio = socketio.AsyncClient()

@sio.event
async def connect():
    print('Connected to Byul WebSocket')
    
    # Subscribe to high-importance news
    await sio.emit('news:subscribe', {
        'minImportance': 7,
        'startDate': '2024-01-01T00:00:00.000Z'
    })


@sio.on('news:data')
async def handle_news(response):
    news = response['data']['news']
    
    for article in news:
        print(article['title'])
        print(f"Importance: {article['importanceScore']}/10")
        print(f"Category: {article['category']}")
        print('---')

@sio.on('auth:success')
async def auth_success(data):
    print(f"Authenticated successfully: {data['user']['plan']}")

@sio.on('news:error')
async def news_error(error):
    print(f"Error: {error['message']}")

async def main():
    print('Connecting to Byul WebSocket...')
    
    await sio.connect('wss://api.byul.ai/news-v2', 
                      auth={'apiKey': API_KEY})
    await sio.wait()

if __name__ == '__main__':
    asyncio.run(main())

import React, { useState, useEffect } from 'react';
import { io } from 'socket.io-client';

// Replace with your actual API key
const API_KEY = 'byul_api_key';

function QuickstartNews() {
  const [news, setNews] = useState([]);
  const [status, setStatus] = useState('Connecting...');

  useEffect(() => {
    console.log('Connecting to Byul WebSocket...');
    
    const socket = io('wss://api.byul.ai/news-v2', {
      auth: { apiKey: API_KEY }
    });

    socket.on('connect', () => {
      console.log('Connected to Byul WebSocket');
      setStatus('Connected');
      
      // Subscribe to high-importance news
      socket.emit('news:subscribe', {
        minImportance: 7,
        startDate: '2024-01-01T00:00:00.000Z'
      });
    });


    socket.on('news:data', (response) => {
      const { news: newNews } = response.data;
      setNews(prev => [...newNews, ...prev].slice(0, 20)); // Keep latest 20
    });

    socket.on('auth:success', (data) => {
      console.log('Authenticated successfully:', data.user.plan);
      setStatus(`Connected (${data.user.plan})`);
    });

    socket.on('news:error', (error) => {
      console.error('Error:', error.message);
      setStatus(`Error: ${error.message}`);
    });

    return () => socket.close();
  }, []);

  return (
    <div style={{ padding: '20px', fontFamily: 'Arial, sans-serif' }}>
      <h2>Byul WebSocket Quickstart</h2>
      <p><strong>Status:</strong> <span style={{ 
        color: status.includes('Connected') ? 'green' : 
               status.includes('Error') ? 'red' : 'orange' 
      }}>{status}</span></p>
      
      <h3>Latest News ({news.length})</h3>
      {news.map(article => (
        <div key={article._id} style={{
          border: '1px solid #ddd',
          padding: '10px',
          margin: '10px 0',
          borderRadius: '5px'
        }}>
          <h4>{article.title}</h4>
          <p>Importance: {article.importanceScore}/10 | Category: {article.category}</p>
          <small>{new Date(article.date).toLocaleString()}</small>
        </div>
      ))}
      
      {news.length === 0 && status.includes('Connected') && (
        <p style={{ color: '#666' }}>Waiting for news updates...</p>
      )}
    </div>
  );
}

export default QuickstartNews;

python your-websocket-app.py

Connecting to Byul WebSocket...
Connected to Byul WebSocket!
Authenticated successfully: pro
Breaking: Fed Issues Emergency Statement
Importance: 10/10
Category: fed
---

npm start