InsiderFlowResponse

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/cubesphere-xyz/json-schema/cubesphere-xyz-insider-flow-response-schema.json",
  "title": "InsiderFlowResponse",
  "x-generated": "2026-11-04",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/cubesphere-xyz-openapi.yml#/components/schemas/InsiderFlowResponse",
  "properties": {
    "ticker": {
      "type": "string",
      "title": "Ticker"
    },
    "window_days": {
      "type": "integer",
      "title": "Window Days"
    },
    "items": {
      "items": {
        "$ref": "#/$defs/InsiderFlowItem"
      },
      "type": "array",
      "title": "Items"
    },
    "items_truncated": {
      "type": "boolean",
      "title": "Items Truncated",
      "description": "`limit` 을 넘는 행이 더 있었는가."
    },
    "limitations": {
      "additionalProperties": {
        "type": "string"
      },
      "type": "object",
      "title": "Limitations"
    }
  },
  "additionalProperties": false,
  "type": "object",
  "required": [
    "ticker",
    "window_days",
    "items",
    "items_truncated",
    "limitations"
  ],
  "$defs": {
    "InsiderFlowItem": {
      "properties": {
        "issuer_cik": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Issuer Cik"
        },
        "ticker": {
          "type": "string",
          "title": "Ticker"
        },
        "as_of_date": {
          "type": "string",
          "format": "date",
          "title": "As Of Date"
        },
        "window_days": {
          "type": "integer",
          "title": "Window Days"
        },
        "buy_count": {
          "type": "integer",
          "title": "Buy Count"
        },
        "buy_shares": {
          "anyOf": [
            {
              "type": "number"
            },
            {
              "type": "null"
            }
          ],
          "title": "Buy Shares"
        },
        "buy_value": {
          "anyOf": [
            {
              "type": "number"
            },
            {
              "type": "null"
            }
          ],
          "title": "Buy Value"
        },
        "distinct_buyers": {
          "type": "integer",
          "title": "Distinct Buyers"
        },
        "sell_count_discretionary": {
          "type": "integer",
          "title": "Sell Count Discretionary"
        },
        "sell_value_discretionary": {
          "anyOf": [
            {
              "type": "number"
            },
            {
              "type": "null"
            }
          ],
          "title": "Sell Value Discretionary"
        },
        "sell_count_planned": {
          "type": "integer",
          "title": "Sell Count Planned"
        },
        "sell_value_planned": {
          "anyOf": [
            {
              "type": "number"
            },
            {
              "type": "null"
            }
          ],
          "title": "Sell Value Planned"
        },
        "distinct_sellers": {
          "type": "integer",
          "title": "Distinct Sellers"
        },
        "known_at_cut": {
          "type": "string",
          "format": "date-time",
          "title": "Known At Cut",
          "description": "PIT 컷 — 이 행이 계산될 때 본 세상의 시각. PIT 재현의 근거."
        },
        "computed_at": {
          "type": "string",
          "format": "date-time",
          "title": "Computed At",
          "description": "이 행이 실제로 계산·저장된 시각(known_at_cut 과 다를 수 있다)."
        }
      },
      "additionalProperties": false,
      "type": "object",
      "required": [
        "ticker",
        "as_of_date",
        "window_days",
        "buy_count",
        "distinct_buyers",
        "sell_count_discretionary",
        "sell_count_planned",
        "distinct_sellers",
        "known_at_cut",
        "computed_at"
      ],
      "title": "InsiderFlowItem",
      "description": "`GET /v1/companies/{ticker}/insider-flow` 행 1건 — `sec.insider_flow_daily` 그대로.\n\n**매수는 `OPEN_MARKET_BUY` 한정.** 계획 매도(`sell_count_planned`)는\n`rule_10b5_1_status='REPORTED_TRUE'` 기준(#312 문서 레벨 파싱 이후 사실 등급) —\n공동제출(joint filing) 184건은 아직 `NOT_REPORTED` 로 남아 재량 매도로 세어진다\n(`#318` 로 추적 중, `limitations.insider_flow_sell_grading` 참조)."
    }
  }
}