Off-Auction Share Buyback (ToSTNeT-3) (/markets/off_auction_share_buyback)

You can get the off-auction share buyback data

Overview

The data includes the name of the security, the purchase price, and the planned volume for treasury share purchases via ToSTNeT-3, announced on the business day prior to the transaction. On the day of the transaction, the executed volume is promptly distributed.

This data is the same as the following site but has a longer history. https://www.jpx.co.jp/english/markets/equities/off-auction-ownshares/index.html

Attention

• Data will not be provided on days when the above transactions did not take place.

Parameter and Response

In your request message, either "code", "implementation_date" and "publication_date" must be specified. Combination of parameters in the request and results are as below.

code	publication_date	publication_date_from/publication_date_to	implementation_date	implementation_date_from/implementation_date_to	Results
					All historical data of a specific issue.
					All listed issue data for the specific date(PublicationDate).
					All listed issue data for the specific date(ImplementationDate)
					Data of a specific issue for the specified date(PublicationDate)
					Data of a specific issue for the specified date(ImplementationDate)
					Data of a specific issue for the specified period(PublicationDate).
					Data of a specific issue for the specified period(ImplementationDate).
					The date parameter only accepts one input at a time, resulting in an error if both are provided.
					The date parameter only accepts one input at a time, resulting in an error if both are provided.

Get off-auction share buyback data

GET https://api.jquants-pro.com/v2/markets/off_auction_share_buyback

Either 'implementation_date','publication_date' or 'code' must be specified.

"*" Required.

Query Parameters

Name	Type	Description
code	String	issue code (e.g. 27890 or 2789) If a 4-character issue code is specified, only the data of common stock will be obtained for the issue on which both common and preferred stocks are listed.
publication_date	String	publication date of data （e.g. 20220106 or 2022-01-06）
publication_date_from	String	starting point of publication date period （e.g. 20220105 or 2022-01-05）
publication_date_to	String	end point of publication date period （e.g. 20220105 or 2022-01-05）
implementation_date	String	implementation date of data （e.g. 20220106 or 2022-01-06）
implementation_date_from	String	starting point of implementation date period （e.g. 20220105 or 2022-01-05）
implementation_date_to	String	end point of implementation date period （e.g. 20220105 or 2022-01-05）
pagination_key	String	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.

Headers

Name	Type	Description
Authorization*	String	Access Key

200: OK

{
    "off_auction_share_buyback": [
        {
            "PublicationDate": "2024-12-09",
            "ImplementationDate": "2024-12-10",
            "Code": "19040",
            "StockName": "大成温調",
            "StockNameEnglish": "TAISEI ONCHO CO.,LTD.",
            "NumberOfSharesToBePurchased": 100000,
            "NumberOfTradedShares": 100000,
            "Price": 3555,
            "CancelFlag": "0"
        },
    ],
  "pagination_key": "value1.value2."
}

400: Bad Request

401: Unauthorized

403: Forbidden

413: Payload Too Large

500: Internal Server Error

Data Item

Variable	Description	Data Type	Remark
PublicationDate	Date of publication	String	YYYY-MM-DD
ImplementationDate	Trading day	String	YYYY-MM-DD
Code	Issue code	String	5-Character
StockName	Name of stock (Japanese)	String
StockNameEnglish	Name of stock (English)	String
NumberOfSharesToBePurchased	Number of shares to be purchased	Number
NumberOfTradedShares	Number of traded shares	Number
Price	Price	Number
Cancel Flag	Cancel flag	String	If the buyback is cancelled after publication, it will be updated from 0 to 1

Sample Code

Curl

idToken=<YOUR idToken> && curl https://api.jquants-pro.com/v2/markets/off_auction_share_buyback?code=86970&implementation_date=20231115 -H "Authorization: Bearer $idToken" 

Python