Skip to main content

Sayou Stock Package for Financial Data from SEC, FnGuide, Naver, OpenDART, Yahoo

Project description

Sayou Stock

PyPI version License Docs

📦 Installation

sayou-stock is automatically installed when you install any Sayou library.

pip install sayou-stock

🔑 Key Components

  1. EDGARCrawler: SEC EDGAR 10-K, 10-Q, 8-K, 13F, DEF 14A
  2. FnGuideCrawler: FnGuide Company Information
  3. NaverCrawler: Naver Market API/Crawling
  4. OpenDartCrawler: OpenDART API
  5. YahooCrawler: 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

Project details


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.8.tar.gz (3.4 MB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

sayou_stock-0.0.8-py3-none-any.whl (194.3 kB view details)

Uploaded Python 3

File details

Details for the file sayou_stock-0.0.8.tar.gz.

File metadata

  • Download URL: sayou_stock-0.0.8.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

Hashes for sayou_stock-0.0.8.tar.gz
Algorithm Hash digest
SHA256 fe771f2fa332ffd68586743b12d1f50ab022bbf45e20d6b31e83e73f58521921
MD5 3ffb2aa81d53531622e4435f2972f986
BLAKE2b-256 dacb30b770acd2e2e221c3150528d3afe46adbc24edd4526e7d241e0f49b8b2d

See more details on using hashes here.

File details

Details for the file sayou_stock-0.0.8-py3-none-any.whl.

File metadata

  • Download URL: sayou_stock-0.0.8-py3-none-any.whl
  • Upload date:
  • Size: 194.3 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for sayou_stock-0.0.8-py3-none-any.whl
Algorithm Hash digest
SHA256 295158bcf2144e46c0e7724a9a5826aff71a0228bc4fd33e7e4d43c5ca7b188c
MD5 9981b95d8c027a22f1ae67a60793ab6f
BLAKE2b-256 b9cc79abf41f7b99e3d62483f8f5c96b280881e67ad54318297bf404a2022125

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page