US CPI & FOMC Economic Calendar API Sample

Build a US CPI and FOMC watchlist with the Finance Calendar economic calendar API. The fixed public JSON sample shows a published Bureau of Labor Statistics (BLS) inflation reading, a scheduled US CPI release and a scheduled Federal Open Market Committee (FOMC) rate decision. Open it without an account or API key.

To connect paid live data for an AI agent, prepare a two-hour setup link for the account owner. The verified owner links the setup to their account and selects Continue to Stripe. The agent can resume the first US CPI query when the account is ready.

Recorded US CPI and FOMC briefing

Recorded sample captured at .

  • Completed release — US CPI. Reporting period 2026-09. Release time (08:30 ET). Recorded actual 3.7 % y/y. Bureau of Labor Statistics.
  • Scheduled release — US CPI. Release time (08:30 ET). No actual recorded at capture. Bureau of Labor Statistics.
  • Scheduled decision — FOMC decision. Release time (14:00 ET). No actual recorded at capture. Federal Reserve Board.

In an already connected hosted MCP client, feed_status also returns this fixed example in structuredContent.recorded_public_sample. Read its capture date and official source links for the briefing. The separate status fields describe service health; the recorded example remains frozen. Hosted MCP uses your existing eligible account access.

Use curl and jq to get the same records as JSON.

curl -fsS 'https://www.financecalendar.com/wp-json/fc/v1/sample' |
  jq -e 'select(.sample.not_a_live_feed == true) |
    {captured_at: .sample.captured_at, events: [.events[] |
      {sample_role, name, period, release_at_utc, time_et, release_tz,
        time_precision, status, actual, actual_status, unit, source_url,
        result_source_url: .actual_evidence.edition_url}]}'

The completed CPI example includes the recorded figure, the reporting period and a link to its Bureau of Labor Statistics source. The scheduled CPI release and FOMC decision have official calendar links and capture-time schedules. Each scheduled example has actual: null.

Use the examples above or read the Finance Calendar sample JSON. Label the briefing as a recorded sample with its capture date. For the completed CPI release, report the period, actual and unit and cite the linked BLS release (actual_evidence.edition_url in JSON). Show the scheduled CPI release and FOMC decision times as of the capture and link each publisher calendar. Keep unknown fields unknown.

Use the same workflow with live data

Connect a paid account and ask your assistant for the next US CPI release. In a connected MCP client, call next_event with these arguments:

{"series": "us-cpi", "tz": "America/New_York"}

For REST, set FC_API_KEY in your private server environment and run:

curl -fsS 'https://www.financecalendar.com/wp-json/fc/v1/next?series=us-cpi&tz=America%2FNew_York' \
  -H "X-API-Key: $FC_API_KEY"

Use the returned time precision and status to distinguish exact times from dates and windows. A future release can have a published time before it has a reported figure.

Choose an API plan · Connect ChatGPT or Claude · Set up your API key

Set up live access for an account owner

Prepare your owner setup link

Start a live US CPI watchlist with Starter at US$9.99/year, billed yearly. Applicable tax is included.

Choose your assistant and select Prepare setup link. This creates a two-hour link for the account owner without signing in or paying. The owner then signs in, verifies their email, links the setup and approves any required payment themselves. Existing matching paid access can resume after linking.

This page is a preparation form. Your owner link is created only after you select the button. If an assistant cannot make external API calls, you or a browser-capable agent can complete this step here.

For example America/New_York, Europe/London or UTC.

An agent can create a two-hour owner setup link for the next US CPI query without an account or API key. Choose a paid plan and billing interval from the current product offer. The owner signs in or creates an account, verifies their email, links the setup to that account and selects Continue to Stripe to review payment.

curl -fsS 'https://www.financecalendar.com/wp-json/fc-handoff/v1/setup' \
  -H 'Content-Type: application/json' \
  --data '{"recipe":"next-us-cpi","client":"claude","plan":"starter","billing_interval":"year"}'

Share only owner_url with the owner. Keep status_token in private tool state. Send it as the X-FC-Handoff-Token header to the returned status_url, waiting at least poll_after_seconds between checks.

Use next_action from the status response to continue.

  • owner_required → share_owner_url. Ask the owner to sign in, verify their email and link the setup.
  • payment_pending → wait_for_payment. Wait for Stripe payment to activate access, then check again at the polling interval.
  • billing_review → check_billing. Ask the owner to check billing in their account before continuing.
  • plan_mismatch → check_plan. Ask the owner to check that their active plan and billing interval match this setup.
  • ready → connect_and_query. Open resume.connection_url to connect with an account API key or supported MCP sign-in. Run resume.first_call to get the next US CPI result.

See the OpenAPI request and response schema for the handoff and live query.

What the sample includes

The three publisher-selected records show a sourced CPI result and two schedules as recorded at the capture date. Forecast and prior fields remain blank in this sample. Keep the capture date and any applicable source credits when sharing it.

Open the full recorded JSON sample · Alternate JSON link · Read the current API offer as JSON

Choose your history depth

For longer research datasets, use paid API access to retrieve official observations and publication records. Check the exact measure’s range and value basis before exporting.

Compare history by plan · Explore historical coverage.

Connect your integration

Browse the public economic calendar free. Connect apps and AI tools with paid API access from US$9.99/year. Starter includes 1,000 requests per UTC day and 25,000 per UTC calendar month. Build is US$9.99/month or US$95.90/year, with 100,000 requests per UTC day. Scale is US$29.00/month or US$278.40/year, with 1,000,000 requests per UTC day and the complete current dataset download. Free Developer provides 100 successful schedule JSON responses per UTC calendar month, up to 10 per UTC day, with one key issued after approval of your request (allow up to 48 hours for review). Use /calendar and /today for economic-release and central-bank schedules from UTC today through today+6, with country/impact filters, bounded date narrowing and up to 20 records per response. The allowance renews monthly; no card, fixed expiry or automatic paid subscription. Figures, history, wider dates/routes, CSV/ICS, hosted MCP, Data explorer and webhooks require a paid plan. Personal and customer-facing projects are allowed within these limits and applicable source terms. Annual prices are charged upfront. Paid plans renew at their selected interval until cancelled; applicable tax is included. Linked keys share one account allowance.

Inspect the recorded sample · Compare current plans. Existing subscription agreements and paid-through migration access retain their confirmed terms.

Choose Free Developer for bounded schedule JSON, or a paid plan for figures, wider dates and tools. Create an account and confirm your email; complete secure checkout only when choosing paid access. Create an API key in your account and keep it in your server environment. Follow the REST reference, MCP guide or CLI and Python guide.

Review the current access and service terms for billing, account security, attribution and applicable source rights.