Oracle Feeds — Free Tier

Oracle feeds are lightweight numeric signals pulled from the same data infrastructure that powers the paid intelligence endpoints. They return a scored integer, a regime label, and a timestamp — no narrative synthesis, no component breakdown. Use them for dashboards, on-chain integrations, embeds, and automated monitoring.

For full intelligence reports with AI synthesis and component-level detail, see the Intelligence API.

Base URL

https://intelligence.untitledfinancial.com

Endpoints

GET /v1/oracle-feed           # list all available feeds
GET /v1/oracle-feed/:slug     # get a specific feed

Available feeds

Slug	Label	Unit	Scale
`macro-stress-index`	Macro Stress Index	score	÷100
`systemic-risk`	Systemic Risk	score	÷100
`supply-chain-pressure`	Supply Chain Pressure	score	÷100
`us-instability-score`	US Instability	score	÷100
`fiscal-dominance-risk`	Fiscal Dominance Risk	score	÷100
`stability-score`	DPX Stability Score	score	÷100
`earth-health-index`	Earth Health Index	score	÷100
`co2-ppm`	Atmospheric CO₂	ppm	÷100
`temperature-anomaly`	Global Temp Anomaly	°C above baseline	÷100
`arctic-sea-ice`	Arctic Sea Ice Extent	Mkm²	÷100
`renewable-share`	Renewables Share	%	÷100

All value fields are returned as scaled integers. Divide by scale to get the display value. Integer encoding avoids floating-point precision loss in on-chain and LLM contexts.

Response format

{
  "feed": "macro-stress-index",
  "value": 7600,
  "scale": 100,
  "unit": "score×100",
  "signal": "CAUTION",
  "description": "Macro credit stress index derived from spread regimes and volatility",
  "asOf": "2026-06-11T00:00:00Z",
  "cacheHit": true
}

Field	Type	Description
`feed`	string	Feed slug
`value`	integer	Scaled value — divide by `scale`
`scale`	integer	Always 100
`unit`	string	Raw unit label
`signal`	string	Regime classification
`description`	string	One-line feed description
`asOf`	ISO 8601	Timestamp of underlying data
`cacheHit`	boolean	Whether response was served from cache

Signal labels

Signal	Meaning
`EXPANSION` / `HEALTHY` / `CALM`	Low risk, normal conditions
`WATCH` / `CAUTION` / `MODERATE`	Elevated, monitor closely
`STRESSED` / `HIGH` / `ELEVATED`	Active stress, above normal risk
`CRISIS` / `CRITICAL` / `EXTREME`	Severe conditions

Examples

Get the macro stress index:

curl https://intelligence.untitledfinancial.com/v1/oracle-feed/macro-stress-index

Get systemic risk:

curl https://intelligence.untitledfinancial.com/v1/oracle-feed/systemic-risk

List all available feeds:

curl https://intelligence.untitledfinancial.com/v1/oracle-feed

Use in JavaScript:

const res = await fetch('https://intelligence.untitledfinancial.com/v1/oracle-feed/macro-stress-index');
const { value, scale, signal } = await res.json();
const score = value / scale; // 76.0

Caching

All feeds are cached for 1 hour in Cloudflare KV. Cache is populated on the first call and refreshed automatically. cacheHit: false on the first call of the hour is expected — subsequent calls within the window return immediately.

On-chain use

Oracle feed integers are designed for direct on-chain consumption via Chainlink Functions or API3 dAPI. The scaled integer format avoids Solidity’s lack of native float support:

// Chainlink Functions example
const res = await Functions.makeHttpRequest({
  url: 'https://intelligence.untitledfinancial.com/v1/oracle-feed/systemic-risk'
});
const scaledValue = res.data.value; // 7600 = 76.00/100
return Functions.encodeUint256(scaledValue);

Rate limits

Free tier: 60 requests/minute per IP. No authentication required. For higher throughput, use an Intelligence API key via RapidAPI.