Documentation on jfinance

Installation

Mon, 01 Jan 0001 00:00:00 +0000

Installation

pip install jfinance

Python 3.9 or later is required. pandas, numpy, requests and pytz are installed as dependencies. Where curl_cffi is available, it is used instead.

No registration and no API key are required.

First steps

import jfinance as jf

t = jf.Ticker("7203.T") # Toyota Motor

t.info # company profile (dict)
t.financials # income statement, annual (DataFrame)
t.balance_sheet # balance sheet
t.cashflow # cash flow statement
t.quarterly_financials # quarterly (up to fiscal 2023)
t.major_holders # ownership breakdown
t.sec_filings # filings

Return types are the same as in yfinance (DataFrame, dict, list).

Ticker symbols

Mon, 01 Jan 0001 00:00:00 +0000

Ticker symbols

Ticker accepts any of the following.

Form	Example	Covers
Securities code + `.T`	`7203.T`	Listed companies
Securities code (4 characters)	`7203`	Same
EDINET code	`E02144`	Companies, including unlisted ones
ISIN	`JP3633400001`	Listed companies
Fund code	`G02925`	Investment trusts

jf.Ticker("7203.T") # all four refer to the same company
jf.Ticker("7203")
jf.Ticker("E02144")
jf.Ticker("JP3633400001")

Codes containing letters

Since 2024 some securities codes contain letters. Pass them as they are.

jf.Ticker("130A.T")

Companies and funds

The first character of the EDINET code tells them apart.

REST API

Mon, 01 Jan 0001 00:00:00 +0000

REST API

The same data is available over HTTP, so you can use it without Python.

https://query1.jfnc.org

No sign-up and no API key. Responses are JSON.

Open the API reference

The reference lists every endpoint and parameter, with a real response example for each one. It is generated from the running server, so it cannot drift away from what the server actually returns. This page is only the way in.

What is there


Yahoo-shaped endpoints	Point a yfinance client at this server instead of `query1.finance.yahoo.com` and it keeps working
`/jf/v1/…`	jfinance’s own endpoints: officers, shareholders, segments, every statement line item, filings, industries, the screener
`/jf/v1/holders/…`	Holder-centric. What a holder owns, what it has filed and what it has traded

curl 'https://query1.jfnc.org/jf/v1/ticker/7203.T/officers'
curl 'https://query1.jfnc.org/ws/fundamentals-timeseries/v1/finance/timeseries/7203.T?type=annualTotalRevenue'

Symbols are written the same way as in the Python client — see Ticker symbols.

Terms of use

Mon, 01 Jan 0001 00:00:00 +0000

Terms of use

Last updated 2026-09-24

What this service is

https://query1.jfnc.org is a free, unauthenticated API that returns EDINET disclosure data in the same shape as yfinance. It is operated by an individual, not as a company business.

This is not investment advice. No responsibility is accepted for any decision made using this data.

No warranty

The service is provided as is. No guarantee is made as to the accuracy, completeness or timeliness of the data. There is no SLA. It may be suspended, slowed, changed or discontinued without notice.

License and attribution

Mon, 01 Jan 0001 00:00:00 +0000

License and attribution

The source code and the data are licensed differently.

	License
`jfinance` (the Python library)	Apache License 2.0
Data returned by the API	Governed by EDINET’s terms (below). jfinance does not license it to you
Element labels (line items, statement names)	Governed by the EDINET Taxonomy terms

Source code

jfinance is released under the Apache License 2.0.

Documentation on jfinance

Installation

Installation

First steps

Ticker symbols

Ticker symbols

Codes containing letters

Companies and funds

REST API

REST API

What is there

Terms of use

Terms of use

What this service is

No warranty

License and attribution

License and attribution

Source code

Software included