信用取引週末残高(/markets/weekly_margin_interest)

信用取引残高を取得することができます

API概要

週末時点での、各銘柄についての信用取引残高（株数）を取得できます。

配信データは下記のページで公表している内容と同一です。 https://www.jpx.co.jp/markets/statistics-equities/margin/05.html

本APIの留意点

• 当該銘柄のコーポレートアクションが発生した場合も、遡及して株数の調整は行われません。

• 年末年始など、営業日が2日以下の週はデータが提供されません。

• 東証上場銘柄でない銘柄（地方取引所単独上場銘柄）についてはデータの収録対象外となっております。

パラメータ及びレスポンス

データの取得では、銘柄コード（code）または日付（date）の指定が必須となります。 各パラメータの組み合わせとレスポンスの結果については以下のとおりです。

code	date	from /to	レスポンスの結果
			指定された銘柄について全期間分のデータ
			指定された銘柄について指定された期間分のデータ
			全上場銘柄について指定された日付のデータ

週次の信用取引残高を取得します

GET https://api.jquants.com/v1/markets/weekly_margin_interest

データの取得では、銘柄コード（code）または日付（date）の指定が必須となります。

*は必須項目

Query Parameters

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

Headers

Name	Type	Description
Authorization*	String	アクセスキー

200: OK

{
    "weekly_margin_interest": [
        {
            "Date": "2023-02-17",
            "Code": "13010",
            "ShortMarginTradeVolume": 4100.0,
            "LongMarginTradeVolume": 27600.0,
            "ShortNegotiableMarginTradeVolume": 1300.0,
            "LongNegotiableMarginTradeVolume": 7600.0,
            "ShortStandardizedMarginTradeVolume": 2800.0,
            "LongStandardizedMarginTradeVolume": 20000.0,
            "IssueType": "2"
        }
    ],
    "pagination_key": "value1.value2."
}

400: Bad Request

{
    "message": "<Error Message>"
}

401: Unauthorized

{
    "message": "The incoming token is invalid or expired."
}

403: Forbidden

{
    "message": "Missing Authentication Token. The method or resources may not be supported."
}

500: Internal Server Error

{
    "message": "Unexpected error. Please try again later."
}

413: Payload Too Large

{
    "message": "Response data is too large. Specify parameters to reduce the acquired data range."
}

データ項目概要

変数名	説明	型	備考
Date	申込日付	String	YYYY-MM-DD 信用取引残高基準となる時点を表します。（通常は金曜日付）
Code	銘柄コード	String
ShortMarginTradeVolume	売合計信用取引週末残高	Number
LongMarginTradeVolume	買合計信用取引週末残高	Number
ShortNegotiableMarginTradeVolume	売一般信用取引週末残高	Number	売合計信用取引週末残高 のうち、一般信用によるものです
LongNegotiableMarginTradeVolume	買一般信用取引週末残高	Number	買合計信用取引週末残高 のうち、一般信用によるものです
ShortStandardizedMarginTradeVolume	売制度信用取引週末残高	Number	売合計信用取引週末残高 のうち、制度信用によるものです
LongStandardizedMarginTradeVolume	買制度信用取引週末残高	Number	買合計信用取引週末残高 のうち、制度信用によるものです
IssueType	銘柄区分	String	1: 信用銘柄、2: 貸借銘柄、3: その他

APIコールサンプルコード

Curl

idToken=<YOUR idToken> && curl https://api.jquants.com/v1/markets/weekly_margin_interest?code=86970 -H "Authorization: Bearer $idToken" 

Python

import requests
import json

idToken = "YOUR idToken"
headers = {'Authorization': 'Bearer {}'.format(idToken)}
r = requests.get("https://api.jquants.com/v1/markets/weekly_margin_interest?code=86970", headers=headers)
r.json()