Open API of realtime financial Market data, Global Stock Market US Europe Asia, Major Index Dow/Nasdaq/S&P/Hang Seng/Nifty50, etc.

These details have not been verified by PyPI

Project links

Project description

FinanceAgent package

This is the official github repo of pypi package FinanceAgent(https://pypi.org/project/FinanceAgent/). This repo is intended to provide common financial API interface to help develop Finance related AI Agents workflows. Since getting realtime or near-realtime finance data is crucial for success of AI Agents, we are building a common interface of open API to get public available data from glocal Finance Market (US, Europe, Asia) with multiple finance investment choices such as Stock, Index, Option, etc. Getting Realtime Data maybe blocked by website and this repo is not responsible for proxy or any data correctness related issues.

*** IMPORTANT LEGAL DISCLAIMER ***

FinanceAgent is not affiliated, endorsed, or vetted by Financial Institutions. It's an open-source tool that uses finance APIs to get realtime finance data to help build AI Agents and Finance Larget Language Models. Please contact the repo owner email if your API or data source need to be removed from the repo.

REGION	MARKET	INVESTMENT TYPE	API DATA SOURCE
United Status	US (NASDAQ,NYSE,DOW)	STOCK	morningstar.com
United Status	US (NASDAQ,NYSE,DOW)	STOCK	zacks.com
United Status	US (NASDAQ,NYSE,DOW)	STOCK	marketbeat.com
Asia	HK (HKEX)	STOCK	hkex.com
Asia	CN_MAINLAND (SHANGHAI SH, SHENZHEN SZ)	STOCK	xueqiu.com
Asia	India (NSE)	STOCK	moneycontrol.com
Europe	London (LSE)	STOCK	stockanalysis.com
Asia	Toyko (TSE)	STOCK	NA

Install

pip install FinanceAgent

Usage

import FinanceAgent as fa

## Hongkong Stock Exchange Tencent: 700, Kuaishou: 1024
hk_stock_info_json = fa.api(symbol_list=['700', '1024'], market="HK")

## Shanghai and Shenzhen Stock Market: SH600519: 贵州茅台(Maotai), SH600036: 招商银行 (China Merchants Bank)
cn_stock_info_json = fa.api(symbol_list=['SH600519', 'SH600036'], market="CN_MAINLAND")

## US Stock Market: Tesla (TSLA), Microsoft(MSFT), Google (GOOG)
us_stock_info_json = fa.api(symbol_list=['TSLA', 'MSFT', 'GOOG'], market="US")

## UK Stock Market: London Stock Exchange Market, Shell (quote: SHEL), Unilever (quote: ULVR)
lse_stock_info_json = fa.api(symbol_list=['SHEL', 'ULVR'], market="LSE")

## India NSE National Stock Exchange, Tata Motor(TM03), Infosys(IT)
india_stock_info_json = fa.api(symbol_list=['TM03', 'IT'], market="NSE_INDIA")

Sample Output


#### HK Stock Info
-----------------------------------
symbol|1024
avg_price|49.650 HKD
high|50.950 HKD
low|47.600 HKD
previous_close|50.850 HKD
update_time|14 Oct 2024 18:33
market_capitalization|214.06 B HKD
pe_ratio|31.15
source|HKEX, https://www.hkex.com.hk/Market-Data/Securities-Prices/Equities/Equities-Quote?sym=1024&sc_lang=en
data_source|hkex.com
-----------------------------------
symbol|700
avg_price|436.000 HKD
high|440.800 HKD
low|424.000 HKD
previous_close|438.800 HKD
update_time|14 Oct 2024 18:33
market_capitalization|4,045.91 B HKD
pe_ratio|33.32
source|HKEX, https://www.hkex.com.hk/Market-Data/Securities-Prices/Equities/Equities-Quote?sym=700&sc_lang=en
data_source|hkex.com
-----------------------------------


#### CN MAINLAND Stock Info
-----------------------------------
symbol|SH600036
avg_price|39.265919080336076 CNY
high|39.8 CNY
low|38.69 CNY
previous_close|38.43 CNY
update_time|2024-10-14 15:00:00
market_capitalization|9918.97 亿 CNY
pe_ratio|
source|XUEQIU.COM, https://xueqiu.com/S/SH600036
data_source|xueqiu.com
-----------------------------------

symbol|SH600519
avg_price|1602.5501242724608 CNY
high|1620.63 CNY
low|1581.17 CNY
previous_close|1604.99 CNY
update_time|2024-10-14 15:00:00
market_capitalization|20124.16 亿 CNY
pe_ratio|
source|XUEQIU.COM, https://xueqiu.com/S/SH600519
data_source|xueqiu.com
-----------------------------------

#### London Stock Exchange LSE
-----------------------------------

symbol|SHEL
avg_price|2,592.00 GBP
high|2,599.29 GBP
low|2,577.50 GBP
previous_close|2,592.00 GBP
update_time|
market_capitalization|161.18B GBP
pe_ratio|11.70
source|stockanalysis.com,https://stockanalysis.com/quote/lon/SHEL
data_source|stockanalysis.com
-----------------------------------

symbol|ULVR
avg_price|4,806.00 GBP
high|4,827.00 GBP
low|4,792.00 GBP
previous_close|4,806.00 GBP
update_time|
market_capitalization|119.19B GBP
pe_ratio|21.57
source|stockanalysis.com,https://stockanalysis.com/quote/lon/ULVR
data_source|stockanalysis.com
-----------------------------------

#### US Stock Info
-----------------------------------
symbol|TSLA
avg_price|217.80 USD
high|223.34 USD
low|214.38 USD
previous_close|238.77 USD
update_time|
market_capitalization|695.79 Bil USD
pe_ratio|87.78
source|
data_source|morningstar.com
-----------------------------------

#### India Stock Market Info
-----------------------------------
symbol|IT
avg_price|1,958.70 INR
high|1,958.70 INR
low|1,958.70 INR
previous_close|1,958.70 INR
update_time|
market_capitalization|813,281.00 INR
pe_ratio|
source|moneycontrol.com,https://www.moneycontrol.comhttps://www.moneycontrol.com/india/stockpricequote/computers-software/infosys/IT
data_source|moneycontrol.com
-----------------------------------
symbol|TM03
avg_price|928.05 INR
high|928.05 INR
low|928.05 INR
previous_close|928.05 INR
update_time|
market_capitalization|341,604.45 INR
pe_ratio|
source|moneycontrol.com,https://www.moneycontrol.comhttps://www.moneycontrol.com/india/stockpricequote/auto-lcvs-hcvs/tatamotors/TM03
data_source|moneycontrol.com
-----------------------------------

Introduction to Available API and Data Source

** note: Stock Data Displayed on Page Might not be stable

REGION	MARKET	DATA SOURCE	API Example	Robots Verification
United Status	US	morningstar.com	https://www.morningstar.com/stocks/xnas/aapl/quote	YES
United Status	US	zacks.com	https://www.zacks.com/stock/quote/aapl	YES
United Status	US	marketbeat.com	https://www.marketbeat.com/stocks/NASDAQ/AAPL	YES
Asia	HK (HKEX)	hkex.com	https://www.hkex.com.hk/Market-Data/Securities-Prices/Equities/Equities-Quote?sym=700&sc_lang=en	YES
Asia	CN_MAINLAND(SH and SHENZHEN)	xueqiu.com	https://xueqiu.com/S/SH600519	YES
Asia	India (NSE)	https://www.moneycontrol.com	https://www.moneycontrol.com/india/stockpricequote/auto-lcvshcvs/tatamotors/TM03	YES
Asia	Japan (TSE)	xxx
Europe	London (LSE)	stockanalysis.com	https://stockanalysis.com/stocks/shel/	YES

AI Services Reviews and Ratings

Project details

These details have not been verified by PyPI

Project links

Release history Release notifications | RSS feed

This version

0.0.2

Oct 14, 2024

0.0.1

Oct 13, 2024

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distributions

No source distribution files available for this release.See tutorial on generating distribution archives.

Built Distribution

FinanceAgent-0.0.2-py3-none-any.whl (32.6 kB view hashes)

Uploaded Oct 14, 2024 Python 3

Hashes for FinanceAgent-0.0.2-py3-none-any.whl

Hashes for FinanceAgent-0.0.2-py3-none-any.whl
Algorithm	Hash digest
SHA256	`0da123e6c62f887a714bcc9b9e6e8f9795d6d65178b57c31ee17c3a162a1059c`
MD5	`98d0c1544d74027eed2a76d071f15236`
BLAKE2b-256	`b5b0439527770fd574345e7f08464534e4b8da1c68b2d61d49ccc0434c63445d`