> ## Documentation Index
> Fetch the complete documentation index at: https://docs.signa.so/llms.txt
> Use this file to discover all available pages before exploring further.

# Market Analytics

Use this endpoint for market sizing and total addressable filing volume across every supported trademark office. Results are precomputed and suited to dashboards and recurring analysis.

## Code Examples

<CodeGroup>
  ```bash cURL theme={null}
  curl https://api.signa.so/v1/analytics/market \
    -H "Authorization: Bearer sig_YOUR_KEY"
  ```

  ```typescript TypeScript theme={null}
  import { Signa } from "@signa-so/sdk";

  const signa = new Signa({ api_key: process.env.SIGNA_API_KEY });
  const market = await signa.analytics.market();
  console.log(market.total_marks, market.active_count);
  ```
</CodeGroup>

## Response

<ResponseField name="total_marks" type="number">Total trademark records.</ResponseField>
<ResponseField name="active_count" type="number">Registered and pending marks.</ResponseField>
<ResponseField name="by_status" type="object">Counts by normalized status bucket.</ResponseField>
<ResponseField name="by_office" type="object">Counts keyed by lowercase office code.</ResponseField>
<ResponseField name="top_classes" type="array<{ class: number; count: number; pct: number }>">Top ten Nice classes. Each `pct` is the share of all marks that include this class.</ResponseField>
<ResponseField name="filing_trend" type="object">Annual filing counts.</ResponseField>

<ResponseExample>
  ```json Response theme={null}
  {
    "object": "market_analytics",
    "total_marks": 12000000,
    "active_count": 8300000,
    "by_status": {
      "registered": 7000000,
      "pending": 1300000,
      "expired": 1800000,
      "cancelled": 900000,
      "abandoned": 1000000
    },
    "by_office": {
      "uspto": 8000000,
      "euipo": 4000000
    },
    "top_classes": [
      {
        "class": 9,
        "count": 950000,
        "pct": 0.079
      }
    ],
    "filing_trend": {
      "2025": 610000
    },
    "computed_at": "2026-07-12T00:00:00.000Z",
    "request_id": "req_example"
  }
  ```
</ResponseExample>