> ## Documentation Index > Fetch the complete documentation index at: https://docs.financialdatasets.ai/llms.txt > Use this file to discover all available pages before exploring further. # Company Snapshot > Get the latest real-time stock price snapshot for any US ticker including open, high, low, and close. ### Overview The Snapshot API lets you pull a price snapshot for a given ticker. We cover all actively traded US stocks. To get started, please create an account and grab your API key at [financialdatasets.ai](https://financialdatasets.ai). You will use the API key to authenticate your API requests. ### Coverage | Tickers | Years of Coverage | Updated | | ------- | ----------------- | --------- | | 13,000+ | Latest | Real-time | ### Available Tickers You can fetch a list of available tickers with a `GET` request to: [https://api.financialdatasets.ai/prices/snapshot/tickers/](https://api.financialdatasets.ai/prices/snapshot/tickers/) ### Getting Started There are only 3 steps for making a successful API call: 1. Add your API key to the header of the request as `X-API-KEY`. 2. Add query params like `ticker` to filter the data. 3. Execute the API request. **Note**: You must provide the `ticker`. ### Example ```python Price Snapshot theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}} import requests # add your API key to the headers headers = { "X-API-KEY": "your_api_key_here" } # set your query params ticker = 'AAPL' # create the URL url = ( f'https://api.financialdatasets.ai/prices/snapshot' f'?ticker={ticker}' ) # make API request response = requests.get(url, headers=headers) # parse snapshot from the response snapshot = response.json().get('snapshot') ``` ## OpenAPI ````yaml GET /prices/snapshot openapi: 3.0.1 info: title: Financial Datasets API description: >- Stock market API with real-time and historical financial data for 27,000+ tickers over 30+ years. Financial statements, equity prices, insider trades, SEC filings, and more. version: 1.0.0 license: name: MIT url: https://opensource.org/licenses/MIT contact: name: API Support url: mailto:support@financialdatasets.ai email: support@financialdatasets.ai termsOfService: https://financialdatasets.ai/terms-of-use servers: - url: https://api.financialdatasets.ai/ description: Production server security: - X-API-KEY: [] tags: - name: Financial Statements description: Access to income statements, balance sheets, and cash flow statements - name: Market Data description: Real-time and historical price data - name: Company Information description: Company facts like ticker, name, and description - name: Earnings description: Earnings data and related information - name: News description: Real-time and historical news articles - name: SEC Filings description: SEC filings and regulatory documents - name: Insider Trades description: Insider trading activity and transactions - name: Activist Ownership description: Activist stakes from SEC Schedule 13D filings, in real time - name: Beneficial Ownership description: >- Holders of more than 5% of a company's shares, from SEC Schedules 13D and 13G - name: Insider Ownership description: Insider ownership statements from SEC Forms 3 and 5 - name: Institutional Holdings description: SEC-direct 13F equity holdings of institutional investment managers - name: Index Funds description: >- ETF and index-fund holdings, weights, and the funds that hold a given security - name: Financial Metrics description: Financial ratios, metrics, and key performance indicators - name: Macroeconomics description: Real-time and historical macroeconomic data like interest rates - name: KPIs description: Sector-specific operational KPIs extracted from earnings releases. paths: /prices/snapshot: get: tags: - Market Data summary: Price Snapshot (Real-Time) description: >- Get the real-time price snapshot for a stock, including the current price, day change, and day change percent. operationId: getPriceSnapshot parameters: - name: ticker in: query description: The stock ticker symbol (e.g. AAPL, MSFT). required: true schema: type: string responses: '200': description: Price snapshot response content: application/json: schema: $ref: '#/components/schemas/PriceSnapshotResponse' '400': $ref: '#/components/responses/BadRequestError' '401': $ref: '#/components/responses/UnauthorizedError' '402': $ref: '#/components/responses/PaymentRequiredError' '404': $ref: '#/components/responses/NotFoundError' components: schemas: PriceSnapshotResponse: type: object properties: snapshot: $ref: '#/components/schemas/PriceSnapshot' PriceSnapshot: type: object properties: price: type: number description: The current price of the stock. ticker: type: string description: The ticker symbol. day_change: type: number description: The price change since the previous trading day's close. day_change_percent: type: number description: The percentage price change since the previous trading day's close. time: type: string description: The timestamp of the price snapshot in human-readable format in UTC. time_milliseconds: type: number description: The timestamp of the price snapshot in milliseconds since epoch. ErrorResponse: type: object properties: error: type: string description: A short error message. message: type: string description: A more detailed error message. responses: BadRequestError: description: Bad request content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: Bad Request message: Invalid request parameters UnauthorizedError: description: Unauthorized content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: Unauthorized message: Invalid API key provided PaymentRequiredError: description: The request requires a paid subscription content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: Payment Required message: >- This endpoint requires a paid subscription. Please upgrade your plan. NotFoundError: description: The specified resource was not found content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: Not Found message: Ticker XXXX not found securitySchemes: X-API-KEY: type: apiKey name: X-API-KEY description: API key for authentication. in: header ````