Skip to main content
GET
/
v1
/
stock
/
usa-spending
Get USA Spending
curl --request GET \
  --url https://api.aries.com/v1/stock/usa-spending \
  --header 'Authorization: Bearer <token>'
{
  "symbol": "AAPL",
  "data": [
    {
      "symbol": "AAPL",
      "recipientName": "APPLE INC.",
      "recipientParentName": "APPLE INC.",
      "awardDescription": "MACBOOK PRO",
      "country": "USA",
      "actionDate": "2021-11-12",
      "totalValue": 4238,
      "performanceStartDate": "2021-11-12",
      "performanceEndDate": "2021-12-10",
      "awardingAgencyName": "SMITHSONIAN INSTITUTION (SI)",
      "awardingSubAgencyName": "SMITHSONIAN INSTITUTION",
      "awardingOfficeName": "SMITHSONIAN ASTROPHYSICAL OBSERVATORY",
      "performanceCountry": "USA",
      "performanceCity": "CUPERTINO",
      "performanceCounty": "SANTA CLARA",
      "performanceState": "CALIFORNIA",
      "performanceZipCode": "950140642",
      "performanceCongressionalDistrict": "17",
      "naicsCode": "334111",
      "permalink": "https://www.usaspending.gov/award/CONT_AWD_33131222P00465925_3300_-NONE-_-NONE-/"
    }
  ]
}

​
Query parameters

ParameterTypeRequiredDescription
symbolstringYesStock ticker symbol (e.g. LMT, BA).
fromstringYesFrom date YYYY-MM-DD (filter actionDate).
tostringYesTo date YYYY-MM-DD (filter actionDate).

​
Response

Success returns 200 OK with a JSON object containing a data array of spending records (e.g. symbol, recipientName, totalValue, actionDate, awardingAgencyName, awardDescription, permalink), and symbol. Errors: 400 when symbol or dates are missing, 401 unauthorized, 404 when no data found, 500 server error.

Authorizations

​
Authorization
string
header
required

OAuth2 Bearer token: obtain an access token from the token endpoint and send it in the Authorization header.

Query Parameters

​
symbol
string
required

Stock ticker to query. Send the plain uppercase symbol exactly as you'd type it on a brokerage screen, e.g. AAPL, MSFT.

Example:

"AAPL"

​
from
string<date>
required

Start of the date window, inclusive. Format: YYYY-MM-DD (e.g. 2024-01-01).

Example:

"2024-01-01"

​
to
string<date>
required

End of the date window, inclusive. Format: YYYY-MM-DD (e.g. 2024-12-31).

Example:

"2024-12-31"

Response

USA spending data.

​
data
object[]
​
symbol
string