Tools / Finance Data
Finance Data icon

Finance Data

Markets, rates, commodities & macro

Live financial market data for portfolio analysis, macro research, and risk monitoring. Covers commodities, yield curves, central bank rates, 30+ FX pairs, economic indicators, energy, labor, housing, sentiment, government bonds, crypto, COT positioning, credit conditions, and the federal budget.

23 skillsv0.06
Commodity Prices

Get live commodity prices from FRED. Covers oil (WTI, Brent), natural gas (Henry Hub, European TTF), gold, silver, copper, corn, wheat, soybeans, coffee, sugar, and nickel. Request a specific commodity for 30-day history, or omit for a snapshot of all prices.

Returns: Commodity prices with name, FRED series ID, latest value, unit, and date. Single commodity includes 30-day history.
Parameters
commoditystringCommodity to fetch (e.g. oil_wti, gold, copper, corn). Omit for all.
Example
Get all commodity prices
curl -H "Authorization: Bearer $TOOLROUTER_API_KEY" \
  -d '{
  "tool": "finance-data",
  "skill": "commodity_prices",
  "input": {}
}' \
  https://api.toolrouter.com/v1/tools/call
Treasury Yields

Get the full US Treasury yield curve from FRED. Covers 11 tenors from 1-month to 30-year, plus key spread indicators (10Y-2Y, 10Y-3M, High Yield OAS). Detects yield curve inversions automatically.

Returns: Yield curve data with rates per tenor, key spreads (10Y-2Y, 10Y-3M, HY OAS), and inversion detection.
Parameters
periodstringSpecific tenor to fetch. One of: 1m, 3m, 6m, 1y, 2y, 3y, 5y, 7y, 10y, 20y, 30y. Omit for full curve.
Example
Get full yield curve with spreads
curl -H "Authorization: Bearer $TOOLROUTER_API_KEY" \
  -d '{
  "tool": "finance-data",
  "skill": "treasury_yields",
  "input": {}
}' \
  https://api.toolrouter.com/v1/tools/call
Benchmark Rates

Get key central bank interest rates from the Federal Reserve, ECB, Bank of England, and Bank of Canada. US: SOFR, EFFR, OBFR. EU: ESTER, Main Refinancing Rate, Deposit Facility Rate. UK: Bank Rate, SONIA. CA: Policy Interest Rate, CORRA. Filter by region or get all.

Returns: Benchmark interest rates grouped by region with rate name, value, date, and source.
Parameters
regionstringFilter by region: us, eu, uk, ca, or all. Default: all.
Example
Get all central bank rates
curl -H "Authorization: Bearer $TOOLROUTER_API_KEY" \
  -d '{
  "tool": "finance-data",
  "skill": "benchmark_rates",
  "input": {}
}' \
  https://api.toolrouter.com/v1/tools/call
Exchange Rates

Get foreign exchange rates for 30+ currencies sourced from the ECB via Frankfurter API. Supports custom base currency, symbol filtering, and historical date lookups.

Returns: Exchange rates with base currency, date, and rates object mapping currency codes to values.
Parameters
basestringBase currency code (e.g. USD, EUR, GBP). Default: USD.
symbolsstringComma-separated target currencies (e.g. "EUR,GBP,JPY"). Omit for all.
datestringHistorical date in YYYY-MM-DD format. Omit for latest rates.
Example
Get all rates with USD base
curl -H "Authorization: Bearer $TOOLROUTER_API_KEY" \
  -d '{
  "tool": "finance-data",
  "skill": "exchange_rates",
  "input": {}
}' \
  https://api.toolrouter.com/v1/tools/call
Economic Indicators

Get key economic indicators: GDP, GDP growth, inflation, unemployment, and CPI. US data from the Bureau of Labor Statistics. Global data from the World Bank. Supports any country by ISO code.

Returns: Economic indicators with values, dates, and source attribution (BLS for US, World Bank for global).
Parameters
indicatorstringSpecific indicator: gdp, inflation, unemployment, cpi, or all. Default: all.
countrystringISO 2-letter country code (US, GB, DE, JP, CN, IN, BR, etc.) or "global" for major economies. Default: US.
Example
Get all US economic indicators
curl -H "Authorization: Bearer $TOOLROUTER_API_KEY" \
  -d '{
  "tool": "finance-data",
  "skill": "economic_indicators",
  "input": {}
}' \
  https://api.toolrouter.com/v1/tools/call
Energy Markets

