競合企業

指定銘柄の競合企業を、有価証券報告書ベースの競合分析に基づいて競合セグメント・競合理由付きで返す。

並び順と件数

• security_code 昇順に並べ、その先頭 limit 件 (既定 8) を返す (自銘柄は除外)。
• 競合としての関連度順ではないため、競合が limit を超える銘柄では証券コードの大きい競合が落ちる。
• 落ちた件数を示すフィールドもページングも無いため、より多く必要な場合は limit を最大 20 まで上げる。

非上場競合の置き換え

• 競合が非上場の場合は親会社チェーンを辿り、最も近い上場親会社に置き換えて返す。
• この置き換えが起きた競合では segments と competition_reason は置き換え前の非上場競合のものになる。
• 置き換えの有無と置き換え前の競合名はレスポンスに含まれない。

親会社等 (parent_companies)

• 各競合には、その競合の議決権を保有する親会社等 (parent_companies: 名称・証券コード・種類・議決権割合) を最新の有価証券報告書「関係会社の状況」から添える。
• これは開示そのもので、上記の置き換えに使う親会社チェーン (競合分析由来の推定) とは別のソース。

注意

• capital_relationship は上流の競合分析が資本関係を出力していないため、現状はすべての競合で null。
• 業種による絞り込みではないため、業種をまたぐ競合が含まれることがあり、同業種でも競合と判定されなければ含まれない。同業種の銘柄一覧が必要な場合は GET /securities の industry フィルタを使う。

空レスポンス

競合分析データが無い銘柄と、競合が全て非上場で上場親会社にも解決できない銘柄は peers: [] を返す。該当データが 0 件のときは空配列とともに reason (code=no_results + 状況の説明) を返す。

curl -X GET "https://api.irbank.net/v1/peers?security_code=7203" \
  -H "Authorization: Bearer YOUR_TOKEN"

const response = await fetch("https://api.irbank.net/v1/peers?security_code=7203", {
  method: "GET",
  headers: {
    "Authorization": "Bearer YOUR_TOKEN"
  }
});

import requests

response = requests.get(
    "https://api.irbank.net/v1/peers?security_code=7203",
    headers={
        "Authorization": "Bearer YOUR_TOKEN"
    },
)

{
  "security_code": "7203",
  "peers": [
    {
      "security_code": "7267",
      "name": "string",
      "industry": "string",
      "segments": [
        "自動車"
      ],
      "competition_reason": "string",
      "capital_relationship": null,
      "parent_companies": [
        {
          "name": "トヨタ自動車株式会社",
          "security_code": "7203",
          "party_type": "親会社",
          "voting_rights_ratio": 50.1,
          "fiscal_period_end": "2026-03-31"
        }
      ]
    }
  ],
  "reason": {
    "code": "no_results",
    "message": "No segment disclosure is currently recorded for this organization."
  },
  "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"
      }
    ]
  }
}