Utility

Sector / subsector peer cohort

Resolve a ticker's peer cohort from the symbols registry, ordered by latest market cap. Defaults to subsector_etf grouping and falls back to sector_etf when the subsector cohort is thin. Powers PeerGroupProxy selection-skill workflows without exposing storage credentials to clients. Authentication: Required (API Key or OAuth2) Billing: $0.005 per request

get/peers

Request

  • Base URL: https://riskmodels.app/api
  • URL: https://riskmodels.app/api/peers
  • Auth: one of:
    • HTTP bearer
    • OAuth 2 (authorization code, authorization URL https://riskmodels.app/oauth/authorize, token URL https://riskmodels.app/api/oauth/token, scopes: mcp:read)

Query parameters

tickerstring required

Target ticker (case-insensitive).

group_by'subsector_etf' | 'sector_etf'

Peer grouping field.

limitinteger

Maximum peers to return (excluding the target).

Response

Peer cohort for the ticker.

tickerstring required
group_by'subsector_etf' | 'sector_etf' required
group_etfstring required
peer_countinteger required
warningsstring[]

Example response

{
  "ticker": "NVDA",
  "target": {
    "ticker": "AMD",
    "sector_etf": "XLK",
    "subsector_etf": "SOXX"
  },
  "group_etf": "SOXX",
  "peers": [
    {
      "ticker": "AMD",
      "sector_etf": "XLK",
      "subsector_etf": "SOXX"
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.