SEC EDGAR Company Lookup
CertifiedLook up companies on SEC EDGAR by ticker
SEC EDGAR Company Lookup
Look up companies on SEC EDGAR by ticker
Resolves stock tickers to the company's CIK (the identifier the other EDGAR tasks use), name and exchange, from SEC's company ticker file. Tickers are matched case-insensitively, and BRK.B also matches EDGAR's BRK-B. The task fails, naming them, if SEC lists no company for one or more tickers.
SEC allows at most 10 requests per second from all your tools together; see maxRequestsPerSecond.
type: io.kestra.plugin.edgar.company.LookupExamples
Look up a company's CIK and use it in the next task.
id: edgar_lookup
namespace: company.team
tasks:
- id: lookup
type: io.kestra.plugin.edgar.company.Lookup
userAgent: "Example Co admin@example.com"
tickers:
- AAPL
fetchType: FETCH_ONE
- id: log
type: io.kestra.plugin.core.log.Log
message: "{{ outputs.lookup.row.name }} has CIK {{ outputs.lookup.row.cik }}"
Look up several companies at once.
id: edgar_lookup_many
namespace: company.team
tasks:
- id: lookup
type: io.kestra.plugin.edgar.company.Lookup
userAgent: "Example Co admin@example.com"
tickers:
- AAPL
- MSFT
- BRK.B
Properties
tickers *array
Tickers to look up
For example AAPL or BRK.B. Results keep this order.
userAgent *string
User-Agent sent to SEC
SEC requires automated tools to identify themselves with a name and a contact email, for example Example Co admin@example.com, and rejects requests without one. See SEC fair access.
assets
Assets this task consumes as inputs or produces as outputs, for lineage tracking and the asset graph (Enterprise Edition). A flow declaring this property on a task is rejected in the open-source edition.
io.kestra.core.models.assets.AssetsDeclaration
IGNOREFAILWARNAsset failure behavior
Behavior applied to the task state when a declared asset fails to render, emit, or be persisted (e.g. a lock conflict): FAIL escalates it to FAILED, WARN (default) warns it if it would otherwise succeed, IGNORE leaves the state untouched.
Whether to auto-register assets referenced dynamically at runtime that are not statically declared in inputs or outputs.
The assets consumed as inputs.
io.kestra.core.models.assets.AssetIdentifier
1The assets produced as outputs.
io.kestra.plugin.ee.assets.Dataset
1150{}1150io.kestra.plugin.ee.assets.File
1150{}1150io.kestra.plugin.ee.assets.Table
1150{}1150io.kestra.plugin.ee.assets.VM
1150{}1150io.kestra.core.models.assets.External
1150{}1150io.kestra.core.models.assets.Custom
11501Custom asset type
{}1150baseUrl string
https://www.sec.govBase URL of the SEC website
Where company tickers and filing documents are read from. Change it only to go through a proxy or a test server.
dataBaseUrl string
https://data.sec.govBase URL of SEC's data API
Where filing lists and XBRL data are read from. Change it only to go through a proxy or a test server.
fetchType string
FETCHSTOREFETCHFETCH_ONENONEHow to return the companies
FETCH (default) returns them in rows, FETCH_ONE returns the first in row, STORE writes them to an ION file in internal storage and returns its uri, NONE returns only size.
maxRequestsPerSecond integerstring
5Maximum requests per second
Requests made by this task are spaced so they stay at or under this rate. Defaults to 5, at most 10, which is SEC's limit. The limit applies to each task run: tasks that run in parallel each count against SEC's limit, so lower this value when several EDGAR tasks run at the same time. A request rejected with HTTP 429 or 503 is retried after SEC's Retry-After delay, then up to twice more, 10 and 20 seconds later.
Outputs
row
The first company
Set when fetchType is FETCH_ONE.
io.kestra.plugin.edgar.Company
CIK
SEC's Central Index Key, as the 10-digit zero-padded string EDGAR URLs use, for example 0000320193.
Exchange
For example Nasdaq or NYSE; empty when SEC lists none.
Company name
As registered with SEC.
Ticker
As listed by SEC; class shares use a hyphen, for example BRK-B.
rows array
The companies, in the order of tickers
Set when fetchType is FETCH.
io.kestra.plugin.edgar.Company
CIK
SEC's Central Index Key, as the 10-digit zero-padded string EDGAR URLs use, for example 0000320193.
Exchange
For example Nasdaq or NYSE; empty when SEC lists none.
Company name
As registered with SEC.
Ticker
As listed by SEC; class shares use a hyphen, for example BRK-B.
size integer
Number of companies found
uri string
uriURI of the ION file holding the companies
Set when fetchType is STORE.
