Secant — Financial Data from the Source

Secant — Financial Data from the Source

Secant is a financial data API built directly on primary public sources — SEC EDGAR filings, U.S. Treasury, CoinGecko, and ECB/Frankfurter. The complete SEC dataset is mirrored and served from cloud storage, with no third-party data resellers and no live dependency at serve time. Authenticate every request with ?apikey=. Not affiliated with or endorsed by the SEC.

Best-effort data derived from public sources. No warranty; not investment advice. Every response carries a source and as-of timestamp.

System

Service health and metadata.

GET /stable/health

Health check

Service status and version. Source: system.

Parameters

No parameters.

Try it

No parameters.

Response will appear here.
Example response
{
  "status": "ok",
  "service": "secant",
  "version": "0.3.0",
  "source": "system",
  "asOf": "2026-06-15T00:00:00Z"
}

Company Information

Company profile and identity. Source: SEC EDGAR (+ derived market cap when a price adapter is configured).

GET /stable/profile

Company Profile

Company identity, address, shares outstanding, and derived market cap (when a price adapter is configured). Source: SEC EDGAR submissions + company facts.

Parameters

NameTypeReqDescription
symbol string required Ticker symbol.
apikey string optional API key (AWS usage plan). Optional in local dev.
Try it 
Response will appear here.
Example response
[
  {
    "symbol": "AAPL",
    "companyName": "Apple Inc.",
    "cik": "0000320193",
    "exchange": "Nasdaq",
    "sicCode": "3571",
    "industry": "Electronic Computers",
    "sharesOutstanding": 14687356000,
    "marketCap": null,
    "source": "SEC EDGAR (submissions)",
    "asOf": "2026-06-13T00:00:00Z"
  }
]

Statements

Income, balance sheet, cash flow. Source: SEC EDGAR XBRL company facts.

GET /stable/income-statement

Income Statement

Annual or quarterly income statements. Source: SEC EDGAR XBRL company facts.

Parameters

NameTypeReqDescription
symbol string required Ticker symbol.
period string optional Reporting period. (default: annual · enum: annual, quarter)
limit integer optional Max rows. (default: 5)
apikey string optional API key (AWS usage plan). Optional in local dev.
Try it 
Response will appear here.
Example response
[
  {
    "symbol": "AAPL",
    "date": "2025-09-27",
    "fiscalYear": 2025,
    "period": "FY",
    "revenue": 416161000000,
    "grossProfit": 195201000000,
    "operatingIncome": 133050000000,
    "netIncome": 112010000000,
    "eps": 7.46,
    "source": "SEC EDGAR XBRL company facts"
  }
]
GET /stable/balance-sheet-statement

Balance Sheet

Annual or quarterly balance sheets. Source: SEC EDGAR XBRL company facts.

Parameters

NameTypeReqDescription
symbol string required Ticker symbol.
period string optional Reporting period. (default: annual · enum: annual, quarter)
limit integer optional Max rows. (default: 5)
apikey string optional API key (AWS usage plan). Optional in local dev.
Try it 
Response will appear here.
Example response
[
  {
    "symbol": "MSFT",
    "date": "2025-06-30",
    "fiscalYear": 2025,
    "totalAssets": 619003000000,
    "totalLiabilities": 275524000000,
    "totalStockholdersEquity": 343479000000
  }
]
GET /stable/cash-flow-statement

Cash Flow Statement

Annual or quarterly cash flow statements (incl. derived free cash flow). Source: SEC EDGAR XBRL company facts.

Parameters

NameTypeReqDescription
symbol string required Ticker symbol.
period string optional Reporting period. (default: annual · enum: annual, quarter)
limit integer optional Max rows. (default: 5)
apikey string optional API key (AWS usage plan). Optional in local dev.
Try it 
Response will appear here.
Example response
[
  {
    "symbol": "AAPL",
    "date": "2025-09-27",
    "operatingCashFlow": 111482000000,
    "capitalExpenditure": 12715000000,
    "freeCashFlow": 98767000000
  }
]

Ratios & Metrics

Profitability, liquidity, per-share metrics, owner earnings, and enterprise value. Computed from SEC fundamentals.

GET /stable/ratios

Financial Ratios

