KoFinance Python SDK
한국 상장사 재무제표, 공시, 종목 스크리닝, 트레이딩 시그널을 pandas DataFrame으로 간편하게 조회하세요.
설치
pip install kofinance
Quick Start
from kofinance import KoFinance
kf = KoFinance("your-api-key")
# 삼성전자 재무제표 (최근 3년)
df = kf.financials("005930")
print(df[["period", "is_revenue", "is_operating_income", "ratio_roe"]])
# 공시 조회 (최근 30일)
disclosures = kf.disclosures("005930")
print(disclosures[["date", "title", "summary"]])
# 종목 스크리닝 (ROE 15% 이상, PER 10배 이하)
screened = kf.screen(roe_gt=15, per_lt=10)
print(screened)
# 트레이딩 시그널
signals = kf.signals(signal_type="golden_cross")
print(signals)
API 메서드
| 메서드 | 설명 | 반환 |
|---|---|---|
stocks(market, search, limit) |
종목 리스트 조회 | DataFrame |
stock(symbol) |
기업 기본정보 | dict |
financials(symbol, period, type) |
재무제표 | DataFrame |
disclosures(symbol, days, type) |
공시 + AI 요약 | DataFrame |
screen(**filters) |
조건 스크리닝 | DataFrame |
signals(symbol, signal_type) |
트레이딩 시그널 | DataFrame |
API 키 발급
kofinance.ntriq.co.kr에서 가입 후 발급받으세요.
import os
kf = KoFinance(os.environ["KOFINANCE_API_KEY"])
문서
전체 API 문서: kofinance.ntriq.co.kr/docs
License
MIT
1 maintainer
Metadata
1 maintainer
Release files for kofinance 0.1.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| kofinance-0.1.0.tar.gz | 5.3 kB | Without provenance | Details for kofinance-0.1.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| kofinance-0.1.0-py3-none-any.whl | Python 3 | none | any | Details for kofinance-0.1.0-py3-none-any.whl |
Total release size: 11.8 kB
Release files / kofinance-0.1.0.tar.gz
| Download URL | kofinance-0.1.0.tar.gz |
|---|---|
| Size | 5.3 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
6bf6ecf771c57fc3d121931e2b002dd30fcf6f401d64ca3eda7d639399fec5c1
|
|
BLAKE2b-256 checksum How to use checksums |
3814ea49600ecd40d0c7fa34c1c4b30cf3b73dee321131766817e2ed09117e05
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.13.7
|
Release files / kofinance-0.1.0-py3-none-any.whl
| Download URL | kofinance-0.1.0-py3-none-any.whl |
|---|---|
| Size | 6.5 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
2fb0bc2665b571d4364d2abd997fe7b9ea8f4e5e65ace9ffc592f352d5fa55ab
|
|
BLAKE2b-256 checksum How to use checksums |
86b124f5380114a2cbdc6c5c14df44108c46301d2dca077177d1635d4e381893
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.13.7
|
Security for kofinance 0.1.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.
