信用取引残高(/markets/margin-interest)
GET /v2/markets/margin-interest
APIの概要
全銘柄の信用取引残高（株数・金額）を日次で取得できます。
本APIの留意点
- 2026年9月28日に、旧仕様（信用取引週末残高・週次配信）から本仕様（日次配信・公表日および金額項目の追加）へ切り替えました。変更内容はリリースをご覧ください。
- 毎営業日に、Date（申込日付）が前営業日となる信用取引残高を配信します。
- 名称が類似している日々公表信用取引残高(/markets/margin-alert)は、日々公表銘柄等に指定された銘柄を対象とした残高データであり、本APIとは異なるデータです。
- 日次の信用取引残高データは2026年9月25日申込分以降で提供されます。2026年9月24日以前は週末時点（通常は金曜日付）のデータのみの収録となります（年末年始など、営業日が2日以下の週のデータは提供されません）。
- 公表日（PubDate）・金額項目（ShrtVal 等の6項目）は2026年9月25日申込分以降のデータでのみ提供されます。それ以前の日付では null が設定されます。
- 金額項目（ShrtVal 等の6項目）は約定代金です（日々の値洗いは行いません）。
- 公表日（published_date）での検索では、公表日が収録されていない過去データは返却されません。また、公表日にも申込日付（date）と同じプランごとの提供期間が適用されます。
- 当該銘柄のコーポレートアクションが発生した場合も、遡及して株数の調整は行われません。
- 収録データ範囲について：
- 収録対象は東証上場銘柄です。東証上場銘柄でない銘柄（地方取引所単独上場銘柄）は収録対象外です。FAQ「地方取引所やPTSのデータは取得可能ですか？」もあわせてご参照ください。
- 各データがJ-Quantsで利用可能となった日時は提供しておりません。更新頻度および更新時刻の目安は提供データの更新タイミングをご参照ください。
- データ仕様について過去にお問い合わせのあった内容は、FAQ（データ内容・仕様）にも記載しておりますので、あわせてご参照ください。
データ訂正のポリシー
- 本サービスにおいて、データ不備・不足によるデータの追加・上書き修正を行う場合がございます。その場合には、データ修正履歴・制約事項に修正履歴を記載しておりますのでご参照ください。
※ 本ケースにおいては、API/CSV等での訂正履歴、訂正前データの提供は行っておりません。
信用取引残高を取得します
GET https://api.jquants.com/v2/markets/margin-interest
データの取得では、銘柄コード（code）、申込日付（date）、公表日（published_date）のいずれかの指定が必須となります。
パラメータ及びレスポンス
データの取得では、銘柄コード（code）、申込日付（date）、公表日（published_date）のいずれかの指定が必須となります。
各パラメータの組み合わせとレスポンスの結果については以下のとおりです。
| code | date | from /to | published_date | レスポンスの結果 |
|---|---|---|---|---|
| 指定された銘柄について全期間分のデータ | ||||
| 指定された銘柄について指定された申込日付のデータ | ||||
| 指定された銘柄について指定された期間分のデータ | ||||
| 全上場銘柄について指定された申込日付のデータ | ||||
| 全上場銘柄について指定された公表日のデータ | ||||
| 指定された銘柄について指定された公表日のデータ |
Requests
Headers
- x-api-keystringrequired
APIキー
Query Parameters
code、date、published_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）
- published_datestringoptional
公表日の指定（e.g. 20260928 or 2026-09-28）
申込日付の指定（date / from / to）と同時に指定することはできません（同時に指定した場合は 400 エラーとなります）。- 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
データ項目概要
- PubDatestring
- 公表日（YYYY-MM-DD）
2026年9月25日申込分以降のみ提供されます。キー自体は常に返却され、それ以前の日付では null が設定されます。 - 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": [
{
"PubDate": "2026-09-28",
"Date": "2026-09-25",
"Code": "86970",
"IssType": "2",
"ShrtVol": 417000.0,
"LongVol": 270800.0,
"ShrtNegVol": 119200.0,
"LongNegVol": 171500.0,
"ShrtStdVol": 297800.0,
"LongStdVol": 99300.0,
"ShrtVal": 838347467.0,
"LongVal": 589568400.0,
"ShrtNegVal": 240247868.0,
"LongNegVal": 370147900.0,
"ShrtStdVal": 598099599.0,
"LongStdVal": 219420500.0
}
],
"pagination_key": "value1.value2."
}