Skip to main content
GET
/
v1
/
stock
/
usa-spending
USA Spending
curl --request GET \
  --url https://api.aries.com/v1/stock/usa-spending \
  --header 'Authorization: Bearer <token>'
{
  "data": [
    {
      "symbol": "AAPL",
      "recipientName": "APPLE INC.",
      "recipientParentName": "APPLE INC.",
      "country": "USA",
      "totalValue": 4238,
      "actionDate": "2021-11-12",
      "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",
      "awardDescription": "MACBOOK PRO",
      "naicsCode": "334111",
      "permalink": "https://www.usaspending.gov/award/CONT_AWD_33131222P00465925_3300_-NONE-_-NONE-/"
    }
  ],
  "symbol": "AAPL"
}

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

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

symbol
string
required

Stock ticker symbol

from
string<date>
required

From date YYYY-MM-DD

to
string<date>
required

To date YYYY-MM-DD

Response

Successful response

data
object[]
symbol
string