Sec Company-resolve
Resolve one exact U.S. public-company ticker to the SEC canonical CIK and EDGAR-conformed company name using the official SEC company_tickers.json mapping. Forest performs no fuzzy company-name search, filing download, market-data inference or mutation.
Forest exposes this capability as a deterministic machine-readable API for software agents. Discovery is free; execution uses the canonical paid endpoint below. The live x402 challenge is the source of truth for payment terms.
$0.001 / callPOST /sec/company-resolvex402 · Base
Typical agent tasks
This capability is intended for bounded machine decisions such as:
- convert a stock ticker to SEC CIK
- find the SEC company identifier for a public company ticker
- resolve a ticker before querying EDGAR filings
- get the canonical SEC identity for a stock symbol
What Forest guarantees
- exact ticker matching only against the official SEC ticker mapping
- canonical CIK is returned both zero-padded and as an integer
- ticker source is cached in-process for six hours to avoid repeated large upstream downloads
- fixed SEC source only; callers cannot choose an upstream URL
- SEC-compatible identifying User-Agent configuration is required before any upstream request
- SEC access is process-locally paced and its waiting queue is hard-bounded; excess bursts fail fast instead of accumulating unbounded work
Boundaries
- fuzzy company-name search, private-company identity or exchange-symbol inference
- real-time quote, valuation, investment recommendation or trading signal
- filing content retrieval or document parsing
- a global or cross-replica SEC rate limit; pacing and queue bounds apply independently per Forest process
Machine contract
The request and response schemas are published in the canonical OpenAPI document. This page shows a representative input from the same production manifest.
Input example
{
"ticker": "AAPL"
}
Canonical paid endpoint
https://http--forest-gas-station-mainnet--lcjl27p8lmjs.code.run/sec/company-resolve
Related capabilities
- Sec Recent-filings — Return newest-first metadata for recent official SEC EDGAR submissions for one exact ticker or CIK, optionally filtered to an exact form such as 10-K, 10-Q, 8-K or S-1. Forest returns bounded filing metadata and canonical SEC archive links only; it does not download filing bodies, crawl exhibits, parse XBRL or perform investment analysis.
- Crypto Fear-greed — Return the current Bitcoin-focused Crypto Fear & Greed reading and an optional bounded recent daily history from Alternative.me. Forest preserves the provider classification and prominent source attribution; it does not synthesize an asset-specific altcoin score, forecast price, create a trading signal, recommend a trade or access any account or wallet.
- Crypto Spot-price — Return one current Coinbase spot-product snapshot for an exact BASE-QUOTE product id, including venue price, 24-hour price change and provider-reported 24-hour product volume. Forest reads only Coinbase Advanced Trade public market data; it does not infer tickers, infer the provider volume denomination, aggregate venues, read an account or wallet, place orders, provide an executable quote, forecast returns or recommend a trade.
- Perp Funding — Return one current Hyperliquid native perpetual snapshot with hourly funding, 8-hour equivalent, simple nominal annualization of the current hourly rate, mark/oracle basis, Hyperliquid funding premium index, open interest, daily notional volume and max leverage. Forest reads only the fixed public Hyperliquid info endpoint; the annualized field is not compounded, forecast or realized return, and Forest does not trade, sign, read a wallet or recommend a position.
- Perp Funding-history — Return a bounded recent history of realized hourly funding-rate observations for one exact Hyperliquid native perpetual. Forest makes one fixed public fundingHistory request, returns at most 168 newest normalized observations, and reuses the existing shared Hyperliquid pacing boundary. This is historical market data only, not a prediction, arbitrage signal, trader funding ledger or trading recommendation.
- Treasury Yield-curve — Return the latest published U.S. Treasury Daily Treasury Par Yield Curve Rates snapshot across standard maturities from 1 month through 30 years. Forest normalizes one coherent official daily observation, reports missing Treasury tenors as null, and performs no forecast, interpolation, trading signal or secondary-market inference.