J-Quants API
View as Markdown

Trading by Type of Investors (/equities/investor-types)

GET /v2/equities/investor-types

Overview

Trading by type of investors (stock trading value) can be obtained.
This data is also available via the following site. The data is set in units of 1000 yen.
https://www.jpx.co.jp/english/markets/statistics-equities/investor-type/index.html

Attention

  • In accordance with the market classification review conducted on April 4, 2022, statistical data that are based on market classifications have been changed to the new market segments.
  • When the data of trading by type of investors is revised, that is, value of the past data is modified, the data is provided by this API as follows.
    • Revisions that are announced on or before April 3, 2023: only the data after revision is provided.
    • Revisions that are announced on or after April 3, 2023: both the data before revision and after revision are provided. When a revision occurs, a record is added with the same Section, StartDate and EndDate. In such a case, data with the newer PublishedDate represents the revised data while the data with the older PublishedDate can be identified as the pre-correction data.
  • When the data of trading by type of investors is revised, the updated data will be available on the next business day after the correction is announced.

Get trading by type of investors

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

In your request message, either "section" or "from/to" can be specified.

Parameter and Response

In your request message, either "section" or "from/to" can be specified.
Combination of parameter in the request and results are as below.

sectionfrom /toResults
Trading data of a specific section for the specified period.
All trading data of a specific section.
Trading data of all sections for the specified period.
All trading data of all sections for all available period.

Requests

Headers

x-api-keystringrequired

API Key

Query Parameters

sectionstringoptional

Section name (e.g. TSEPrime) For a list of possible values, please see here.

fromstringoptional

Starting point of data period (e.g. 20210901 or 2021-09-01)

tostringoptional

End point of data period (e.g. 20210907 or 2021-09-07)

pagination_keystringoptional

The primary key of the first item that this operation will evaluate.
Use the value that was returned for pagination_key in the previous operation.

Sample Code

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

Data Item

PubDatestring
Published Date (YYYY-MM-DD)
StDatestring
Start Date (YYYY-MM-DD)
EnDatestring
End Date (YYYY-MM-DD)
Sectionstring

Section Name (See Section name)

PropSellnumber
Proprietary Sales Value
PropBuynumber
Proprietary Purchase Value
PropTotnumber
Proprietary Total Value
PropBalnumber
Proprietary Balance Value
BrkSellnumber
Brokerage Sales Value
BrkBuynumber
Brokerage Purchase Value
BrkTotnumber
Brokerage Total Value
BrkBalnumber
Brokerage Balance Value
TotSellnumber
Total Sales Value
TotBuynumber
Total Purchase Value
TotTotnumber
Total Value
TotBalnumber
Total Balance Value
IndSellnumber
Individuals Sales Value
IndBuynumber
Individuals Purchase Value
IndTotnumber
Individuals Total Value
IndBalnumber
Individuals Balance Value
FrgnSellnumber
Foreigners Sales Value
FrgnBuynumber
Foreigners Purchase Value
FrgnTotnumber
Foreigners Total Value
FrgnBalnumber
Foreigners Balance Value
SecCoSellnumber
Securities Companies Sales Value
SecCoBuynumber
Securities Companies Purchase Value
SecCoTotnumber
Securities Companies Total Value
SecCoBalnumber
Securities Companies Balance Value
InvTrSellnumber
Investment Trusts Sales Value
InvTrBuynumber
Investment Trusts Purchase Value
InvTrTotnumber
Investment Trusts Total Value
InvTrBalnumber
Investment Trusts Balance Value
BusCoSellnumber
Business Companies Sales Value
BusCoBuynumber
Business Companies Purchase Value
BusCoTotnumber
Business Companies Total Value
BusCoBalnumber
Business Companies Balance Value
OthCoSellnumber
Other Companies Sales Value
OthCoBuynumber
Other Companies Purchase Value
OthCoTotnumber
Other Companies Total Value
OthCoBalnumber
Other Companies Balance Value
InsCoSellnumber
Insurance Companies Sales Value
InsCoBuynumber
Insurance Companies Purchase Value
InsCoTotnumber
Insurance Companies Total Value
InsCoBalnumber
Insurance Companies Balance Value
BankSellnumber
City Banks Regional Banks Etc Sales Value
BankBuynumber
City Banks Regional Banks Etc Purchase Value
BankTotnumber
City Banks Regional Banks Etc Total Value
BankBalnumber
City Banks Regional Banks Etc Balance Value
TrstBnkSellnumber
Trust Banks Sales Value
TrstBnkBuynumber
Trust Banks Purchase Value
TrstBnkTotnumber
Trust Banks Total Value
TrstBnkBalnumber
Trust Banks Balance Value
OthFinSellnumber
Other Financial Institutions Sales Value
OthFinBuynumber
Other Financial Institutions Purchase Value
OthFinTotnumber
Other Financial Institutions Total Value
OthFinBalnumber
Other Financial Institutions Balance Value

Response Sample

{
    "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?