# 2s BEA State GDP Lookup

> 2s BEA State GDP Lookup is a paid API for AI agents from 2s.io, paid per call via x402, $0.00108/call, status unknown (last checked 2026-10-10).

Returns real GDP data by US state from the Bureau of Economic Analysis, with quarterly or annual observations in chained 2017 dollars.

## Facts

- Endpoint: GET https://2s.io/api/gov/bea-gdp?utm_source=zero.xyz
- Price: $0.00108/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-10
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/2s-bea-state-gdp-lookup-41480f2b
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_47s74G_dPA5AuY2FzM9C1

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 2s-bea-state-gdp-lookup-41480f2b
```

Example prompt: What is Texas's real GDP for the last 5 quarters? Pull the BEA regional GDP data for state code TX with a limit of 5 observations.

## When to prefer this

Use this endpoint when you need official, ground-truth US state-level real GDP figures sourced directly from the Bureau of Economic Analysis. Prefer this over general web search or LLM knowledge when you need current quarterly data, precise chained-dollar figures, or verifiable public-domain government statistics for a specific state.

## Known failure modes

- Missing required 'state' query parameter returns an error
- Invalid or unrecognized 2-letter state code returns empty results or error
- Year outside available BEA data range returns no observations
- Limit outside 1-40 range may be rejected or clamped
- Upstream BEA API downtime may cause failure or stale data

## How this service works

Quarterly real GDP by US state from the Bureau of Economic Analysis (BEA) Regional accounts — all-industry total, in millions of chained (inflation-adjusted) dollars. Requires state (2-letter); optionally a specific year (defaults to the last 5 years). Returns the state name plus GDP observations (period like 2025Q2, real GDP in millions USD, unit), newest quarter first. Free, public-domain (BEA). Authoritative state economic-output data an LLM cannot recall — for economic research, regional analysis, and market sizing.

## Output

Returns an array of observations for the requested US state, each containing the period (e.g. '2025Q1'), real GDP in millions of chained 2017 dollars, unit label, and source metadata including BEA URL and license. Also includes the geographic FIPS code, state name, and query echo.

## 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",
    "queryParams"
   ],
   "properties": {
    "type": {
     "const": "http"
    },
    "method": {
     "const": "GET"
    },
    "queryParams": {
     "required": [
      "state"
     ],
     "properties": {
      "year": {
       "type": "integer",
       "description": "Specific year (e.g. 2024). Default: last 5 years."
      },
      "limit": {
       "type": "integer",
       "description": "Max observations (1-40, default 8)."
      },
      "state": {
       "type": "string",
       "description": "2-letter US state/territory code (required)."
      }
     }
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/2s-bea-state-gdp-lookup-41480f2b/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from 2s.io](https://www.zero.xyz/host/2s.io/llms.txt)