Changelog

What’s new in the Foresight API.

August 2026

Payable surface updates — GET /v1/flows is now payable at $0.01; batch latest requests with indicators= are a flat $0.01 per request; concept aliases are priced like the series they resolve to; and premium cf:* requests now correctly charge $0.05.

Employment by industry for every US county — how many people work in health care, construction, manufacturing, retail, and 17 other sectors, in any county in America, quarterly back to 2020. Rankings come free: ask for insights and you’ll get lines like “Among Tennessee counties, Williamson ranks 5th of 80 for health care and social assistance employment.”
County GDP and incomes — GDP, total personal income, and per-capita income for ~3,100 counties, annual back to 2005.
County essentials from the American Community Survey — median household income, home values, rents, population, and more, for every county, back to 2013.
~90 marquee national series — the numbers people actually watch: mortgage rates, core CPI, oil and gas prices, Treasury yields and spreads, job openings and quits, credit-card delinquencies, the Fed’s balance sheet, consumer sentiment, and dozens more, full history included.

L402 — paid endpoints now accept Lightning alongside x402. The same 402 that carries USDC payment requirements also carries a WWW-Authenticate: L402 challenge with a bolt11 invoice; pay it with any Lightning wallet and retry with the proof of payment. Same prices on both rails. See Pay per request.

Concepts — indicator=population, gdp, median_income, median_home_value, unemployment_rate and more now work on every read endpoint, no agency codes required. The API editorially picks the best series for each kind of place — Census for a county, FRED for the nation — and discloses the choice in meta.concept on every response. See Concepts.
Honest refusals — ask for a combination no source publishes (county-level CPI, say) and the API says so plainly and names the closest available alternative, instead of returning something misleading.
Derived concepts — measures no agency publishes, computed on demand: employment_rate (employed ÷ labor force) is live for counties and states, with every input series disclosed in meta.concept.inputs.

GET /v1/ask — a natural-language question in, a grounded answer out. Every number in the prose traces to a cited tool call you can replay against the deterministic endpoints, and the grounded flag tells you the verification passed. You don’t pay when we don’t have the data: questions with no coverage return no_coverage for free. Also available as the ask MCP tool. See Ask. Ask now resolves questions through the concept layer deterministically — identical questions cite identical series.

Economic news tone and attention — cf:osint.econ_news_tone and cf:osint.econ_news_volume turn the global news firehose (GDELT) into daily time series: how positive or negative economic coverage is, and how much of it there is. Official statistics tell you what happened last month; these tell you what the conversation is doing today — same API, same citations, updated daily.

Panels — GET /v1/panel returns up to 10 indicators aligned on one date grid in a single call, ready for charts and models. See Panel.
Query-time transforms — add transform=yoy, mom, qoq, index:2020-01-01, or log to observations and get derived values with the unit already updated. Percent changes compare calendar periods, so gaps yield honest nulls instead of misleading numbers. See Observations.
Every US county on the map — all 50 states, DC, and 3,144 county equivalents are first-class regions. If you ask for a series we’re still preparing, the API answers 202 with Retry-After — retry with the code from the response body and the data will be there.

Self-serve API keys — POST /v1/signup with an email returns a free key instantly. No forms, no waiting. See Signup.
Access tiers in the catalog — every indicator now says whether it’s free or premium, so you know before you call. See Indicators.
Agent onboarding — the docs, llms.txt , and the API’s discovery index all route agents to a key or to x402 without human help.

46 new Williamson County finance indicators — revenue by category, spending by function, and debt by type, from audited TN Comptroller data, 2007 through FY2025. The county’s full budget story is now queryable, not just the totals.
Complete demographics — population by age and sex (36 series, 2010–2024) joins the race and age-group breakdowns, all from the Census Bureau.

Shareable sentences everywhere — every insight fact and every signal carries text: a plain-spoken, ready-to-display sentence like “Arts and entertainment employment in Williamson County is picking up.” See Insights.
Chips you can render as-is — signals ship a vocabulary of glyph, label, and tone, already adjusted for whether up is good or bad for that indicator. See Signals.
Honest timelines — when a signal says “since April,” that’s the start of the current move, not a stale first detection.

New docs site at docs.creativeforesight.io — guides, the full API reference, the Derived Indicators catalog, and agent-readable llms-full.txt .

No-account access — call a paid endpoint without a key, get a 402 with payment instructions, pay on-chain, retry. Standard series cost $0.01 per request; premium series and signals cost$ 0.05. See Pay per request.

The cf:* series — Creative Foresight originals like cf:labor_composite (a single monthly read on the US labor market) and cf:recession_signal (a monthly recession-risk gauge), each traceable to the public data behind it. See Derived Indicators.