Get US energy market data from the EIA. Covers crude oil spot prices (WTI, Brent), retail gasoline/diesel prices, Henry Hub natural gas futures, electricity prices by sector, coal prices, and petroleum inventory levels including the Strategic Petroleum Reserve.

Returns: Energy market data points with period, product name, value, and units. Source: US EIA.
Parameters
categorystringData category: oil, gas, natural_gas, electricity, coal, or inventories. Default: oil.
Example
Get crude oil spot prices
curl -H "Authorization: Bearer $TOOLROUTER_API_KEY" \
  -d '{
  "tool": "finance-data",
  "skill": "energy_markets",
  "input": {}
}' \
  https://api.toolrouter.com/v1/tools/call
COT Report

Get CFTC Commitment of Traders positioning data showing how commercial hedgers and speculative traders are positioned in major futures markets. Covers energy, metals, agriculture, financials, and currencies. Updated weekly.

Returns: COT report with open interest, commercial and non-commercial long/short positions, net positions, and changes. Source: CFTC.
Parameters
marketstringFilter by market keyword (e.g. "wheat", "crude", "gold", "natural gas", "euro", "s&p"). Omit for all major markets.
Example
Get all major COT positions
curl -H "Authorization: Bearer $TOOLROUTER_API_KEY" \
  -d '{
  "tool": "finance-data",
  "skill": "cot_report",
  "input": {}
}' \
  https://api.toolrouter.com/v1/tools/call
US National Debt

Get US national debt figures and average interest rates on Treasury securities from the Treasury Fiscal Data API. Includes debt-to-the-penny (total, held by public, intragovernmental) and average coupon rates by security type.

Returns: US national debt figures (total, public, intragovernmental) and average interest rates by security type. Source: US Treasury.
Parameters
metricstringData to fetch: debt (totals), interest_rates (avg coupon by security), or all. Default: all.
Example
Get all debt and rate data
curl -H "Authorization: Bearer $TOOLROUTER_API_KEY" \
  -d '{
  "tool": "finance-data",
  "skill": "us_national_debt",
  "input": {}
}' \
  https://api.toolrouter.com/v1/tools/call
Fed Balance Sheet

Get the Federal Reserve balance sheet (SOMA holdings) from the New York Fed. Shows total holdings and breakdown by asset class: Treasury securities, mortgage-backed securities, agency debt, and more.

Returns: Federal Reserve SOMA holdings with total value, asset class breakdown, and as-of date. Source: NY Fed.
Example
Get current Fed balance sheet
curl -H "Authorization: Bearer $TOOLROUTER_API_KEY" \
  -d '{
  "tool": "finance-data",
  "skill": "fed_balance_sheet",
  "input": {}
}' \
  https://api.toolrouter.com/v1/tools/call
VIX Index

Get the CBOE VIX (Volatility Index) from FRED. Returns daily values with summary stats and fear-level classification.

Returns: VIX daily values with summary stats (high, low, average, latest, trend direction) and fear-level classification.
Parameters
daysnumberNumber of days of history to fetch (1-365). Default: 30.
Example
Get 30 days of VIX data
curl -H "Authorization: Bearer $TOOLROUTER_API_KEY" \
  -d '{
  "tool": "finance-data",
  "skill": "vix_index",
  "input": {}
}' \
  https://api.toolrouter.com/v1/tools/call
Labor Market

Get comprehensive US labor market data from FRED. Covers nonfarm payrolls, initial jobless claims (weekly), JOLTS job openings, average hourly earnings, labor force participation rate, unemployment rate, and U-6 underemployment rate.

Returns: US labor market metrics with values, dates, and units. Single metric includes 12-month history.
Parameters
metricstringMetric to fetch (e.g. nonfarm_payrolls, initial_claims, jolts, unemployment). Default: all.
Example
Get all labor market data
curl -H "Authorization: Bearer $TOOLROUTER_API_KEY" \
  -d '{
  "tool": "finance-data",
  "skill": "labor_market",
  "input": {}
}' \
  https://api.toolrouter.com/v1/tools/call
Housing Market

Get US housing market data from FRED. Covers 30-year and 15-year fixed mortgage rates, S&P/Case-Shiller home price index, median sale price, housing starts, existing home sales, building permits, vacancy rate, and homeownership rate.

Returns: US housing market metrics with values, dates, and units. Single metric includes 12-month history.
Parameters
metricstringSpecific metric: mortgage_rates, home_prices, housing_starts, existing_sales, permits, vacancy, homeownership, or all. Default: all.
Example
Get all housing market data
curl -H "Authorization: Bearer $TOOLROUTER_API_KEY" \
  -d '{
  "tool": "finance-data",
  "skill": "housing_market",
  "input": {}
}' \
  https://api.toolrouter.com/v1/tools/call
