# DopamineDesk Federal Contracts Lookup API

> DopamineDesk Federal Contracts Lookup API is a paid API for AI agents from ai-data-marketplace-1042299154756.us-central1.run.app, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-13).

Retrieves US federal government contract award records, filterable by agency and vendor name.

## Facts

- Endpoint: GET https://ai-data-marketplace-1042299154756.us-central1.run.app/api/v1/contracts
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/dopaminedesk-federal-contracts-lookup-api-70f637c0
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_EBqFzpCYd-fUlHZ9YOqO-

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 dopaminedesk-federal-contracts-lookup-api-70f637c0
```

Example prompt: Can you pull up the federal government contracts awarded to Space Exploration Technologies Corp from the USAF? I want to see the contract IDs, amounts, and what the contracts were for.

## When to prefer this

Choose this endpoint when you need structured, machine-readable federal contract award data filtered by agency or vendor, especially for due diligence, competitive intelligence, or procurement research workflows. It is well-suited for agents that need to programmatically retrieve USASpending-style records without scraping. Prefer this over generic web search when you need structured fields like contract IDs and dollar amounts rather than unstructured text.

## Known failure modes

- No results returned if vendor name or agency spelling doesn't match government records exactly
- Empty awards array if no contracts exist for the given filter combination
- Possible stale or incomplete data if underlying public dataset is not fully current
- x402 payment failure if USDC balance is insufficient or Base network is congested
- Rate limiting or service unavailability from the cloud run backend

## How this service works

Search 100 packaged federal government contract awards from USAspending.gov with a live source link for every award ID.

## Output

Returns a JSON object containing an 'awards' array where each element includes a contract_id, vendor name, agency, dollar amount (integer), award date, and a text description of the contract's scope — suitable for display, analysis, or further filtering.

## 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",
     "properties": {
      "agency": {
       "type": "string",
       "description": "Federal agency name."
      },
      "vendor_name": {
       "type": "string",
       "description": "Name of the winning vendor."
      }
     },
     "additionalProperties": true
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "required": [
      "success",
      "source",
      "source_verified_count",
      "count",
      "data",
      "marketplace_metadata"
     ],
     "properties": {
      "data": {
       "type": "array",
       "items": {
        "type": "object",
        "required": [
         "award_id",
         "recipient",
         "description",
         "agency",
         "source_url"
        ],
        "properties": {
         "agency": {
          "type": "string"
         },
         "award_id": {
          "type": "string"
         },
         "recipient": {
          "type": "string"
         },
         "source_url": {
          "type": "string"
         },
         "description": {
          "type": "string"
         }
        },
        "additionalProperties": true
       }
      },
      "count": {
       "type": "integer"
      },
      "source": {
       "type": "string"
      },
      "success": {
       "type": "boolean"
      },
      "marketplace_metadata": {
       "type": "object",
       "required": [
        "data_mode",
        "billable",
        "availability",
        "source"
       ],
       "properties": {
        "source": {
         "type": "string"
        },
        "billable": {
         "type": "boolean"
        },
        "data_mode": {
         "type": "string"
        },
        "availability": {
         "type": "string"
        }
       },
       "additionalProperties": true
      },
      "source_verified_count": {
       "type": "integer"
      }
     },
     "additionalProperties": true
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "data": [
   {
    "agency": "US Gov",
    "award_id": "CONT_AWD_HT940216C0001_9700_-NONE-_-NONE-",
    "recipient": "Unknown",
    "source_url": "https://api.usaspending.gov/api/v2/awards/CONT_AWD_HT940216C0001_9700_-NONE-_-NONE-/",
    "description": "IGF::OT::IGF"
   }
  ],
  "count": 100,
  "source": "USAspending.gov award records",
  "success": true,
  "marketplace_metadata": {
   "source": "USAspending.gov snapshot; all 100 award IDs API-verified on 2026-08-02",
   "billable": true,
   "data_mode": "curated_snapshot",
   "availability": "operational"
  },
  "source_verified_count": 100
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/dopaminedesk-federal-contracts-lookup-api-70f637c0/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from ai-data-marketplace-1042299154756.us-central1.run.app](https://www.zero.xyz/host/ai-data-marketplace-1042299154756.us-central1.run.app/llms.txt)