Finnhub Stock Usa Spending

0.5 credits/call
ae_finnhub_stock_usa_spending

<p>Get a list of government's spending activities from USASpending dataset for public companies. This dataset can help you identify companies that win big government contracts which is extremely important for industries such as Defense, Aerospace, and Education. Only recent data is available via the API.</p><p>Provide a U.S.-listed company's stock symbol and from/to dates in YYYY-MM-DD format. The dates filter actionDate.</p> ## Date and amount interpretation `from` and `to` filter records by `actionDate`; they do not convert contract amounts into incremental amounts for that interval. Matching records may describe contracts that began years earlier and span multiple years. Do not directly sum amount fields as annual new contract awards, annual government cash spending, or company revenue. Annual incremental totals require transaction-level amounts for the relevant year and an explicit calendar-year or fiscal-year definition. ## Returned fields Records are in `data[]`; top-level `symbol` is the stock symbol. - `actionDate`: activity date used by this endpoint's date filter, not the year to which the full contract amount belongs and not necessarily the contract start date. - `performanceStartDate` and `performanceEndDate`: contract performance dates; use them to identify multi-year contracts. - `totalValue`: contract-value field on the record, not the requested interval's incremental amount or annual revenue. Do not add it to the other amount fields. - `potentialAmount`: potential contract amount, not an amount already paid or an annual incremental amount. - `obligatedAmount`: government payment commitments, distinct from actual payments; an `actionDate` match does not make this value an increment for the requested interval. - `outlayedAmount`: actual-payment amount field; filtering dates does not establish that this value covers only the requested interval, so do not treat it as annual spending. - `permalink`: original USASpending award record for checking the contract and amount basis. Multiple records can refer to the same award URL; do not blindly sum their contract amounts.

Productivity
0.5 credits/call

Pricing

0.5 credits/call
ConditionCharge
Each call0.5 credits/call

Parameters

Optional parameters use the platform defaults when omitted.

ParameterTypeRequiredDescriptionDefault
tostringYes结束/End date,格式 YYYY-MM-DD。仅按记录的 actionDate 筛选,不按合同履行日期筛选,也不会将合同金额换算为区间新增金额;所选年份内的记录可能对应多年合同。/ Format YYYY-MM-DD. Filters the record actionDate, not contract performance dates; does not turn contract amounts into increments for this interval or year.—
fromstringYes开始/Start date,格式 YYYY-MM-DD。仅按记录的 actionDate 筛选,不按合同履行日期筛选,也不会将合同金额换算为区间新增金额;所选年份内的记录可能对应多年合同。/ Format YYYY-MM-DD. Filters the record actionDate, not contract performance dates; does not turn contract amounts into increments for this interval or year.—
symbolstringYes必填。填写要查询的美国上市公司的股票代码(symbol),不要填写公司名称、URL 或占位符。若尚未确定代码,先通过股票代码查询确认,不要猜测。—

Invocation example

Copy the request and explore its response example.

POST/agent-api/v1/tool/executeX-Api-Key
Request coderequest.sh
curl --request POST \
  --url 'https://agentearth.ai/agent-api/v1/tool/execute?tool_name=ae_finnhub_stock_usa_spending' \
  --header "X-Api-Key: $AGENTEARTH_API_KEY" \
  --header 'Content-Type: application/json' \
  --data-raw '{
  "params": {
    "from": "2026-08-01",
    "symbol": "AAPL",
    "to": "2026-09-03"
  }
}'
Response exampleresponse.json
JSONPartial content
{
  "data": [
    {
      "actionDate": "2026-08-10",
      "awardDescription": "TELECOM CONSULAR PROJECT NEW DESK PHONE PART",
      "awardingAgencyName": "Department of State",
      "awardingOfficeName": "U.S. EMBASSY PARIS",
      "awardingSubAgencyName": "Department of State",
      "country": "USA"
    }
  ],
  "symbol": "AAPL"
}

This example shows part of the response. Copied content is valid JSON.