日々公表信用取引残高(/markets/margin-alert)
GET /v2/markets/margin-alert
APIの概要
日々公表銘柄に指定された個別銘柄の日々の信用取引残高を取得することができます。
各銘柄についての信用取引残高(株数)を取得できます。
配信データは下記のページで公表している内容と同一です。
https://www.jpx.co.jp/markets/statistics-equities/margin/index.html
本APIの留意点
- 当該銘柄のコーポレートアクションが発生した場合であっても、遡及して約定株数の調整は行われません。
- 東京証券取引所または日本証券金融が、日次の信用取引残高を公表する必要があると認めた銘柄のみが収録されます。
- 過誤訂正により過去の日々公表信用取引残高データが訂正された場合は、本APIでは以下のとおりデータを提供します。
- 訂正前と訂正後のデータのいずれも提供します。訂正が生じた場合には、申込日を同一とするレコードが追加されます。公表日が新しいデータが訂正後、公表日が古いデータが訂正前のデータと識別することが可能です。
日々公表信用取引残高を取得します
GET https://api.jquants.com/v2/markets/margin-alert
データの取得では、銘柄コード(code)または公表日(date)の指定が必須となります。
パラメータ及びレスポンス
データの取得では、銘柄コード(code)または公表日(date)の指定が必須となります。
各パラメータの組み合わせとレスポンスの結果については以下のとおりです。
| code | date | from /to | レスポンスの結果 |
|---|---|---|---|
| 指定された銘柄について全期間分のデータ | |||
| 指定された銘柄について指定された公表日のデータ | |||
| 指定された銘柄について指定された期間分のデータ | |||
| 全上場銘柄について指定された公表日のデータ |
Requests
Headers
- x-api-keystringrequired
APIキー
Query Parameters
code または date のいずれか一つの指定が必須です。
- codestringoptional
銘柄コード(e.g. 27800 or 2780)
4桁の銘柄コードを指定した場合は、普通株式と優先株式の両方が上場している銘柄においては普通株式のデータのみが取得されます。- fromstringoptional
from の指定(e.g. 20210901 or 2021-09-01)
- tostringoptional
to の指定(e.g. 20210907 or 2021-09-07)
- datestringoptional
from と to を指定しないときの公表日(e.g. 20210907 or 2021-09-07)
- pagination_keystringoptional
検索の先頭を指定する文字列
過去の検索で返却されたpagination_keyを設定
APIコールサンプルコード
Request
GET
/v2/markets/margin-alertcurl -G https://api.jquants.com/v2/markets/margin-alert
-H "x-api-key: {loading}"
-d code=13260
-d date=20240208Responses
データ項目概要
- PubDatestring
- 公表日
- Codestring
- 銘柄コード
- AppDatestring
- 申込日(YYYY-MM-DD)
信用取引残高の基準となる時点を表します。 - PubReasonmap
- ShrtOutnumber
- 売合計信用残高
- ShrtOutChgnumber / string
- 前日比 売合計信用残高(単位:株)
前日に公表されていない銘柄の場合、「-」を出力します。 - ShrtOutRationumber / string
- 上場比 売合計信用残高(単位:%) 売合計信用残高 ÷ 上場株数 × 100
ETF の場合、「*」を出力します。 - LongOutnumber
- 買合計信用残高
- LongOutChgnumber / string
- 前日比 買合計信用残高(単位:株)
前日に公表されていない銘柄の場合、「-」を出力します。 - LongOutRationumber / string
- 上場比 買合計信用残高(単位:%) 買合計信用残高 ÷ 上場株数 × 100
ETF の場合、「*」を出力します。 - SLRationumber
- 取組比率(単位:%) 売合計信用残高 ÷ 買合計信用残高 × 100
- ShrtNegOutnumber
- 一般信用取引売残高
売合計信用残高のうち、一般信用によるものです。 - ShrtNegOutChgnumber / string
- 前日比 一般信用取引売残高(単位:株)
前日に公表されていない銘柄の場合、「-」を出力します。 - ShrtStdOutnumber
- 制度信用取引売残高
売合計信用残高のうち、制度信用によるものです。 - ShrtStdOutChgnumber / string
- 前日比 制度信用取引売残高(単位:株)
前日に公表されていない銘柄の場合、「-」を出力します。 - LongNegOutnumber
- 一般信用取引買残高
買合計信用残高のうち、一般信用によるものです。 - LongNegOutChgnumber / string
- 前日比 一般信用取引買残高(単位:株)
前日に公表されていない銘柄の場合、「-」を出力します。 - LongStdOutnumber
- 制度信用取引買残高
買合計信用残高のうち、制度信用によるものです。 - LongStdOutChgnumber / string
- 前日比 制度信用取引買残高(単位:株)
前日に公表されていない銘柄の場合、「-」を出力します。 - TSEMrgnRegClsstring
レスポンスサンプル
{
"data": [
{
"PubDate": "2024-02-08",
"Code": "13260",
"AppDate": "2024-02-07",
"PubReason":
{
"Restricted": "0",
"DailyPublication": "0",
"Monitoring": "0",
"RestrictedByJSF": "0",
"PrecautionByJSF": "1",
"UnclearOrSecOnAlert": "0"
},
"ShrtOut": 11.0,
"ShrtOutChg": 0.0,
"ShrtOutRatio": "*",
"LongOut": 676.0,
"LongOutChg": -20.0,
"LongOutRatio": "*",
"SLRatio": 1.6,
"ShrtNegOut": 0.0,
"ShrtNegOutChg": 0.0,
"ShrtStdOut": 11.0,
"ShrtStdOutChg": 0.0,
"LongNegOut": 192.0,
"LongNegOutChg": -20.0,
"LongStdOut": 484.0,
"LongStdOutChg": 0.0,
"TSEMrgnRegCls": "001"
}
],
"pagination_key": "value1.value2."
}