投資部門別情報(/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)の指定が可能です。
各パラメータの組み合わせとレスポンスの結果については以下のとおりです。
| section | from /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-typescurl -G https://api.jquants.com/v2/equities/investor-types
-H "x-api-key: {loading}"
-d section=TSEPrime
-d from=20230324
-d to=20230403Responses
データ項目概要
- 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."
}