複数条件スクリーニング

財務指標・銘柄名・業種/セクターで上場銘柄をスクリーニングする。filters は field:op:value[:unit] のカンマ区切り（AND 結合。op は gte / lte / gt / lt / eq）。指定できる条件数（filters の各条件 + sector の指定 + industry の指定）の上限は会員区分によって変わり、いずれの区分でも 20 件を超えられない。有効な指標キーと単位は GET /screening/fields。unit を書くとその単位でしきい値を解釈する（時価総額 1,000 億円は marketCap:gte:1000）。unit を省略した場合のしきい値と metrics[].value は GET /screening/fields の unit と同じスケール（金額は円。marketCap:gte）で、金額指標のしきい値が 0 より大きく 100 万円未満なら旧単位 (億円) の指定とみなして 400 を返す。

curl -X GET "https://api.irbank.net/v1/screening" \
  -H "Authorization: Bearer YOUR_TOKEN"

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

import requests

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

{
  "securities": [
    {
      "security_code": "7203",
      "edinet_code": "E02144",
      "name": "トヨタ自動車",
      "metrics": [
        {
          "field": "per",
          "value": 0,
          "as_of": "string"
        }
      ]
    }
  ],
  "total_count": 0,
  "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"
      }
    ]
  }
}