# ForgeMesh House Stock Trades

> ForgeMesh House Stock Trades is a paid API for AI agents from x402.forgemesh.io, paid per call via x402, $0.02/call, status unknown (last checked 2026-10-11).

Query US House member STOCK Act trade disclosures as JSON, filterable by member, ticker, transaction type, state, and date range.

## Facts

- Endpoint: POST https://x402.forgemesh.io/house-stock-trades?utm_source=zero.xyz
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-11
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/forgemesh-house-stock-trades-d8b65399
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_FMYk6N9yrJoXXefB8yO0s

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 forgemesh-house-stock-trades-d8b65399 -d '<json body>'
```

Example prompt: Show me the most recent House member stock trades for NVDA — pull up to 20 results, purchases and sales, from January 2025 to today.

## When to prefer this

Choose this endpoint when you need structured, filterable access to US House member STOCK Act disclosures with ticker symbols, especially when you need to filter by specific representatives, tickers, states, or date windows. Prefer over manually scraping the House Clerk website or general web search when you need machine-readable JSON with consistent schema and dataset coverage metadata.

## Known failure modes

- Invalid ticker format returns no results rather than an error
- Date range outside dataset coverage returns empty trades array
- Member name substring with no match returns matched:0
- Limit exceeding 100 is rejected by schema validation
- Misspelled state/district prefix returns empty results

## How this service works

US House member trade disclosures as queryable JSON: purchases, sales, and exchanges of stocks, bonds, and funds reported under the STOCK Act, with ticker symbols where the asset has one. Filter by member, ticker, type, state, or date window; results sorted newest first with dataset coverage and generation date stamped in every response.

## Output

A JSON object containing an array of matching trade records (each with member name, asset, ticker, transaction type, amount range, state/district, transaction date, notification date, doc ID, and chamber), plus total matched count, number returned, dataset coverage (years and chambers), and attribution string.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "type": {
   "enum": [
    "purchase",
    "sale",
    "sale_partial",
    "exchange"
   ],
   "type": "string"
  },
  "limit": {
   "type": "integer",
   "maximum": 100,
   "minimum": 1
  },
  "since": {
   "type": "string",
   "description": "ISO date lower bound on transaction date"
  },
  "state": {
   "type": "string",
   "description": "state or district prefix, e.g. 'VA' or 'VA01'"
  },
  "until": {
   "type": "string",
   "description": "ISO date upper bound on transaction date"
  },
  "member": {
   "type": "string",
   "description": "member name substring, e.g. 'wittman'"
  },
  "ticker": {
   "type": "string",
   "description": "exact ticker, e.g. 'NVDA'"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "trades": [
   {
    "type": "sale",
    "asset": "Crown Castle Inc. Common Stock",
    "owner": null,
    "doc_id": "20034916",
    "member": "Robert J. Wittman",
    "ticker": "CCI",
    "chamber": "house",
    "amount_range": "$1,001 - $15,000",
    "state_district": "VA01",
    "transaction_date": "2026-06-30",
    "notification_date": "2026-07-02"
   }
  ],
  "matched": 12,
  "coverage": {
   "years": [
    2025,
    2026
   ],
   "chambers": [
    "house"
   ]
  },
  "returned": 5,
  "attribution": "US House Clerk financial disclosures (public domain)"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/forgemesh-house-stock-trades-d8b65399/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402.forgemesh.io](https://www.zero.xyz/host/x402.forgemesh.io/llms.txt)