# 信用取引残高

`GET`    /v2/markets/margin-interest (scheduled for September 28, 2026)

## APIの概要

全銘柄の信用取引残高（株数・金額）を日次で取得できます。

### 本APIの留意点

> **Info**
>
> - 本APIは2026年9月28日に新仕様での提供を開始予定です。
> - 毎営業日に、Date（申込日付）が前営業日となる信用取引残高を配信します。
> - 名称が類似している[日々公表信用取引残高(/markets/margin-alert)](/ja/spec/mkt-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: – → 指定された銘柄について全期間分のデータ

- code: ✓, date: ✓, from /to: – → 指定された銘柄について指定された申込日付のデータ

- code: ✓, date: –, from /to: ✓ → 指定された銘柄について指定された期間分のデータ

- code: –, date: ✓, from /to: – → 全上場銘柄について指定された申込日付のデータ

### Requests

### Headers

| Parameter | Type   | Required | Description |
| --------- | ------ | -------- | ----------- |
| x-api-key | string | Required | APIキー       |

### Query Parameters

> **Note**
>
> **code** または **date** のいずれか一つの指定が必須です。

| Parameter       | Type   | Required | Description                                                                              |
| --------------- | ------ | -------- | ---------------------------------------------------------------------------------------- |
| code            | string | Optional | 銘柄コード（e.g. 27800 or 2780） 4桁の銘柄コードを指定した場合は、普通株式と優先株式等の両方が上場している銘柄においては普通株式のデータのみが取得されます。 |
| from            | string | Optional | from の指定（e.g. 20210901 or 2021-09-01）                                                    |
| to              | string | Optional | to の指定（e.g. 20210907 or 2021-09-07）                                                      |
| date            | string | Optional | from と to を指定しないときの申込日付（e.g. 20210907 or 2021-09-07）                                     |
| pagination\_key | string | Optional | 検索の先頭を指定する文字列 過去の検索で返却された pagination\_key を設定                                            |

### APIコールサンプルコード

/v2/markets/margin-interest

**cURL**

```bash
curl -G https://api.jquants.com/v2/markets/margin-interest \
-H "x-api-key: {{apiKey}}" \
-d code="{{code}}" \
-d date="{{date}}"
```

**JavaScript**

```javascript
import axios from 'axios'

const client = axios.create({
baseURL: "https://api.jquants.com",
headers: { "x-api-key": "{{apiKey}}" },
})

await client.get("/v2/markets/margin-interest", {
params: {
  code: '{{code}}',
  date: '{{date}}',
},
})
```

**Python**

```python
import requests

headers = {"x-api-key": "{{apiKey}}"}
resp = requests.get(
  "https://api.jquants.com/v2/markets/margin-interest",
  params={"code": "{{code}}", "date": "{{date}}"},
  headers=headers,
)
print(resp.json())
```

### Responses

### データ項目概要

| Parameter  | Type   | Required | Description                                                                                            |
| ---------- | ------ | -------- | ------------------------------------------------------------------------------------------------------ |
| Date       | string | Required | 申込日付 信用取引残高の基準となる時点を表します。 （YYYY-MM-DD）                                                                 |
| Code       | string | Required | 銘柄コード                                                                                                  |
| IssType    | string | Required | 銘柄区分 1: 信用銘柄、2: 貸借銘柄、3: その他                                                                            |
| ShrtVol    | number | Required | 売合計信用取引残高（株数）                                                                                          |
| LongVol    | number | Required | 買合計信用取引残高（株数）                                                                                          |
| ShrtNegVol | number | Required | 売一般信用取引残高（株数） 売合計信用取引残高（株数）のうち、一般信用によるものです。                                                            |
| LongNegVol | number | Required | 買一般信用取引残高（株数） 買合計信用取引残高（株数）のうち、一般信用によるものです。                                                            |
| ShrtStdVol | number | Required | 売制度信用取引残高（株数） 売合計信用取引残高（株数）のうち、制度信用によるものです。                                                            |
| LongStdVol | number | Required | 買制度信用取引残高（株数） 買合計信用取引残高（株数）のうち、制度信用によるものです。                                                            |
| ShrtVal    | number | Required | 売合計信用取引残高（金額） 2026年9月25日申込分以降のみ提供されます。キー自体は常に返却され、それ以前の日付では null が設定されます。                              |
| LongVal    | number | Required | 買合計信用取引残高（金額） 2026年9月25日申込分以降のみ提供されます。キー自体は常に返却され、それ以前の日付では null が設定されます。                              |
| ShrtNegVal | number | Required | 売一般信用取引残高（金額） 売合計信用取引残高（金額）のうち、一般信用によるものです。2026年9月25日申込分以降のみ提供されます。キー自体は常に返却され、それ以前の日付では null が設定されます。 |
| LongNegVal | number | Required | 買一般信用取引残高（金額） 買合計信用取引残高（金額）のうち、一般信用によるものです。2026年9月25日申込分以降のみ提供されます。キー自体は常に返却され、それ以前の日付では null が設定されます。 |
| ShrtStdVal | number | Required | 売制度信用取引残高（金額） 売合計信用取引残高（金額）のうち、制度信用によるものです。2026年9月25日申込分以降のみ提供されます。キー自体は常に返却され、それ以前の日付では null が設定されます。 |
| LongStdVal | number | Required | 買制度信用取引残高（金額） 買合計信用取引残高（金額）のうち、制度信用によるものです。2026年9月25日申込分以降のみ提供されます。キー自体は常に返却され、それ以前の日付では null が設定されます。 |

### レスポンスサンプル

```bash {{ title: "200:OK" }}
{
    "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."
}
```