# US Government Contract & Grant Awards API

> US Government Contract & Grant Awards API is a paid API for AI agents from x402stock.xyz, paid per call via x402, $0.02/call, status unknown (last checked 2026-09-15).

Returns recent US federal government contract and grant awards from USAspending.gov, filterable by award type, amount, and time window.

## Facts

- Endpoint: GET https://x402stock.xyz/api/v1/gov-awards
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/us-government-contract-grant-awards-api-6ec05feb
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_103KNLHecPPOxClpbCz36

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-government-contract-grant-awards-api-6ec05feb
```

Example prompt: Pull the 20 largest US federal contracts awarded in the last 90 days from USAspending, sorted by amount, only include awards over $50 million.

## When to prefer this

Use this endpoint when you need structured, filterable federal government award data (contracts and/or grants) directly from the authoritative USAspending.gov source, especially when you want to sort by size or recency, filter by dollar threshold, or look up specific award recipients — without needing an API key or account setup.

## Known failure modes

- Invalid award_type enum value returns validation error
- days exceeding 365 or limit exceeding 50 returns schema validation error
- No awards matching filters returns empty awards array with count 0
- Payment not provided or insufficient USDC balance returns 402 Payment Required
- USAspending.gov upstream unavailability may cause 5xx errors

## How this service works

The latest large NEW federal awards across all recipients, from USAspending.gov — browse what the government is funding right now. Tune `?days=` lookback (max 365), `?award_type=contracts|grants|all`, `?min_amount=` floor, `?order=amount|date`, `?limit=` (max 50). Each award carries recipient, amount, awarding agency, dates, description, and a link. Uses new-award dating, not modifications.

## Output

A JSON object containing a list of up to 50 federal government award records sourced from USAspending.gov, each including the award ID, recipient name, dollar amount, awarding agency and sub-agency, start/end dates, a plain-English description of the award, and a direct USAspending.gov URL. Also includes metadata like total count, the lookback window, and attribution.

## Example request

```json
{
 "input": {
  "type": "http",
  "method": "GET",
  "queryParams": {
   "days": 30,
   "limit": 10,
   "order": "amount",
   "award_type": "contracts"
  }
 }
}
```

## 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",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "$schema": "https://json-schema.org/draft/2020-12/schema",
     "required": [
      "award_type",
      "days",
      "limit",
      "order"
     ],
     "properties": {
      "days": {
       "type": "integer",
       "default": 90,
       "maximum": 365,
       "exclusiveMinimum": 0
      },
      "limit": {
       "type": "integer",
       "default": 20,
       "maximum": 50,
       "exclusiveMinimum": 0
      },
      "order": {
       "enum": [
        "amount",
        "date"
       ],
       "type": "string",
       "default": "amount"
      },
      "award_type": {
       "enum": [
        "contracts",
        "grants",
        "all"
       ],
       "type": "string",
       "default": "contracts"
      },
      "min_amount": {
       "type": "number",
       "minimum": 0
      }
     },
     "additionalProperties": false
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "$schema": "https://json-schema.org/draft/2020-12/schema",
     "required": [
      "source",
      "as_of",
      "award_type",
      "window_days",
      "since",
      "min_amount",
      "count",
      "awards",
      "attribution"
     ],
     "properties": {
      "as_of": {
       "type": "string"
      },
      "count": {
       "type": "number"
      },
      "since": {
       "type": "string"
      },
      "awards": {
       "type": "array",
       "items": {
        "type": "object",
        "required": [
         "award_id",
         "recipient",
         "amount",
         "awarding_agency",
         "awarding_sub_agency",
         "start_date",
         "end_date",
         "description",
         "url"
        ],
        "properties": {
         "url": {
          "anyOf": [
           {
            "type": "string"
           },
           {
            "type": "null"
           }
          ]
         },
         "amount": {
          "anyOf": [
   
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "as_of": "2026-06-05T12:00:00.000Z",
  "count": 1,
  "since": "2026-03-07",
  "awards": [
   {
    "url": "https://www.usaspending.gov/award/CONT_AWD_70Z02326DBORDR001_7012_-NONE-_-NONE-",
    "amount": 2594040000,
    "award_id": "70Z02326DBORDR001",
    "end_date": "2030-06-02",
    "recipient": "FISHER SAND & GRAVEL CO",
    "start_date": "2026-06-03",
    "description": "BORDER WALL CONSTRUCTION",
    "awarding_agency": "Department of Homeland Security",
    "awarding_sub_agency": "U.S. Customs and Border Protection"
   }
  ],
  "source": "usaspending",
  "award_type": "contracts",
  "min_amount": 100000000,
  "attribution": "Source: USAspending.gov (U.S. Department of the Treasury, Bureau of the Fiscal Service)",
  "window_days": 90
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/us-government-contract-grant-awards-api-6ec05feb/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402stock.xyz](https://www.zero.xyz/host/x402stock.xyz/llms.txt)