# Gig Finance Tools – US Macro Snapshot

> Gig Finance Tools – US Macro Snapshot is a paid API for AI agents from safe-weekly-spend-api-production.gigfinancetools.workers.dev, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-18).

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.

## Facts

- Endpoint: GET https://safe-weekly-spend-api-production.gigfinancetools.workers.dev/v1/us-macro-snapshot?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-18
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/gig-finance-tools-us-macro-snapshot-ed7dcda0
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_qK9XXMmysjadrLtSn18x4

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability gig-finance-tools-us-macro-snapshot-ed7dcda0
```

Example prompt: 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.

## When to prefer this

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.

## Known failure modes

- 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)

## How this service works

Pay-per-call finance tools for US gig workers, paid in USDC on Base via x402. Not tax or financial advice.

## Output

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.

## Request schema (JSON Schema)

```json
{
 "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"
         ]
    
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "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_
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/gig-finance-tools-us-macro-snapshot-ed7dcda0/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from safe-weekly-spend-api-production.gigfinancetools.workers.dev](https://www.zero.xyz/host/safe-weekly-spend-api-production.gigfinancetools.workers.dev/llms.txt)
