Skip to main content
Descriptive alt text

Overview

The live audio dataset provides access to live audio streams from regular earnings calls, capital market days, M&A announcements, conferences, and more – with close to zero delays. The dataset is continuously updated as new audio streams become available.

How it works

The API supports live streaming using the M3U8 format, a standard for HTTP Live Streaming (HLS). When a live stream request is made, the API returns an M3U8 URL. This URL can be used with any compatible media player to access the live stream. The M3U8 file acts as a playlist, referencing a series of audio segments that are updated in real time.

How to access this data

REST API

Query with filtering by ticker, ISIN, date, and more.

Webhooks

Subscribe to live.audio.updated events for real-time updates.

Live states

A lot can happen during an event, the API provides the state property to indicate the current state of the live audio stream. The query parameter states can be used to filter events based on their state. The possible values for the property are:
  • notLive: The event is not live.
  • willBeLive: The event is scheduled to go live.
  • live: The event is currently live.
  • processingRecording: The event audio is being processed.
  • recordingAvailable: The event audio is available for playback.
You can include multiple states in the query by separating them with a comma. This is useful when you want to get both live and upcoming events.

Example

Below is an example of how to consume a live audio stream using hls.js. Replace the audioUrl with the audioUrl from the API response.
const audioUrl = 'your-audio-stream.m3u8'; // from API response
const audio = document.getElementById('audioPlayer');

if (Hls.isSupported()) {
  const hls = new Hls();
  hls.loadSource(audioUrl);
  hls.attachMedia(audio);
} else if (audio.canPlayType('application/vnd.apple.mpegurl')) {
  audio.src = audioUrl;
}