API Acre · Research US Contract Search

import { wrapFetchWithPayment } from "@x402/fetch";
import { privateKeyToAccount } from "viem/accounts";

const account = privateKeyToAccount(process.env.PRIVATE_KEY);
const fetchWithPay = wrapFetchWithPayment(fetch, account);

const res = await fetchWithPay("https://apiacre.com/v1/research/us-contract-search", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({
    "end_date": "2026-08-13",
    "max_results": 5,
    "minimum_award_amount": 1000000,
    "recipient_query": "Palantir USG",
    "start_date": "2024-01-01"
  }),
});
const data = await res.json();

curl -X POST \
  "https://apiacre.com/v1/research/us-contract-search" \
  -H "Content-Type: application/json" \
  -d '{"end_date":"2026-08-13","max_results":5,"minimum_award_amount":1000000,"recipient_query":"Palantir USG","start_date":"2024-01-01"}' \
  -H "X-PAYMENT: <signed x402 payment>"

{
  "data": {
    "awards": [
      {
        "awardAmountUsd": 545578476.94,
        "awardId": "W9128Z26FA001",
        "internalId": 355423040,
        "recipientName": "PALANTIR USG INC",
        "recipientUei": "HNN4F9JZWDY8"
      }
    ],
    "awardsReturned": 5,
    "awardsSkipped": 0,
    "disclaimer": "Public federal procurement evidence for research only; verify the official aw...",
    "documentation": "https://github.com/fedspendingtransparency/usaspending-api/blob/master/usaspe...",
    "hasMore": true,
    "limitations": [
      "Recipient search is fuzzy across names, UEIs, and legacy DUNS values; a resul...",
      "Award Amount is USAspending's current aggregate award value, not necessarily ...",
      "Results are prime contracts only, sorted by aggregate award amount, limited t..."
    ],
    "query": {
      "endDate": "2026-08-13",
      "minimumAwardAmountUsd": 1000000,
      "recipientFieldsSearched": [
        "name",
        "UEI",
        "legacy DUNS"
      ],
      "recipientQuery": "Palantir USG",
      "startDate": "2024-01-01"
    },
    "resultsReceived": 5,
    "retrievedAt": "2026-08-13T07:00:00+00:00",
    "source": "https://api.usaspending.gov/api/v2/search/spending_by_award/",
    "sourceMessages": [
      "USAspending search dates are limited to records from 2007-10-01 onward."
    ]
  },
  "meta": {
    "cached": false,
    "duration_ms": 42,
    "next_actions": [
      {
        "method": "POST",
        "path": "/v1/research/lei-entity-search",
        "reason": "Resolve a selected contract recipient against official GLEIF legal-entity rec...",
        "service": "research.lei-entity-search",
        "title": "GLEIF legal entity search"
      }
    ],
    "sources": [],
    "warnings": []
  },
  "request_id": "018f1f54-7f38-7ba2-8dc3-5f90272d9f1a",
  "service": "research.us-contract-search",
  "version": "1"
}