Money Supply

Get US money supply and monetary aggregates from FRED. Covers M1 and M2 money stock, velocity of money, monetary base, total reserves, excess reserves, Fed reserve balances, and Fed total assets (WALCL). Includes a Fed summary with total assets and reserves.

Returns: US money supply metrics with values, dates, and units. Single metric includes 24-month history. Includes Fed summary.
Parameters
metricstringSpecific metric: m1, m2, velocity, monetary_base, reserves, fed_assets, or all. Default: all.
Example
Get all money supply data
curl -H "Authorization: Bearer $TOOLROUTER_API_KEY" \
  -d '{
  "tool": "finance-data",
  "skill": "money_supply",
  "input": {}
}' \
  https://api.toolrouter.com/v1/tools/call
Consumer Sentiment

Get US consumer confidence and sentiment data from FRED. Covers UMich Consumer Sentiment Index, 1-year inflation expectations, OECD Consumer Confidence, personal consumption (durable goods), personal saving rate, total vehicle sales, and advance retail sales.

Returns: Consumer sentiment and spending metrics with values, dates, and units. Single index includes 24-month history.
Parameters
indexstringSpecific index: umich (sentiment + inflation expectations), spending (consumption, saving, retail), vehicles, or all. Default: all.
Example
Get all consumer data
curl -H "Authorization: Bearer $TOOLROUTER_API_KEY" \
  -d '{
  "tool": "finance-data",
  "skill": "consumer_sentiment",
  "input": {}
}' \
  https://api.toolrouter.com/v1/tools/call
Government Bonds

Get Euro area 10-year government bond yields from the ECB for 11 countries: Germany, France, Italy, Spain, Netherlands, Belgium, Austria, Portugal, Greece, Ireland, and Finland. Computes spread vs Germany (benchmark) in basis points.

Returns: Euro area 10Y government bond yields by country with spread vs Germany in basis points. Source: ECB.
Parameters
countrystringISO 2-letter country code: DE, FR, IT, ES, NL, BE, AT, PT, GR, IE, FI. Omit for all countries.
Example
Get all Euro area bond yields
curl -H "Authorization: Bearer $TOOLROUTER_API_KEY" \
  -d '{
  "tool": "finance-data",
  "skill": "government_bonds",
  "input": {}
}' \
  https://api.toolrouter.com/v1/tools/call
Crypto Markets

Get crypto market data from CoinGecko. Global stats, top coins by market cap, trending coins, DeFi stats, Fear & Greed Index, category breakdowns, and single-coin details. Real-time.

Returns: Crypto market data with prices, market caps, volumes, dominance, Fear & Greed sentiment, and trends. Source: CoinGecko + Alternative.me.
Parameters
categorystringData category: overview (global stats + fear/greed + top 5), top_coins, trending, defi, fear_greed, categories. Default: overview.
coinstringSpecific coin ID for details (e.g. "bitcoin", "ethereum", "solana"). Used with overview or on its own.
limitnumberNumber of coins for top_coins (1-100). Default: 20.
Example
Get crypto market overview
curl -H "Authorization: Bearer $TOOLROUTER_API_KEY" \
  -d '{
  "tool": "finance-data",
  "skill": "crypto_markets",
  "input": {}
}' \
  https://api.toolrouter.com/v1/tools/call
Credit Conditions

Get US credit market conditions from FRED. Covers credit spreads (IG, HY, BBB, TED), bank lending (credit, C&I loans, real estate), consumer credit (outstanding, cards, debt service), delinquency rates, and SLOOS lending standards.

Returns: US credit market metrics with values, dates, and units. Single metric includes 24-month history.
Parameters
metricstringSpecific metric: credit_spreads, bank_lending, consumer_credit, delinquencies, lending_standards, or all. Default: all.
Example
Get all credit conditions
curl -H "Authorization: Bearer $TOOLROUTER_API_KEY" \
  -d '{
  "tool": "finance-data",
  "skill": "credit_conditions",
  "input": {}
}' \
  https://api.toolrouter.com/v1/tools/call
Precious Metals

Get real-time precious metals spot prices from Gold-API. Covers gold, silver, platinum, and palladium with live bid/ask, daily high/low, change from previous close, and gold price per gram in multiple karats (24k, 22k, 18k, 14k). Updated every few seconds — much more current than daily FRED data.

