Company Guidance — Future Outlook (SEC)

Management's own forecasts for future periods, when the company files them with the SEC.

GET/api/v1/guidance/{ticker}

Insider InfoIncluded in every plan · one key.

Overview

Management forecasts for future periods — not financial results already reported. Forward revenue, EPS, margin, cash-flow, capex and other company guidance is extracted from official SEC-filed earnings releases. Domestic issuers are discovered through 8-K Items 2.02/7.01 and EX-99.1; foreign private issuers through filed 6-K documents. Every row keeps an exact source quote, accession and exhibit link. Comparable history labels raises, cuts, reiterations, withdrawals and newly initiated guidance. Coverage is lazy: a ticker without a prepared profile returns HTTP 202 while a single sequential worker reads only that issuer's EDGAR filings. Raw HTML lives only in a temporary directory and is deleted after extraction; the server retains compact structured extracts and the compressed query profile. Existing data is served stale-while-revalidate. It does not claim to include analyst consensus or statements made only during an earnings call.

Use it toTrack exactly what management guided and whether that guidance improved or deteriorated.

Guidance is voluntary and can legitimately be empty — Apple often reports complete financial results without filing formal forward guidance. For results already announced, use `/api/v1/financials/{ticker}` instead. A first uncached request can return HTTP 202 with dataStatus `preparing` and `Retry-After: 15`. SEC access is free; the first successful extraction can use DeepSeek, while later requests use the compact cache.

Coverage

Universe

US SEC filers that file guidance

History

Filed outlook periods

Updates

As filed

Source

SEC EDGAR (official)

Call it

Send your ra_live_… key in the x-api-key header. Pick your language:

curl "https://raspberrytrades.com/api/v1/guidance/NVDA?change=lowered&limit=1" \
  -H "x-api-key: ra_live_your_key_here"

Parameters

Parameter	Type	Description
`ticker`	path	Mapped company ticker, e.g. NVDA (required)
`metric`	string	Comma-separated canonicalMetric values such as revenue, eps or gross margin (optional). canonicalMetric is the stable field for filtering and grouping; the descriptive metric label may vary between filings.
`period`	string	Period text such as FY2027 or H2 2026 (optional)
`change`	string	raised \| lowered \| maintained \| withdrawn \| initiated \| unknown (optional)
`since`	date	Minimum SEC filing date, YYYY-MM-DD (optional)
`limit`	number	Maximum observations (optional, integer 1–500; invalid values return HTTP 400)
`x-api-key`	header	Your API key (required)

Example response

200 OK · application/json

