Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/finnhub-stock-api/finnhub-python

Finnhub Python API Client. Finnhub API provides institutional-grade financial data to investors, fintech startups and investment firms. We support real-time stock price, global fundamentals, global ETFs holdings and alternative data. https://finnhub.io/docs/api
https://github.com/finnhub-stock-api/finnhub-python

api finnhub stock

Last synced: 6 days ago
JSON representation

Host: GitHub
URL: https://github.com/finnhub-stock-api/finnhub-python
Owner: Finnhub-Stock-API
License: apache-2.0
Created: 2020-05-20T21:54:37.000Z (over 4 years ago)
Default Branch: master
Last Pushed: 2023-10-17T07:49:12.000Z (over 1 year ago)
Last Synced: 2024-05-21T22:44:46.778Z (8 months ago)
Topics: api, finnhub, stock
Language: Python
Homepage: https://finnhub.io/
Size: 289 KB
Stars: 500
Watchers: 20
Forks: 94
Open Issues: 31
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE

Awesome Lists containing this project

README

        # finnhub-python

- API documentation: https://finnhub.io/docs/api

- API version: 1.0.0

- Package version: 2.4.21

## Installation

Install package

```sh

pip install finnhub-python

```

## Getting Started

Refer to [CHANGELOG](https://github.com/Finnhub-Stock-API/finnhub-python/blob/master/CHANGELOG.md) If you are coming from version 1

```python

import finnhub

# Setup client

finnhub_client = finnhub.Client(api_key="YOUR API KEY")

# Stock candles

res = finnhub_client.stock_candles('AAPL', 'D', 1590988249, 1591852249)

print(res)

#Convert to Pandas Dataframe

import pandas as pd

print(pd.DataFrame(res))

# Aggregate Indicators

print(finnhub_client.aggregate_indicator('AAPL', 'D'))

# Basic financials

print(finnhub_client.company_basic_financials('AAPL', 'all'))

# Earnings surprises

print(finnhub_client.company_earnings('TSLA', limit=5))

# EPS estimates

print(finnhub_client.company_eps_estimates('AMZN', freq='quarterly'))

# Company Executives

print(finnhub_client.company_executive('AAPL'))

# Company News

# Need to use _from instead of from to avoid conflict

print(finnhub_client.company_news('AAPL', _from="2020-06-01", to="2020-06-10"))

# Company Peers

print(finnhub_client.company_peers('AAPL'))

# Company Profile

print(finnhub_client.company_profile(symbol='AAPL'))

print(finnhub_client.company_profile(isin='US0378331005'))

print(finnhub_client.company_profile(cusip='037833100'))

# Company Profile 2

print(finnhub_client.company_profile2(symbol='AAPL'))

# Revenue Estimates

print(finnhub_client.company_revenue_estimates('TSLA', freq='quarterly'))

# List country

print(finnhub_client.country())

# Crypto Exchange

print(finnhub_client.crypto_exchanges())

# Crypto symbols

print(finnhub_client.crypto_symbols('BINANCE'))

# Economic data

print(finnhub_client.economic_data('MA-USA-656880'))

# Filings

print(finnhub_client.filings(symbol='AAPL', _from="2020-01-01", to="2020-06-11"))

# Financials

print(finnhub_client.financials('AAPL', 'bs', 'annual'))

# Financials as reported

print(finnhub_client.financials_reported(symbol='AAPL', freq='annual'))

# Forex exchanges

print(finnhub_client.forex_exchanges())

# Forex all pairs

print(finnhub_client.forex_rates(base='USD'))

# Forex symbols

print(finnhub_client.forex_symbols('OANDA'))

# Fund Ownership

print(finnhub_client.fund_ownership('AMZN', limit=5))

# General news

print(finnhub_client.general_news('forex', min_id=0))

# Investors ownership

print(finnhub_client.ownership('AAPL', limit=5))

# IPO calendar

print(finnhub_client.ipo_calendar(_from="2020-05-01", to="2020-06-01"))

# Major developments

print(finnhub_client.press_releases('AAPL', _from="2020-01-01", to="2020-12-31"))

# News sentiment

print(finnhub_client.news_sentiment('AAPL'))

# Pattern recognition

print(finnhub_client.pattern_recognition('AAPL', 'D'))

# Price target

print(finnhub_client.price_target('AAPL'))

# Quote

print(finnhub_client.quote('AAPL'))

# Recommendation trends

print(finnhub_client.recommendation_trends('AAPL'))

# Stock dividends

print(finnhub_client.stock_dividends('KO', _from='2019-01-01', to='2020-01-01'))

# Stock dividends 2

print(finnhub_client.stock_basic_dividends("KO"))

# Stock symbols

print(finnhub_client.stock_symbols('US')[0:5])

# Transcripts

print(finnhub_client.transcripts('AAPL_162777'))

# Transcripts list

print(finnhub_client.transcripts_list('AAPL'))

# Earnings Calendar

print(finnhub_client.earnings_calendar(_from="2020-06-10", to="2020-06-30", symbol="", international=False))

# Covid-19

print(finnhub_client.covid19())

# Upgrade downgrade

print(finnhub_client.upgrade_downgrade(symbol='AAPL', _from='2020-01-01', to='2020-06-30'))

# Economic code

print(finnhub_client.economic_code()[0:5])

# Economic calendar

print(finnhub_client.calendar_economic('2021-01-01', '2021-01-07'))

# Support resistance

print(finnhub_client.support_resistance('AAPL', 'D'))

# Technical Indicator

print(finnhub_client.technical_indicator(symbol="AAPL", resolution='D', _from=1583098857, to=1584308457, indicator='rsi', indicator_fields={"timeperiod": 3}))

# Stock splits

print(finnhub_client.stock_splits('AAPL', _from='2000-01-01', to='2020-01-01'))

# Forex candles

print(finnhub_client.forex_candles('OANDA:EUR_USD', 'D', 1590988249, 1591852249))

# Crypto Candles

print(finnhub_client.crypto_candles('BINANCE:BTCUSDT', 'D', 1590988249, 1591852249))

# Tick Data

print(finnhub_client.stock_tick('AAPL', '2020-03-25', 500, 0))

# BBO Data

print(finnhub_client.stock_nbbo("AAPL", "2020-03-25", 500, 0))

# Indices Constituents

print(finnhub_client.indices_const(symbol = "^GSPC"))

# Indices Historical Constituents

print(finnhub_client.indices_hist_const(symbol = "^GSPC"))

# ETFs Profile

print(finnhub_client.etfs_profile('SPY'))

print(finnhub_client.etfs_profile(isin="US78462F1030"))

# ETFs Holdings

print(finnhub_client.etfs_holdings('SPY'))

print(finnhub_client.etfs_holdings(isin="US00214Q1040", skip=2))

print(finnhub_client.etfs_holdings("IPO", date='2022-03-10'))

# ETFs Sector Exposure

print(finnhub_client.etfs_sector_exp('SPY'))

# ETFs Country Exposure

print(finnhub_client.etfs_country_exp('SPY'))

# International Filings

print(finnhub_client.international_filings('RY.TO'))

print(finnhub_client.international_filings(country='GB'))

# SEC Sentiment Analysis

print(finnhub_client.sec_sentiment_analysis('0000320193-20-000052'))

# SEC similarity index

print(finnhub_client.sec_similarity_index('AAPL'))

# Bid Ask

print(finnhub_client.last_bid_ask('AAPL'))

# FDA Calendar

print(finnhub_client.fda_calendar())

# Symbol lookup

print(finnhub_client.symbol_lookup('apple'))

# Insider transactions

print(finnhub_client.stock_insider_transactions('AAPL', '2021-01-01', '2021-03-01'))

# Mutual Funds Profile

print(finnhub_client.mutual_fund_profile("VTSAX"))

print(finnhub_client.mutual_fund_profile(isin="US9229087286"))

# Mutual Funds Holdings

print(finnhub_client.mutual_fund_holdings("VTSAX"))

print(finnhub_client.mutual_fund_holdings(isin="US9229087286", skip=2))

# Mutual Funds Sector Exposure

print(finnhub_client.mutual_fund_sector_exp("VTSAX"))

# Mutual Funds Country Exposure

print(finnhub_client.mutual_fund_country_exp("VTSAX"))

# Revenue breakdown

print(finnhub_client.stock_revenue_breakdown('AAPL'))

# Social sentiment

print(finnhub_client.stock_social_sentiment('GME'))

# Investment Themes

print(finnhub_client.stock_investment_theme('financialExchangesData'))

# Supply chain

print(finnhub_client.stock_supply_chain('AAPL'))

# Company ESG

print(finnhub_client.company_esg_score("AAPL"))

# Earnings Quality Score

print(finnhub_client.company_earnings_quality_score('AAPL', 'quarterly'))

# Crypto Profile

print(finnhub_client.crypto_profile('BTC'))

# EBITDA Estimates

print(finnhub_client.company_ebitda_estimates("TSLA", freq="quarterly"))

# EBIT Estimates

print(finnhub_client.company_ebit_estimates("TSLA", freq="quarterly"))

# USPTO Patent

print(finnhub_client.stock_uspto_patent("AAPL", "2021-01-01", "2021-12-31"))

# Visa application

print(finnhub_client.stock_visa_application("AAPL", "2021-01-01", "2022-06-15"))

# Insider sentiment

print(finnhub_client.stock_insider_sentiment('AAPL', '2021-01-01', '2022-03-01'))

# Bond Profile

print(finnhub_client.bond_profile(isin='US912810TD00'))

# Bond price

print(finnhub_client.bond_price('US912810TD00', 1590988249, 1649099548))

# Lobbying

print(finnhub_client.stock_lobbying("AAPL", "2021-01-01", "2022-06-15"))

# USA Spending

print(finnhub_client.stock_usa_spending("LMT", "2021-01-01", "2022-06-15"))

# Sector metrics

print(finnhub_client.sector_metric('NA'))

## Fund's EET data

print(finnhub_client.mutual_fund_eet('LU2036931686'))

print(finnhub_client.mutual_fund_eet_pai('LU2036931686'))

# Symbol & ISIN change

print(finnhub_client.isin_change(_from='2022-10-01', to='2022-10-07'))

print(finnhub_client.symbol_change(_from='2022-10-01', to='2022-10-07'))

# 13-F data

print(finnhub_client.institutional_profile())

print(finnhub_client.institutional_portfolio(cik='1000097', _from='2022-01-01', to='2022-10-07'))

print(finnhub_client.institutional_ownership('TSLA', '', _from='2022-01-01', to='2022-10-07'))

# Bond yield and FINRA Trace tick

print(finnhub_client.bond_yield_curve('10y'))

print(finnhub_client.bond_tick('US693475BF18', '2022-08-19', 500, 0, 'trace'))

# Congressional Trading

print(finnhub_client.congressional_trading('AAPL', '2020-01-01', '2023-03-31'))

# Price metrics with historical data

print(finnhub_client.price_metrics(symbol="AAPL", date="2022-01-01"))

## Market Holday / Status

print(finnhub_client.market_holiday(exchange='US'))

print(finnhub_client.market_status(exchange='US'))

```

## License

Apache License