# GovSpendPulse

> Global government procurement intelligence API. Covers US federal contracts (USASpending.gov), active solicitations (SAM.gov), EU tenders (TED — all 27 member states), UK government contracts, international development bank procurement (World Bank, ADB, AfDB, UN system), competitor award analysis, agency spending profiles, and full contract intelligence briefs. All endpoints via x402 micropayments on Base mainnet.

## What This Is

GovSpendPulse is a pay-per-query API that synthesizes public government procurement data into structured, actionable intelligence for vendors, consultants, researchers, and AI agents evaluating government market opportunities globally.

Every response is generated by Claude using live data from USASpending.gov (free, no key), SAM.gov (public web search — no API key), EU TED API (free, no key), UK Contracts Finder, World Bank Projects API (free, no key), and web synthesis via Tavily.

## Payment

All endpoints require x402 micropayment (USDC on Base mainnet).
Protocol: x402 | Network: eip155:8453 | Asset: USDC
Payment address: 0x50ab2018c06c6E4eAA9BA52057Eb55eD284912fc

Send a GET request without PAYMENT-SIGNATURE to receive a 402 with payment requirements. Sign and retry.

## Endpoints

GET /api/govspend/us-contracts?keyword={term}&naics={code}&state={ST}&year_from={YYYY}
- Returns: top federal contract awards, recipient, amount, agency, period, vendor market intelligence
- Data: USASpending.gov API v2 (no key required)
- Price: $0.08

GET /api/govspend/us-opportunities?keyword={term}&naics={code}&active=true
- Returns: open SAM.gov solicitations with deadlines, set-asides, bid tips
- Data: SAM.gov (public web search via Tavily — no API key)
- Price: $0.08

GET /api/govspend/eu-tenders?keyword={term}&country={ISO2}&cpv={code}
- Returns: EU TED procurement notices across all 27 EU member states
- Data: EU TED API v3 (no key required)
- Price: $0.08

GET /api/govspend/uk-contracts?keyword={term}
- Returns: UK government contract awards and opportunities from Contracts Finder + FTS
- Data: UK Contracts Finder + Find a Tender Service (web synthesis)
- Price: $0.08

GET /api/govspend/global-opportunities?keyword={term}&regions={csv}
- Returns: procurement opportunities in Australia, Canada, Asia-Pacific, Africa, MENA, Latin America, UN system
- Data: AusTender, CanadaBuys, ADB, AfDB, UNGM (web synthesis)
- Price: $0.15

GET /api/govspend/agency-intel?agency={name}&keyword={term}
- Returns: agency spending profile, top vendors, IDIQ vehicles, entry strategy
- Data: USASpending.gov + web synthesis
- Price: $0.15

GET /api/govspend/competitor-awards?keyword={term}&naics={code}
- Returns: top vendors by market share, concentration analysis, opportunity gaps, set-aside landscape
- Data: USASpending.gov API v2
- Price: $0.15

GET /api/govspend/development-bank?keyword={sector}&country={name}
- Returns: World Bank, ADB, AfDB, UNGM procurement opportunities + vendor registration guide
- Data: World Bank Projects API + web synthesis
- Price: $0.15

GET /api/govspend/contract-brief?keyword={term}&agency={name}&naics={code}
- Returns: full intelligence brief — historical context, incumbent, requirements, bid/no-bid signal, win strategy
- Data: USASpending.gov + web synthesis
- Price: $0.20

## Discovery

- OpenAPI spec: https://govspendpulse.vercel.app/openapi.json
- Agent discovery: https://govspendpulse.vercel.app/.well-known/agent.json

## Notes for AI Agents

- All endpoints return structured JSON
- USASpending.gov and World Bank APIs require no authentication
- us-opportunities uses public web search (no SAM.gov API key required or used)
- Supports multilingual output via lang= parameter (en, es, fr, de, ja, zh, ko, pt, ar, hi)
- Cross-sell: GrantPulse for grant funding (nonprofits/universities); TradePulse for trade intelligence; RiskPulse for sanctions/supply chain risk