# USAspending Federal Buyer Award History

> USAspending Federal Buyer Award History is a paid API for AI agents from x402-domain-check.vercel.app, paid per call via x402, $0.05/call, status unknown (last checked 2026-11-13).

Returns prior contract and grant awards for a US federal agency buyer, showing top recipients, award sizes, periods, and USAspending.gov links, optionally filtered by sub-agency, keywords, and NAICS codes.

## Facts

- Endpoint: GET https://x402-domain-check.vercel.app/buyers/award-history?utm_source=zero.xyz
- Price: $0.05/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/usaspending-federal-buyer-award-history-9d6a3f30
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_p0e2sSaCgo1xBPiqbT6dh

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 usaspending-federal-buyer-award-history-9d6a3f30
```

Example prompt: Who are the top 10 recipients of IT contracts from the Department of Education over the last 3 years? Filter to NAICS code 541512 and show me the award sizes and USAspending links.

## When to prefer this

Choose this endpoint when you need procurement intelligence about which vendors, contractors, or grantees win business from a specific US federal agency. It is best suited for competitive intelligence, bid/no-bid decisions, market sizing, and identifying key players in a federal buying category. Prefer this over general web search when you need structured, queryable data with dollar amounts and award counts directly from USAspending.gov.

## Known failure modes

- Unknown or unrecognized agency name returns no charge and an error response
- Invalid NAICS code format may return empty results
- Years parameter outside 1-5 range is rejected by schema validation
- No awards found for the combination of filters returns an empty result set
- Rate limiting or upstream USAspending.gov unavailability may cause timeouts

## How this service works

Procurement intelligence: prior awards and top recipients for a US federal buyer agency (e.g. Department of Education), optionally narrowed by sub-agency, keywords and NAICS, contracts and/or grants, over the last 1-5 years. Shows who wins this buyer's business, award sizes, periods and USAspending links. Data: USAspending.gov. Not charged on errors or unknown agency.

## Output

A ranked list of top award recipients for the specified federal agency, including recipient names, total award amounts, number of awards, award periods, award types (contract or grant), and direct USAspending.gov links for further research. Results are scoped by the requested filters (sub-agency, NAICS, keywords, years, award type).

## 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": {
      "type": {
       "enum": [
        "contracts",
        "grants",
        "all"
       ],
       "type": "string",
       "default": "all"
      },
      "limit": {
       "type": "integer",
       "default": 10,
       "maximum": 25,
       "minimum": 1
      },
      "naics": {
       "type": "string",
       "description": "Comma-separated NAICS codes (contracts only)"
      },
      "years": {
       "type": "integer",
       "default": 3,
       "maximum": 5,
       "minimum": 1
      },
      "agency": {
       "type": "string",
       "description": "Top-tier federal agency name or abbreviation (e.g. ED, Department of Education)"
      },
      "keywords": {
       "type": "string",
       "description": "Comma-separated keywords"
      },
      "sub_agency": {
       "type": "string",
       "description": "Optional sub-tier agency name"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/usaspending-federal-buyer-award-history-9d6a3f30/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402-domain-check.vercel.app](https://www.zero.xyz/host/x402-domain-check.vercel.app/llms.txt)
