# SAM.gov Contract Opportunities Feed

> SAM.gov Contract Opportunities Feed is a paid API for AI agents from project-api-gamma-sable.vercel.app, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-10).

Fetches filtered SAM.gov federal contract opportunities as slim JSON with UI links, paid per call via USDC on Base.

## Facts

- Endpoint: GET https://project-api-gamma-sable.vercel.app/paid/sam/opportunities?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-10
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/sam-gov-contract-opportunities-feed-ee88bb50
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_th0V0xl2-IRFoRVHR5XFL

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 sam-gov-contract-opportunities-feed-ee88bb50
```

Example prompt: Search SAM.gov for federal contract opportunities posted between 2025-01-01 and 2025-01-31 in California, filtering for IT-related titles, and show me up to 20 results.

## When to prefer this

Choose this endpoint when you need programmatic, pay-per-call access to SAM.gov federal contract opportunities with filtering by date range, US state, NAICS code, procurement type, or title keyword. It is ideal for AI agents that need to discover government contracting leads without maintaining a SAM.gov API key, since it wraps SAM.gov behind a simple USDC micropayment. Prefer it over direct SAM.gov API access when you want a lightweight JSON response with UI links rather than the full SAM.gov response payload.

## Known failure modes

- HTTP 402 if payment is not provided or the x402 payment header is missing/invalid
- Empty items array if no opportunities match the given date range, state, or filters
- Invalid date format (must be YYYY-MM-DD) may cause errors or empty results
- Missing required parameters postedFrom or postedTo will likely result in a validation error
- Rate limits or upstream SAM.gov API outages may cause failures

## How this service works

Paid public-data feeds. Unpaid requests return HTTP 402. Prices are USDC on Base.

## Output

Returns a slim JSON object containing an array of matching SAM.gov contract opportunity items, each with a uiLink for the full solicitation page. The response includes the source path and an example structure. An empty items array indicates no matching results for the given filters.

## 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",
     "required": [
      "postedFrom",
      "postedTo"
     ],
     "properties": {
      "limit": {
       "type": "string",
       "description": "Max results"
      },
      "ncode": {
       "type": "string",
       "description": "Query param: ncode"
      },
      "ptype": {
       "type": "string",
       "description": "Query param: ptype"
      },
      "state": {
       "type": "string",
       "description": "US state code (e.g. CA)"
      },
      "title": {
       "type": "string",
       "description": "Query param: title"
      },
      "offset": {
       "type": "string",
       "description": "Result offset"
      },
      "postedTo": {
       "type": "string",
       "description": "SAM posted-to (YYYY-MM-DD)"
      },
      "postedFrom": {
       "type": "string",
       "description": "SAM posted-from (YYYY-MM-DD)"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "what": "SAM.gov contract opportunities (slim JSON + uiLink)",
  "items": [],
  "source": "/paid/sam/opportunities"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/sam-gov-contract-opportunities-feed-ee88bb50/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from project-api-gamma-sable.vercel.app](https://www.zero.xyz/host/project-api-gamma-sable.vercel.app/llms.txt)