# StableFinance Balance Sheet Segments

> StableFinance Balance Sheet Segments is a paid API for AI agents from stablefinance.dev, paid per call via x402, $0.02/call, status unknown (last checked 2026-09-15).

Retrieves segmented financial data (e.g. revenue by product line) from company balance sheets, broken down by business segment for a given period.

## Facts

- Endpoint: GET https://stablefinance.dev/api/financials/balance-sheets/segments
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/stablefinance-balance-sheet-segments-028c2465
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_I8XJJyK-jsgThb12DjSvh

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability stablefinance-balance-sheet-segments-028c2465
```

Example prompt: Can you pull the annual segmented financials for Apple (AAPL) — I want to see how revenue breaks down by product line like iPhone, Mac, and Services for the most recent fiscal year?

## When to prefer this

Use this endpoint when you need revenue or financial data broken down by business segment (e.g. product lines, geographic regions) rather than consolidated totals. Ideal for equity research, competitive analysis, or understanding how a conglomerate's individual divisions perform. Choose over general balance sheet endpoints when segment-level granularity is required.

## Known failure modes

- Missing required 'period' parameter returns validation error
- Invalid ticker symbol or CIK returns empty results or 404
- Report period date outside available data range returns empty array
- Limit exceeding maximum of 50 returns schema validation error
- Insufficient USDC balance triggers x402 payment failure
- Malformed date format (not YYYY-MM-DD) returns validation error

## How this service works

Balance sheet segment breakdowns.

## Output

Returns an array of segmented_financials objects, each containing the ticker, reporting period, period type (annual/quarterly), and revenue broken down by labeled product/business segments with their dollar values.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "$schema": "https://json-schema.org/draft/2020-12/schema",
     "required": [
      "period"
     ],
     "properties": {
      "cik": {
       "type": "string",
       "minLength": 1
      },
      "limit": {
       "type": "integer",
       "maximum": 50,
       "minimum": 1
      },
      "period": {
       "enum": [
        "annual",
        "quarterly"
       ],
       "type": "string"
      },
      "ticker": {
       "type": "string",
       "minLength": 1
      },
      "report_period": {
       "type": "string",
       "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
      },
      "report_period_gt": {
       "type": "string",
       "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
      },
      "report_period_lt": {
       "type": "string",
       "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
      },
      "report_period_gte": {
       "type": "string",
       "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
      },
      "report_period_lte": {
       "type": "string",
       "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
      }
     },
     "additionalProperties": false
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "$schema": "https://json-schema.org/draft/2020-12/schema",
     "required": [
      "segmented_financials"
     ],
     "properties": {
      "segmented_financials": {
       "type": "array",
       "items": {}
      }
     },
     "additionalProperties": false
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "segmented_financials": [
   {
    "period": "annual",
    "ticker": "AAPL",
    "revenue": {
     "product": [
      {
       "label": "iPhone",
       "value": 201183000000
      },
      {
       "label": "Mac",
       "value": 29984000000
      },
      {
       "label": "Services",
       "value": 96169000000
      }
     ]
    },
    "report_period": "2024-09-28"
   }
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/stablefinance-balance-sheet-segments-028c2465/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from stablefinance.dev](https://www.zero.xyz/host/stablefinance.dev/llms.txt)