上場銘柄の一覧
上場銘柄(証券コード・銘柄名・市場区分・業種)を証券コード昇順で返す。銘柄詳細は GET /securities/{code}。
GET
/securitiesAuthorization
AuthorizationBearer token · headerrequiredIRBANK Connect (app.irbank.net/mcp-api) で発行した API キー
Query parameters
qstring検索語(銘柄名・証券コードの部分一致)
max length 100
marketstring市場区分フィルタ(Prime / Standard / Growth)
Allowed:
PrimeStandardGrowthindustrystring業種名フィルタ(東証 33 業種の名称に完全一致)
min length 1 · max length 120
limitintegermin 1 · max 500 · default: 100
cursorstring前回レスポンスの next_cursor
Responses
200OK
securitiesSecurityListItem[]requiredShow propertiesHide properties
Array of
SecurityListItemcodestringrequired証券コード (4 桁)
matches ^[0-9A-Z]{4,5}$
namestringrequired銘柄名
marketstring | nullrequired市場区分(Prime / Standard / Growth)。対象外の市場(旧市場・ETF 等)は null
industrystringrequired業種(東証 33 業種 + ETF / REIT / その他)
next_cursorstring | nullrequired次ページ取得用の不透明 cursor。null なら最終ページ
attributionAttributionrequiredShow propertiesHide properties
source_labelstringrequired出典表示ラベル(第三者に表示する際はこの表記を使う)
license_notestringrequired出典・再配信条件の注記
processed_bystringrequired400パラメータまたは cursor が不正
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" \
-H "Authorization: Bearer YOUR_TOKEN"const response = await fetch("https://api.irbank.net/v1/securities", {
method: "GET",
headers: {
"Authorization": "Bearer YOUR_TOKEN"
}
});import requests
response = requests.get(
"https://api.irbank.net/v1/securities",
headers={
"Authorization": "Bearer YOUR_TOKEN"
},
)Response
{
"securities": [
{
"code": "7203",
"name": "トヨタ自動車",
"market": "Prime",
"industry": "輸送用機器"
}
],
"next_cursor": "string",
"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"
}
]
}
}