Profitability, liquidity, and return ratios. Computed from SEC fundamentals.

Parameters

NameTypeReqDescription
symbol string required Ticker symbol.
period string optional Reporting period. (default: annual · enum: annual, quarter)
limit integer optional Max rows. (default: 5)
apikey string optional API key (AWS usage plan). Optional in local dev.
Try it 
Response will appear here.
Example response
[
  {
    "symbol": "AAPL",
    "fiscalYear": 2025,
    "grossProfitMargin": 0.469,
    "netProfitMargin": 0.269,
    "currentRatio": 0.893,
    "returnOnEquity": 1.519
  }
]
GET /stable/key-metrics

Key Metrics

Per-share and working-capital metrics. Computed from SEC fundamentals.

Parameters

NameTypeReqDescription
symbol string required Ticker symbol.
period string optional Reporting period. (default: annual · enum: annual, quarter)
limit integer optional Max rows. (default: 5)
apikey string optional API key (AWS usage plan). Optional in local dev.
Try it 
Response will appear here.
Example response
[
  {
    "symbol": "AAPL",
    "fiscalYear": 2025,
    "revenuePerShare": 27.74,
    "netIncomePerShare": 7.46,
    "bookValuePerShare": 4.91
  }
]
GET /stable/owner-earnings

Owner Earnings

Illustrative owner earnings (net income + D&A − capex) per period. Computed from SEC cash-flow data. Not investment advice.

Parameters

NameTypeReqDescription
symbol string required Ticker symbol.
period string optional Reporting period. (default: annual · enum: annual, quarter)
limit integer optional Max rows. (default: 5)
apikey string optional API key (AWS usage plan). Optional in local dev.
Try it 
Response will appear here.
Example response
[
  {
    "symbol": "AAPL",
    "fiscalYear": 2025,
    "netIncome": 112010000000,
    "depreciationAndAmortization": 11900000000,
    "capitalExpenditure": 12715000000,
    "ownerEarnings": 111195000000,
    "source": "derived from SEC EDGAR"
  }
]
GET /stable/enterprise-values

Enterprise Values

Enterprise value = market cap + total debt − cash, with components. Market cap needs the price adapter (latest close, applied to the most recent period); SEC components (shares, cash, long-term debt) are returned for every period.

Parameters

NameTypeReqDescription
symbol string required Ticker symbol.
period string optional Reporting period. (default: annual · enum: annual, quarter)
limit integer optional Max rows. (default: 5)
apikey string optional API key (AWS usage plan). Optional in local dev.
Try it 
Response will appear here.
Example response
[
  {
    "symbol": "AAPL",
    "fiscalYear": 2025,
    "numberOfShares": 15022100000,
    "stockPrice": null,
    "marketCapitalization": null,
    "addTotalDebt": 85750000000,
    "minusCashAndCashEquivalents": 30299000000,
    "enterpriseValue": null,
    "source": "derived from SEC EDGAR"
  }
]

Discounted Cash Flow

Illustrative DCF from public fundamentals. Not investment advice.

GET /stable/discounted-cash-flow

Discounted Cash Flow

Illustrative DCF projecting the latest free cash flow. Tune the assumptions via query params. Not investment advice.

Parameters

NameTypeReqDescription
symbol string required Ticker symbol.
discountRate number optional (default: 0.09)
growth number optional (default: 0.05)
terminalGrowth number optional (default: 0.025)
years integer optional (default: 5)
apikey string optional API key (AWS usage plan). Optional in local dev.
Try it 
Response will appear here.
Example response
[
  {
    "symbol": "AAPL",
    "dcfEnterpriseValue": 1733978110233,
    "dcfPerShare": 115.56,
    "baseFreeCashFlow": 98767000000,
    "assumptions": {
      "discountRate": 0.09,
      "growth": 0.05,
      "terminalGrowth": 0.025,
      "years": 5
    }
  }
]

Charts

Historical EOD OHLCV. Source: Stooq (pluggable price adapter — see plan §3.6).

GET /stable/historical-price-eod

Historical EOD Prices (Deprecated)

DEPRECATED — requires an external/licensed price vendor, out of scope for the public-data static model. Returns HTTP 410.

