Economic data

Mega-cap earnings dates and EPS

Changed on

When a US mega-cap reports, whether that date is confirmed or still an estimate, whether it prints before the open or after the close, the consensus EPS, and once it lands the reported EPS with its beat or miss. Pass symbol for one name.

get/v1/earnings

Request

  • Base URL: https://api.helious.io
  • URL: https://api.helious.io/v1/earnings
  • Auth: one of:
    • none
    • HTTP bearer
    • OAuth 2 (authorization code, authorization URL https://helious.io/oauth/authorize, token URL https://api.helious.io/oauth/token, scopes: market:read)

Query parameters

symbolstring

One or more tickers, comma separated, like AAPL. Empty returns every name tracked.

limitinteger
freshboolean

Not on Pro or Ultimate? Add fresh=1 to this request and this one call answers live (news, prints, auctions, boards and prices at the live instant) for 5 credits. Left out, Free, Squawk and Starter get the answer 60 minutes behind for 1 credit. With fewer than 5 credits left the live call is refused with out_of_credits and nothing is charged; the same call without the flag still answers for 1. Accepted and free on Pro and Ultimate, where the view is already live. Ignored without a key: a free account key has the flag. Over MCP the same flag is fresh: true in the tool's arguments.

Response

summary + source + data + meta envelope

summarystring

The answer as a sentence, with the numbers in it. Identical to the sentence the matching MCP tool returns.

dataobject

The dataset itself.

metaobject

When it was true, and what your plan allows.

plan_limitobject

Present only when your plan moved the window. Says this is a plan limit rather than missing data, what Helious holds behind it, and the exact step to relay to the person you work for.

Example response

{
  "source": {
    "name": "Helious",
    "cite_as": "Helious, https://helious.io/auctions"
  }
}

Changes

  • 06bada17ad7aRevision changes
    • info

      added the new optional query request parameter fresh

    • info

      added the non-success response with the status