---
title: "Financial intelligence indicators"
description: "Lists financial intelligence (FININT) indicators from FRED macroeconomic series, Yahoo Finance markets, and EIA energy data. Each includes current and previous values, percentage change, sparkline data, and active alerts. ### Aggregate and dimension rows Most indicators are US aggregates: one row per `indicatorId` (for example, `EIA:WTI`, `FRED:DGS10`). EIA also publishes per-dimension rows tagged with `dimension`, `dimensionType`, `lat`, and `lon`: - `dimensionType=facility`: reactor outages, such as `EIA:NUKE_OUTAGE:vogtle` - `dimensionType=rto`: hourly US balancing-authority demand, such as `EIA:RTO_LOAD:PJM` - `dimensionType=port`: monthly port-level crude imports, such as `EIA:CRUDE_IMPORT:houston` Filter by `dimensionType` for dimension rows only. Aggregate rows set `dimension`, `dimensionType`, `lat`, and `lon` to null. Nuclear-outage rows with `outagePct > 0` publish `economic` map events to the OSINT cache. RTO and crude-import rows do not publish map events. Accepts a bearer API key or [x402 payment](https://y2.dev/docs/api/x402). Without a key, read the `402` challenge in `PAYMENT-REQUIRED`. Retry with `PAYMENT-SIGNATURE`."
canonical: https://y2.dev/docs/api/reference/osint/listFinintIndicators/
---

Endpoint Reference[OSINT](https://y2.dev/docs/api/reference/osint)

# Financial intelligence indicators

Lists financial intelligence (FININT) indicators from FRED macroeconomic series, Yahoo Finance markets, and EIA energy data. Each includes current and previous values, percentage change, sparkline data, and active alerts. ### Aggregate and dimension rows Most indicators are US aggregates: one row per \`indicatorId\` (for example, \`EIA:WTI\`, \`FRED:DGS10\`). EIA also publishes per-dimension rows tagged with \`dimension\`, \`dimensionType\`, \`lat\`, and \`lon\`: - \`dimensionType=facility\`: reactor outages, such as \`EIA:NUKE\_OUTAGE:vogtle\` - \`dimensionType=rto\`: hourly US balancing-authority demand, such as \`EIA:RTO\_LOAD:PJM\` - \`dimensionType=port\`: monthly port-level crude imports, such as \`EIA:CRUDE\_IMPORT:houston\` Filter by \`dimensionType\` for dimension rows only. Aggregate rows set \`dimension\`, \`dimensionType\`, \`lat\`, and \`lon\` to null. Nuclear-outage rows with \`outagePct > 0\` publish \`economic\` map events to the OSINT cache. RTO and crude-import rows do not publish map events. Accepts a bearer API key or \[x402 payment]\(https\://y2.dev/docs/api/x402). Without a key, read the \`402\` challenge in \`PAYMENT-REQUIRED\`. Retry with \`PAYMENT-SIGNATURE\`.

`GET https://api.y2.dev/api/v1/osint/finint`

- Operation ID: `listFinintIndicators`
- Required scopes: `osint:read`
- Accepts x402 pay-per-request payment
- Contract: https://y2.dev/openapi.json

## Parameters

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `category` | query | `rates`, `credit`, `inflation`, `labor`, `gdp`, `business`, `consumer`, `housing`, `money_supply`, `volatility`, `commodities`, `fx`, `equities`, `energy`, `crypto` | No | Filter by indicator category |
| `source` | query | `fred`, `yfinance`, `eia` | No | Filter by data source |
| `dimensionType` | query | `facility`, `rto`, `port`, `state` | No | Filter to per-dimension rows only (nuclear facilities, RTO balancing authorities, ports of entry, or US states). When provided, aggregate rows are excluded from the response. |
| `limit` | query | integer | No | Maximum number of indicators to return |
| `cursor` | query | string | No | Opaque continuation token from the previous response. Bound to the original filters and ordering. |
| `format` | query | `json`, `ndjson` | No | `json` uses the resource envelope. `ndjson` streams one canonical row per line. |

## Responses

| Status | Description | Body |
| --- | --- | --- |
| 200 | List of financial intelligence indicators | `FinintIndicatorListResponse` |
| 400 | Invalid request parameters |  |
| 401 | Missing or invalid API key |  |
| 402 | x402 payment required | `X402PaymentRequiredResponse` |
| 403 | Insufficient permissions or access denied |  |
| 429 | Rate limit exceeded (per-key or per-account aggregate) |  |
| 500 | Internal server error |  |

### 200 response fields

| Field | Type | Description |
| --- | --- | --- |
| `data[]` | array of `FinintIndicator` |  |
| `data[].period` | `FinintPeriod` | Provider reporting label or a timestamp tied to the selected quote. Labels are not inferred UTC boundaries. Null when the adapter has no supported timing. Never inferred from fetch time. |
| `data[].provenance` | `FinintProvenance` | Bounded provider metadata retained with the current cached value, not an archived source payload or evidence of original publication/availability. Null for rows without captured metadata. This feed does not retain historical vintages. |
| `data[].indicatorId` | string | Unique indicator key. Aggregate rows use `<SOURCE>:<METRIC>` (e.g., `FRED:DGS10`, `YF:^GSPC`, `EIA:WTI`). Per-dimension rows use `<SOURCE>:<METRIC>:<DIMENSION>` (e.g., `EIA:NUKE_OUTAGE:vogtle`, `EIA:RTO_LOAD:PJM`, `EIA:CRUDE_IMPORT:houston`). |
| `data[].source` | `fred`, `yfinance`, `eia` | Data source |
| `data[].sourceUrl` | string or null (uri) | Canonical provider page for this indicator |
| `data[].label` | string | Human-readable indicator name |
| `data[].category` | `rates`, `credit`, `inflation`, `labor`, `gdp`, `business`, `consumer`, `housing`, `money_supply`, `volatility`, `commodities`, `fx`, `equities`, `energy`, `crypto` | Indicator category |
| `data[].value` | number | Current indicator value |
| `data[].previousValue` | number or null | Previous value (for change calculation) |
| `data[].change` | number or null | Absolute change from previous value |
| `data[].changePct` | number or null | Percentage change from previous value |
| `data[].unit` | string or null | Value unit (e.g., "%", "$", "index", "$/bbl") |
| `data[].recent[]` | array of object | Recent data points for sparkline rendering |
| `data[].signals[]` | array of string | Active signal descriptions (threshold crossings) |
| `data[].fetchedAt` | integer (int64) | Unix timestamp of last data fetch |
| `data[].dimension` | string or null | Dimension key (e.g., `vogtle`, `PJM`, `houston`). Null on US-aggregate rows. |
| `data[].dimensionType` | `facility`, `rto`, `port`, `state`, `null` | Dimension classifier. Null on US-aggregate rows. Currently only EIA emits per-dimension rows. |
| `data[].lat` | number or null (double) | Latitude of the dimension (facility/RTO HQ/port). Null on aggregate rows. |
| `data[].lon` | number or null (double) | Longitude of the dimension. Null on aggregate rows. |
| `meta` | object |  |
| `meta.count` | integer |  |
| `meta.limit` | integer |  |
| `meta.hasMore` | boolean | Whether more results are available beyond the current limit |
| `meta.filters` | object | Applied filter values |
