銘柄詳細
指定した銘柄の基本情報(証券コード・銘柄名・市場区分・業種・EDINET コード・上場状態・上場年月・決算月・発行済株式数)を返す。
GET
/securities/{code}Authorization
AuthorizationBearer token · headerrequiredIRBANK Connect (app.irbank.net/mcp-api) で発行した API キー
Path parameters
codestringrequired証券コード (4 桁)
matches ^[0-9A-Z]{4,5}$
Responses
200OK
codestringrequired証券コード (4 桁)
matches ^[0-9A-Z]{4,5}$
namestringrequired銘柄名
marketstring | nullrequired市場区分(Prime / Standard / Growth)。対象外の市場(旧市場・ETF 等)は null
industrystringrequired業種(東証 33 業種 + ETF / REIT / その他)
edinet_codestring | nullrequiredEDINET コード。EDINET 未登録は null
listing_statusstringrequired上場状態(listed = 上場中 / delisted = 上場廃止)
Allowed:
listeddelisteddelisting_datestring | nullrequired上場廃止日 (YYYY-MM-DD)。上場中は null
listing_monthstring | nullrequired上場年月 (YYYY-MM)。出典(EDINET 提出書類)は月単位のため日は持たない
fiscal_year_end_monthinteger | nullrequired決算月(1〜12)
min 1 · max 12
issued_sharesnumber | nullrequired発行済株式数(株)
attributionAttributionrequiredShow propertiesHide properties
source_labelstringrequired出典表示ラベル(第三者に表示する際はこの表記を使う)
license_notestringrequired出典・再配信条件の注記
processed_bystringrequired400パラメータが不正
errorobjectrequiredShow propertiesHide properties
codestringrequiredmessagestringrequireddetailsExternalErrorDetail[]Show propertiesHide properties
Array of
ExternalErrorDetailparamstringrequiredreasonstringrequiredAllowed:
missingconflictinvalid_typeinvalid_formatout_of_rangeunknown_valuetoo_many_itemsinvalidexpectedstring受理される値の要約(範囲・型・列挙値)。示せない場合は省略する
404銘柄が存在しない
errorobjectrequiredShow propertiesHide properties
codestringrequiredmessagestringrequireddetailsExternalErrorDetail[]Show propertiesHide properties
Array of
ExternalErrorDetailparamstringrequiredreasonstringrequiredAllowed:
missingconflictinvalid_typeinvalid_formatout_of_rangeunknown_valuetoo_many_itemsinvalidexpectedstring受理される値の要約(範囲・型・列挙値)。示せない場合は省略する
Request
curl -X GET "https://api.irbank.net/v1/securities/7203" \
-H "Authorization: Bearer YOUR_TOKEN"const response = await fetch("https://api.irbank.net/v1/securities/7203", {
method: "GET",
headers: {
"Authorization": "Bearer YOUR_TOKEN"
}
});import requests
response = requests.get(
"https://api.irbank.net/v1/securities/7203",
headers={
"Authorization": "Bearer YOUR_TOKEN"
},
)Response
{
"code": "7203",
"name": "トヨタ自動車",
"market": "Prime",
"industry": "輸送用機器",
"edinet_code": "E02144",
"listing_status": "listed",
"delisting_date": "string",
"listing_month": "1949-05",
"fiscal_year_end_month": 3,
"issued_shares": 16314987460,
"attribution": {
"source_label": "金融庁 EDINET / TDnet",
"license_note": "string",
"processed_by": "IRBANK"
}
}{
"error": {
"code": "not_found",
"message": "Security not found",
"details": [
{
"param": "years",
"reason": "out_of_range",
"expected": ">= 1"
}
]
}
}{
"error": {
"code": "not_found",
"message": "Security not found",
"details": [
{
"param": "years",
"reason": "out_of_range",
"expected": ">= 1"
}
]
}
}