Guides · Vanoe Market Intelligence API
Macro regime API: is the market risk-on or risk-off today?
The macro endpoint condenses the backdrop that every stock trades against into one regime label, risk_on, neutral or risk_off, computed by a transparent point system from Federal Reserve (FRED) series and CFTC positioning data. The rationale names the readings that drove the call.
How the regime is scored
High-yield credit spreads carry the most weight: tight and tightening spreads are the clearest risk-on signal there is. The 2s10s yield-curve slope, initial jobless claims, the one-month change in the 10-year yield and consumer sentiment add or subtract points. A total at or above the risk-on threshold gives risk_on; at or below the risk-off threshold, risk_off; anything between is neutral. Every input is returned alongside the label.
What else is in the response
Policy and market rates, CPI and core PCE inflation, the curve, unemployment and claims, the high-yield OAS and its monthly change, WTI crude, and Commitments of Traders net positioning for crude, gold, silver and copper with the weekly change.
Request
curl -H "Authorization: Bearer sk_live_…" \
"https://api.vanoe.ai/v1/macro"Response
{
"data": {
"regime": "risk_on",
"rationale": "Risk-on backdrop: HY credit spreads tight at 2.71%; curve positively sloped (+41bps 2s10s); labor market firm (206k initial claims).",
"rates": {"fed_funds": 3.63, "ust10y": 4.8, "ust2y": 4.39, "ust10y_chg_1m": 0.15},
"inflation": {"cpi_yoy": 3.54, "core_cpi_yoy": 2.79, "core_pce_yoy": 3.34},
"yield_curve": {"spread_2s10s_bps": 41, "inverted": false},
"labor": {"unemployment": 4.1, "initial_claims_k": 206.0},
"risk_appetite": {"hy_oas": 2.71, "hy_oas_chg_1m": -0.01, "consumer_sentiment": 55.2},
"commodities": {"wti": 97.26},
"cot_positioning": {"gold": {"net": 228124, "chg": -15210, "date": "2026-09-01"}, "copper": {"net": 80869, "chg": -4397, "date": "2026-09-01"}},
"as_of": "2026-09-08"
},
"as_of": "2026-09-08", "freshness": "end_of_day", "suggested_recheck_seconds": 21600,
"disclaimer": "Informational data only. Not financial advice. This is not a recommendation, solicitation, or offer to buy or sell any security."
}Cost: 1 credit per call.
Fields
| regime | risk_on · neutral · risk_off |
| risk_appetite.hy_oas | ICE BofA high-yield option-adjusted spread, % |
| yield_curve.spread_2s10s_bps | 10-year minus 2-year Treasury yield, basis points |
| cot_positioning | CFTC net speculative positioning and weekly change |
Questions
Where does the data come from?
Macro series from the Federal Reserve's FRED database and positioning from the CFTC's weekly Commitments of Traders report. Both are public sources.
Is this real-time?
No. FRED series update daily to monthly and COT weekly; the response carries the as-of date and a recheck interval of six hours.
Try it
Free tier: 1,000 credits a month, no card. Every response is informational data only, not financial advice.