Endpoints

Live events

List currently live and upcoming earnings calls being streamed.

GEThttps://edge.alpha.earningscall.dev/live

Returns the calls EarningsCall is actively streaming right now, plus any that are about to start. Each event includes a streaming_url, an HLS playlist you can hand to your own audio player.

Responses are cached for 60 seconds.

live_transcript is experimental and its shape may change. It is null when a call has no live transcript, and always null for the demo key.

The list comes back under events, next to a meta object that carries the request id and the item count — see the response envelope.

Parameters#

apikeystringRequired
Your API key. No other parameters.

Examples#

List live calls right now#

curl 'https://edge.alpha.earningscall.dev/live?apikey=demo'

Response

{
  "events": [
    {
      "exchange": "NASDAQ",
      "symbol": "AAPL",
      "year": 2024,
      "quarter": 4,
      "company_name": "Apple Inc.",
      "event_date": "2024-11-01T17:00:00Z",
      "streaming_url": "https://earningscall.biz/live-demo/dynamic-playlist/playlist.m3u8",
      "live_transcript": null
    }
  ],
  "meta": {
    "request_id": "794066d2-edd9-4a9b-a080-ce213ad019af",
    "total": 1,
    "next_cursor": null
  }
}

Error responses#

See the Errors page for the full error format. This endpoint can return:

401invalid_api_key — Auth failure.429rate_limit_exceeded — Plan rate limit exceeded.503service_unavailable — Live events cache is cold. Retry after 5 seconds.