> ## Documentation Index > Fetch the complete documentation index at: https://docs.sanfoundation.com/llms.txt > Use this file to discover all available pages before exploring further. # Get a finance quote > Retrieve a quote, price chart, and available market context. Use a symbol such as `AAPL:NASDAQ`, `EUR-USD`, or `BTC-USD`. Company names are not supported. `change` and `change_percent` are signed numbers. Keep the available timestamp and market context with a quote, and handle missing prices without substituting zero. Statistics and financial statements retain their displayed units and formatting. A completed lookup with no quote returns `404` and counts toward quota. Use [web fetch](https://docs.sanfoundation.com/api-reference/web-fetch.md) to read linked news stories. ## OpenAPI ````yaml https://api.sanfoundation.com/openapi.json GET /v1/finance/quote openapi: 3.0.0 info: title: SAN API description: >- Web data and context for agents, served by a network of miners running real browsers on residential connections. One resource per thing an agent asks for: search the web, read the news, find places, hotels and flights, and quote a symbol. Present an API key as `Authorization: Bearer san_...`. Every response is snake_case JSON and every error is `{ error: { code, message, param } }`. version: 0.0.1 contact: {} servers: [] security: [] tags: - name: web description: Web search - name: news description: News search - name: places description: Places search - name: hotels description: Stays search - name: flights description: Flight search - name: finance description: Quotes and charts - name: shopping description: Products and sellers - name: account description: Plan and remaining budget paths: /v1/finance/quote: get: tags: - finance summary: Quote and chart for one symbol description: >- The current price for a ticker, index, currency pair or crypto pair, with a chart series for the requested window, headline statistics, recent stories and published financials. operationId: FinanceController_quote parameters: - name: window required: false in: query description: Chart range. Defaults to 1D and is always echoed back. schema: enum: - 1D - 5D - 1M - 6M - YTD - 1Y - 5Y - MAX type: string - name: symbol required: true in: query description: >- A ticker, not free text. `AAPL:NASDAQ`, `.DJI:INDEXDJX`, `EUR-USD`, `BTC-USD`, or a bare `AAPL`. schema: example: AAPL:NASDAQ type: string responses: '200': description: '' content: application/json: schema: $ref: '#/components/schemas/FinanceQuoteResponseDto' '400': description: A parameter is missing, invalid or not recognized. content: application/json: schema: $ref: '#/components/schemas/PublicErrorDto' '401': description: Invalid API key. content: application/json: schema: $ref: '#/components/schemas/PublicErrorDto' '404': description: No quote exists for this symbol. content: application/json: schema: $ref: '#/components/schemas/PublicErrorDto' '429': description: Monthly quota exhausted. Hard stop, no overage. content: application/json: schema: $ref: '#/components/schemas/PublicErrorDto' '503': description: No miner and no fallback could serve the request. content: application/json: schema: $ref: '#/components/schemas/PublicErrorDto' security: - api_key: [] - x-api-key: [] components: schemas: FinanceQuoteResponseDto: type: object properties: id: type: string format: uuid description: Id of this request. Quote it when reporting a problem. took_ms: type: number example: 1420 description: How long the request took, in milliseconds. request: type: object additionalProperties: true description: >- The parameters as accepted, after defaults and normalization. What the request actually ran with. example: query: coffee country: us page: 1 quote: $ref: '#/components/schemas/FinanceQuoteDto' chart: description: The series for the requested `window`, oldest point first. type: array items: $ref: '#/components/schemas/FinanceChartPointDto' stats: type: object additionalProperties: type: string description: >- Headline statistics as flat keys, e.g. `market_cap`, `pe_ratio`, `dividend_yield`. Values are shown exactly as they are published. example: market_cap: 4.09T pe_ratio: '25.43' avg_volume: 31.51M about: $ref: '#/components/schemas/FinanceAboutDto' news: type: array items: $ref: '#/components/schemas/FinanceNewsDto' financials: type: array items: $ref: '#/components/schemas/FinanceFinancialsDto' related: description: Other symbols shown beside this one. type: array items: $ref: '#/components/schemas/FinanceRelatedDto' required: - id - took_ms - request - quote - chart PublicErrorDto: type: object properties: error: $ref: '#/components/schemas/PublicErrorBodyDto' required: - error FinanceQuoteDto: type: object properties: symbol: type: string example: GOOGL name: type: string example: Alphabet Inc Class A exchange: type: string example: NASDAQ price: type: number example: 338.36 currency: type: string example: USD description: ISO 4217. The empty string for an index, which has none. change: type: number example: -0.1 change_percent: type: number example: -0.03 direction: type: string enum: - up - down example: down as_of: type: string example: '2026-09-08T16:00:01-04:00' description: When the quote was taken, ISO 8601 with the market offset. market: description: The pre or after hours quote, when the market is closed. allOf: - $ref: '#/components/schemas/FinanceMarketDto' notes: example: - 'Closed: Sep 8, 4:00 PM EDT' description: Free text lines shown under the price. type: array items: type: string required: - symbol - name FinanceChartPointDto: type: object properties: date: type: string example: '2026-09-08T09:30:00-04:00' price: type: number example: 337.11 volume: type: number example: 1204300 required: - date - price FinanceAboutDto: type: object properties: title: type: string example: About Alphabet Inc Class A description: type: string example: Alphabet Inc. is a holding company. description_link: type: string example: https://example.com/about info: type: array items: $ref: '#/components/schemas/FinanceAboutInfoDto' required: - title - info FinanceNewsDto: type: object properties: title: type: string example: Alphabet shares rise on cloud growth link: type: string example: https://example.com/story source: type: string example: Reuters date: type: string example: 17 minutes ago thumbnail: type: string required: - title - link FinanceFinancialsDto: type: object properties: title: type: string example: Income statement periods: type: array items: $ref: '#/components/schemas/FinanceFinancialPeriodDto' required: - title - periods FinanceRelatedDto: type: object properties: title: type: string example: You may be interested in items: type: array items: $ref: '#/components/schemas/FinanceRelatedItemDto' required: - items PublicErrorBodyDto: type: object properties: code: type: string enum: - unauthorized - missing_parameter - invalid_parameter - not_found - quota_exceeded - rate_limited - unavailable - expired - internal_error example: missing_parameter message: type: string example: Missing parameter `query`. param: type: string example: query description: The parameter at fault, when one parameter is at fault. required: - code - message FinanceMarketDto: type: object properties: price: type: number example: 338.9 currency: type: string example: USD change: type: number example: 0.54 change_percent: type: number example: 0.16 direction: type: string enum: - up - down example: up label: type: string example: After hours FinanceAboutInfoDto: type: object properties: label: type: string example: CEO value: type: string example: Sundar Pichai link: type: string example: https://example.com required: - label - value FinanceFinancialPeriodDto: type: object properties: date: type: string example: Jun 2026 period_type: type: string example: Quarterly rows: type: array items: $ref: '#/components/schemas/FinanceFinancialRowDto' required: - date - period_type - rows FinanceRelatedItemDto: type: object properties: symbol: type: string example: GOOG:NASDAQ name: type: string example: Alphabet Inc Class C price: type: number example: 339.1 currency: type: string example: USD change: type: number example: 1.2 change_percent: type: number example: 0.35 direction: type: string enum: - up - down example: up required: - symbol FinanceFinancialRowDto: type: object properties: title: type: string example: Revenue value: type: string example: 96.43B change: type: string example: 13.79% required: - title - value securitySchemes: api_key: scheme: bearer bearerFormat: JWT type: http description: 'Public API key: `Authorization: Bearer san_...`.' x-api-key: type: apiKey in: header name: X-Api-Key description: The same public API key, as a header. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.