信用取引残高
GET /v2/markets/margin-interest (scheduled for September 28, 2026)
APIの概要
全銘柄の信用取引残高(株数・金額)を日次で取得できます。
本APIの留意点
- 本APIは2026年9月28日に新仕様での提供を開始予定です。
- 毎営業日に、Date(申込日付)が前営業日となる信用取引残高を配信します。
- 名称が類似している日々公表信用取引残高(/markets/margin-alert)は、日々公表銘柄等に指定された銘柄を対象とした残高データであり、本APIとは異なるデータです。
- 日次の信用取引残高データは2026年9月25日申込分以降で提供されます。2026年9月24日以前は週末時点(通常は金曜日付)のデータのみの収録となります(年末年始など、営業日が2日以下の週のデータは提供されません)。
- 金額項目(ShrtVal 等の6項目)は2026年9月25日申込分以降のデータでのみ提供されます。それ以前の日付では null が設定されます。
- 当該銘柄のコーポレートアクションが発生した場合も、遡及して株数の調整は行われません。
- 東証上場銘柄でない銘柄(地方取引所単独上場銘柄)についてはデータの収録対象外となっております。
信用取引残高を取得します
GET https://api.jquants.com/v2/markets/margin-interest (scheduled for September 28, 2026)
データの取得では、銘柄コード(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
curl -G https://api.jquants.com/v2/markets/margin-interest \
-H "x-api-key: {loading}" \
-d code="86970" \
-d date="20260925"Responses
データ項目概要
- Datestring
- 申込日付
信用取引残高の基準となる時点を表します。
(YYYY-MM-DD) - Codestring
- 銘柄コード
- IssTypestring
銘柄区分
1: 信用銘柄、2: 貸借銘柄、3: その他- ShrtVolnumber
- 売合計信用取引残高(株数)
- LongVolnumber
- 買合計信用取引残高(株数)
- ShrtNegVolnumber
売一般信用取引残高(株数)
売合計信用取引残高(株数)のうち、一般信用によるものです。- LongNegVolnumber
買一般信用取引残高(株数)
買合計信用取引残高(株数)のうち、一般信用によるものです。- ShrtStdVolnumber
売制度信用取引残高(株数)
売合計信用取引残高(株数)のうち、制度信用によるものです。- LongStdVolnumber
買制度信用取引残高(株数)
買合計信用取引残高(株数)のうち、制度信用によるものです。- ShrtValnumber
売合計信用取引残高(金額)
2026年9月25日申込分以降のみ提供されます。キー自体は常に返却され、それ以前の日付では null が設定されます。- LongValnumber
買合計信用取引残高(金額)
2026年9月25日申込分以降のみ提供されます。キー自体は常に返却され、それ以前の日付では null が設定されます。- ShrtNegValnumber
売一般信用取引残高(金額)
売合計信用取引残高(金額)のうち、一般信用によるものです。2026年9月25日申込分以降のみ提供されます。キー自体は常に返却され、それ以前の日付では null が設定されます。- LongNegValnumber
買一般信用取引残高(金額)
買合計信用取引残高(金額)のうち、一般信用によるものです。2026年9月25日申込分以降のみ提供されます。キー自体は常に返却され、それ以前の日付では null が設定されます。- ShrtStdValnumber
売制度信用取引残高(金額)
売合計信用取引残高(金額)のうち、制度信用によるものです。2026年9月25日申込分以降のみ提供されます。キー自体は常に返却され、それ以前の日付では null が設定されます。- LongStdValnumber
買制度信用取引残高(金額)
買合計信用取引残高(金額)のうち、制度信用によるものです。2026年9月25日申込分以降のみ提供されます。キー自体は常に返却され、それ以前の日付では null が設定されます。
レスポンスサンプル
{
"data": [
{
"Date": "2026-09-25",
"Code": "86970",
"IssType": "2",
"ShrtVol": 257400.0,
"LongVol": 225000.0,
"ShrtNegVol": 242800.0,
"LongNegVol": 81900.0,
"ShrtStdVol": 14600.0,
"LongStdVol": 143100.0,
"ShrtVal": 514800000.0,
"LongVal": 450000000.0,
"ShrtNegVal": 485600000.0,
"LongNegVal": 163800000.0,
"ShrtStdVal": 29200000.0,
"LongStdVal": 286200000.0
}
],
"pagination_key": "value1.value2."
}