Sayou Stock Package for Financial Data from SEC, FnGuide, Naver, OpenDART, Yahoo
Project description
Sayou Stock
📦 Installation
sayou-stock is automatically installed when you install any Sayou library.
pip install sayou-stock
🔑 Key Components
EDGARCrawler: SEC EDGAR 10-K, 10-Q, 8-K, 13F, DEF 14AFnGuideCrawler: FnGuide Company InformationNaverCrawler: Naver Market API/CrawlingOpenDartCrawler: OpenDART APIYahooCrawler: Yahoo Finance API
🤝 Usage Example
Retrieve SEC EDGAR 10-K
from sayou.stock.edgar import EDGARCrawler
crawler = EDGARCrawler(user_agent="Sayouzone sjkim@sayouzone.com")
ticker = "AAPL"
# Retrieve CIK by Ticker
cik = crawler.fetch_cik_by_ticker(ticker)
# EDGAR 10-K Annual Report
filings = crawler.fetch_filings(cik, doc_type="10-K", count=1)
data = crawler.extract_10k(cik, filings[0].document_url, filings[0].accession_number)
# EDGAR 10-Q Quarterly Report
filings = crawler.fetch_filings(cik, doc_type="10-Q", count=1)
data = crawler.extract_10q(cik, filings[0].document_url, filings[0].accession_number)
# EDGAR 8-K Current Report
filings = crawler.fetch_filings(cik, doc_type="8-K", count=1)
data = crawler.extract_8k(cik, filings[0].document_url, filings[0].accession_number)
# EDGAR 13F Institutional Holdings
filings = crawler.fetch_filings(cik, doc_type="13F", count=1)
data = crawler.extract_13f(cik, filings[0].document_url, filings[0].accession_number)
# EDGAR DEF 14A Proxy Statement
filings = crawler.fetch_filings(cik, doc_type="DEF 14A", count=1)
data = crawler.extract_def14a(cik, filings[0].document_url, filings[0].accession_number)
Retrieve FnGuide's Company Information
from sayou.stock.fnguide import FnGuideCrawler
stock = "005930"
crawler = FnGuideCrawler()
data = crawler.finance(stock)
print(data)
data = crawler.company(stock)
print(data)
data = crawler.finance_ratio(stock)
print(data)
data = crawler.invest(stock)
print(data)
data = crawler.consensus(stock)
print(data)
📜 License
Apache 2.0 License © 2025 Sayouzone
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
sayou_stock-0.0.9.tar.gz
(3.4 MB
view details)
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
sayou_stock-0.0.9-py3-none-any.whl
(196.5 kB
view details)
File details
Details for the file sayou_stock-0.0.9.tar.gz.
File metadata
- Download URL: sayou_stock-0.0.9.tar.gz
- Upload date:
- Size: 3.4 MB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.1.0 CPython/3.13.7
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
31e0a49e2c9631bd3510b383a8a288a0b15265094445d03f260f870ba95b90a7
|
|
| MD5 |
71198c6e5cb1217091448dd21217f6fc
|
|
| BLAKE2b-256 |
4249b0c19230dac0027a4d9cf473e7d55a87783dd648eb1c081aa05df2a7df60
|
File details
Details for the file sayou_stock-0.0.9-py3-none-any.whl.
File metadata
- Download URL: sayou_stock-0.0.9-py3-none-any.whl
- Upload date:
- Size: 196.5 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.1.0 CPython/3.13.7
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
f98d278bafc7430a887d6b7f19c50c606192aaab96263fd10f0e3c659abdcc56
|
|
| MD5 |
872cb598318411ca5f19dcf06284b204
|
|
| BLAKE2b-256 |
4bc2d59e6a247e9b6c1bf1d03c842674ff87aa87f804869b9e062bbdefa6c30a
|
