openapi: 3.2.0
info:
  title: Finage Market Data US Stocks API
  description: Finage is a real-time and historical market data provider covering US and global stocks, forex, cryptocurrencies, indices, ETFs, bonds, and company fundamentals. This OpenAPI was generated by API Evangelist from Finage's own machine-readable docs database (https://api.finage.co.uk/op/v1/endpoints/list — the same JSON the docs at https://finage.co.uk/docs/api render); every path, parameter, and example comes from that source. All endpoints are read-only GET requests authenticated with an apikey query parameter. Responses must be requested with gzip Accept-Encoding (the API returns 406 "GZip compression required" otherwise).
  version: 1.0.0
  contact:
    name: Finage Support
    email: support@finage.co.uk
    url: https://finage.co.uk
  x-apievangelist:
    generated: '2026-07-22'
    method: generated
    source: https://api.finage.co.uk/op/v1/endpoints/list
servers:
- url: https://api.finage.co.uk
security:
- apiKey: []
tags:
- name: US Stocks
paths:
  /last/stock/{symbol}:
    get:
      operationId: stockLastQuote
      summary: Stock Last Quote
      description: You can get the last quote for a symbol with this endpoint.
      tags:
      - US Stocks
      parameters:
      - name: symbol
        in: path
        required: true
        description: 'Symbol Name (eg: AAPL)'
        schema:
          type: string
      responses:
        '200':
          description: Stock Last Quote response.
          content:
            application/json:
              schema:
                type: object
                properties:
                  symbol:
                    type: string
                    description: Symbol Name
                  ask:
                    type: number
                    description: Ask Price
                  bid:
                    type: number
                    description: Bid Price
                  asize:
                    type: integer
                    description: Ask Size
                  bsize:
                    type: integer
                    description: Bid Size
                  timestamp:
                    type: integer
                    format: int64
                    description: Last Update Time
              example:
                symbol: AAPL
                ask: 118.55
                bid: 118.53
                asize: 3
                bsize: 1
                timestamp: 1604710766331
        '401':
          $ref: '#/components/responses/Unauthorized'
  /last/trade/stock/{symbol}:
    get:
      operationId: stockLastTrade
      summary: Stock Last Trade
      description: You can get the last trade for a symbol with this endpoint.
      tags:
      - US Stocks
      parameters:
      - name: symbol
        in: path
        required: true
        description: Symbol Name
        schema:
          type: string
      responses:
        '200':
          description: Stock Last Trade response.
          content:
            application/json:
              schema:
                type: object
                properties:
                  symbol:
                    type: string
                    description: Symbol Name
                  price:
                    type: number
                    description: Trade Price
                  size:
                    type: integer
                    description: Trade Size
                  timestamp:
                    type: integer
                    format: int64
                    description: Last Update Time
              example:
                symbol: AAPL
                price: 131.99
                size: 5
                timestamp: 1608847193770
        '401':
          $ref: '#/components/responses/Unauthorized'
  /agg/stock/{symbol}/{multiply}/{time}/{from}/{to}:
    get:
      operationId: stockMarketAggregatesApi
      summary: Stock Market Aggregates API
      description: With the Stock Market Aggregates endpoint, you can get the OHLCV bars of the stock market.
      tags:
      - US Stocks
      parameters:
      - name: symbol
        in: path
        required: true
        description: Symbol Name
        schema:
          type: string
      - name: multiply
        in: path
        required: true
        description: Time Multiplier
        schema:
          type: string
      - name: time
        in: path
        required: true
        description: Size of the time. [minute, hour, day, week, month, quarter, year]
        schema:
          type: string
      - name: from
        in: path
        required: true
        description: Start date
        schema:
          type: string
      - name: to
        in: path
        required: true
        description: End date
        schema:
          type: string
      - name: limit
        in: query
        required: false
        description: Limit of the results. Default is 100, maximum allowed limit is 50000. Please set a limit if you are using the API in the production.
        schema:
          type: string
      - name: sort
        in: query
        required: false
        description: You can sort the results by timestamp. asc will return ascending results oldest to newest, desc will return descending results newest to oldest. Default is asc.
        schema:
          type: string
      - name: dbt_filter
        in: query
        required: false
        description: Daily-based time filter. You can allow the time filters to filter daily based. Otherwise, the filter will only trim the start and end of the output. Default is false.
        schema:
          type: string
      - name: st
        in: query
        required: false
        description: Start time in UTC. (Eg. 17:30)
        schema:
          type: string
      - name: et
        in: query
        required: false
        description: End time in UTC. (Eg. 17:45)
        schema:
          type: string
      - name: date_format
        in: query
        required: false
        description: 'Choose date format: ''dt'' for datetime or ''ts'' for timestamp. [Default: timestamp]'
        schema:
          type: string
      responses:
        '200':
          description: Stock Market Aggregates API response.
          content:
            application/json:
              schema:
                type: object
                properties:
                  symbol:
                    type: string
                    description: Symbol Name
                  totalResults:
                    type: integer
                    description: Result Count
                  o:
                    type: number
                    description: Open Price
                  h:
                    type: number
                    description: Highest Price
                  l:
                    type: number
                    description: Lowest Price
                  c:
                    type: number
                    description: Close Price
                  v:
                    type: integer
                    description: Volume
                  t:
                    type: integer
                    format: int64
                    description: Timestamp
              example:
                symbol: AAPL
                totalResults: 3
                results:
                - o: 80.88
                  h: 81.19
                  l: 79.7375
                  c: 80.3625
                  v: 118746872
                  t: 1580878800000
                - o: 80.6425
                  h: 81.305
                  l: 80.0662
                  c: 81.3025
                  v: 105392140
                  t: 1580965200000
                - o: 80.5925
                  h: 80.85
                  l: 79.5
                  c: 80.0075
                  v: 117684048
                  t: 1581051600000
        '401':
          $ref: '#/components/responses/Unauthorized'
  /agg/stock/prev-close/{symbol}:
    get:
      operationId: stockMarketPreviousClose
      summary: Stock Market Previous Close
      description: With the Stock Market Previous Close API, you can get the historiacal end of day data and also previous day's last tick bar of the stock market.
      tags:
      - US Stocks
      parameters:
      - name: symbol
        in: path
        required: true
        description: Symbol of the stock
        schema:
          type: string
      responses:
        '200':
          description: Stock Market Previous Close response.
          content:
            application/json:
              schema:
                type: object
                properties:
                  symbol:
                    type: string
                    description: Symbol of the stock
                  totalResults:
                    type: integer
                    description: Total result size
                  o:
                    type: number
                    description: Open price
                  h:
                    type: number
                    description: High price
                  l:
                    type: number
                    description: Low price
                  c:
                    type: number
                    description: Close price
                  v:
                    type: integer
                    description: Volume
                  t:
                    type: integer
                    format: int64
                    description: Timestamp [ms]
              example:
                symbol: AAPL
                totalResults: 1
                results:
                - o: 124.81
                  h: 125.71
                  l: 121.84
                  c: 122.06
                  v: 112966340
                  t: 1614805200000
        '401':
          $ref: '#/components/responses/Unauthorized'
  /snapshot/stock:
    get:
      operationId: stockSnapshotApi
      summary: Stock Snapshot API
      description: Stock Snapshot API will give you access to all U.S Market with one single API request. You can get the latest trades, quotes or both of them with one request.
      tags:
      - US Stocks
      parameters:
      - name: quotes
        in: query
        required: true
        description: Enable or disable last quotes. Default is true.
        schema:
          type: string
      - name: trades
        in: query
        required: true
        description: Enable or disable last trades. Default is false.
        schema:
          type: string
      - name: symbols
        in: query
        required: true
        description: You can get the data from specific symbols by using this query. If you leave it empty, you will get the all available last data. (Separate symbols with commas.)
        schema:
          type: string
      responses:
        '200':
          description: Stock Snapshot API response.
          content:
            application/json:
              schema:
                type: object
                properties:
                  s:
                    type: string
                    description: Stock symbol
                  p:
                    type: number
                    description: Last trade price
                  a:
                    type: number
                    description: Last ask price
                  b:
                    type: number
                    description: Last bid price
                  asz:
                    type: integer
                    description: Ask size
                  bsz:
                    type: integer
                    description: Bid size
                  sz:
                    type: integer
                    description: Trade size
                  t:
                    type: integer
                    format: int64
                    description: Timestamp (microseconds)
                  totalResults:
                    type: integer
                    description: Total incoming symbol number.
              example:
                totalResults: 1
                lastQuotes:
                - s: AAPL
                  a: 215.604252
                  b: 215.407484
                  asz: 1
                  bsz: 5
                  t: 1726494971049
                lastTrades:
                - s: AAPL
                  p: 215.505522
                  sz: 1
                  t: 1726494971049
        '401':
          $ref: '#/components/responses/Unauthorized'
components:
  responses:
    Unauthorized:
      description: Missing or invalid API key, or your plan does not include this market.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          example:
            error: Please use your APIKey to make a request.
  schemas:
    Error:
      type: object
      description: Finage error envelope — a single error string.
      properties:
        error:
          type: string
          description: Human-readable error message.
  securitySchemes:
    apiKey:
      type: apiKey
      name: apikey
      in: query
      description: Finage API key, passed as the apikey query parameter on every request. Get one at https://moon.finage.co.uk/register.
externalDocs:
  description: Finage API documentation
  url: https://finage.co.uk/docs/api