{
  "requestedTicker": "NVDA",
  "mappingStatus": "exact",
  "issuer": {
    "cik": "0001045810",
    "name": "NVIDIA CORP",
    "ticker": "NVDA",
    "tickers": ["NVDA"]
  },
  "query": {
    "metrics": [],
    "periods": [],
    "changes": ["lowered"],
    "since": null,
    "limit": 1
  },
  "count": 1,
  "guidance": [
    {
      "period": "FY2027",
      "metric": "tax rate (gaap)",
      "canonicalMetric": "tax rate",
      "low": 16,
      "high": 18,
      "unit": "percent",
      "currency": null,
      "basis": "gaap",
      "explicitChange": "unknown",
      "qualitative": false,
      "evidence": "For the full year fiscal 2027, NVIDIA expects GAAP and non-GAAP tax rates to be between 16.0% and 18.0%, excluding any discrete items and material changes to NVIDIA’s tax environment.",
      "comparisonKey": "fy2027|tax rate|%||gaap",
      "change": {
        "direction": "lowered",
        "method": "numeric_midpoint",
        "currentMidpoint": 17,
        "previous": {
          "accession": "0001045810-26-000019",
          "filingDate": "2026-02-25",
          "low": 17,
          "high": 19,
          "midpoint": 18
        },
        "delta": -1,
        "deltaPercent": -5.5556
      },
      "accession": "0001045810-26-000051",
      "form": "8-K",
      "filingDate": "2026-05-20",
      "reportDate": "2026-05-20",
      "source": {
        "source": "sec_filed_exhibit",
        "filingIndexUrl": "https://www.sec.gov/Archives/edgar/data/1045810/000104581026000051/index.json",
        "filingDetailUrl": "https://www.sec.gov/Archives/edgar/data/1045810/000104581026000051/nvda-20260520.htm",
        "documents": [
          {
            "exhibitType": "EX-99.1",
            "documentUrl": "https://www.sec.gov/Archives/edgar/data/1045810/000104581026000051/q1fy27pr.htm"
          }
        ],
        "retrievedAt": "2026-07-27T21:54:37.058Z"
      },
      "extraction": {
        "extractorVersion": "1.2.0",
        "promptVersion": "guidance-v3",
        "model": "deepseek-v4-flash",
        "extractedAt": "2026-07-27T22:26:24.449Z",
        "rejectedStatements": 0
      }
    }
  ],
  "latestByMetric": {
    "tax rate:gaap": {
      "period": "FY2027",
      "metric": "tax rate (gaap)",
      "canonicalMetric": "tax rate",
      "low": 16,
      "high": 18,
      "unit": "percent",
      "currency": null,
      "basis": "gaap",
      "explicitChange": "unknown",
      "qualitative": false,
      "evidence": "For the full year fiscal 2027, NVIDIA expects GAAP and non-GAAP tax rates to be between 16.0% and 18.0%, excluding any discrete items and material changes to NVIDIA’s tax environment.",
      "comparisonKey": "fy2027|tax rate|%||gaap",
      "change": {
        "direction": "lowered",
        "method": "numeric_midpoint",
        "currentMidpoint": 17,
        "previous": {
          "accession": "0001045810-26-000019",
          "filingDate": "2026-02-25",
          "low": 17,
          "high": 19,
          "midpoint": 18
        },
        "delta": -1,
        "deltaPercent": -5.5556
      },
      "accession": "0001045810-26-000051",
      "form": "8-K",
      "filingDate": "2026-05-20",
      "reportDate": "2026-05-20",
      "source": {
        "source": "sec_filed_exhibit",
        "filingIndexUrl": "https://www.sec.gov/Archives/edgar/data/1045810/000104581026000051/index.json",
        "filingDetailUrl": "https://www.sec.gov/Archives/edgar/data/1045810/000104581026000051/nvda-20260520.htm",
        "documents": [
          {
            "exhibitType": "EX-99.1",
            "documentUrl": "https://www.sec.gov/Archives/edgar/data/1045810/000104581026000051/q1fy27pr.htm"
          }
        ],
        "retrievedAt": "2026-07-27T21:54:37.058Z"
      },
      "extraction": {
        "extractorVersion": "1.2.0",
        "promptVersion": "guidance-v3",
        "model": "deepseek-v4-flash",
        "extractedAt": "2026-07-27T22:26:24.449Z",
        "rejectedStatements": 0
      }
    }
  },
  "storeStats": {
    "filingCount": 6,
    "filingsWithGuidance": 6,
    "statementCount": 40
  },
  "limitations": {
    "includesAnalystConsensus": false,
    "includesUnfiledCallTranscript": false,
    "sourceScope": "SEC-filed EX-99.1 exhibits for 8-K Items 2.02/7.01 and filed 6-K documents."
  }
}

Insider Info — related datasets

News SentimentWhether the financial-news headlines on a stock are positive or negative — AI-scored, with links.Market NewsThe latest news driving a whole market — US, gold, BTC, oil… — AI-scored, with links.Insider Trading (SEC)Who's buying or selling their own stock — recent insider trades from official SEC filings.Reported Financial Statements (SEC)The income statement, balance sheet and cash flow a company has reported to the SEC — historical facts.

Get your API key

Create a free account, copy your ra_live_… key and make your first call to https://raspberrytrades.com/api/v1/guidance/{ticker}.

Keep your key on your server — never ship it in front-end code.