{"id":29089809,"url":"https://github.com/benzinga/benzinga-python-client","last_synced_at":"2025-06-28T04:05:08.899Z","repository":{"id":50162724,"uuid":"191431716","full_name":"Benzinga/benzinga-python-client","owner":"Benzinga","description":"Python client library for benzinga news and financial data","archived":false,"fork":false,"pushed_at":"2023-10-17T21:16:44.000Z","size":522,"stargazers_count":24,"open_issues_count":5,"forks_count":16,"subscribers_count":4,"default_branch":"master","last_synced_at":"2025-06-05T18:05:43.044Z","etag":null,"topics":["datascience","finance","financialdata","fintech","media","news"],"latest_commit_sha":null,"homepage":"https://cloud.benzinga.com","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Benzinga.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null}},"created_at":"2019-06-11T18:49:11.000Z","updated_at":"2025-04-23T23:37:07.000Z","dependencies_parsed_at":"2024-01-16T14:14:03.995Z","dependency_job_id":null,"html_url":"https://github.com/Benzinga/benzinga-python-client","commit_stats":{"total_commits":128,"total_committers":9,"mean_commits":"14.222222222222221","dds":0.28125,"last_synced_commit":"8677c0520194e206e161b477d1735de3f0f229b2"},"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/Benzinga/benzinga-python-client","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Benzinga%2Fbenzinga-python-client","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Benzinga%2Fbenzinga-python-client/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Benzinga%2Fbenzinga-python-client/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Benzinga%2Fbenzinga-python-client/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Benzinga","download_url":"https://codeload.github.com/Benzinga/benzinga-python-client/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Benzinga%2Fbenzinga-python-client/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":262371674,"owners_count":23300596,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["datascience","finance","financialdata","fintech","media","news"],"created_at":"2025-06-28T04:05:06.831Z","updated_at":"2025-06-28T04:05:08.882Z","avatar_url":"https://github.com/Benzinga.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"![Benzinga Logo](https://raw.githubusercontent.com/Benzinga/benzinga-python-client/master/logo/Benzinga_Logo-navy.png)\n# Benzinga's Python Client Library's Documentation\n\nBenzinga's Python client library focuses on financial data methods, that can be used for quantitative analysis, and on news data from Benzinga, that can help give meaningful insights that complement quantitative data.\n\n## Table of Contents\n- [Benzinga Python Client](#benzinga-python-client)\n  * [Getting Started](#getting-started)\n  * [Your Key](#your-key)\n  * [Sample Test Financial Data Module](#sample-test-financial-data-module)\n  * [Sample Test News Data Module](#sample-test-news-data-module)\n  * [Financial Data Methods:](#financial-data-methods-)\n    + [Price History](#price-history)\n    + [Auto-Complete](#auto-complete)\n    + [Security](#security)\n    + [Chart](#chart)\n    + [Quote](#quote)\n    + [Instruments](#instruments)\n    + [Dividends](#dividends)\n    + [Ratings](#ratings)\n    + [Earnings](#earnings)\n    + [Splits](#splits)\n    + [Economics](#economics)\n    + [Guidance](#guidance)\n    + [IPO](#ipo)\n    + [Retail](#retail)\n    + [Conference Calls](#conference-calls)\n    + [Fundamentals](#fundamentals)\n    + [Financials](#financials)\n    + [Valuation Ratios](#valuation-ratios)\n    + [Earning Ratios](#earning-ratios)\n    + [Operation Ratios](#operation-ratios)\n    + [Share Class](#share-class)\n    + [Earning Reports](#earning-reports)\n    + [Alpha Beta](#alpha-beta)\n    + [Company Profile](#company-profile)\n    + [Company](#company)\n    + [Share Class Profile History](#share-class-profile-history)\n    + [Asset Classification](#asset-classification)\n    + [Summary](#summary)\n    + [Logos](#logos)\n    + [Movers](#movers)\n    + [Ticker Detail](#ticker-detail)\n  * [News Data:](#news-data-)\n    + [News](#news)\n    + [Top News](#top-news)\n    + [Channels](#channels)\n    + [Quantified News](#quantified-news)\n  * [Additional Links](#additional-links)\n\n## Getting Started\n\nThe basic installation instructions are as follows (Recommended):\n\n\n```shell\npip install git+ssh://git@github.com/Benzinga/benzinga-python-client.git\n```\n\nOnce you have successfully installed the package, you can either import the\nFinancial Data module, for quantitative financial data:\n```python\nfrom benzingaorg import financial_data\n```\nor you can import the Benzinga News Data module, if you're looking into financial news:\n```python\nfrom benzingaorg import news_data\n```\n\n## Your Key\n\n**Api Key** To initiate a class, an API key is used, for\nauthentication purposes. [Contact us](https://cloud.benzinga.com/lets-talk/) if you don't yet have a key, we will take care of you!\n\n*Sample API Key (type: str) : \"testkey892834789s9s8abshtuy\"*\n\n## Sample Test Financial Data Module\n\n1. Initiating the class:\n\n```python\nfrom benzingaorg import financial data\napi_key = \"testkey892834789s9s8abshtuy\"\nfin = financial_data.Benzinga(api_key)\n```\n\n2. A sample test run to get ratings on a stock. (Returns a JSON object):\n\n```python\nstock_ratings = fin.ratings()\n```\n\n3. Since `fin.ratings()` returns a JSON dict, for a better view of the dict,\nyou can call the `fin.output()` method on the result. Example:\n\n```python\nfin.output(stock_ratings)\n```\n\n## Sample Test News Data Module\n\n1. Initiating the class:\n\n```python\nfrom benzingaorg import news_data\napi_key = \"testkey892834789s9s8abshtuy\"\nnews = news_data.News(api_key)\n```\n\n2. A sample test run to get general news. (Returns a JSON Object)\n\n```python\nstories = news.news()\n```\n\n3. Since `fin.news()` returns a JSON dict, for a better view of the dict,\nyou can call the `fin.output()` method on the result. Example:\n\n```python\nnews.output(stories)\n```\n\nIt is important to note that for both the Financial Data Module and the News Data Module, there are many **Optional** parameters for the methods. Below is a detailed listing of possible methods for the Financial Data Module and the news Data Module, their method\ncall names, arguments, and what they return.\n\n## Financial Data Methods:\n\n### Price History\n\n```python\nfin.price_history()\n```\nPublic Method: Benzinga Price History returns daily candles for a specific date range for a company.\n* Arguments:\n    * **Required** - company_tickers ****(str)****\n    * **Required** - date_from ****(str)**** - \"YYYY-MM-DD\"\n    * **Required** - date_to ****(str)**** - \"YYYY-MM-DD\"\n\n* Returns:\n    * Daily candles for the company for a specific date range\n\n\n### Auto-Complete\n\n```python\nfin.auto_complete()\n```\n\nPublic Method: Benzinga Auto-Complete returns the relevant information related to a company ticker.\n* Arguments:\n    * **Required** - company_tickers ****(str)****\n    * **Optional**:\n    * limit ****(int)**** - Limits the number of results to input.\n    * search_method ****(str)**** - You can enter either \"SYMBOL\", which does a prefix match on symbol, or\n    \"SYMBOL_NAME\" which does a prefix match on symbol and prefix match on any word in the name, or\n    you can enter \"SYMBOL_WITHIN\" which matches any part of the symbol.\n    * exchanges ****(str)**** - If this value is present, then it will only include those exchanges.\n    * types ****(str)**** You can enter either \"STOCK\", \"TYPE\" or \"OEF\".\n\n* Returns:\n    * Relevant information such as company name of short name, type and exchange\n\n### Security\n\n```python\nfin.security()\n```\n\nPublic Method: Benzinga Security returns the information regarding the security.\n* Arguments:\n    * **Required** - company_tickers ****(str)****\n        * **Optional**:\n        * cusip ****(str)****\n\n* Returns:\n    * Symbol, exchange symbol, exchange, country, currency, cusip and description\n\n### Chart\n\n```python\nfin.chart()\n```\n\nPublic Method: Benzinga Chart looks at detailed price values over a period of time.\n* Arguments:\n    * **Required** - company_tickers ****(str)****\n    * **Required** - date_from ****(str)**** For date_from, you can enter \"YTD\" for the first trading day of the year. \"1d\", \"5d\" or \"1m\". You can also enter the date from in the \"YY-MM-DD\"format too.\n    * **Optional**:\n    * date_to ****(str)**** - \"YY-MM-DD\"\n    * interval ****(str)*** -  \"1MONTH\", \"1W\", \"1D\", \"1H\", \"15M\". Default: \"5M\"\n    * session ****(str)**** - \"ANY\", \"REGULAR\"\n\n\n* Returns:\n    * open, high, low, close, volume, time, dateTime\n\n\n### Quote\n\n```python\nfin.quote()\n```\n\nPublic Method: Benzinga Quote looks at many different attributes of the ticker like high, low, close etc\n\n* Arguments:\n    * **Required** - company_tickers ****(str)****\n\n* Returns:\n    *   symbol, dxsymbol, exchange, bzexchange, isoexchange, type, name, description, open\n        high, low, close, bid price, ask price, ask size, size, bid time, ask time, last trade price, last\n        trade time, volume, change, change percent, previous close price, fifty day average price,\n        fifty two week high, fifty two week low, dividend yield, price/earnings, forward price/earnings,\n        payout ratio, shares outstanding, open interest, shares per contract, multiplier.\n\n### Instruments\n\n```python\nfin.instruments()\n```\n\nPublic Method: Benzinga Instruments looks at all of the screener data with price statistics, based\n         on different attributes.\n* Arguments:\n    * **Optional**:\n    * date_from ****(str)**** - \"YYYY-MM-DD\"\n    * date_to ****(str)**** - \"YYYY-MM-DD\"\n    * date_asof ****(str)**** - \"YYYY-MM-DD\"\n    * market_cap_gt ****(str)**** - market cap greater than \"1b\" etc\n    * market_cap_lt ****(str)**** - market cap less than \"1b\" etc\n    * close_gt ****(str)**** - close price greater than.\n    * sector ****(str)**** - sector like \"healthcare\"\n    * sort field ****(str)**** - field to sort by (un-tested)\n    * sortdir ****(str)**** - direction of sort (un-tested)\n\n* Returns:\n    * all of the data related to the instrument including marketcap, sector, company name\n         etc, that can be found on the Benzinga Pro screener.\n\n### Dividends\n\n```python\nfin.dividends()\n```\n\nPublic Method: Benzinga Dividends looks at the relevant dividend information for a\n         company.\n\n* Arguments:\n    * **Optional**:\n    * page ****(int)**** - page offset\n    * pagesize ****(int)**** - limit of results returned\n    * date_asof ****(str)**** - \"YYYY-MM-DD\"\n    * date_from ****(str)**** - \"YYYY-MM-DD\"\n    * date_to ****(str)**** - \"YYYY-MM-DD\"\n    * company_tickers ****(str)****\n    * importance - ****(int)**** - not tested yet.\n    * date_sort - ****(str)**** - Dividend date field to sort on (\"ex\", \"payable\", \"record\")\n    * updated_params **(int64)** - records last updated unix time stamp. Forces the\n    * sort order to be greater or equal to the time stamp indicated.\n    * div_yield_operation ****(str)**** - to filter the div yield by for eg. \"gt\", \"gte\",\n     \"eq\", \"lte\", \"lt\". Not tested\n    * div_yield ****(int)**** - div yield amount fo filter by. \"1\" for 100% or above.\n\n* Returns:\n    * the id, date, updated, isin, ticker, name, exchange, frequency, dividend,\n     dividend prior, dividend type, dividend yield, ex-dividend date, payable date,\n     record date, importance\n\n### Ratings\n\n```python\nfin.ratings()\n```\n\nPublic Method: Benzinga Ratings looks at ratings from different firms\n\n* Arguments:\n    * **Optional**:\n    * page **(int)** - page offset\n    * pagesize **(int)** - limit of results returned\n    * date_asof **(str)** - \"YYYY-MM-DD\"\n    * date_from **(str)** - \"YYYY-MM-DD\"\n    * date_to **(str)** - \"YYYY-MM-DD\"\n    * company_tickers **(str)**\n    * importance - **(int)** - not tested yet.\n    * date_sort - **(str)** - Dividend date field to sort on\n    * updated_params **(int64)** - records last updated unix time stamp. Forces the\n    sort order to be greater or equal to the time stamp indicated.\n    * action - **(str)** - \" Upgrades , Downgrades , Maintains , Lowers , Raises ,\n    Initiates Coverage On , Terminates Coverage On\"\n\n* Returns:\n    * id, date, time, ticker, exchange, name, action_pt, action_company, rating_current,\n    pt_current, rating_prior, pt_prior, url, importance, updated, url_calendar, url_news,\n    analyst, analyst_name\n\n### Earnings\n\n```python\nfin.earnings()\n```\n\nPublic Method: Benzinga Earnings looks at the quarterly earnings reports for different\n        companies.\n\n* Arguments:\n    * **Optional**:\n    * page ****(int)**** - page offset\n    * pagesize ****(int)**** - limit of results returned\n    * date_asof ****(str)**** - \"YYYY-MM-DD\"\n    * date_from ****(str)**** - \"YYYY-MM-DD\"\n    * date_to ****(str)**** - \"YYYY-MM-DD\"\n    * company_tickers ****(str)****\n    * importance - ****(int)**** - not tested yet.\n    * date_sort - ****(str)**** - Dividend date field to sort on\n    * updated_params **(int64)** - records last updated unix time stamp. Forces the\n     sort order to be greater or equal to the time stamp indicated.\n\n* Returns:\n    * id, date, date confirmed, time, isin, ticker, exchange, name, period, period_year,\n    eps, eps_est, eps_prior, eps_surprise, eps_surprise_percent, revenue, revenue est,\n    revenue_prior, revenue_surprise, revenue_surprise_percent, importance, updated\n\n### Splits\n\n```python\nfin.splits()\n```\n\nPublic Method: Benzinga Splits looks at the stock splits calendar data\n\n* Arguments:\n    * **Optional**:\n    * page ****(int)**** - page offset\n    * pagesize ****(int)**** - limit of results returned\n    * date_asof ****(str)**** - \"YYYY-MM-DD\"\n    * date_from ****(str)**** - \"YYYY-MM-DD\"\n    * date_to ****(str)**** - \"YYYY-MM-DD\"\n    * company_tickers ****(str)****\n    * importance - ****(int)**** - not tested yet.\n    * date_sort - ****(str)**** - Dividend date field to sort on\n    * updated_params **(int64)** - records last updated unix time stamp. Forces the\n    sort order to be greater or equal to the time stamp indicated.\n\n* Returns:\n    * id, updated, date, time, ticker, exchange, importance, ratio, optionable,\n     date_ex, date_recorded, date_distribution\n\n### Economics\n\n```python\nfin.economics()\n```\n\nPublic Method: Benzinga Economics looks at different economic events in a country.\n\n* Arguments:\n    * **Optional**:\n    * page ****(int)**** - page offset\n    * pagesize ****(int)**** - limit of results returned\n    * date_asof ****(str)**** - \"YYYY-MM-DD\"\n    * date_from ****(str)**** - \"YYYY-MM-DD\"\n    * date_to ****(str)**** - \"YYYY-MM-DD\"\n    * company_tickers ****(str)****\n    * importance - ****(int)**** - not tested yet.\n    * date_sort - ****(str)**** - Dividend date field to sort on\n    * updated_params **(int64)** - records last updated unix time stamp. Forces the\n    sort order to be greater or equal to the time stamp indicated.\n    * country ****(str)**** - 3 digit country code\n\n* Returns:\n    * id, date, time, country, event_name, event_period, period_year, actual, actual_t\n    consensus, consensus_t, prior, importance, updated, description\n\n### Guidance\n\n```python\nfin.guidance()\n```\n\nPublic Method: Benzinga Guidance looks at different attributes like revenue guidance etc.\n* Arguments:\n    * **Optional**:\n    * page ****(int)**** - page offset\n    * pagesize ****(int)**** - limit of results returned\n    * date_asof ****(str)**** - \"YYYY-MM-DD\"\n    * date_from ****(str)**** - \"YYYY-MM-DD\"\n    * date_to ****(str)**** - \"YYYY-MM-DD\"\n    * company_tickers ****(str)****\n    * importance - ****(int)**** - not tested yet.\n    * date_sort - ****(str)**** - Dividend date field to sort on\n    * updated_params **(int64)** - records last updated unix time stamp. Forces the\n    sort order to be greater or equal to the time stamp indicated.\n    * country ****(str)**** - 3 digit country code\n\n\n* Returns:\n    * id, date, time, ticker, exchange, name, period, period_year, prelim, eps_guidance_est,\n    eps_guidance_max, eps_guidance_min, eps_guidance_prior_max, eps_guidance_prior_min,\n    revenue_guidance_est, revenue_guidance_max, revenue_guidance_min, revenue_guidance_prior_max\n    , revenue_guidance_prior_min, importance, updated\n\n### IPO\n\n```python\nfin.ipo()\n```\n\nPublic Method: Benzing IPO looks at initial public offering data for companies.\n* Arguments:\n    * **Optional**:\n    * page ****(int)**** - page offset\n    * pagesize ****(int)**** - limit of results returned\n    * date_asof ****(str)**** - \"YYYY-MM-DD\"\n    * date_from ****(str)**** - \"YYYY-MM-DD\"\n    * date_to ****(str)**** - \"YYYY-MM-DD\"\n    * company_tickers ****(str)****\n    * importance - ****(int)**** - not tested yet.\n    * date_sort - ****(str)**** - Dividend date field to sort on\n    * updated_params **(int64)** - records last updated unix time stamp. Forces the\n    sort order to be greater or equal to the time stamp indicated.\n\n\n* Returns:\n    * id, date, time, ticker, exchange, name, pricing_date, price_min, price_max, deal_status,\n    insider_lockup_days, insider_lockup_date, offering_value, offering_shares, lead_underwriters,\n    underwriter_quiet_expiration_days, underwriter_quiet_expiration_date, update\n\n### Retail\n\n```python\nfin.retail()\n```\n\nPublic Method: Benzinga Retail looks at retail data.\n\n* Arguments:\n    * **Optional**:\n    * page ****(int)**** - page offset\n    * pagesize ****(int)**** - limit of results returned\n    * date_asof ****(str)**** - \"YYYY-MM-DD\"\n    * date_from ****(str)**** - \"YYYY-MM-DD\"\n    * date_to ****(str)**** - \"YYYY-MM-DD\"\n    * company_tickers ****(str)****\n    * importance - ****(int)**** - not tested yet.\n    * date_sort - ****(str)**** - Dividend date field to sort on\n    * updated_params **(int64)** - records last updated unix time stamp. Forces the\n    sort order to be greater or equal to the time stamp indicated.\n\n\n* Returns:\n    * id, date, time, ticker, exchange, name, importance, period, period_year, sss,\n    sss_est, retail_surprise, updated\n\n### Conference Calls\n\n```python\nfin.conference_calls()\n```\n\nPublic Method: Benzinga Conference calls looks at conference calls.\n* Arguments:\n    * **Optional**:\n    * page ****(int)**** - page offset\n    * pagesize ****(int)**** - limit of results returned\n    * date_asof ****(str)**** - \"YYYY-MM-DD\"\n    * date_from ****(str)**** - \"YYYY-MM-DD\"\n    * date_to ****(str)**** - \"YYYY-MM-DD\"\n    * company_tickers ****(str)****\n    * importance - ****(int)**** - not tested yet.\n    * date_sort - ****(str)**** - Dividend date field to sort on\n    * updated_params **(int64)** - records last updated unix time stamp. Forces the\n    sort order to be greater or equal to the time stamp indicated.\n    * country ****(str)**** - 3 digit country code\n\n* Returns:\n    * id, date, time, ticker, exchange, name, start_time, phone_num, international_line,\n    reservation_num, access_code, webcase_url, importance, updated\n\n### Fundamentals\n\n```python\nfin.fundamentals()\n```\n\nPublic Method: Benzinga Fundamentals looks at overall financial data for a company.\n\n* Arguments:\n    * **Required** - company_tickers ****(str)****\n    * **Optional**:\n    * isin ****(str)**** - specifies company data to return.\n    * cik ****(str)**** - cik identifier\n    * date_asof ****(str)**** \"YYYY-MM-DD\"\n\n* Returns:\n    * company, companyProfile, shareClass, earningReports, financialStatements, operation earning and valuation\n     ratios, alphaBeta\n\n### Financials\n\n```python\nfin.financials()\n```\n\nPublic Method: Benzinga Financials looks at overall financial data like  for a company.\n\n* Arguments:\n    * **Required** - company_tickers ****(str)****\n    * **Optional**:\n    * isin ****(str)**** - specifies company data to return.\n    * cik ****(str)**** - cik identifier\n    * date_asof ****(str)**** \"YYYY-MM-DD\"\n    * period ****(str)**** - select from (3M , 6M , 9M , 12M , 1Y)\n    * reporttype ****(str)**** - select from (TTM, A (default), R,P)\n\n* Returns:\n    * company, financials such as balance sheet information, assets and liabilities\n\n\n### Valuation Ratios\n\n```python\nfin.valuation_ratios()\n```\n\nPublic Method: Benzinga Valuation Ratios looks at overall financial data like  for a company.\n\n* Arguments:\n    * **Required** - company_tickers ****(str)****\n    * **Optional**:\n    * isin ****(str)**** - specifies company data to return.\n    * cik ****(str)**** - cik identifier\n    * date_asof ****(str)**** \"YYYY-MM-DD\"\n\n\n* Returns:\n    * different attributes of the valuation ratios\n\n### Earning Ratios\n\n```python\nfin.earning_ratios()\n```\n\nPublic Method: Benzinga Earning Ratios\n\n* Arguments:\n    * **Required** - company_tickers ****(str)****\n    * **Optional**:\n    * isin ****(str)**** - specifies company data to return.\n    * cik ****(str)**** - cik identifier\n    * date_asof ****(str)**** \"YYYY-MM-DD\"\n\n\n* Returns:\n    * different attributes of the earning ratios\n\n### Operation Ratios\n\n```python\nfin.operation_ratios()\n```\n\nPublic Method: Benzinga Operation Ratios\n\n* Arguments:\n    * **Required** - company_tickers ****(str)****\n    * **Optional**:\n    * isin ****(str)**** - specifies company data to return.\n    * cik ****(str)**** - cik identifier\n    * date_asof ****(str)**** - \"YYYY-MM-DD\"\n\n* Returns:\n    * different attributes of the operation ratios\n\n### Share Class\n\n```python\nfin.share_class()\n```\n\nPublic Method: Benzinga Share Class\n\n* Arguments:\n    * **Required** - company_tickers ****(str)****\n    * ****Optional****:\n    * isin ****(str)**** - specifies company data to return.\n    * cik ****(str)**** - cik identifier\n    * date_asof ****(str)**** - \"YYYY-MM-DD\"\n\n* Returns:\n    * different attributes of the share class.\n\n\n### Earning Reports\n\n```python\nfin.earning_reports()\n```\n\nPublic Method: Benzinga Earning Reports looks at overall earning reports for a company.\n\n* Arguments:\n    * **Required** - company_tickers ****(str)****\n    * **Optional**:\n    * isin ****(str)**** - specifies company data to return.\n    * cik ****(str)**** - cik identifier\n    * date_asof ****(str)**** - \"YYYY-MM-DD\"\n\n* Returns:\n    * different attributes of the earning reports.\n\n### Alpha Beta\n\n```python\nfin.alpha_beta()\n```\n\nPublic Method: Benzinga Alpha Beta\n\n* Arguments:\n    * **Required** - company_tickers ****(str)****\n    * **Optional**:\n    * isin ****(str)**** - specifies company data to return.\n    * cik ****(str)**** - cik identifier\n    * date_asof ****(str)**** - \"YYYY-MM-DD\"\n\n* Returns:\n    * different attributes of alphabeta.\n\n\n### Company Profile\n\n```python\nfin.company_profile()\n```\n\nPublic Method: Benzinga Company Profile\n\n* Arguments:\n    * **Required** - company_tickers ****(str)****\n    * **Optional**:\n    * isin ****(str)**** - specifies company data to return.\n    * cik ****(str)**** - cik identifier\n    * date_asof ****(str)**** - \"YYYY-MM-DD\"\n\n* Returns:\n    * different attributes of company profile.\n\n### Company\n\n```python\nfin.company()\n```\n\nPublic Method: Benzinga Company\n\n* Arguments:\n    * **Required** - company_tickers ****(str)****\n    * **Optional**:\n    * isin ****(str)**** - specifies company data to return.\n    * cik ****(str)**** - cik identifier\n    * date_asof ****(str)**** - \"YYYY-MM-DD\"\n\n* Returns:\n    * different attributes of the company.\n\n\n### Share Class Profile History\n\n```python\nfin.share_class()\n```\n\nPublic Method: Benzinga Share Class Profile History\n\n* Arguments:\n    * **Required** - company_tickers ****(str)****\n    * **Optional**:\n    * isin ****(str)**** - specifies company data to return.\n    * cik ****(str)**** - cik identifier\n    * date_asof ****(str)**** - \"YYYY-MM-DD\"\n\n* Returns:\n    * different attributes of share class profile history.\n\n\n### Asset Classification\n\n```python\nfin.asset_classification()\n```\n\nPublic Method: Benzinga Asset Classification\n\n* Arguments:\n    * **Required** - company_tickers ****(str)****\n    * **Optional**:\n    * isin ****(str)**** - specifies company data to return.\n    * cik ****(str)**** - cik identifier\n    * date_asof ****(str)**** - \"YYYY-MM-DD\"\n\n* Returns:\n    * different attributes of the asset classification.\n\n### Summary\n\n```python\nfin.summary()\n```\n\nPublic Method: Summary\n* Arguments:\n    * **Required** - company_tickers ****(str)****\n    * **Optional**:\n    * isin ****(str)**** - specifies company data to return.\n    * cik ****(str)**** - cik identifier\n    * date_asof ****(str)**** - \"YYYY-MM-DD\"\n\n* Returns:\n    * different attributes of the summary.\n\n\n### Logos\n\n```python\nfin.logos()\n```\n\nPublic Method: Benzinga Logos\n\n* Arguments:\n    * **Required** - company_tickers ****(str)****\n    * **Optional**:\n    * filters ****(str)**** - specifies company data to return.\n\n* Returns:\n    * different attributes of the logos\n\n### Movers\n\n```python\nfin.movers()\n```\n\nPublic Method: Movers Data on Gainers and Losers\n\n* Arguments:\n    * **Optional**:\n    * session ****(str)**** - \"PRE_MARKET, REGULAR, AFTER_MARKET\n    * period_from ****(str)**** - \"YYYY-MM-DD\"\n    * period_to ****(str)**** - \"YYYY-MM-DD\" default is the most recent timestamp\n    * max_results ******(int)****** - default 10\n    * market_cap_gt ****(str)**** - market cap greater than \"1b\" etc\n    * market_cap_lt ****(str)**** - market cap less than \"1b\" etc\n    * close_gt ****(str)**** - close price greater than.\n    * sector ****(str)**** - sector like \"healthcare\"\n\n* Returns:\n    * different attributes of the gainers and the losers.\n\n### Ticker Detail\n\n```python\nfin.ticker_detail()\n```\n\nPublic Method: Benzinga Ticker detail provides key statistics, peers, and percentile information on the company.\n\n* Arguments:\n    * **Required** - company_tickers ****(str)****\n\n* Returns:\n    *  Key statistics, peer information and percentile information on the ticker.\n\n### Options Activity\n\n```python\nfin.options_activity()\n```\nPublic Method: Benzinga Options Activity\n\n* Arguments:\n    * **Required** - company_tickers ****(str)****\n    * **Optional**:\n    * pagesize ****(int)**** - Limit is set to 1000\n    * page ****(int)****\n    * date ****(str)**** - \"YYYY-MM-DD\"\n    * date_from ****(str)**** - \"YYYY-MM-DD\"\n    * date_to ****(str)**** - \"YYYY-MM-DD\"\n\n* Returns:\n    * Different attributes for options activity.\n\n\n\n## News Data:\n\n```python\nfin.news()\n```\n### News\n\nPublic Method: Benzinga News\n\n* Arguments:\n    * **Optional**:\n    * pagesize ****(int)**** - default is 15\n    * page ****(int)**** - default is 0\n    * display_output ****(str)**** - select from (full, abstract, headline)\n    * base_date ****(str)**** - \"YYYY-MM-DD\" The date to query for calendar data. Shorthand for date_from and date_to if\n      they are the same. Defaults for latest.\n    * date_from ****(str)**** - \"YYYY-MM-DD\"\n    * date_to ****(str)**** - \"YYYY-MM-DD\"\n    * last_id ****(str)**** - The last ID to start paging from and sorted by and sorted by the last updated date.\n    * updated_since ****(str)**** - he last updated unix timestamp (UTC) to pull and sort by.\n    * publish_since ****(str)**** - The last publish unix  timestamp (UTC) to pull and sort by.\n    * company_tickers ****(str)****\n    * channel ****(str)**** - multiple channels separated by comma.\n\n* Returns:\n    * Author, created, updated, title, teaser, body, url, image, channels, stocks, tags\n\n\n### Top News\n\n```python\nnews.top_news()\n```\n\nPublic Method: Benzinga Top News\n\n* Arguments:\n   * **Optional**:\n   * type ****(str)**** - The type of content to select\n   * channel ****(str)**** - multiple channels separated by comma.\n   * limit ****(str)**** - max period\n   * display_output ****(str)**** - select from (full, abstract, headline)\n\n* Returns:\n   * Author, created, updated, title, teaser, body, url, image, channels, stocks, tags\n\n### Channels\n\n```python\nnews.channels()\n```\n\nPublic Method: Benzinga Channels only focuses on Channel IDs. The below arguments will have no impact\n        on what is returned. It is just for reference.\n\n* Arguments:\n    * **Optional**:\n    * pagesize ****(int)**** - default is 15\n    * page ****(int)**** - default is 0\n    * display_output ****(str)**** - select from (full, abstract, headline)\n    * base_date ****(str)**** - \"YYYY-MM-DD\" The date to query for calendar data. Shorthand for date_from and date_to if\n      they are the same. Defaults for latest.\n    * date_from ****(str)**** - \"YYYY-MM-DD\"\n    * date_to ****(str)**** - \"YYYY-MM-DD\"\n    * last_id ****(str)**** - The last ID to start paging from and sorted by and sorted by the last updated date.\n    * updated_since ****(str)**** - he last updated unix timestamp (UTC) to pull and sort by.\n    * publish_since ****(str)**** - The last publish unix  timestamp (UTC) to pull and sort by.\n    * company_tickers ****(str)****\n    * channel ****(str)**** - multiple channels separated by comma.\n\n* Returns:\n   * Channel name, channel id.\n\n### Quantified News\n\n```python\nnews.quantified_news()\n```\n\nPublic Method: Benzinga Quantified News\n\n* Arguments:\n   * **Optional**:\n   * pagesize ****(int)**** - default is 15\n   * page ****(int)**** - default is 0\n   * base_date ****(str)**** - \"YYYY-MM-DD\" The date to query for calendar data. Shorthand for date_from and date_to if\n     they are the same. Defaults for latest.\n   * date_from ****(str)**** - \"YYYY-MM-DD\"\n   * date_to ****(str)**** - \"YYYY-MM-DD\"\n   * updated_since ****(str)**** - he last updated unix timestamp (UTC) to pull and sort by.\n   * publish_since ****(str)**** - The last publish unix  timestamp (UTC) to pull and sort by.\n\n* Returns:\n   * multiple attributes like headlines, volume, day open, open gap, range etc.\n\n\n## Additional Links\n\n* Benzinga News: https://www.benzinga.com/\n* Benzinga Pro: https://pro.benzinga.com/\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbenzinga%2Fbenzinga-python-client","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbenzinga%2Fbenzinga-python-client","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbenzinga%2Fbenzinga-python-client/lists"}