Parameters

NameTypeReqDescription
symbol string required Ticker symbol.
limit integer optional (default: 120)
apikey string optional API key (AWS usage plan). Optional in local dev.
Try it 
Response will appear here.
Example response
[
  {
    "symbol": "AAPL",
    "date": "2026-06-12",
    "open": 210.1,
    "high": 212.5,
    "low": 209.3,
    "close": 211.8,
    "volume": 51000000
  }
]

Technical Indicators

SMA / EMA / RSI computed from the EOD price series.

GET /stable/technical-indicator

Technical Indicator (Deprecated)

DEPRECATED — requires an external/licensed price vendor (EOD price series), out of scope for the public-data static model. Returns HTTP 410.

Parameters

NameTypeReqDescription
symbol string required Ticker symbol.
type string optional (default: sma · enum: sma, ema, rsi)
period integer optional (default: 20)
limit integer optional (default: 60)
apikey string optional API key (AWS usage plan). Optional in local dev.
Try it 
Response will appear here.

SEC Filings

Recent filings, links, and full-text search. Source: SEC EDGAR submissions + EFTS.

GET /stable/sec-filings

SEC Filings

Recent filings with direct document links. Filter by form type. Source: SEC EDGAR submissions.

Parameters

NameTypeReqDescription
symbol string required Ticker symbol.
type string optional Form type filter (e.g. 10-K, 10-Q, 8-K, 4).
limit integer optional (default: 20)
apikey string optional API key (AWS usage plan). Optional in local dev.
Try it 
Response will appear here.
Example response
[
  {
    "symbol": "AAPL",
    "form": "10-K",
    "filingDate": "2025-10-31",
    "link": "https://www.sec.gov/Archives/edgar/data/320193/000032019325000079/aapl-20250927.htm"
  }
]
GET /stable/sec-full-text-search

SEC Full-Text Search

Full-text search across EDGAR filing bodies (2001-present). Optionally filter by form type. Source: SEC EDGAR full-text search (EFTS).

Parameters

NameTypeReqDescription
query string required Search phrase.
forms string optional Comma-separated form types (e.g. 8-K, 10-K).
limit integer optional (default: 10)
apikey string optional API key (AWS usage plan). Optional in local dev.
Try it 
Response will appear here.
Example response
[
  {
    "cik": "0001333274",
    "companyName": "MERCER INTERNATIONAL INC. (MERC) (CIK 0001333274)",
    "form": "8-K",
    "filingDate": "2010-01-26",
    "fileType": "EX-99.1",
    "accessionNumber": "0000950123-10-004963",
    "link": "https://www.sec.gov/Archives/edgar/data/1333274/000095012310004963/o58838exv99w1.htm",
    "source": "SEC EDGAR full-text search (EFTS)"
  }
]
GET /stable/sec-8k

8-K Current Reports (Material Events)

A company's recent Form 8-K current reports — material-event disclosures (earnings releases, leadership changes, agreements). Item codes are mapped to human-readable descriptions. Source: SEC EDGAR submissions index.

Parameters

NameTypeReqDescription
symbol string required Ticker symbol.
limit integer optional (default: 20)
apikey string optional API key (AWS usage plan). Optional in local dev.
Try it 
Response will appear here.
Example response
[
  {
    "symbol": "AAPL",
    "form": "8-K",
    "filingDate": "2026-01-29",
    "eventDate": "2026-01-29",
    "items": [
      "2.02",
      "9.01"
    ],
    "itemDescriptions": [
      "Results of Operations and Financial Condition",
      "Financial Statements and Exhibits"
    ],
    "title": "Results of Operations and Financial Condition; Financial Statements and Exhibits",
    "accessionNumber": "0000320193-26-000007",
    "link": "https://www.sec.gov/Archives/edgar/data/320193/000032019326000007/aapl-20260129.htm",
    "source": "SEC EDGAR (Form 8-K current report)"
  }
]

Insider Trades

Form 3/4/5 insider transactions, parsed from SEC ownership filings.

GET /stable/insider-trades

Insider Trades

Insider (Form 3/4/5) non-derivative transactions for a symbol: who traded, buy/sell, shares, price, and resulting holdings. Source: SEC EDGAR ownership filings.

