pyjpx-etf 0.3.3

A clean, beginner-friendly Python library for fetching JPX ETF portfolio composition (PCF) data.

pyjpx-etf

A clean, beginner-friendly Python library for fetching JPX ETF portfolio composition (PCF) data and ranking ETFs by returns.

Installation

pip install pyjpx-etf

Quick Start

import pyjpx_etf as etf

e = etf.ETF("1306")
print(e.info.name)       # "TOPIX連動型上場投資信託"
print(e.nav)             # total fund NAV in yen
print(e.fee)             # trust fee (%) e.g. 0.06
print(e.holdings[:3])
# [Holding(code='7203', name='トヨタ自動車', ...),
#  Holding(code='8306', name='三菱UFJフィナンシャル・グループ', ...),
#  Holding(code='6758', name='ソニーグループ', ...)]

# Rank ETFs by returns
etf.ranking()              # top 10 by 1-month return
etf.ranking("1y", n=20)    # top 20 by 1-year return
etf.ranking("ytd", n=-5)   # worst 5 by ytd return

CLI

$ etf 1306

1306 — TOPIX連動型上場投資信託 (2026-02-27)
Nav: 5170億  信託報酬: 0.06%

 Code   Name                                Weight
─────  ──────────────────────────────────  ──────
 7203   トヨタ自動車                          3.7%
 8306   三菱ＵＦＪフィナンシャル・グループ    3.3%
 6501   日立製作所                            2.4%
 ...

ETF Ranking

Rank all TSE ETFs by period returns:

$ etf rank                # top 10 by 1-month return
$ etf rank 20 1y          # top 20 by 1-year return
$ etf rank -5 ytd --en    # worst 5 by ytd, English names

Available periods: 1m (default), 3m, 6m, 1y, 3y, 5y, 10y, ytd

Aliases

Use shorthand aliases instead of codes:

Alias	Code	ETF
etf topix	1306	TOPIX連動型上場投資信託
etf 225	1321	日経225連動型上場投資信託
etf core30	1311	TOPIX Core30連動型上場投資信託
etf div50	1489	日経平均高配当株50指数連動型ETF
etf div70	1577	野村日本株高配当70連動型ETF
etf pbr	2080	PBR1倍割れ解消推進ETF
etf sox	2243	Global X 半導体 ETF
etf jpsox1	200A	日経半導体株 ETF
etf jpsox2	2644	Global X 半導体関連-日本株式 ETF

Options

$ etf sox --en         # English names
$ etf topix -a         # all holdings (not just top 10)
$ etf 1306 -a --en     # combine options
$ etf --help           # show all commands
$ etf --version        # show version

Language Setting

Names default to Japanese. Switch to English via config or CLI flag:

import pyjpx_etf as etf

# English names
etf.config.lang = "en"
e = etf.ETF("1306")
print(e.info.name)  # "TOPIX ETF"

Configuration

import pyjpx_etf as etf

etf.config.timeout = 60
etf.config.request_delay = 0.5
etf.config.lang = "en"  # "ja" (default) or "en"

Documentation

Full documentation