Returns: Live precious metals spot prices with bid/ask, high/low, change, and per-gram prices for gold. Source: Gold-API.com.
Parameters
metalstringSpecific metal: gold, silver, platinum, palladium, or all. Default: all.
Example
Get all precious metals prices
curl -H "Authorization: Bearer $TOOLROUTER_API_KEY" \
  -d '{
  "tool": "finance-data",
  "skill": "precious_metals",
  "input": {}
}' \
  https://api.toolrouter.com/v1/tools/call
Leading Indicators

Get OECD Composite Leading Indicators (CLI) for 14 major economies. Predicts turning points 6-9 months ahead — above 100 = expansion, below 100 = contraction. Covers US, UK, DE, JP, FR, IT, CA, CN, BR, IN, MX, KR, AU, ZA.

Returns: OECD CLI values with direction (expanding/contracting/stabilizing), trend position (above/below 100), and 6-month history. Source: OECD.
Parameters
countrystringISO 2-letter country code (US, GB, DE, JP, FR, IT, CA, CN, BR, IN, MX, KR, AU, ZA) or "all" for all 14 economies. Default: all.
Example
Get CLI for all major economies
curl -H "Authorization: Bearer $TOOLROUTER_API_KEY" \
  -d '{
  "tool": "finance-data",
  "skill": "leading_indicators",
  "input": {}
}' \
  https://api.toolrouter.com/v1/tools/call
Federal Budget

Get US federal budget data from the Treasury Monthly Treasury Statement (MTS) API. Covers monthly receipts, outlays, surplus/deficit, and year-to-date fiscal totals. Includes outlays broken down by government function. Updated monthly.

Returns: Federal budget data with monthly receipts, outlays, surplus/deficit, year-to-date totals, and optionally outlays by function. Source: US Treasury.
Parameters
categorystringData category: summary (receipts/outlays/deficit), receipts (same as summary), outlays (by function), or all. Default: summary.
Example
Get federal budget summary
curl -H "Authorization: Bearer $TOOLROUTER_API_KEY" \
  -d '{
  "tool": "finance-data",
  "skill": "federal_budget",
  "input": {}
}' \
  https://api.toolrouter.com/v1/tools/call
Live Prices

Real-time market prices with intraday charts. Covers energy, metals, agriculture futures, global stock indices, FX majors, crypto, and bond futures. Supports 5-minute to daily intervals.

Returns: Real-time OHLCV data for single symbols (with price, change, 52-week range, and history), or a price summary table for categories.
Parameters
symbolstringYahoo Finance ticker symbol (e.g. "BZ=F" for Brent, "GC=F" for gold, "^GSPC" for S&P 500, "BTC-USD" for Bitcoin).
categorystringFetch all instruments in a group: energy, metals, agriculture, indices, fx_majors, crypto, bonds. Returns a price table for the whole category.
intervalstringPrice interval: 5m, 15m, 1h, 1d. Default: 1d. Intraday intervals (5m/15m/1h) only work with short ranges (1d/5d).
rangestringTime range: 1d, 5d, 1mo, 3mo, 6mo, 1y. Default: 5d.
Example
Get live TTF natural gas price
curl -H "Authorization: Bearer $TOOLROUTER_API_KEY" \
  -d '{
  "tool": "finance-data",
  "skill": "live_prices",
  "input": {
    "symbol": "TTF=F"
  }
}' \
  https://api.toolrouter.com/v1/tools/call
Electricity Prices

European wholesale electricity day-ahead prices at 15-minute resolution. Covers 24 bidding zones across Europe including Germany, France, Netherlands, Belgium, Spain, Italy, Nordics, UK, Poland, and more. Shows current spot price, average, min/max, and full time series.

Returns: Wholesale electricity prices with summary stats (latest, average, min, max) and 15-minute time series data.
Parameters
zonestringBidding zone code (e.g. DE-LU, FR, NL, BE, AT, ES, IT-North, GB). Default: DE-LU.
hoursnumberHours of data to fetch (1-168). Default: 24 (last day).
Example
Get current German electricity price
curl -H "Authorization: Bearer $TOOLROUTER_API_KEY" \
  -d '{
  "tool": "finance-data",
  "skill": "electricity_prices",
  "input": {}
}' \
  https://api.toolrouter.com/v1/tools/call
Futures Curve

Full futures term structure (forward curve) for 16 major contracts. Shows every contract month with price, change, volume, and market structure (contango vs backwardation). Covers energy, metals, agriculture, and Treasury futures.

