{
  "openapi": "3.1.0",
  "info": {
    "title": "GovSpendPulse API",
    "description": "Global government procurement intelligence API. 9 endpoints covering US federal contracts (USASpending.gov), active solicitations (SAM.gov), EU tenders (TED), UK contracts, global development bank opportunities (World Bank/ADB/AfDB/UNGM), agency spending profiles, competitor award analysis, and full contract intelligence briefs. All endpoints require x402 payment (USDC on Base mainnet) via the PAYMENT-SIGNATURE header.",
    "version": "1.0.0",
    "contact": {
      "name": "The Aslan Group LLC",
      "url": "https://pulsenetwork.theaslangroupllc.com",
      "email": "info@theaslangroupllc.com"
    },
    "x-guidance": "# GovSpendPulse API (x402 pay-per-call)\n\nGlobal government procurement intelligence API. Tracks $5+ trillion in annual government spending across US federal contracts (USASpending.gov), EU tenders (TED — all 27 member states), UK government contracts, international development banks (World Bank, ADB, AfDB), and UN system procurement. 9 endpoints covering vendor competitive intelligence, agency profiles, active solicitations, and full contract briefs. Payments via x402 USDC micropayments on Base.\n\nBase URL: https://govspendpulse.theaslangroupllc.com\n\n## Payment\nAll paid endpoints use the x402 protocol (HTTP 402): USDC on Base mainnet (eip155:8453). No API keys, no accounts, no subscriptions — pay per call.\n\n## Agent workflow\n1. Request the endpoint. Unpaid requests receive a 402 challenge with exact price and pay-to details (the challenge is returned before request validation).\n2. Settle with any x402 client (agentcash fetch, x402-fetch, x402-axios) and retry with the X-PAYMENT header.\n3. Responses are JSON. Prices below are fixed per call.\n\n## Paid endpoints\n- GET /api/govspend/us-contracts — $0.08 — US federal contract awards — search USASpending.gov API v2 for top awards by amount with recipient, agency, NAICS, period, and vendor market intelligence.\n- GET /api/govspend/us-opportunities — $0.08 — US active solicitations (SAM.gov) — open federal contract opportunities with deadlines, set-aside types, NAICS codes, and bid guidance.\n- GET /api/govspend/eu-tenders — $0.08 — EU procurement tenders (TED) — contract notices across all 27 EU member states with value, authority, CPV category, and deadline.\n- GET /api/govspend/uk-contracts — $0.08 — UK government contracts — awards and opportunities from Contracts Finder and Find a Tender Service with department, value, sector, and market snapshot.\n- GET /api/govspend/global-opportunities — $0.15 — Global procurement opportunities — Australia (AusTender), Canada (CanadaBuys), Asia-Pacific (ADB), Africa (AfDB), MENA, Latin America, and UN system (UNGM).\n- GET /api/govspend/agency-intel — $0.15 — US agency spending intelligence — deep spending profile for any federal agency: top vendors, NAICS codes, procurement vehicles, IDIQ/GWAC contracts, entry strat\n- GET /api/govspend/competitor-awards — $0.15 — Competitor federal award analysis — top vendors by total awards, market concentration analysis, opportunity gaps, and set-aside landscape.\n- GET /api/govspend/development-bank — $0.15 — Development bank procurement — World Bank, ADB, AfDB, and UN system (UNGM) opportunities with vendor registration guide for each institution.\n- GET /api/govspend/contract-brief — $0.2 — Full contract intelligence brief — historical awards, incumbent analysis, requirements intelligence, competitive landscape, and bid/no-bid recommendation with w\n\nMore APIs from this provider: https://pulsenetwork.theaslangroupllc.com (grouped catalog, all x402)."
  },
  "servers": [
    {
      "url": "https://govspendpulse.theaslangroupllc.com"
    }
  ],
  "paths": {
    "/api/govspend/us-contracts": {
      "get": {
        "summary": "US federal contract awards",
        "description": "Search US federal contract awards via USASpending.gov API v2. Returns top awards by amount with recipient, agency, NAICS, period, and vendor market intelligence. No API key required.",
        "operationId": "usContracts",
        "parameters": [
          {
            "name": "keyword",
            "in": "query",
            "description": "Search term — e.g. cybersecurity, cloud computing, management consulting",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "naics",
            "in": "query",
            "description": "NAICS code — e.g. 541512 (computer systems design)",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "state",
            "in": "query",
            "description": "Two-letter US state code — e.g. VA, CA, TX",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "year_from",
            "in": "query",
            "description": "Fiscal year start — e.g. 2024, 2025",
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "description": "Number of results (5, 10, or 20)",
            "schema": {
              "type": "integer",
              "default": 10
            }
          },
          {
            "name": "lang",
            "in": "query",
            "description": "Response language",
            "schema": {
              "type": "string",
              "default": "en"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Contract award intelligence"
          },
          "402": {
            "description": "Payment required — x402 USDC on Base"
          }
        },
        "x-bazaar": {
          "price_usd": 0.08,
          "model": "claude-haiku-4-5-20251001",
          "data_sources": [
            "USASpending.gov API v2"
          ],
          "tags": [
            "us-contracts",
            "federal-procurement",
            "usaspending",
            "naics",
            "vendor-intelligence"
          ]
        },
        "x-price-usd": 0.08,
        "x-payment-info": {
          "price": {
            "mode": "fixed",
            "currency": "USD",
            "amount": "0.080000"
          },
          "protocols": [
            {
              "x402": {}
            }
          ]
        }
      }
    },
    "/api/govspend/us-opportunities": {
      "get": {
        "summary": "US active solicitations (SAM.gov)",
        "description": "Search active US federal contract opportunities from SAM.gov. Returns open solicitations with deadlines, set-aside types, NAICS codes, and bid guidance. Uses public web search — no API key required.",
        "operationId": "usOpportunities",
        "parameters": [
          {
            "name": "keyword",
            "in": "query",
            "description": "Search term — e.g. software development, janitorial, IT support",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "naics",
            "in": "query",
            "description": "NAICS code filter",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "active",
            "in": "query",
            "description": "Only return open solicitations",
            "schema": {
              "type": "boolean",
              "default": true
            }
          },
          {
            "name": "limit",
            "in": "query",
            "description": "Number of results",
            "schema": {
              "type": "integer",
              "default": 10
            }
          },
          {
            "name": "lang",
            "in": "query",
            "schema": {
              "type": "string",
              "default": "en"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Active solicitation intelligence"
          },
          "402": {
            "description": "Payment required"
          }
        },
        "x-bazaar": {
          "price_usd": 0.08,
          "model": "claude-haiku-4-5-20251001",
          "data_sources": [
            "SAM.gov (public web search)"
          ],
          "tags": [
            "sam-gov",
            "solicitations",
            "rfp",
            "set-aside",
            "small-business",
            "active-bids"
          ]
        },
        "x-price-usd": 0.08,
        "x-payment-info": {
          "price": {
            "mode": "fixed",
            "currency": "USD",
            "amount": "0.080000"
          },
          "protocols": [
            {
              "x402": {}
            }
          ]
        }
      }
    },
    "/api/govspend/eu-tenders": {
      "get": {
        "summary": "EU procurement tenders (TED)",
        "description": "Search EU procurement notices from TED (Tenders Electronic Daily) covering all 27 EU member states. Returns contract notices with value, authority, CPV category, and deadline. No API key required.",
        "operationId": "euTenders",
        "parameters": [
          {
            "name": "keyword",
            "in": "query",
            "description": "Search term — e.g. artificial intelligence, renewable energy, cybersecurity",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "country",
            "in": "query",
            "description": "ISO 2-letter country code — e.g. DE, FR, PL, NL (blank = all EU)",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "cpv",
            "in": "query",
            "description": "CPV procurement code — e.g. 72000000 (IT services)",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "schema": {
              "type": "integer",
              "default": 10
            }
          },
          {
            "name": "lang",
            "in": "query",
            "schema": {
              "type": "string",
              "default": "en"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "EU tender intelligence"
          },
          "402": {
            "description": "Payment required"
          }
        },
        "x-bazaar": {
          "price_usd": 0.08,
          "model": "claude-haiku-4-5-20251001",
          "data_sources": [
            "EU TED API v3"
          ],
          "tags": [
            "eu-tenders",
            "ted-europa",
            "european-procurement",
            "cpv",
            "b2g-europe"
          ]
        },
        "x-price-usd": 0.08,
        "x-payment-info": {
          "price": {
            "mode": "fixed",
            "currency": "USD",
            "amount": "0.080000"
          },
          "protocols": [
            {
              "x402": {}
            }
          ]
        }
      }
    },
    "/api/govspend/uk-contracts": {
      "get": {
        "summary": "UK government contracts",
        "description": "Search UK government procurement from Contracts Finder and Find a Tender Service. Returns UK public sector contract awards with department, value, sector, and market snapshot.",
        "operationId": "ukContracts",
        "parameters": [
          {
            "name": "keyword",
            "in": "query",
            "description": "Search term — e.g. digital transformation, facilities management, cyber",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "lang",
            "in": "query",
            "schema": {
              "type": "string",
              "default": "en"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "UK procurement intelligence"
          },
          "402": {
            "description": "Payment required"
          }
        },
        "x-bazaar": {
          "price_usd": 0.08,
          "model": "claude-haiku-4-5-20251001",
          "data_sources": [
            "UK Contracts Finder",
            "Find a Tender Service"
          ],
          "tags": [
            "uk-contracts",
            "contracts-finder",
            "nhs",
            "crown-commercial",
            "b2g-uk"
          ]
        },
        "x-price-usd": 0.08,
        "x-payment-info": {
          "price": {
            "mode": "fixed",
            "currency": "USD",
            "amount": "0.080000"
          },
          "protocols": [
            {
              "x402": {}
            }
          ]
        }
      }
    },
    "/api/govspend/global-opportunities": {
      "get": {
        "summary": "Global procurement opportunities",
        "description": "Government procurement intelligence beyond US/EU/UK: Australia (AusTender), Canada (CanadaBuys), Asia-Pacific (ADB), Africa (AfDB), MENA, Latin America, and UN system (UNGM). Multi-source synthesis.",
        "operationId": "globalOpportunities",
        "parameters": [
          {
            "name": "keyword",
            "in": "query",
            "description": "Sector or service — e.g. water infrastructure, health IT, renewable energy",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "regions",
            "in": "query",
            "description": "Comma-separated regions: australia, canada, asia, africa, latam, mena, un",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "lang",
            "in": "query",
            "schema": {
              "type": "string",
              "default": "en"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Global procurement intelligence"
          },
          "402": {
            "description": "Payment required"
          }
        },
        "x-bazaar": {
          "price_usd": 0.15,
          "model": "claude-sonnet-4-6",
          "data_sources": [
            "AusTender",
            "CanadaBuys",
            "ADB",
            "AfDB",
            "UNGM"
          ],
          "tags": [
            "global-procurement",
            "austender",
            "adb",
            "afdb",
            "ungm",
            "multilateral",
            "b2g-global"
          ]
        },
        "x-price-usd": 0.15,
        "x-payment-info": {
          "price": {
            "mode": "fixed",
            "currency": "USD",
            "amount": "0.150000"
          },
          "protocols": [
            {
              "x402": {}
            }
          ]
        }
      }
    },
    "/api/govspend/agency-intel": {
      "get": {
        "summary": "US agency spending intelligence",
        "description": "Deep spending profile for any US federal agency. Returns top vendors, NAICS codes, procurement vehicles, IDIQ/GWAC contracts, entry strategy, and budget priorities.",
        "operationId": "agencyIntel",
        "parameters": [
          {
            "name": "agency",
            "in": "query",
            "required": true,
            "description": "Agency name or abbreviation — e.g. DHS, VA, HHS, DoD, NASA, GSA",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "keyword",
            "in": "query",
            "description": "Optional focus area — e.g. cybersecurity, cloud, healthcare IT",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "lang",
            "in": "query",
            "schema": {
              "type": "string",
              "default": "en"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Agency intelligence brief"
          },
          "402": {
            "description": "Payment required"
          }
        },
        "x-bazaar": {
          "price_usd": 0.15,
          "model": "claude-sonnet-4-6",
          "data_sources": [
            "USASpending.gov",
            "web synthesis"
          ],
          "tags": [
            "agency-intel",
            "federal-agency",
            "idiq",
            "gwac",
            "procurement-strategy",
            "b2g-strategy"
          ]
        },
        "x-price-usd": 0.15,
        "x-payment-info": {
          "price": {
            "mode": "fixed",
            "currency": "USD",
            "amount": "0.150000"
          },
          "protocols": [
            {
              "x402": {}
            }
          ]
        }
      }
    },
    "/api/govspend/competitor-awards": {
      "get": {
        "summary": "Competitor federal award analysis",
        "description": "Who is winning federal contracts in your market space. Returns top vendors by total awards, market concentration analysis, opportunity gaps, and set-aside landscape. Replaces a $5,000 market intelligence report.",
        "operationId": "competitorAwards",
        "parameters": [
          {
            "name": "keyword",
            "in": "query",
            "required": true,
            "description": "Market keyword — e.g. cybersecurity, cloud computing, logistics",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "naics",
            "in": "query",
            "description": "NAICS code to narrow results",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "lang",
            "in": "query",
            "schema": {
              "type": "string",
              "default": "en"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Competitive landscape intelligence"
          },
          "402": {
            "description": "Payment required"
          }
        },
        "x-bazaar": {
          "price_usd": 0.15,
          "model": "claude-sonnet-4-6",
          "data_sources": [
            "USASpending.gov API v2"
          ],
          "tags": [
            "competitor-intelligence",
            "market-share",
            "federal-awards",
            "incumbent-analysis",
            "b2g-competitive"
          ]
        },
        "x-price-usd": 0.15,
        "x-payment-info": {
          "price": {
            "mode": "fixed",
            "currency": "USD",
            "amount": "0.150000"
          },
          "protocols": [
            {
              "x402": {}
            }
          ]
        }
      }
    },
    "/api/govspend/development-bank": {
      "get": {
        "summary": "Development bank procurement",
        "description": "International development bank procurement opportunities: World Bank, ADB, AfDB, and UN system (UNGM). Includes vendor registration guide for each institution. Covers $200B+ in annual multilateral procurement.",
        "operationId": "developmentBank",
        "parameters": [
          {
            "name": "keyword",
            "in": "query",
            "description": "Sector or service — e.g. health systems, road construction, education technology",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "country",
            "in": "query",
            "description": "Borrower country — e.g. Nigeria, Bangladesh, Indonesia",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "lang",
            "in": "query",
            "schema": {
              "type": "string",
              "default": "en"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Development bank procurement intelligence"
          },
          "402": {
            "description": "Payment required"
          }
        },
        "x-bazaar": {
          "price_usd": 0.15,
          "model": "claude-sonnet-4-6",
          "data_sources": [
            "World Bank Projects API",
            "ADB",
            "AfDB",
            "UNGM"
          ],
          "tags": [
            "world-bank",
            "adb",
            "afdb",
            "ungm",
            "multilateral-procurement",
            "international-development"
          ]
        },
        "x-price-usd": 0.15,
        "x-payment-info": {
          "price": {
            "mode": "fixed",
            "currency": "USD",
            "amount": "0.150000"
          },
          "protocols": [
            {
              "x402": {}
            }
          ]
        }
      }
    },
    "/api/govspend/contract-brief": {
      "get": {
        "summary": "Full contract intelligence brief",
        "description": "Comprehensive intelligence brief on any specific federal contract opportunity. Covers historical awards, incumbent analysis, requirements intelligence, competitive landscape, and bid/no-bid recommendation with win strategy. Replaces a $10,000 BD consulting engagement.",
        "operationId": "contractBrief",
        "parameters": [
          {
            "name": "keyword",
            "in": "query",
            "required": true,
            "description": "Contract title, topic, or solicitation number — e.g. 'DHS zero trust SOC' or 'N0017824R0012'",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "agency",
            "in": "query",
            "description": "Agency to narrow search — e.g. DHS, Air Force, VA",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "naics",
            "in": "query",
            "description": "NAICS code",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "lang",
            "in": "query",
            "schema": {
              "type": "string",
              "default": "en"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Contract intelligence brief"
          },
          "402": {
            "description": "Payment required"
          }
        },
        "x-bazaar": {
          "price_usd": 0.2,
          "model": "claude-sonnet-4-6",
          "data_sources": [
            "USASpending.gov",
            "SAM.gov",
            "web synthesis"
          ],
          "tags": [
            "contract-brief",
            "bid-intelligence",
            "capture-management",
            "bid-no-bid",
            "win-strategy",
            "incumbent-analysis"
          ]
        },
        "x-price-usd": 0.2,
        "x-payment-info": {
          "price": {
            "mode": "fixed",
            "currency": "USD",
            "amount": "0.200000"
          },
          "protocols": [
            {
              "x402": {}
            }
          ]
        }
      }
    },
    "/openapi.json": {
      "get": {
        "summary": "OpenAPI specification",
        "description": "Returns this OpenAPI specification. Free endpoint — no payment required.",
        "operationId": "getOpenApiSpec",
        "responses": {
          "200": {
            "description": "OpenAPI JSON spec"
          }
        }
      }
    }
  }
}