تدفق النصوص

Documentation Index

Fetch the complete documentation index at: https://benzinga-2-locadex-parallel-main.mintlify.app/llms.txt

Use this file to discover all available pages before exploring further.

• تفريغ مباشر: احصل على تحديثات للجمل في الوقت الفعلي أثناء حديث المتحدثين في مكالمات الأرباح
• توقيت على مستوى الكلمة: تتضمّن كل جملة طوابع زمنية لكل كلمة بالإضافة إلى درجات ثقة
• تحديد المتحدّث: تتبّع من يتحدّث (المديرون التنفيذيون، المحلّلون، إلخ)
• تتبّع الحالة: راقب ما إذا كانت نصوص المكالمات قيد التنفيذ أم مكتملة
• اشتراك مرن: اشترك في رموز تداول محدّدة أو في جميع النصوص باستخدام *
• اختبار تجريبي: اختبر عملية التكامل لديك باستخدام بيانات وهمية عندما لا تكون هناك مكالمات مباشرة نشطة

• بناء عارِضات آنية لنصوص مكالمات الأرباح
• إنشاء أدوات للترجمة النصية الحية وتحسين إمكانية الوصول
• إجراء تحليل للمشاعر في الوقت الفعلي على مكالمات الأرباح
• استخراج العبارات والمقاييس الرئيسية عند ورودها في المكالمة
• إطلاق تنبيهات عند ورود كلمات مفتاحية أو موضوعات محددة أثناء المكالمات الحية
• أرشفة النصوص الكاملة مع بيانات توقيت دقيقة

wss://api.benzinga.com/api/v1/transcripts/stream?token=YOUR_TOKEN

{
  "action": "subscribe",
  "ticker": "AAPL"
}

{
  "action": "subscribe",
  "ticker": "*"
}

{
  "action": "unsubscribe",
  "ticker": "AAPL"
}

{
  "action": "list"
}

{
  "action": "ping"
}

{
  "action": "subscribe",
  "ticker": "AAPL",
  "mock": true
}

{
  "call_id": "call_123456",
  "transcript_id": "550e8400-e29b-41d4-a716-446655440000",
  "call_title": "Apple Inc. Q4 2024 Earnings Call",
  "sentence": "Revenue for the quarter was 89.5 billion dollars.",
  "start_time": "2024-01-15T16:30:15Z",
  "end_time": "2024-01-15T16:30:19Z",
  "symbol": "AAPL",
  "exchange": "NASDAQ",
  "name": "Apple Inc.",
  "sequence": 42,
  "status": "IN_PROGRESS",
  "speaker": "Tim Cook, CEO",
  "type": "LIVE",
  "language": "en",
  "confidence": 0.98,
  "words": [
    {
      "text": "Revenue",
      "confidence": 0.99,
      "start": 0,
      "end": 450
    },
    {
      "text": "for",
      "confidence": 0.98,
      "start": 450,
      "end": 600
    }
  ],
  "created_time": "2024-01-15T16:30:19Z"
}

{
  "text": "Revenue",
  "confidence": 0.99,
  "start": 0,
  "end": 450
}

• text: الكلمة نفسها
• confidence: درجة الثقة في التعرف (0.0 - 1.0)
• start/end: الإزاحات الزمنية بالميلي ثانية من بداية الجملة

• إدارة التخزين المؤقت (buffer): اعرض الجمل حسب ترتيبها التسلسلي باستخدام الحقل sequence
• تنسيق المتحدث: نسِّق العرض بشكل مختلف بناءً على قيمة speaker (المديرين التنفيذيين مقابل المحللين)
• مؤشرات الحالة: اعرض مؤشرات مرئية لحالتي IN_PROGRESS وCOMPLETE

• تحذير من البدل (Wildcard): استخدام ticker: "*" يعني الاشتراك في جميع المحاضر، ما قد ينتج عنه حجم بيانات كبير
• اشتراكات موجهة: اشترك فقط في رموز التداول التي تحتاجها لتقليل استهلاك عرض النطاق الترددي
• نبضة (Heartbeat): أرسل ping كل 30-60 ثانية للحفاظ على الاتصال

• التصفية بناءً على مستوى الثقة: فكّر في تجاهل أو تمييز الجمل ذات درجات الثقة المنخفضة
• دقة الكلمات: استخدم درجة الثقة لكل كلمة لتحديد عمليات النسخ غير المؤكدة
• التعامل مع اللغة: تحقق من الحقل language لضمان العرض الصحيح للنص

• وضع المحاكاة (Mock Mode): استخدم mock: true أثناء التطوير عند عدم وجود اتصالات مباشرة فعّالة
• اختبار الصدى (Echo Testing): استخدم الإجراء echo للتحقق من الاتصال والتعامل مع الرسائل
• أمر القائمة (List Command): تحقّق من list لمعرفة ما هو متاح حاليًا

const ws = new WebSocket(
  'wss://api.benzinga.com/api/v1/transcripts/stream?token=YOUR_TOKEN'
);

ws.onopen = () => {
  // الاشتراك في نصوص محاضر Apple
  ws.send(JSON.stringify({
    action: 'subscribe',
    ticker: 'AAPL'
  }));
};

ws.onmessage = (event) => {
  const data = JSON.parse(event.data);

  // عرض الجملة مع اسم المتحدث
  console.log(`[${data.sequence}] ${data.speaker}: ${data.sentence}`);

  // التحقق من اكتمال المحضر
  if (data.status === 'COMPLETE') {
    console.log('Transcript finished');
  }
};

// الحفاظ على الاتصال نشطاً
setInterval(() => {
  ws.send(JSON.stringify({ action: 'ping' }));
}, 30000);

• مقدمة ويب سوكيت - مفاهيم ويب سوكيت العامة وأساسيات الاتصال
• المصادقة - كيفية الحصول على رموز وصول واجهة برمجة التطبيقات API واستخدامها

{
  "action": "list"
}

No examples found