USAspending
api.usaspending.gov
The official U.S. government record of federal spending: every contract, grant, loan and direct payment, with the agencies, accounts and recipients behind them.
GET /v1/data/usaspending/agency-award-category-obligations1Request
Three- or four-character CGAC/FREC toptier agency code, from the toptier agency list.
U.S. federal fiscal year (October to September). Data starts at FY2017.
curl "https://api.fastcrw.com/v1/data/usaspending/agency-award-category-obligations?toptier_code=012&fiscal_year=2025" \ -H "Authorization: Bearer $FASTCRW_API_KEY"
2Response example
A sample shape. Press Run to see live data from USAspending.
| category | aggregated_amount |
|---|---|
| contracts | 9571454726.69 |
| direct_payments | 111779014211.77 |
| grants | 58156870932.63 |
| idvs | 66954046.82 |
| loans | 2314118585.47 |
| other | 4643029660.09 |
Attribution: Source: USAspending.gov, U.S. Department of the Treasury (public domain, CC0 1.0).
Licence: The USAspending API's own licence statement (CONTRIBUTING.md, repository fedspendingtransparency/usaspending-api): "Note: this codebase supports a Federal US Government website. This project is in the public domain within the United States, and copyright and related rights in the work worldwide are waived through the CC0 1.0 Universal public domain dedication." The repository LICENSE file is the full CC0 1.0 Universal text, whose Statement of Purpose says the work may be reused "as freely as possible in any form whatsoever and for any purposes, including without limitation commercial purposes." The data served is a work of the U.S. federal government.
Ask with this source
A prompt for your agent that names this source and how to call it through the crw MCP.
Agency obligations by award category
Use USAspending (usaspending) from fastCRW Pergamon, capability "Agency obligations by award category" (agency-award-category-obligations). You want to see what mix of instruments an agency spends through in a given year. Example options: toptier_code=012, fiscal_year=2025. Use the crw MCP tools: crw_find_data to confirm the source and its options, then crw_get_data with provider "usaspending" and capability "agency-award-category-obligations". Tell me the credits used and cite the licence from the response. If the crw MCP tools are missing, install them with: npx -y crw-mcp install --api-key <your fastCRW API key>
Award counts for all agencies
Use USAspending (usaspending) from fastCRW Pergamon, capability "Award counts for all agencies" (agency-award-counts). You want a one-shot comparison of award volume across all federal agencies. Example options: fiscal_year=2025, group=all. Use the crw MCP tools: crw_find_data to confirm the source and its options, then crw_get_data with provider "usaspending" and capability "agency-award-counts". Tell me the credits used and cite the licence from the response. If the crw MCP tools are missing, install them with: npx -y crw-mcp install --api-key <your fastCRW API key>
Agency award totals
Use USAspending (usaspending) from fastCRW Pergamon, capability "Agency award totals" (agency-awards). You want one agency's award-spending headline numbers for a year without pulling the awards themselves. Example options: toptier_code=012, fiscal_year=2025, agency_type=awarding. Use the crw MCP tools: crw_find_data to confirm the source and its options, then crw_get_data with provider "usaspending" and capability "agency-awards". Tell me the credits used and cite the licence from the response. If the crw MCP tools are missing, install them with: npx -y crw-mcp install --api-key <your fastCRW API key>
Agency budgetary resources by year
Use USAspending (usaspending) from fastCRW Pergamon, capability "Agency budgetary resources by year" (agency-budgetary-resources). You want an agency's multi-year budget and burn-rate series rather than a single year's snapshot. Example options: toptier_code=012. Use the crw MCP tools: crw_find_data to confirm the source and its options, then crw_get_data with provider "usaspending" and capability "agency-budgetary-resources". Tell me the credits used and cite the licence from the response. If the crw MCP tools are missing, install them with: npx -y crw-mcp install --api-key <your fastCRW API key>
