Skip to content
HALOWERK

Datenwerk

peer set sec

Takes the SIC code of the target from the SEC submissions API, lists the registrants with that SIC through EDGAR company browse (up to 2,000 entries per call; larger SIC groups are flagged with sic_listing_complete=false) and intersects them with the SEC XBRL frames API for the chosen year: revenue = larger of us-gaap Revenues and RevenueFromContractWithCustomerExcludingAssessedTax in the calendar-year frame CYyyyy, assets = Assets at the latest quarter-end instant frame of that year. Peers.

POST https://daten.halowerk.com/v1/peer-set-sec

Inputs

Fields of the published input schema
FieldTypeRequiredDescription
companystringYesTicker symbol (e.g. AAPL, BRK-B) or SEC CIK number.
metricstringNoSize measure for ranking.
yearintegerNoCalendar year of the XBRL frame (default: two years ago).
countintegerNoNumber of peers returned.
Show full input schema
{
  "type": "object",
  "additionalProperties": false,
  "required": [
    "company"
  ],
  "properties": {
    "company": {
      "type": "string",
      "minLength": 1,
      "maxLength": 12,
      "pattern": "^[A-Za-z0-9][A-Za-z0-9.\\-]{0,11}$",
      "description": "Ticker symbol (e.g. AAPL, BRK-B) or SEC CIK number."
    },
    "metric": {
      "type": "string",
      "enum": [
        "revenue",
        "assets"
      ],
      "default": "revenue",
      "description": "Size measure for ranking."
    },
    "year": {
      "type": "integer",
      "minimum": 2009,
      "maximum": 2100,
      "description": "Calendar year of the XBRL frame (default: two years ago)."
    },
    "count": {
      "type": "integer",
      "minimum": 1,
      "maximum": 30,
      "default": 10,
      "description": "Number of peers returned."
    }
  }
}

Open original schema

Published input example

{
  "company": "MSFT",
  "metric": "revenue",
  "year": 2023,
  "count": 5
}

Result & documentation

Machine-readable documentation of this hub

Source of this page: the published HALOWERK catalog. Updated: 2026-11-17 UTC.

More endpoints in this hub

All endpoints in this hub โ†’