---
title: "Sector breakdown"
method: GET
path: "/sectors"
tags: ["Signal"]
---

# Sector breakdown

`GET /sectors`

## Request

- Base URL: `https://frontrun.vc/v1`
- URL: `https://frontrun.vc/v1/sectors`
- Auth: API key in header `X-API-Key`

Sector and entity-type breakdown of all discovered entities across your tracked accounts. Costs 4 credits. Cheap way to see what your coverage is surfacing and to discover the exact sector and entity_type strings to pass as filters to /search, /follows/enriched, and /feed.

## Query parameters

- `scope` string

## Response `200`

Sector breakdown.

- object
  - `total_entities` integer
  - `classified_entities` integer
  - `sectors` object[]
    - `name` string
    - `count` integer
    - `percentage` integer
  - `entity_types` object[]
    - `name` string
    - `count` integer
  - `cost_credits` integer: Credits charged for this call.
  - `balance_credits` integer: Remaining credit balance after this call.

## Other responses

- `401`: Missing, invalid, inactive, or expired API key.
- `402`: Insufficient credits for this operation. Top up from the developer page or enable auto-refill.
- `429`: Rate limit or daily credit cap reached. Retry after the indicated reset time.

## Changes

- **2026-10-19** `6880b29e94c9`: 1 info
  - added the new optional `query` request parameter `scope`

[Operation history](https://skmtc.dev/frontrun/apis/frontrun-api/changes/sectors/get.md)

---

[API](https://skmtc.dev/frontrun/apis/frontrun-api.md) · [All operations](https://skmtc.dev/frontrun/apis/frontrun-api/llms.txt) · [OpenAPI document](https://skmtc.dev/frontrun/apis/frontrun-api/revisions/6880b29e94c9?raw)
