{"uid":"cap_NGwa3bZcaVsAJINZHLdtd","slug":"stationfx-gdp-nominal-gross-domestic-product-8548b7e8","name":"StationFX GDP – Nominal Gross Domestic Product","description":"Total value of goods and services produced in the U.S., nominal (current dollar) terms. Quarterly BEA estimate. Use for economic size comparisons, debt-to-GDP calculations, and long-run growth trend analysis. Quarterly frequency with full history back to 1947.","url":"https://stationfx.com/economic-data/gdp-growth/gross-domestic-product?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http","description":"Always \"http\" for HTTP endpoints"},"method":{"enum":["GET","HEAD","DELETE"],"type":"string","description":"HTTP method. Always GET for StationFX query endpoints"},"queryParams":{"type":"object","properties":{"fmt":{"enum":["json","toon"],"type":"string","description":"Response format. Use toon for compact agent-friendly output."},"fields":{"type":"string","description":"Comma-separated metric names"},"date_to":{"type":"string","description":"End date YYYY-MM-DD"},"date_from":{"type":"string","description":"Start date YYYY-MM-DD"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string","description":"Response format. Always \"json\" (or \"toon\" if fmt=toon was requested)"},"example":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string","description":"Observation date YYYY-MM-DD"},"value":{"type":"number","description":"Raw observed value in series units"},"mom_pct":{"type":"number","description":"Month-over-month % change"},"yoy_pct":{"type":"number","description":"Year-over-year % change"},"zscore_5y":{"type":"number","description":"Z-score relative to trailing 5 years"},"mom_change":{"type":"number","description":"Month-over-month absolute change"},"yoy_change":{"type":"number","description":"Year-over-year absolute change"},"zscore_12m":{"type":"number","description":"Z-score relative to trailing 12 months"},"above_trend":{"type":"integer","description":"1 if value is above long-run trend, else 0"},"pct_rank_5y":{"type":"number","description":"Percentile rank over trailing 5 years (0-100)"},"rolling_3m_avg":{"type":"number","description":"3-month rolling average"},"rolling_12m_avg":{"type":"number","description":"12-month rolling average"},"trend_direction":{"type":"integer","description":"Trend: 1 rising, -1 falling, 0 flat"}}},"description":"Observations ordered by date ascending"},"meta":{"type":"object","description":"Series metadata: source_key (FRED series ID), units, frequency (D/W/M/Q/A), date_from, date_to, fields"}},"description":"Station f(x) response with metadata and pre-computed derived metrics"}}}}},"responseSchema":{"type":"json","schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string","description":"Observation date YYYY-MM-DD"},"value":{"type":"number","description":"Raw observed value in series units"},"mom_pct":{"type":"number","description":"Month-over-month % change"},"yoy_pct":{"type":"number","description":"Year-over-year % change"},"zscore_5y":{"type":"number","description":"Z-score relative to trailing 5 years"},"mom_change":{"type":"number","description":"Month-over-month absolute change"},"yoy_change":{"type":"number","description":"Year-over-year absolute change"},"zscore_12m":{"type":"number","description":"Z-score relative to trailing 12 months"},"above_trend":{"type":"integer","description":"1 if value is above long-run trend, else 0"},"pct_rank_5y":{"type":"number","description":"Percentile rank over trailing 5 years (0-100)"},"rolling_3m_avg":{"type":"number","description":"3-month rolling average"},"rolling_12m_avg":{"type":"number","description":"12-month rolling average"},"trend_direction":{"type":"integer","description":"Trend: 1 rising, -1 falling, 0 flat"}}},"description":"Observations ordered by date ascending"},"meta":{"type":"object","description":"Series metadata: source_key (FRED series ID), units, frequency (D/W/M/Q/A), date_from, date_to, fields"}},"description":"Station f(x) response with metadata and pre-computed derived metrics"},"example":{"data":[{"date":"2024-01-01","value":5.33,"mom_pct":0,"yoy_change":0.5,"zscore_12m":1.2,"trend_direction":1}],"meta":{"frequency":"Q","source_key":"GDP"}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_oYrnoCMGIVWMbUgS0p5lj","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns U.S. nominal GDP quarterly time series data from the BEA, with derived stats like YoY growth, z-scores, trend flags, and rolling averages.","exampleAgentPrompt":"Pull the StationFX nominal GDP series from Q1 2015 through Q4 2023 in JSON format so I can see the year-over-year growth rates and whether each quarter was above or below the long-run trend.","exampleUseCases":[{"title":"Debt-to-GDP ratio calculation","prompt":"Fetch the latest U.S. nominal GDP value from StationFX so I can divide our national debt figure by it and get the current debt-to-GDP ratio."},{"title":"Long-run GDP growth trend analysis","prompt":"Give me quarterly U.S. nominal GDP data from 1947 through today so I can chart the long-run growth trajectory and identify the fastest- and slowest-growing decades."},{"title":"Recession-era GDP contraction review","prompt":"Pull StationFX nominal GDP data for 2007 through 2010 in JSON and show me the year-over-year percent changes and z-scores so I can quantify how deep the Great Recession contraction was."}],"resultDescription":"Returns an array of quarterly observations, each containing the observation date, raw nominal GDP value in current dollars, month-over-month and year-over-year absolute and percentage changes, 12-month and 5-year z-scores, a percentile rank over the trailing 5 years, a binary above-trend flag, and 3-month and 12-month rolling averages.","failureModes":["Invalid date format in date_from or date_to returns an error","date_from later than date_to yields empty or error response","Unsupported fmt enum value causes a 400 bad request","Requesting fields not present in the GDP series returns null or missing values","Dates before 1947 may return no data as BEA history starts then","Payment of 0.005 USDC not completed results in 402 Payment Required"],"whenToPreferThis":"Choose this endpoint when you need U.S. nominal (current-dollar) GDP time series data with pre-computed statistical enrichments like z-scores, trend flags, and rolling averages. It is ideal for debt-to-GDP calculations, long-run growth comparisons, and macroeconomic dashboards. Prefer it over raw BEA data pulls when you want enriched, agent-ready output without building your own derived stats. Use sibling StationFX endpoints for inflation, labor, or interest rate data.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-02T00:45:01.556Z","isFirstParty":false,"canonicalSlug":"stationfx-gdp-nominal-gross-domestic-product-8548b7e8"}