NetNest Design Fundamentals API

Free ticker and company name lookup: find the ticker for a company name, or the company for a ticker. Data from SEC filings. Not investment advice.

{
  "type": "object",
  "properties": {
    "q": {
      "type": "string",
      "description": "Company name or ticker, for example apple or AAPL"
    },
    "limit": {
      "description": "Number of results, 1 to 25 (default 10)",
      "type": [
        "number",
        "string"
      ]
    }
  },
  "required": [
    "q"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Latest company financials from SEC filings for one ticker: revenue, net income, diluted EPS, operating income, total assets, cash, free cash flow and shares outstanding, for the latest fiscal year, latest quarter and trailing twelve months. Every number includes its period dates, the 10-K or 10-Q it came from, the filing date and a link to the SEC filing.

{
  "type": "object",
  "properties": {
    "ticker": {
      "type": "string",
      "description": "Stock ticker, for example AAPL or BRK.B"
    }
  },
  "required": [
    "ticker"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Latest company revenue, net income, EPS, operating income, assets, liabilities, equity, cash, operating cash flow, capex, free cash flow or shares outstanding from SEC filings. Choose metrics and period (annual, quarterly or ttm). Latest values follow the fiscal year of each company, with the source filing, filing date and accession number for every number.

{
  "type": "object",
  "properties": {
    "ticker": {
      "type": "string",
      "description": "Stock ticker, for example AAPL or BRK.B"
    },
    "metrics": {
      "description": "Comma separated: revenue, net_income, eps_basic, eps_diluted, operating_income, total_assets, total_liabilities, equity, cash, operating_cash_flow, capex, free_cash_flow, shares_outstanding, revenue_contract",
      "type": "string"
    },
    "period": {
      "description": "annual, quarterly or ttm (trailing twelve months)",
      "type": "string"
    }
  },
  "required": [
    "ticker"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Financial history of one metric from SEC filings, newest first: revenue history, net income history, EPS history, cash flow history and more, by year, quarter or trailing twelve months. Up to 200 periods, each with its 10-K or 10-Q, filing date and SEC link.

{
  "type": "object",
  "properties": {
    "ticker": {
      "type": "string",
      "description": "Stock ticker, for example AAPL or BRK.B"
    },
    "metric": {
      "type": "string",
      "description": "The metric to return: revenue, net_income, eps_basic, eps_diluted, operating_income, total_assets, total_liabilities, equity, cash, operating_cash_flow, capex, free_cash_flow, shares_outstanding, revenue_contract"
    },
    "period": {
      "description": "annual, quarterly or ttm (trailing twelve months)",
      "type": "string"
    },
    "limit": {
      "description": "Number of periods, newest first, 1 to 200 (default 20)",
      "type": [
        "number",
        "string"
      ]
    }
  },
  "required": [
    "ticker",
    "metric"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

SEC filing events across companies, newest first: 8-K items by plain name, Form 4 insider transactions and Schedule 13D and 13G stakes, each with its form, filing date, acceptance time, accession number, SEC link, CIK and ticker. Paid with x402 per call or with an API key.

{
  "type": "object",
  "properties": {
    "since": {
      "description": "Cursor from an earlier answer (its next field): only events newer than it are returned",
      "type": "string"
    },
    "before": {
      "description": "Cursor from an earlier answer (its continue field): the next page of older events",
      "type": "string"
    },
    "types": {
      "description": "Event types to include, for example 8k_results or form4_transaction",
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "tickers": {
      "description": "Tickers to include, for example AAPL or BRK.B",
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "limit": {
      "description": "Number of events, 1 to 100 (default 100)",
      "type": [
        "number",
        "string"
      ]
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Free: the newest cursor of the SEC events feed and, given a cursor, how many events are newer than it, so a poller pays only when there is something new. Data from SEC filings. Not investment advice.

{
  "type": "object",
  "properties": {
    "since": {
      "description": "Cursor from an earlier answer (its next field): only events newer than it are returned",
      "type": "string"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}