API Docs

Sign in to try

Sign in to request data

Sign in

/benzinga/benzinga_earnings_calendar/tickers

Returns a list of benzinga ticker symbols. This list is updated daily.

page

Specific page of a paginated result to be displayed

Example: 0

page_size

Number of items displayed per page in a paginated result

Default value: 1000

ticker

Filter by ticker symbol

Example: AAPL

cqs

Filter by cqs symbol

Example: ACI

cik

Filter by cik code

Example: 320193

cusip

Filter by cusip code

Example: 037833100

isin

Filter by isin code

Example: US0378331005

composite_figi

Filter by composite figi code

Example: BBG000B9XRY4

share_figi

Filter by share class figi code

Example: BBG001S5N8V8

lei

Filter by lei code

Example: HWUPKR0MPOU8FGXBT394

data

array of object
Attributes

asset_type

string
Asset type

cik

string
CIK code

composite_figi

string
FIGI Composite code

currency

string
Currency of the instrument according to the ISO 4217 standard

lei

string
LEI code

mic

string
Market identifier code (MIC) under ISO 10383 standard

security

string
Security name

share_figi

string
FIGI share class code

ticker

string
Instrument symbol (ticker)

meta

object
Request general information
Attributes

pagination

object
Pagination information
Attributes

page

integer
Current page of result

per_page

integer
Number of items displayed per page

Response

{
    "data": [
        {
            "asset_type": "COMMON_STOCK",
            "cik": "320193",
            "composite_figi": "BBG000B9XRY4",
            "currency": "USD",
            "lei": "HWUPKR0MPOU8FGXBT394",
            "mic": "nyse",
            "security": "Apple Inc.",
            "share_figi": "BBG001S5N8V8",
            "ticker": "AAPL"
        }
    ],
    "meta": {
        "pagination": {
            "page": 1,
            "per_page": 100
        }
    }
}

/benzinga/benzinga_earnings_calendar/earnings_calendar

Returns the earnings calendar from Benzinga.

ticker

Filter by ticker symbol

Example: AAPL

order

Sorting order of the output series

Values: desc asc

Default value: desc

date

Specifies the exact date to get the data for

Example: 2023-05-04

start_at

Filter events by start time using a UNIX timestamp

Example: 1681963910

end_at

Filter events by end time using a UNIX timestamp

Example: 1687209110

page

Specific page of a paginated result to be displayed

Default value: 0

page_size

Number of items displayed per page in a paginated result

Default value: 100

cqs

Filter by cqs symbol

Example: ACI

cik

Filter by cik code

Example: 320193

cusip

Filter by cusip code

Example: 037833100

isin

Filter by isin code

Example: US0378331005

composite_figi

Filter by composite figi code

Example: BBG000B9XRY4

share_figi

Filter by share class figi code

Example: BBG001S5N8V8

lei

Filter by lei code

Example: HWUPKR0MPOU8FGXBT394

data

array of object
Attributes

currency

string
The currency code of the security according to the ISO 4217 standard

date

string
Date when earnings are disbursed

date_confirmed

boolean
Indicates if the predicted date has been verified by the company

eps

object
Earnings per share for the specified reporting period
Attributes

estimated

number
EPS predicted

prior

number
EPS reported for the same period a year ago

reported

number
EPS reported

surprise

number
Difference between the predicted and the actual reported value

surprise_percent

number
Percentage difference between the predicted and the actual reported value

type

string
Type of the earnings

importance

integer
Significance of the event

mic

string
Market identifier code (MIC) under ISO 10383 standard

name

string
Full name of the instrument

notes

string
Notes

period

string
Fiscal period being reported

period_year

integer
Fiscal year being reported

record_id

string
Unique record ID from Benzinga

revenue

object
Revenue for the specified reporting period
Attributes

estimated

number
Revenue predicted

prior

number
Revenue reported for the same period a year ago

reported

number
Revenue reported

surprise

number
Difference between the predicted and the actual reported value

surprise_percent

number
Percentage difference between the predicted and the actual reported value

type

string
Type of the revenue

ticker

string
Ticker symbol of the instrument

time

string
Time when earnings are disbursed

updated

integer
Last updated timestamp (UNIX)

Response

{
    "data": [
        {
            "currency": "USD",
            "date": "2023-05-04",
            "date_confirmed": true,
            "eps": {
                "estimated": 1.43,
                "prior": 1.52,
                "reported": 1.52,
                "surprise": 0.09,
                "surprise_percent": 0.0629,
                "type": "GAAP"
            },
            "importance": 5,
            "mic": "XNGS",
            "name": "Apple",
            "notes": "",
            "period": "Q2",
            "period_year": 2023,
            "record_id": "32515085",
            "revenue": {
                "estimated": 92960000000,
                "prior": 97278000000,
                "reported": 94836000000,
                "surprise": 1876000000,
                "surprise_percent": 0.0202,
                "type": "GAAP"
            },
            "ticker": "AAPL",
            "time": "12:30:00",
            "updated": 1683232340
        }
    ]
}

/benzinga/benzinga_earnings_calendar/api_usage

Returns API usage for the current dataset

No parameters are required

api_calls

object
Attributes

limit

integer
Quota limit

usage

integer
Quota usage

api_calls_dataset

object
Attributes

limit

integer
Quota limit

usage

integer
Quota usage

api_calls_price

object
Attributes

limit

integer
Quota limit

usage

integer
Quota usage

api_calls_reference

object
Attributes

limit

integer
Quota limit

usage

integer
Quota usage

api_calls_snapshots

object
Attributes

limit

integer
Quota limit

usage

integer
Quota usage

api_calls_time_series

object
Attributes

limit

integer
Quota limit

usage

integer
Quota usage

api_calls_trades

object
Attributes

limit

integer
Quota limit

usage

integer
Quota usage

historical_api_calls

object
Attributes

limit

integer
Quota limit

usage

integer
Quota usage

Response

{
    "api_calls": {
        "limit": 1000,
        "usage": 10
    },
    "api_calls_dataset": {
        "limit": 1000,
        "usage": 10
    },
    "api_calls_price": {
        "limit": 1000,
        "usage": 10
    },
    "api_calls_reference": {
        "limit": 1000,
        "usage": 10
    },
    "api_calls_snapshots": {
        "limit": 1000,
        "usage": 10
    },
    "api_calls_time_series": {
        "limit": 1000,
        "usage": 10
    },
    "api_calls_trades": {
        "limit": 1000,
        "usage": 10
    },
    "historical_api_calls": {
        "limit": 1000,
        "usage": 10
    }
}
Finazon • Marketplace for the Global Financial Data APIs
Finazon is a financial data marketplace covering stocks, forex, cryptocurrencies and beyond. Access real-time, historical and alternative data via API & WebSocket.
Url:
credit card
Finazon LLC