Parameters

NameTypeReqDescription
symbol string required Ticker symbol.
type string optional Restrict to a single ownership form (3, 4, or 5). (enum: 3, 4, 5)
limit integer optional (default: 20)
apikey string optional API key (AWS usage plan). Optional in local dev.
Try it 
Response will appear here.
Example response
[
  {
    "symbol": "AAPL",
    "form": "4",
    "filingDate": "2026-05-29",
    "transactionDate": "2026-05-27",
    "reportingName": "LEVINSON ARTHUR D",
    "relationship": "Director",
    "securityType": "equity",
    "securityName": "Common Stock",
    "transactionCode": "S",
    "transactionType": "Sale",
    "acquiredOrDisposed": "D",
    "shares": 50000,
    "pricePerShare": 311.02,
    "value": 15551000,
    "sharesOwnedFollowing": 3764576,
    "ownershipType": "Direct",
    "source": "SEC EDGAR (Form 3/4/5 ownership)"
  }
]

Form 13F

Institutional manager holdings, parsed from SEC 13F-HR information tables.

GET /stable/form-13f

Institutional Holdings (13F)

Latest 13F-HR holdings for an institutional manager, by CIK (managers have no ticker), largest position first. Source: SEC EDGAR 13F-HR information table.

Parameters

NameTypeReqDescription
cik string required Manager CIK (e.g. 0001067983 = Berkshire Hathaway).
limit integer optional (default: 50)
apikey string optional API key (AWS usage plan). Optional in local dev.
Try it 
Response will appear here.
Example response
[
  {
    "managerName": "BERKSHIRE HATHAWAY INC",
    "cik": "0001067983",
    "reportDate": "2026-03-31",
    "nameOfIssuer": "AMERICAN EXPRESS CO",
    "titleOfClass": "COM",
    "cusip": "025816109",
    "putCall": null,
    "value": 45087984892,
    "shares": 149061045,
    "sharesType": "SH",
    "investmentDiscretion": "DFND",
    "source": "SEC EDGAR (Form 13F-HR information table)"
  }
]

Fund Holdings

ETF & mutual-fund portfolio holdings, parsed from SEC Form N-PORT filings.

GET /stable/fund-holdings

ETF / Mutual-Fund Holdings (N-PORT)

Latest portfolio holdings for an ETF or mutual fund, largest position first, from the fund's most recent SEC Form N-PORT filing. Resolve by fund ticker (e.g. IVV, VOO, QQQ), or pass cik & series directly. Source: SEC EDGAR Form N-PORT.

Parameters

NameTypeReqDescription
symbol string optional Fund/ETF ticker (resolved via SEC company_tickers_mf.json).
cik string optional Registrant CIK (alternative to symbol; use with series).
series string optional Fund series ID, e.g. S000004310 (alternative to symbol; use with cik).
limit integer optional (default: 50)
apikey string optional API key (AWS usage plan). Optional in local dev.
Try it 
Response will appear here.
Example response
[
  {
    "fundSymbol": "IVV",
    "fundName": "iShares Core S&P 500 ETF",
    "seriesId": "S000004310",
    "reportDate": "2026-03-31",
    "netAssets": 720543356320.99,
    "name": "NVIDIA Corp.",
    "title": "NVIDIA Corp.",
    "cusip": "67066G104",
    "isin": "US67066G1040",
    "balance": 96000000,
    "units": "NS",
    "valueUSD": 54500000000,
    "pctVal": 7.564382338558,
    "assetCategory": "EC",
    "source": "SEC EDGAR (Form N-PORT)"
  }
]

Congressional Trading

U.S. House member financial disclosures incl. periodic transaction reports (stock trades), from the House Clerk index.

GET /stable/house-disclosures

House Financial Disclosures

U.S. House member financial-disclosure filings for a year, defaulting to Periodic Transaction Reports (stock-trade disclosures), newest first. Source: House Clerk annual index. Filing-level — each row links to the official PDF holding the individual transactions. The Senate has no keyless bulk feed, so it is not covered here.

Parameters

