# Foresight API

> Economic, demographic, financial, and Creative Foresight original time-series data served as clean JSON for agents, dashboards, and research workflows.

Foresight API provides curated indicators from FRED, BLS, BEA, BIS, and derived `cf:*` series such as `cf:labor_composite`. Catalog endpoints are free. Observation endpoints require an API key or anonymous x402 pay-per-request access.

Base URL: https://api.creativeforesight.io

## Links

- [API root JSON index](https://api.creativeforesight.io/)
- [OpenAPI 3.1 specification](https://api.creativeforesight.io/openapi.json)
- [Full llms.txt reference](https://api.creativeforesight.io/llms-full.txt)
- [Developer docs](https://api.creativeforesight.io/docs)
- [Pricing](https://api.creativeforesight.io/docs/pricing)
- [Checkout](https://api.creativeforesight.io/checkout)
- [Changelog](https://api.creativeforesight.io/changelog.md)

## Authentication

- API key: `Authorization: Bearer cf_live_...` or `X-API-Key: cf_live_...`.
- x402: unauthenticated `/v1/observations` and `/v1/observations/latest` requests return HTTP 402 payment requirements; retry with `X-PAYMENT` after payment.
- Pricing: catalog endpoints are free, regular observations are $0.01 per paid x402 request, Creative Foresight `cf:*` premium series are $0.05 per paid x402 request, and signals require premium API-key access.

## Endpoints

- [GET /v1/sources](https://api.creativeforesight.io/v1/sources): list data sources.
- [GET /v1/regions](https://api.creativeforesight.io/v1/regions): list regions. Counties use 5-digit FIPS codes.
- [GET /v1/indicators](https://api.creativeforesight.io/v1/indicators): search indicators by source, category, frequency, and text.
- [GET /v1/indicators/{code}](https://api.creativeforesight.io/v1/indicators/UNRATE): indicator detail.
- [GET /v1/observations](https://api.creativeforesight.io/v1/observations?indicator=UNRATE): time-series observations.
- [GET /v1/observations/latest](https://api.creativeforesight.io/v1/observations/latest?indicator=UNRATE): latest observation. Use `indicators=UNRATE,INDPRO` for batch latest up to 20 codes; batch returns `{data, errors}`.
- [GET /v1/observations/latest](https://api.creativeforesight.io/v1/observations/latest?indicator=UNRATE): latest observation.
- [GET /v1/signals/active](https://api.creativeforesight.io/v1/signals/active): active premium signals.
- [GET /v1/signals](https://api.creativeforesight.io/v1/signals): premium signal interval history.

## MCP

- [POST /api/mcp](https://api.creativeforesight.io/api/mcp): Streamable HTTP MCP server exposing catalog and observation tools. Catalog tools work without auth; observation tools require `Authorization: Bearer cf_live_...`.

## Example

```bash
curl "https://api.creativeforesight.io/v1/indicators?search=unemployment&limit=5"
```