J-Quants API

投資部門別情報(/equities/investor-types)

GET /v2/equities/investor-types

APIの概要

投資部門別売買状況(株式・金額)のデータを取得することができます。
配信データは下記のページで公表している内容と同一です。データの単位は千円です。
https://www.jpx.co.jp/markets/statistics-equities/investor-type/index.html

本APIの留意点

  • 2022年4月4日に行われた市場区分見直しに伴い、市場区分に応じた内容となっている統計資料は、見直し後の市場区分に変更して掲載しています。
  • 過誤訂正により過去の投資部門別売買状況データが訂正された場合は、本APIでは以下のとおりデータを提供します。
    • 2023年4月3日以前に訂正が公表された過誤訂正:訂正前のデータは提供せず、訂正後のデータのみ提供します。
    • 2023年4月3日以降に訂正が公表された過誤訂正:訂正前と訂正後のデータのいずれも提供します。訂正が生じた場合には、市場名、開始日および終了日を同一とするレコードが追加され、公表日が新しいデータが訂正後、公表日が古いデータが訂正前のデータと識別することが可能です。
  • 過誤訂正により過去の投資部門別売買状況データが訂正された場合は、過誤訂正が公表された翌営業日にデータが更新されます。

投資部門別売買状況のデータを取得します

GET https://api.jquants.com/v2/equities/investor-types

データの取得では、市場(section)または公表日の日付(from / to)が指定できます。

パラメータ及びレスポンス

データの取得では、セクション(section)または日付(from / to)の指定が可能です。
各パラメータの組み合わせとレスポンスの結果については以下のとおりです。

sectionfrom /toレスポンスの結果
指定したセクションの指定した期間のデータ
指定したセクションの全期間のデータ
すべてのセクションの指定した期間のデータ
すべてのセクションの全期間のデータ

セクション(section)で指定可能なパラメータについては、以下の「市場名」を参照してください。

Requests

Headers

x-api-keystringrequired

APIキー

Query Parameters

sectionstringoptional

セクション(e.g. TSEPrime)

fromstringoptional

fromの指定(e.g. 20210901 or 2021-09-01)

tostringoptional

toの指定(e.g. 20210907 or 2021-09-07)

pagination_keystringoptional

検索の先頭を指定する文字列
過去の検索で返却された pagination_key を設定

APIコールサンプルコード

Request

GET
/v2/equities/investor-types
curl -G https://api.jquants.com/v2/equities/investor-types 
-H "x-api-key: {loading}" 
-d section=TSEPrime 
-d from=20230324 
-d to=20230403

Responses

データ項目概要

PubDatestring
公表日(YYYY-MM-DD)
StDatestring
開始日(YYYY-MM-DD)
EnDatestring
終了日(YYYY-MM-DD)
Sectionstring

市場名(市場名を参照)

PropSellnumber
自己計_売
PropBuynumber
自己計_買
PropTotnumber
自己計_合計
PropBalnumber
自己計_差引
BrkSellnumber
委託計_売
BrkBuynumber
委託計_買
BrkTotnumber
委託計_合計
BrkBalnumber
委託計_差引
TotSellnumber
総計_売
TotBuynumber
総計_買
TotTotnumber
総計_合計
TotBalnumber
総計_差引
IndSellnumber
個人_売
IndBuynumber
個人_買
IndTotnumber
個人_合計
IndBalnumber
個人_差引
FrgnSellnumber
海外投資家_売
FrgnBuynumber
海外投資家_買
FrgnTotnumber
海外投資家_合計
FrgnBalnumber
海外投資家_差引
SecCoSellnumber
証券会社_売
SecCoBuynumber
証券会社_買
SecCoTotnumber
証券会社_合計
SecCoBalnumber
証券会社_差引
InvTrSellnumber
投資信託_売
InvTrBuynumber
投資信託_買
InvTrTotnumber
投資信託_合計
InvTrBalnumber
投資信託_差引
BusCoSellnumber
事業法人_売
BusCoBuynumber
事業法人_買
BusCoTotnumber
事業法人_合計
BusCoBalnumber
事業法人_差引
OthCoSellnumber
その他法人_売
OthCoBuynumber
その他法人_買
OthCoTotnumber
その他法人_合計
OthCoBalnumber
その他法人_差引
InsCoSellnumber
生保・損保_売
InsCoBuynumber
生保・損保_買
InsCoTotnumber
生保・損保_合計
InsCoBalnumber
生保・損保_差引
BankSellnumber
都銀・地銀等_売
BankBuynumber
都銀・地銀等_買
BankTotnumber
都銀・地銀等_合計
BankBalnumber
都銀・地銀等_差引
TrstBnkSellnumber
信託銀行_売
TrstBnkBuynumber
信託銀行_買
TrstBnkTotnumber
信託銀行_合計
TrstBnkBalnumber
信託銀行_差引
OthFinSellnumber
その他金融機関_売
OthFinBuynumber
その他金融機関_買
OthFinTotnumber
その他金融機関_合計
OthFinBalnumber
その他金融機関_差引

レスポンスサンプル

{
    "data": [
        {
            "PubDate": "2017-01-13",
            "StDate": "2017-01-04",
            "EnDate": "2017-01-06",
            "Section": "TSE1st",
            "PropSell": 1311271004,
            "PropBuy": 1453326508,
            "PropTot": 2764597512,
            "PropBal": 142055504,
            "BrkSell": 7165529005,
            "BrkBuy": 7030019854,
            "BrkTot": 14195548859,
            "BrkBal": -135509151,
            "TotSell": 8476800009,
            "TotBuy": 8483346362,
            "TotTot": 16960146371,
            "TotBal": 6546353,
            "IndSell": 1401711615,
            "IndBuy": 1161801155,
            "IndTot": 2563512770,
            "IndBal": -239910460,
            "FrgnSell": 5094891735,
            "FrgnBuy": 5317151774,
            "FrgnTot": 10412043509,
            "FrgnBal": 222260039,
            "SecCoSell": 76381455,
            "SecCoBuy": 61700100,
            "SecCoTot": 138081555,
            "SecCoBal": -14681355,
            "InvTrSell": 168705109,
            "InvTrBuy": 124389642,
            "InvTrTot": 293094751,
            "InvTrBal": -44315467,
            "BusCoSell": 71217959,
            "BusCoBuy": 63526641,
            "BusCoTot": 134744600,
            "BusCoBal": -7691318,
            "OthCoSell": 10745152,
            "OthCoBuy": 15687836,
            "OthCoTot": 26432988,
            "OthCoBal": 4942684,
            "InsCoSell": 15926202,
            "InsCoBuy": 9831555,
            "InsCoTot": 25757757,
            "InsCoBal": -6094647,
            "BankSell": 10606789,
            "BankBuy": 8843871,
            "BankTot": 19450660,
            "BankBal": -1762918,
            "TrstBnkSell": 292932297,
            "TrstBnkBuy": 245322795,
            "TrstBnkTot": 538255092,
            "TrstBnkBal": -47609502,
            "OthFinSell": 22410692,
            "OthFinBuy": 21764485,
            "OthFinTot": 44175177,
            "OthFinBal": -646207
        }
    ],
    "pagination_key": "value1.value2."
}

Was this page helpful?