Docs navigation +
FMP reference  /  4 endpoints

Economic data

Treasury rates, economic indicators, the economic calendar, and market risk premium.

Call these with cvApi.call('/fmp/stable/<endpoint>', params) in an app, GET /api/data/fmp/stable/<endpoint> over REST, or the fmp_request MCP tool from a coding agent. Available on every plan; requests count against your hourly limit.

Economic Data Releases Calendar

GET /api/data/fmp/stable/economic-calendar

Stay informed with the FMP Economic Data Releases Calendar API. Access a comprehensive calendar of upcoming economic data releases to prepare for market impacts and make informed investment decisions.

Query parameter Type Example
country string US
from date 2026-01-27
to date 2026-04-27
cvApi (in-app)
const data = await cvApi.call('/fmp/stable/economic-calendar');
curl (REST)
curl -H "Authorization: Bearer cv_live_..." \
  "https://tap.convexvalue.com/api/data/fmp/stable/economic-calendar"
MCP
fmp_request({ "endpoint": "economic-calendar" })
Example response +
[
  {
    "date": "2026-06-06 16:00:00",
    "country": "US",
    "event": "Fed Barr Speech",
    "currency": "USD",
    "previous": null,
    "estimate": null,
    "actual": null,
    "change": null,
    "impact": "Medium",
    "changePercentage": 0,
    "unit": null
  }
]

Economics Indicators

GET /api/data/fmp/stable/economic-indicators

Access real-time and historical economic data for key indicators like GDP, unemployment, and inflation with the FMP Economic Indicators API. Use this data to measure economic performance and identify growth trends.

Query parameter Type Example
name required string GDP,realGDP,nominalPotentialGDP,realGDPPerCapita,federalFunds,CPI,inflationRate,inflation,retailSales,consumerSentiment,durableGoods,unemploymentRate,totalNonfarmPayroll,initialClaims,industrialProductionTotalIndex,newPrivatelyOwnedHousingUnitsStartedTotalUnits,totalVehicleSales,retailMoneyFunds,smoothedUSRecessionProbabilities,3MonthOr90DayRatesAndYieldsCertificatesOfDeposit,commercialBankInterestRateOnCreditCardPlansAllAccounts,30YearFixedRateMortgageAverage,15YearFixedRateMortgageAverage,tradeBalanceGoodsAndServices
from date 2025-04-27
to date 2026-04-27
cvApi (in-app)
const data = await cvApi.call('/fmp/stable/economic-indicators', { name: 'GDP' });
curl (REST)
curl -H "Authorization: Bearer cv_live_..." \
  "https://tap.convexvalue.com/api/data/fmp/stable/economic-indicators?name=GDP"
MCP
fmp_request({ "endpoint": "economic-indicators", "params": {"name":"GDP"} })
Example response +
[
  {
    "name": "GDP",
    "date": "2026-01-01",
    "value": 31819.464
  }
]

Market Risk Premium

GET /api/data/fmp/stable/market-risk-premium

Access the market risk premium for specific dates with the FMP Market Risk Premium API. Use this key financial metric to assess the additional return expected from investing in the stock market over a risk-free investment.

No query parameters.

cvApi (in-app)
const data = await cvApi.call('/fmp/stable/market-risk-premium');
curl (REST)
curl -H "Authorization: Bearer cv_live_..." \
  "https://tap.convexvalue.com/api/data/fmp/stable/market-risk-premium"
MCP
fmp_request({ "endpoint": "market-risk-premium" })
Example response +
[
  {
    "country": "Zimbabwe",
    "continent": "Africa",
    "countryRiskPremium": 11.66,
    "totalEquityRiskPremium": 15.89
  }
]

Treasury Rates

GET /api/data/fmp/stable/treasury-rates

Access latest and historical Treasury rates for all maturities with the FMP Treasury Rates API. Track key benchmarks for interest rates across the economy.

Query parameter Type Example
from date 2026-01-27
to date 2026-04-27
cvApi (in-app)
const data = await cvApi.call('/fmp/stable/treasury-rates');
curl (REST)
curl -H "Authorization: Bearer cv_live_..." \
  "https://tap.convexvalue.com/api/data/fmp/stable/treasury-rates"
MCP
fmp_request({ "endpoint": "treasury-rates" })
Example response +
[
  {
    "date": "2026-06-05",
    "month1": 3.71,
    "month2": 3.71,
    "month3": 3.78,
    "month6": 3.81,
    "year1": 3.88,
    "year2": 4.17,
    "year3": 4.22,
    "year5": 4.29,
    "year7": 4.41,
    "year10": 4.55,
    "year20": 5.03,
    "year30": 5.01
  }
]

Get example prompts & new data guides

Occasional emails with prompts worth trying and what’s new in the data.