Returns: Futures curve with price per contract month, front month, calendar spread, market structure (contango/backwardation), and volume. Proxy for CME/ICE settlement data.
Parameters
contractstringContract ID (e.g. ttf_gas, wti_crude, gold, corn, treasury_10y). Omit to list all available contracts.
monthsnumberNumber of contract months to fetch (3-24). Default: 12.
Example
Get TTF gas futures curve (CME settlements equivalent)
curl -H "Authorization: Bearer $TOOLROUTER_API_KEY" \
  -d '{
  "tool": "finance-data",
  "skill": "futures_curve",
  "input": {
    "contract": "ttf_gas"
  }
}' \
  https://api.toolrouter.com/v1/tools/call
Loading reviews...
Loading activity...
v0.062026-03-23
  • Added Yahoo Finance real-time fallback for FRED-dependent skills — treasury_yields, vix_index, commodity_prices, and credit_conditions now automatically fall back to Yahoo Finance when FRED is unavailable
  • Fixed cot_report parser — tries multiple CFTC URLs, validates response format, added market name aliases for common searches (crude, oil, gold, etc.)
  • Added credit ETF proxy signals (HYG, LQD, JNK, VIX) to credit_conditions fallback — shows spread direction when FRED OAS data is unavailable
v0.052026-03-23
  • Added live_prices skill — real-time OHLCV from Yahoo Finance covering energy, metals, agriculture, indices, FX, crypto, and bond futures with intraday support
  • Added electricity_prices skill — European wholesale day-ahead prices at 15-min resolution for 24 bidding zones from Energy-Charts
v0.042026-03-22
  • Added Bank of Canada rates (Policy Rate, CORRA) to benchmark_rates — now covers 4 central banks
  • Added Euro Area HICP inflation from ECB to economic_indicators for Euro area countries
  • Added federal_budget skill — US Treasury Monthly Treasury Statement (receipts, outlays, surplus/deficit)
  • Added electricity retail prices and coal prices to energy_markets
v0.032026-03-22
  • Added crypto_markets skill — CoinGecko market data (top coins, trending, DeFi, categories) + Fear & Greed Index
  • Added credit_conditions skill — credit spreads (IG/HY/BBB/TED), bank lending, consumer credit, delinquencies, SLOOS lending standards
  • Added precious_metals skill — real-time gold, silver, platinum, palladium spot prices with bid/ask from Gold-API
  • Added leading_indicators skill — OECD Composite Leading Indicators for 14 major economies
v0.022026-03-22
  • Added labor_market skill — nonfarm payrolls, initial claims, JOLTS, avg hourly earnings, participation rate, U-6 underemployment
  • Added housing_market skill — mortgage rates (30y/15y), Case-Shiller, median price, housing starts, existing sales, permits, vacancy/homeownership rates
  • Added money_supply skill — M1/M2 money stock, velocity, monetary base, reserves, Fed total assets (WALCL)
  • Added consumer_sentiment skill — UMich sentiment, inflation expectations, OECD confidence, retail sales, saving rate, vehicle sales
  • Added government_bonds skill — Euro area 10Y yields for 11 countries with spread vs Germany (bps) from ECB
v0.012026-03-22
  • Initial release with 10 skills: commodity_prices, treasury_yields, benchmark_rates, exchange_rates, economic_indicators, energy_markets, cot_report, us_national_debt, fed_balance_sheet, vix_index

Quick Start

MCP (Claude Code)
claude mcp add --transport stdio \
  --env TOOLROUTER_API_KEY=YOUR_API_KEY \
  toolrouter -- npx -y toolrouter-mcp
REST API
curl -H "Authorization: Bearer $TOOLROUTER_API_KEY" \
  -d '{"tool":"finance-data","skill":"commodity_prices","input":{}}' \
  https://api.toolrouter.com/v1/tools/call

Frequently Asked Questions

What is the quickest way to get a market snapshot?

Use `live_prices` for a broad real-time read across energy, metals, agriculture, indices, FX, crypto, and bonds. It is the fastest way to check the tape.

Can I see the US yield curve and detect inversions?

Yes. `treasury_yields` returns the full curve and highlights key spreads, including the 10Y-2Y and 10Y-3M moves that traders watch for inversion signals.

Does it cover FX, commodities, and macro data too?

Yes. You can pull exchange rates, commodity prices, benchmark rates, energy market data, economic indicators, credit conditions, and more from the same tool.

When should I use the official historical feeds instead of live prices?

Use the FRED-backed skills when you want a cleaner historical reference series, and use the live pricing skills when you need current market levels.