# US Federal Contract Awards by Agency

> US Federal Contract Awards by Agency is a paid API for AI agents from api.companyrecords-api.workers.dev, paid per call via x402, $0.002/call, status unknown (last checked 2026-10-24).

Returns the largest US federal contract awards from USAspending.gov for a specified toptier awarding agency over a configurable lookback period (1–365 days)

## Facts

- Endpoint: GET https://api.companyrecords-api.workers.dev/api/gov/us-gov-contract-watch?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-24
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/us-federal-contract-awards-by-agency-12102ced
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_ldslT1HLsjx9eKiz4B84e

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 us-federal-contract-awards-by-agency-12102ced
```

Example prompt: Show me the 10 largest federal contracts awarded by the Department of Defense over the last 60 days — I need the recipient names, amounts, and award IDs.

## When to prefer this

Choose this endpoint when you need quick, structured lookups of the largest federal contract awards for a known toptier agency from USAspending.gov without building your own USAspending API integration. It is ideal for competitive intelligence, procurement monitoring, and compliance research where the agency name is known and you want top awards by dollar value rather than a full search.

## Known failure modes

- Agency name does not match USAspending's canonical toptier name — returns empty or error result
- Days parameter out of range (less than 1 or greater than 365) — may return error or default behavior
- Limit exceeds 10 — clamped or rejected
- No contracts found for the agency in the specified period — empty result set
- USAspending.gov upstream API unavailable — service error propagated

## How this service works

Pay-per-call company registry, government, legal and B2B data tools for AI agents, from official registers and public sources. Payment: x402, USDC on Base, Solana, Arc, Polygon, Arbitrum, Monad, World Chain, Optimism, Avalanche, Celo or Stellar, or RLUSD/XRP on the XRP Ledger. No signup, no API key; a failed call is not charged.

## Output

A list of up to 10 of the largest federal contract awards for the specified toptier agency within the lookback window, each including the award ID, recipient name, award amount in USD, and contract start date — sourced from USAspending.gov.

## 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": [
      "agency"
     ],
     "properties": {
      "days": {
       "type": "string",
       "description": "Look back 1 to 365 days (default 30)"
      },
      "limit": {
       "type": "string",
       "description": "Awards to return, 1 to 10 (default 5)"
      },
      "agency": {
       "type": "string",
       "description": "Toptier awarding agency name, e.g. Department of Defense"
      }
     }
    }
   },
   "additionalProperties": false
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/us-federal-contract-awards-by-agency-12102ced/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.companyrecords-api.workers.dev](https://www.zero.xyz/host/api.companyrecords-api.workers.dev/llms.txt)