NAV Navbar
shell
  • Introduction
  • Historical Data
  • Search
  • Market Data Reference
  • Securities Classification
  • Introduction

    Welcome to the Fitch Data API! Access historical data programmatically without having to navigate the data portal.

    Authentication

    API url request format:

    # You need to pass the key parameter as follows with each request
    curl "https://api.fitchdata.com/some_endpoint_here?key=APIKEY"
    

    Make sure to replace APIKEY with your own API key.

    In order to request data from any Fitch Data API endpoint, an API key needs to be provided. All registered users can get their key by visiting the settings page. If are not a Fitch Data Member, you can sign up by creating an account.

    Account Information

    curl "https://api.fitchdata.com/account/access?key=APIKEY"
    

    The above command returns JSON structured like this:

      {
        "success": true,
        "account": {
          "type": "Analyst",
          "status": "Active",
          "limit": 500000
        },
        "month": {
          "start": "2018-01-01 16:00:01",
          "next": "2018-02-01 16:00:01",
          "usage": 2234,
          "usagePercent": 10.2,
          "remaining": 22345
        }
      }
    

    This endpoint returns information relevant to your Fitch Data account including your current monthly usage, account type and account status.

    HTTP Request

    GET https://api.fitchdata.com/account/access

    Query Parameters

    Parameter Required Description
    key Yes Your Fitch Data API key

    Historical Data

    Day Data (EOD)

    curl "https://api.fitchdata.com/pricing/historical/day1?symbol=AAPL&key=APIKEY"
    

    The above command returns JSON structured like this:

      {
        "symbol": "AAPL",
        "startDate": "2018-01-03",
        "endDate": "2018-04-10",
        "resolution": "daily",
        "content": {
          "pre": [...],
          "intra": [...],
          "after": [...],
          "preIntra": [...],
          "preAfter": [...],
          "intraAfter": [...],
          "preIntraAfter": [...]
        }
      }
    

    This endpoint returns daily stock data also known as End of Day (EOD) data for a selected stock. This data is the aggregate of all stock transactions each day represented in Open, High, Low, Close, Volume (OHLCV) format. For each day, data is returned with different market hours combinations.

    HTTP Request

    GET https://api.fitchdata.com/pricing/historical/day1

    Query Parameters

    Parameter Required Description
    key Yes Your API key
    symbol Yes Security ticker/symbol
    start No Starting date of data range
    end No Ending date of data range
    hours No Market hours such as pre-market
    output No Defaults to JSON can be set to CSV

    Minute Data

    curl "https://api.fitchdata.com/pricing/historical/minute1?symbol=TSLA&key=APIKEY"
    

    The above command returns JSON structured like this:

      {
        "symbol": "AAPL",
        "date": "2018-01-03",
        "resolution": "minute",
        "content": {
          "pre": [
            { "date": "2018-01-03", "time": "4:00", "open": 12, "high": 13, "low": 14, "close": 15, "volume": 22304 }
            { "date": "2018-01-03", "time": "4:01", "open": 12, "high": 13, "low": 14, "close": 15, "volume": 22304 }
          ],
          "intra": [
            { "date": "2018-01-03", "time": "9:00", "open": 12, "high": 13, "low": 14, "close": 15, "volume": 22304 }
            { "date": "2018-01-03", "time": "9:01", "open": 12, "high": 13, "low": 14, "close": 15, "volume": 22304 }
          ],
          "after": [
            { "date": "2018-01-03", "time": "16:00", "open": 12, "high": 13, "low": 14, "close": 15, "volume": 22304 }
            { "date": "2018-01-03", "time": "16:01", "open": 12, "high": 13, "low": 14, "close": 15, "volume": 22304 }
          ],
        }
      }
    

    This endpoint returns minute stock data for a selected security. The data is the aggregate of all stock transaction for each minute of the day, represented in Open, High, Low, Close, Volume (OHLCV) format. The data is split into 3 parts according to market hours, that is Pre-Market, Intra-Day and After-Market.

    HTTP Request

    GET https://api.fitchdata.com/pricing/historical/minute1

    Query Parameters

    Parameter Required Description
    key Yes Your API key
    symbol Yes Security ticker/symbol
    day Yes Selected trading day
    hours No Markets Hours such as Pre-Market
    output No Defaults to JSON can be set to CSV

    Tick Data

    curl "https://api.fitchdata.com/api/historical/tick?symbol=AAPL&key=APIKEY"
    

    The above command returns JSON structured like this:

      {
        "symbol": "AAPL",
        "date": "2018-01-03",
        "resolution": "tick",
        "content": {
          "pre": [],
          "intra": [],
          "after": [],
        }
      }
    

    This endpoint returns tick stock data for a selected security. This data is the set of all transactions on every single U.S. exchange along with relevant information about each trade. Just like the minute and day endpoints, tick data is split according to market hours. Bear in mind that tick data can be quite heavy for popular, high volumes stock such as AAPL.

    HTTP Request

    GET https://api.fitchdata.com/api/historical/tick

    Query Parameters

    Parameter Required Description
    key Yes Your API key
    symbol Yes Security ticker/symbol
    day Yes Trading day
    hours No Market hours
    output No Defaults to JSON can be set to CSV

    Search

    Search by ticker/symbol

    curl "https://api.fitchdata.com/open/search/stock1?query=AA&key=APIKEY"
    

    The above command returns JSON structured like this:

      "count": 220,
      "content": [
        {
          "symbol": "AAPL",
          "securityName": "Apple Inc.",
          "securityType": "Common Stock",
          "exchange": "Nasdaq"
        }
        {
          "symbol": "MSFT",
          "securityName": "Microsoft Corp.",
          "securityType": "Common Stock",
          "exchange": "Nasdaq"
        }
      ]
    

    This endpoint retrieves securities with a ticker/symbol matching the specified query term.

    HTTP Request

    GET https://api.fitchdata.com/open/search/stock1

    Query Parameters

    Parameter Required Description
    key Yes Your API key
    query Yes Search query term to match with ticker/symbol

    Stock Information

    curl "https://api.fitchdata.com/open/stock/info?symbol=AAPL&key=APIKEY"
    

    The above command returns JSON structured like this:

      {
        "symbol": "AAPL",
        "securityName": "Apple Inc.",
        "securityType": "Common Stock",
        "calendar": {
            "start": "2013-01-01",
            "end": "2019-01-04"
        } 
      }
    

    This endpoint retrieves information related to the security matching the symbol provided as parameter. This includes the company address, geo-location, contact information and much more.

    HTTP Request

    GET https://api.fitchdata.com/open/stock/info

    Query Parameters

    Parameter Required Description
    key Yes Your API key
    symbol Yes Security ticker/symbol
    curl "https://api.fitchdata.com/search/filter/stocks?key=APIKEY"
    

    The above command returns JSON structured like this:

      "exchange": [],
      "sector": [],
      "industry": [],
      "type": [],
      "status": [],
      "stocks": [
        {
          "symbol": "AAPL",
          "securityName": "Apple Inc.",
          "securityType": "Common Stock",
          "exchange": "Nasdaq",
          "logo": "..."
        }
        {
          "symbol": "MSFT",
          "securityName": "Microsoft Corp.",
          "securityType": "Common Stock",
          "exchange": "Nasdaq",
          "logo": "..."
        }
      ]
    

    This endpoint retrieves all securities that match the specified search parameters. Example: To retrieve all preferred shares traded on NYSE, you can set the "exchange" parameter to "NYSE" and the "type" parameter to "Preferred Stock".

    HTTP Request

    GET https://api.fitchdata.com/search/filter/stocks

    Query Parameters

    Parameter Required Description
    key Yes Your API key
    exchange No Security's listing stock exchange. Example: NYSE
    type No Security's type. Example: ETF
    sector No Security's affiliated sector. Example: Technology
    industry No Security's affiliated industry. Example: Investment Banks
    status No Security's trading status. You can set it to "Active" or "Inactive"

    Market Data Reference

    Market Hours

    U.S. Equity Markets are open from 9:30 am to 4:00 pm each trading day. Trading that occurs before 9:30 am and after 4:00 pm is referred to as Extended Market Hours. In order to give you a full view of historical data, we included extended hours trading to our historical datasets. The following table showcases the different market hours that apply to U.S. Equity markets and the general activity they reflect.

    Name Time Range Activity
    Pre-Market 4:00 am EST to 9:30 am EST Institutional Trades
    Intraday 9:30 am EST to 4:00 pm EST Retail and Institutional Trades
    After-Market 4:00 pm EST to 8:00 pm EST Institutional Trades

    Listed Exchanges

    We cover all U.S. Equities stock exchanges including Tape A, B and C. The following table list those exchanges with their full name for easy navigation when checking the exchange of each transaction through Tick data.

    Exchange Full Name
    NYSE New York Stock Exchange
    NYSE-MKT NYSE Market (Ex- American Stock Exchange)
    NYSE-ARCA NYSE Arca (Ex- Archipelago Exchange)
    NASDAQ NASDAQ Stock Exchange
    NASDAQ-BX NASDAQ BX (Ex- Boston Stock Exchange)
    NASDAQ-PSX NASDAQ PSX (Ex- Philadeliphia Stock Exchange)
    ISE NASDAQ International Securities Exchange
    CHX Chicago Stock Exchange
    CBOE-EDGA Chicago Board Options Exchange Direct Edge A
    CBOE-EDGX Chicago Board Options Exchange Direct Edge B
    CBOE-BYX Chicago Board Options Exchange BYX (Ex- BATS BYX)
    CBOE-BZX Chicago Board Options Exchange BYZ (Ex- BATS BZX)
    FINRA Financial Industry Regulatory Authority (ADF)
    CTS Consolidated Tape System
    IEX The Investor's Exchange

    Securities Classification

    Sectors & Industries

    The following table lists different industry sectors and their corresponding industries. These sectors can be used as a parameters in advanced search to limit results

    Sector Industries
    Consumer Discretionary Apparel, Automobile, Building Materials, Communications, Computers, Consumer Serivces, Durable Goods, Electronics, Equipment, Furnishing, Furniture, Jewelry, Leisure, Lumber & Wood, Motion Pictures, Recreation Services, Retail Ordering, Stores, Other
    Consumer Staples Agriculture, Food & Beverage, Tobacco, Retail, Wholesale
    Energy Coal, Oil & Gas, Other
    Finance Banking, Financial Services, Insurance, Investment Services
    Healthcare Health Services, Healthcare Research, Phrarmaceuticals
    Industrial Chemicals, Construction, Electric, Equipment, Manufacturing Products, Paper, Printing & Publishing, Textile, Other
    Materials Mining, Plastics
    Real Estate Real Estate, Real Estate Agents, Real Estate Developers, Real Estate Lessors, Real Estate Managers, Real Estate Trusts
    Technology Cloud, Hardware, Software, Technology Services
    Transportation Air Transportation, Freight, Railroads, Transportation Equipment, Transportation Services
    Utilities Electric, Electric & Gas, Natural Gas, Power, Sanitary, Water
    Other Unclassified companies according to sector affiliation

    Security Types

    The following table lists different Equity Securities types and their definitions. These types can also be used as parameter for the filtered search endpoint.

    Type Definition
    Common Stock Shares of US companies listed on a US exchange
    Common Stock (ADR) American Depositary Shares - Shares of foreign company listed in the US
    Preferred Stock Shares of a US company that give more features than common shares
    Preferred Stock (ADR) American Depositary Shares - Preferred Shares of a foreign company listed in the US
    ETF Exchange Traded Fund - Basket of stocks generally tracking an index. Includes ETNs
    Fund Funds listed on US exchanges. This includes mutual funds.
    Structured Product Complied product based on a variety of listed financial products.
    Warrant Derivative that allows buyer to acquire a security for a specified price before expiration.
    Other Unclassified Equity Securities listed on US exchanges.