View as Markdown
Polygon icon

Polygon ACTION

Get Company Financials

Retrieves financial details for a specific company by stock ticker. See the documentation.
  • Action
  • Read only
  • API key
  • SDK
  • MCP

IMPLEMENTATION

Call this tool

Connect a user's Polygon account once, then configure and run Get Company Financials from your backend or agent.

import { PipedreamClient } from "@pipedream/sdk"

const pd = new PipedreamClient({
  projectId: process.env.PIPEDREAM_PROJECT_ID!,
  clientId: process.env.PIPEDREAM_CLIENT_ID!,
  clientSecret: process.env.PIPEDREAM_CLIENT_SECRET!,
  projectEnvironment: "production",
})

const result = await pd.actions.run({
  id: "polygon-get-company-financials",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    polygon: { authProvisionId: "apn_xxxxxxx" },
    stockTicker: "Stock Ticker",
    filingDate: "Filing Date",
  },
})

console.log(result)

SCHEMA

Inputs

Pipedream supplies the connected account. Your application provides the operation-specific values below. Dynamic inputs are resolved against that user's account.

Get Company Financials inputs
Property Type Description
stockTicker Stock Ticker string
Specify a case-sensitive ticker symbol. For example, AAPL represents Apple Inc.
Required Dynamic
filingDate Filing Date string
Query by the date when the filing with financials data was filed in YYYY-MM-DD format.
Optional
periodOfReportDate Period Of Report Date string
The period of report for the filing with financials data in YYYY-MM-DD format.
Optional
timeframe Timeframe string
Query by timeframe. Annual financials originate from 10-K filings, and quarterly financials originate from 10-Q filings. Note: Most companies do not file quarterly reports for Q4 and instead include those financials in their annual report, so some companies my not return quarterly financials for Q4
Optional
order Order string
Order results based on the Sort field.
Optional
limit Limit integer
Limit the number of results returned.
Optional
sort Sort string
Sort field used for ordering
Optional

REFERENCE

Tool details

Behavior hints are published with the component in the Pipedream registry and surface as MCP tool annotations, so an agent can reason about a tool before it calls it.

Registry key
polygon-get-company-financials
Version
0.0.2
App
Polygon
Authentication
API key
Read-only
Yes
Destructive
No
Open world
Yes