> ## 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. # Market Snapshot > Get a real-time price snapshot for every actively traded US stock in a single request. ### Overview The Market Snapshot API returns real-time prices for the entire US market in a single call. Each snapshot includes the current price, day change, and day change percent. Requires an active subscription. ### 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 1. Add your API key to the header of the request as `X-API-KEY`. 2. Execute the API request. No query parameters are needed. ### Example ```python Market Snapshot theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}} import requests headers = { "X-API-KEY": "your_api_key_here" } url = "https://api.financialdatasets.ai/prices/snapshot/market" response = requests.get(url, headers=headers) snapshots = response.json().get("snapshots") ``` ### Example Response ```json theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}} { "snapshots": [ { "ticker": "BIRD", "price": 15.26, "day_change": 12.77, "day_change_percent": 512.85, "time": "2026-04-15T22:06:27Z", "time_milliseconds": 1776290787600 }, { "ticker": "BDRX", "price": 3.29, "day_change": 0.04, "day_change_percent": 1.23, "time": "2026-04-15T22:06:25Z", "time_milliseconds": 1776290785553 }, { "ticker": "SKYQ", "price": 11.05, "day_change": 1.85, "day_change_percent": 20.11, "time": "2026-04-15T22:06:25Z", "time_milliseconds": 1776290785498 }, ... ] } ``` ## OpenAPI ````yaml GET /prices/snapshot/market 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/market: get: tags: - Market Data summary: Market Snapshot (Real-Time) description: >- Get the real-time price snapshot for the entire market. Requires an active subscription. operationId: getPriceSnapshotMarket parameters: [] responses: '200': description: Market snapshot response content: application/json: schema: $ref: '#/components/schemas/PriceSnapshotMarketResponse' '401': $ref: '#/components/responses/UnauthorizedError' '402': $ref: '#/components/responses/PaymentRequiredError' '404': $ref: '#/components/responses/NotFoundError' components: schemas: PriceSnapshotMarketResponse: type: object properties: snapshots: type: array items: $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: 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 ````