NameTypeReqDescription
type string optional Filing-type code: P=Periodic Transaction Report (trades), A=Annual, X=Extension, etc., or 'all'. (default: P)
name string optional Case-insensitive substring match on member name.
year integer optional Disclosure year (defaults to the current year).
limit integer optional (default: 100)
apikey string optional API key (AWS usage plan). Optional in local dev.
Try it 
Response will appear here.
Example response
[
  {
    "name": "Nancy Pelosi",
    "office": "House",
    "state": "CA",
    "district": "CA11",
    "filingType": "P",
    "filingTypeLabel": "Periodic Transaction Report",
    "filingDate": "2026-01-23",
    "year": 2026,
    "documentId": "20033725",
    "link": "https://disclosures-clerk.house.gov/public_disc/ptr-pdfs/2026/20033725.pdf",
    "source": "U.S. House Clerk — Financial Disclosures"
  }
]

Economics

Treasury par yield curve. Source: U.S. Treasury.

GET /stable/treasury-rates

Treasury Rates

Daily Treasury par yield curve across maturities, newest first. Source: U.S. Treasury.

Parameters

NameTypeReqDescription
limit integer optional (default: 30)
apikey string optional API key (AWS usage plan). Optional in local dev.
Try it 
Response will appear here.
Example response
[
  {
    "date": "2026-06-12",
    "month1": 3.69,
    "year2": 4.09,
    "year10": 4.48,
    "year30": 4.97,
    "source": "U.S. Treasury (par yield curve)"
  }
]

Crypto

Crypto prices & markets. Source: CoinGecko (attribution required).

GET /stable/crypto-quote

Crypto Quote

Live quote for one cryptocurrency. Source: CoinGecko (attribution required).

Parameters

NameTypeReqDescription
symbol string required Crypto symbol (BTC, ETH, SOL, ...).
apikey string optional API key (AWS usage plan). Optional in local dev.
Try it 
Response will appear here.
Example response
[
  {
    "symbol": "BTCUSD",
    "name": "Bitcoin",
    "price": 64379,
    "marketCap": 1290687997924,
    "change24h": 1.32,
    "source": "CoinGecko (free API; attribution required)"
  }
]
GET /stable/crypto-list

Crypto Markets

Top cryptocurrencies by market cap. Source: CoinGecko.

Parameters

NameTypeReqDescription
limit integer optional (default: 50)
apikey string optional API key (AWS usage plan). Optional in local dev.
Try it 
Response will appear here.

Forex

FX reference rates. Source: ECB via Frankfurter (EOD/reference, not real-time).

GET /stable/forex-quote

Forex Quote

Reference rate for a currency pair. Source: ECB via Frankfurter (EOD/reference).

Parameters

NameTypeReqDescription
pair string required Six-letter pair, e.g. EURUSD.
apikey string optional API key (AWS usage plan). Optional in local dev.
Try it 
Response will appear here.
Example response
[
  {
    "ticker": "EURUSD",
    "base": "EUR",
    "quote": "USD",
    "rate": 1.1567,
    "date": "2026-06-12",
    "source": "Frankfurter / ECB reference rates"
  }
]
GET /stable/forex-list

Forex Rates

Latest USD reference rates for all available currencies. Source: ECB via Frankfurter.

Parameters

NameTypeReqDescription
apikey string optional API key (AWS usage plan). Optional in local dev.
Try it 
Response will appear here.

Market Performance

Top gainers/losers over a sample universe. Derived from EOD prices.

GET /stable/market-performance

Gainers & Losers (Deprecated)

DEPRECATED — requires an external/licensed price vendor (EOD prices), out of scope for the public-data static model. Returns HTTP 410.

Parameters

NameTypeReqDescription
apikey string optional API key (AWS usage plan). Optional in local dev.
Try it 
Response will appear here.

Market Hours

Exchange session status. Static config (no holidays).

GET /stable/market-hours

Market Hours

Whether NYSE/Nasdaq regular sessions are currently open. Static config; holidays not accounted for.

Parameters

NameTypeReqDescription
apikey string optional API key (AWS usage plan). Optional in local dev.
Try it 
Response will appear here.
Example response
[
  {
    "exchange": "NYSE",
    "isMarketOpen": false,
    "openingHour": "09:30",
    "closingHour": "16:00"
  }
]