# OneShot Agent – Government Solicitations Search

> OneShot Agent – Government Solicitations Search is a paid API for AI agents from win.oneshotagent.com, paid per call via x402, $0.04/call, status unknown (last checked 2026-10-11).

Search and filter active government contract solicitations from SAM.gov by NAICS code, agency, keywords, set-aside type, and notice type

## Facts

- Endpoint: POST https://win.oneshotagent.com/v1/tools/gov/solicitations?utm_source=zero.xyz
- Price: $0.04/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-11
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/oneshot-agent-government-solicitations-search-ce52091f
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_NynYh0909ChDXM-XYqHsu

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 oneshot-agent-government-solicitations-search-ce52091f -d '<json body>'
```

Example prompt: Search for active government solicitations in the IT services space — NAICS code 541512 — from the Department of Defense, looking back 60 days, only Sources Sought and Presolicitation notices, limited to 50 results, and include the full description for each one.

## When to prefer this

Use this endpoint when an AI agent or business development workflow needs to programmatically discover and filter federal government contract opportunities from SAM.gov. Prefer it over manual SAM.gov searches when you need structured, filterable JSON output suitable for downstream scoring, CRM enrichment, or automated bid qualification. It is especially useful when combining multiple filters simultaneously (NAICS + agency + set-aside + keywords) that would require many manual searches otherwise.

## Known failure modes

- Invalid NAICS code format returns validation error
- Unsupported set-aside code returns 400 Bad Request
- since_days outside 1–365 range rejected
- limit outside 1–500 range rejected
- SAM.gov upstream unavailability causes delayed or failed result on polling
- Polling with wrong X-Agent-ID returns 403 or empty result
- x402 payment not completed causes 402 Payment Required on initial call

## How this service works

Tools, payments, and compute orchestration for autonomous AI agents.

## Authentication

- **`x402Payment`** — paid tool endpoints use the [x402 payment protocol](https://x402.io).
  First call returns `402 Payment Required` with a quote; sign and resend the request
  with `Authorization: <signed payment header>` and `X-Quote-ID: <quote_id>`.
- **`agentId`** — free read-only endpoints accept `X-Agent-ID: <wallet>` (0x… address).
- **`soulKey`** — soul marketplace seller dashboard uses `Authorization: Bearer soul_…`
  (issued by `POST /v1/soul/register`).
- **`acpBearer`** — Stripe ACP checkout sessions use a separate bearer token plus the
  `API-Version: 2026-01-30` header.

## Async tools & polling

Most tool endpoints return `202 Accepted` with `{ request_id, tool, status }`. Poll
`GET /v1/requests/{id}` (with the same `X-Agent-ID`) to retrieve the final result.
A WebSocket fallback is available at `wss://<host>/v1/requests/subscribe`.

## Pricing

See [docs.oneshotagent.com/pricing](https://docs.oneshotagent.com/pricing) for the full
table. Per-call costs for this environment, rendered from the same config the routes bill from:

| Tool | Cost |
|---|---|
| Web search | $0.001 |
| Web read | $0.002 |
| Research | $0.01 |
| Person enrichment | $0.005 |
| Email verification | $0.001 |
| Deep research (person) | $0.05 |
| Social profiles | $0.50 |
| Local business search | $0.01 |
| Commerce search | $0.002 |
| LinkedIn history sync | $0.02 per bounded run |
| LinkedIn reply | $0.02 per message |
| LinkedIn profile view | $0.01 per view |
| LinkedIn post reaction | $0.01 per reaction |
| Email send | quote-based; service fee from $0.005 per send |
| SMS send | $0.0035 per segment per recipient |
| Voice call | $0.35/minute + $5.00 number registration on the first call |
| Browser task | quote-based; minimum $0.005 |
| Website build | quote-based; from $1.00 |
| Compute goal | quote-based; minimum budget $1.00 + 20% platform fee |

## Error format

`{ "error": "<machine_code>", "message": "<human readable>", "details": <optional> }`.
Validation errors include a `details` field with the failing field paths.

## Output

Returns a 202 Accepted with a request_id immediately; poll GET /v1/requests/{id} for the final JSON array of matching solicitation notices, each including notice type, title, agency, posted date, response deadline, place of performance, set-aside type, point-of-contact details, and optionally the full description body.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "limit": {
   "type": "number",
   "description": "Max results (1-500, default 100)"
  },
  "naics": {
   "type": "array",
   "items": {
    "type": "string"
   },
   "description": "6-digit NAICS codes (1-20)"
  },
  "state": {
   "type": "string",
   "description": "Place-of-performance state code"
  },
  "agencies": {
   "type": "array",
   "items": {
    "type": "string"
   },
   "description": "Agency-name substrings to keep"
  },
  "keywords": {
   "type": "array",
   "items": {
    "type": "string"
   },
   "description": "Title / full-text keywords"
  },
  "set_aside": {
   "type": "string",
   "description": "Set-aside code (SBA, 8A, HZC, SDVOSBC, WOSB, ...)"
  },
  "since_days": {
   "type": "number",
   "description": "Look-back window for posted date (1-365, default 30)"
  },
  "active_only": {
   "type": "boolean",
   "description": "Default true: drop archived notices and past response deadlines"
  },
  "has_contact": {
   "type": "boolean",
   "description": "Only notices with a name + email point of contact"
  },
  "notice_types": {
   "type": "array",
   "items": {
    "enum": [
     "r",
     "p",
     "o",
     "k",
     "s",
     "a",
     "u",
     "i",
     "g"
    ],
    "type": "string"
   },
   "description": "SAM.gov notice types: r=Sources Sought, p=Presolicitation, o=Solicitation, k=Combined Synopsis, s=Special Notice, a=Award. Default [\"r\",\"p\"]"
  },
  "include_description": {
   "type": "boolean",
   "description": "Default true: fetch description bodies for the first rows"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "status": "processing",
  "request_id": "uuid"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/oneshot-agent-government-solicitations-search-ce52091f/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from win.oneshotagent.com](https://www.zero.xyz/host/win.oneshotagent.com/llms.txt)