{"uid":"cap_qK9XXMmysjadrLtSn18x4","slug":"gig-finance-tools-us-macro-snapshot-ed7dcda0","name":"Gig Finance Tools – US Macro Snapshot","description":"Pay-per-call finance tools for US gig workers, paid in USDC on Base via x402. Not tax or financial advice.","url":"https://safe-weekly-spend-api-production.gigfinancetools.workers.dev/v1/us-macro-snapshot?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"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","title":"UsMacroSnapshotQuery","properties":{"format":{"enum":["json"],"type":"string"},"history":{"enum":["0","5","22"],"type":"string","description":"Trailing business days of par-curve points to include in curve.history. Default 0."},"sections":{"type":"string","pattern":"^(curve|real|policy|inflation|labor|fiscal)(,(curve|real|policy|inflation|labor|fiscal))*$","description":"Comma-separated subset of curve, real, policy, inflation, labor, fiscal. Default: all."}},"description":"Query parameters (all optional). GET /v1/us-macro-snapshot?sections=curve,policy&history=5","additionalProperties":true}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","title":"us-macro-snapshot","required":["generated_at","cache_age_s","as_of","stale","stale_sections","sources","notices","disclaimer"],"properties":{"real":{"type":["object","null"],"properties":{"as_of":{"type":["string","null"]},"stale":{"type":"boolean"}},"description":"TIPS par real yields and breakeven_bp (nominal minus real)"},"as_of":{"type":"object","description":"Latest observation date per requested section (YYYY-MM-DD, or YYYY-MM for monthly BLS series)","additionalProperties":{"type":["string","null"]}},"curve":{"type":["object","null"],"properties":{"as_of":{"type":["string","null"]},"stale":{"type":"boolean"}},"description":"Treasury par yield curve: par (percent by tenor), chg_bp 1d/1w/1m, spreads_bp 2s10s/3m10y, inverted, inversion_streak_days, shape, optional history"},"labor":{"type":["object","null"],"properties":{"as_of":{"type":["string","null"]},"stale":{"type":"boolean"}},"description":"Unemployment rate and nonfarm payrolls level/change (thousands)"},"stale":{"type":"boolean","description":"true if any requested section is stale (last refresh failed and last good data is served, or data older than expected)"},"fiscal":{"type":["object","null"],"properties":{"as_of":{"type":["string","null"]},"stale":{"type":"boolean"}},"description":"Average interest rate on marketable / interest-bearing Treasury debt, and debt to the penny"},"policy":{"type":["object","null"],"properties":{"as_of":{"type":["string","null"]},"stale":{"type":"boolean"}},"description":"EFFR with target range, OBFR, SOFR, SOFR averages, real_policy_rate_pct, rule-based stance"},"notices":{"type":"array","items":{"type":"string"},"description":"Required attribution and NY Fed / DTCC notices"},"sources":{"type":"array","items":{"type":"object","required":["id","name","publisher","url","license"],"properties":{"id":{"type":"string"},"url":{"type":"string"},"name":{"type":"string"},"license":{"type":"string"},"publisher":{"type":"string"},"fetched_at":{"type":["string","null"]},"last_attempt_ok":{"type":"boolean"}}}},"inflation":{"type":["object","null"],"properties":{"as_of":{"type":["string","null"]},"stale":{"type":"boolean"}},"description":"CPI-U headline and core: index, yoy_pct (NSA), mom_pct_sa"},"disclaimer":{"type":"string"},"cache_age_s":{"type":"integer"},"generated_at":{"type":"string","description":"When the cached snapshot was last refreshed (ISO 8601)"},"stale_sections":{"type":"array","items":{"type":"string"}}}}}}}},"responseSchema":{"type":"json","example":{"real":{"tips":{"5yr":2.52,"7yr":2.62,"10yr":2.74,"20yr":3.01,"30yr":3.16},"unit":"percent","as_of":"2026-10-16","stale":false,"breakeven_bp":{"5yr":237,"7yr":236,"10yr":235,"20yr":246,"30yr":227},"breakeven_rule":"nominal par yield minus TIPS real yield,…"},"as_of":{"real":"2026-10-16","curve":"2026-10-16","labor":"2026-09","fiscal":"2026-10-15","policy":"2026-10-15","inflation":"2026-09"},"curve":{"par":{"1mo":4.12,"1yr":4.46,"2mo":4.17,"2yr":4.74,"3mo":4.26,"3yr":4.82,"4mo":4.32,"5yr":4.89,"6mo":4.34,"7yr":4.98,"10yr":5.09,"20yr":5.47,"30yr":5.43,"1.5mo":4.14},"unit":"percent","as_of":"2026-10-16","shape":"normal","stale":false,"chg_bp":{"1d":{"1mo":-5,"1yr":-3,"2mo":-2,"2yr":-3,"3mo":-2,"3yr":-3,"4mo":-3,"5yr":-2,"6mo":-1,"7yr":-2,"10yr":-1,"20yr":-1,"30yr":0,"1.5mo":-1},"1m":{"1mo":16,"1yr":1,"2mo":10,"2yr":0,"3mo":12,"3yr":0,"4mo":8,"5yr":3,"6mo":12,"7yr":4,"10yr":8,"20yr":8,"30yr":8,"1.5mo":14},"1w":{"1mo":-1,"1yr":-1,"2mo":4,"2yr":-6,"3mo":1,"3yr":-7,"4mo":3,"5yr":-13,"6mo":2,"7yr":-15,"10yr":-15,"20yr":-18,"30yr":-17,"1.5mo":1}},"inverted":{"2s10s":false,"3m10y":false},"shape_rule":"inverted: 2s10s<0 and 3m10y<0; flat: bot…","spreads_bp":{"2s10s":35,"3m10y":83},"chg_ref_dates":{"1d":"2026-10-15","1m":"2026-09-16","1w":"2026-10-09"},"inversion_streak_days":{"2s10s":0,"3m10y":0}},"labor":{"as_of":"2026-09","stale":false,"nonfarm_payrolls":{"period":"2026-09","preliminary":true,"level_thousands":159044,"change_thousands":29},"unemployment_rate":{"period":"2026-09","value_pct":4.2}},"stale":false,"fiscal":{"as_of":"2026-10-15","stale":false,"debt_to_penny":{"record_date":"2026-10-15","intragovernmental_usd":7850081127619.83,"total_public_debt_usd":40388317675071.91,"debt_held_by_public_usd":32538236547452.08},"avg_interest_rate":{"record_date":"2026-09-30","total_marketable_pct":3.518,"total_interest_bearing_pct":3.531}},"policy":{"effr":{"date":"2026-10-15","rate":3.88,"volume_bn":118,"target_range":[3.75]},"obfr":{"date":"2026-10-15","rate":3.88},"sofr":{"date":"2026-10-15","rate":3.89,"volume_bn":3025},"unit":"percent","as_of":"2026-10-15","stale":false,"stance":"neutral","stance_rule":"real policy rate = EFFR - CPI-U YoY; > 1…","sofr_averages":{"date":"2026-10-16","index":1.26303308,"avg_30d":3.87449,"avg_90d":3.73159,"avg_180d":3.69699},"real_policy_rate_pct":0.14},"notices":["Sources: U.S. Department of the Treasury; Bureau of the Fiscal Service (Fiscal Data); U.S. Bureau of Labor Statistics; Federal Reserve Bank of New York.","The Effective Federal Funds Rate, Overnight Bank Funding Rate, Secured Overnight Financing Rate and SOFR Averages are subject to the Terms of Use posted at newyorkfed.org. The New York Fed is not responsible for publication of the Effective Federal Funds Rate, Overnight Bank Funding Rate, Secured Overnight Financing Rate or SOFR Averages by Gig Finance Tools, does not sanction or endorse any particular republication, and has no liability for your use.","The Secured Overnight Financing Rate (SOFR) Data are calculated using data provided under a license granted to the New York Fed by DTCC Solutions LLC (\"Solutions\"), an affiliate of The Depository Trust & Clearing Corporation. Solutions, its affiliates, and third parties from which they obtained data have no liability for the content of this material.","Gig Finance Tools is not affiliated with the New York Fed. The New York Fed does not sanction, endorse, or recommend any products or services offered by Gig Finance Tools.","Not affiliated with or endorsed by the U.S. Treasury, BLS or any government agency. Derived fields (changes, spreads, breakevens, real policy rate, labels) are calculations by Gig Finance Tools."],"sources":[{"id":"treasury_nominal","url":"https://home.treasury.gov/resource-cente…","name":"Daily Treasury Par Yield Curve Rates","license":"CC0-1.0 / public domain (17 U.S.C. 105)","sections":["curve"],"publisher":"U.S. Department of the Treasury","fetched_at":"2026-10-17T14:45:00.000Z","last_attempt_ok":true}],"inflation":{"as_of":"2026-09","cpi_u":{"period":"2026-09","yoy_pct":3.74,"index_nsa":336.94,"mom_pct_sa":0.65},"stale":false,"core_cpi":{"period":"2026-09","yoy_pct":2.56,"index_nsa":339.287,"mom_pct_sa":0.33}},"disclaimer":"Informational only, not financial or inv…","cache_age_s":812,"generated_at":"2026-10-17T14:45:00.000Z","stale_sections":[]}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"unprobed","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.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_4HtqMtAC_vaYBdyPZHse5","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns a real-time snapshot of US macroeconomic indicators including Treasury yield curve, TIPS real yields, Fed policy rates, inflation, labor market data, and federal fiscal metrics.","exampleAgentPrompt":"Pull the latest US macro snapshot — I want the full yield curve, real TIPS yields, current Fed rate, and labor data, with 5 days of yield curve history.","exampleUseCases":[{"title":"Yield curve inversion check for market brief","prompt":"Is the US Treasury yield curve currently inverted? Give me the 2s10s and 3m10y spreads, the curve shape, and how long any inversion has lasted."},{"title":"Gig worker economic context dashboard","prompt":"I need a quick read on the US economy right now — what's the unemployment rate, latest nonfarm payrolls, and where is the Fed funds rate?"},{"title":"Bond market inflation expectations research","prompt":"What are current US breakeven inflation rates from TIPS across the 5, 10, and 30 year tenors, and what are the real yields as of today?"}],"resultDescription":"A JSON object with sections for curve (par yields by tenor, 1d/1w/1m changes in basis points, 2s10s/3m10y spreads, shape, inversion streak), real (TIPS real yields, breakeven inflation in bps), policy (EFFR, OBFR, target range), inflation, labor (unemployment rate, nonfarm payrolls), and fiscal (total public debt, debt held by public, intragovernmental debt, average interest rate). Each section includes an as_of date and a stale boolean. Top-level fields include generated_at, cache_age_s, stale, stale_sections, sources, notices, and a disclaimer.","failureModes":["Upstream data sources (Treasury, Fed, BLS) may be delayed on weekends or holidays, causing stale flags to be true","Requesting unsupported section names returns a validation error","Invalid history value (not 0, 5, or 22) returns a validation error","402 Payment Required if USDC payment is not provided or is insufficient","Data may be cached and slightly delayed (cache_age_s indicates staleness)"],"whenToPreferThis":"Use this endpoint when you need a single consolidated, structured snapshot of US macroeconomic conditions from authoritative government sources — especially when you need yield curve data, real rates, Fed policy, labor, and fiscal metrics in one call. Prefer this over individual Fed or Treasury data scraping when you need structured JSON with staleness flags and multiple sections in a single pay-per-call request. Particularly suited for agents serving gig workers or individual users who need macro context without expensive subscription data feeds.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-18T12:30:13.142Z","isFirstParty":false,"canonicalSlug":"gig-finance-tools-us-macro-snapshot-ed7dcda0"}