Apple Numbers STOCK Function: Attributes, Symbols and Reporting Controls
Use the complete stock-selector map, identify unavailable fields and validate position arithmetic without inventing live prices.
Verification status: See the evidence and test scope described in this guide. How formula examples are checked
STOCK retrieves a data attribute for a market symbol through an internet data service. Its default share-price request uses the previous market day’s close. A ticker and a number alone are insufficient report context: retain the attribute, currency and observation timing as well.
Availability and verification
The official STOCK reference was retrieved October 15, 2026. The original introduction release and last functioning version are unknown from the checked first-party evidence. Current documentation is not a final supported-version endpoint or a test of every older Numbers client.
No native Numbers session was executed. Fixed examples below are independent controls; remotely supplied values are not claimed as current observations. First-party example values, when identified, remain source examples rather than newly retrieved native results.
Syntax and symbol identity
STOCK(symbol, price)
symbol is a quoted market symbol or a cell reference containing one. Optional price is the attribute selector; 0 or omission requests price. Some instruments require an exchange suffix, with .CO and .L given by Apple as examples. Do not assume a short ticker uniquely identifies every international listing.
The page’s numeric selector map is:
| Mode | Attribute | Mode | Attribute |
|---|---|---|---|
| 0 | price | 13 | ask price, unavailable |
| 1 | name | 14 | ask size, unavailable |
| 2 | change | 15 | avg. 3-month volume |
| 3 | percent change | 16 | beta |
| 4 | open | 17 | bid price, unavailable |
| 5 | high | 18 | bid size, unavailable |
| 6 | low | 19 | currency |
| 7 | market cap | 20 | annual dividend |
| 8 | volume | 21 | eps |
| 9 | yield | 22 | exchange |
| 10 | 1-year target | 23 | p/e ratio |
| 11 | 52-week high | 24 | previous close |
| 12 | 52-week low | 25 | symbol |
The unavailable labels reflect Apple’s checked reference. A documented selector is not proof that its data is supplied for every symbol.
Example requests without invented market quotes
=STOCK("AAPL",0) requests price; =STOCK("AAPL","price") uses the named form shown by Apple. =STOCK("AAPL",1) requests the company name, illustrated in the source as Apple Inc.
If A2 contains a chosen symbol, =STOCK(A2,19) requests currency and =STOCK(A2,22) requests exchange. Keep those identifying fields alongside the value instead of inferring denomination from a displayed currency symbol.
No current stock price, listing verification or native data response was obtained for this guide.
Complete fictional position worksheet
Use a separate fixed-input model with two fictional positions:
| Position | Shares | Assumed price | Independent value |
|---|---|---|---|
| Example A | 12 | 50 | 600 |
| Example B | 8 | 75 | 600 |
The total value is 1200 in the common fictional currency. These prices are synthetic controls, not live STOCK observations. If one position is actually priced in another currency, adding the values without a specified conversion would lose their meaning.
For Example A, changing the fixed price to 52 gives 624, an increase of 24. The corresponding price return from 50 to 52 is 4%, and the fixed-share position has the same percentage change before fees or other cash flows.
Advanced: inspect related financial fields
For a fictional share price 50, annual dividend per share 2, trailing earnings per share 5, and 1000000 outstanding shares, independent arithmetic gives dividend yield 4%, price/earnings 10, and market capitalization 50000000.
These are controls illustrating units, not a claim that every service field can always be reconstructed from other rounded fields. The dividend input is per share, while market capitalization is a whole-company amount. A one-year analyst target is an estimate, not a guaranteed future price.
Advanced: preserve split context
A fictional two-for-one split changes 10 shares at 40 into 20 shares at 20, leaving position value 400 in this simplified example. Comparing prices alone would show a 50% decline even though this split-only position value is unchanged.
Apple warns that splits and reverse splits can affect STOCK output. It does not establish a universal adjustment policy in this entry. Keep share-count changes and provider conventions visible when comparing observations across a corporate action.
Timing, failures and troubleshooting
Apple says entering the function without internet returns no value and that connectivity restoration updates it. The source illustrates wrapping a query in IFERROR with a text fallback, but replacing failure with zero would distort totals.
For change and percent-change attributes, the source says no trading in the stated interval can result in zero change. That is different from treating missing data as a zero share price. Check attribute meaning before interpreting a zero.
The source also gives precious-metal futures symbols. Those examples do not justify treating every instrument as a real-time stock quote; the main documented stock timing remains previous market close. Exact provider errors, refresh schedules and availability for every instrument were not native-tested.