Service Outages

Market Data, as stated in our terms of service, makes no representation as to the reliability, availability, or timeliness of our service. This is not just a standard disclaimer. We have not yet been able to achieve 99.9% reliability, which is a metric we consider a minimum level of reliability that is needed to operate without a backup provider.

Market Data is a low cost provider and we have determined that cost, rather than reliability, is our key driver. While we hope to achieve 99.9% reliability in the future, our focus will remain on keeping down costs and avoiding price increases for our users.

Recommendation

We highly encourage users with mission critical applications to have a backup provider or utilize Market Data as their secondary provider.

How To Confirm Downtime

Market Data provides real-time status monitoring for each of our API endpoints. You can check the status of individual endpoints either through our status webpage or programmatically via our status API endpoint.

Status Webpage

Visit our status page to view the current status of all Market Data API endpoints, including historical uptime statistics.

• Status Page: https://www.marketdata.app/status/

Confirm Downtime Programmatically

Use the /utilities/status/ endpoint to programmatically check the status of all Market Data API endpoints. This endpoint returns the current status for each endpoint (e.g., /v1/stocks/quotes/, /v1/options/chain/, etc.) and will remain online during outages, allowing you to determine which specific endpoints are affected.

tip

This endpoint is ideal to allow for automatic switching between Market Data and your backup provider when specific endpoints are down.

JavaScript

status.js

import { MarketDataClient } from "@marketdata/sdk";

const client = new MarketDataClient();

// Look up the status of a specific endpoint in the API status response.
function findEndpointStatus(status, endpointPath) {
  const index = status.service.indexOf(endpointPath);
  if (index === -1) return null;
  return {
    online: status.online[index],
    status: status.status[index],
    uptime30d: status.uptimePct30d?.[index],
    uptime90d: status.uptimePct90d?.[index],
  };
}

try {
  const status = await client.utilities.status();

  const stocksQuotes = findEndpointStatus(status, "/v1/stocks/quotes/");
  const optionsChain = findEndpointStatus(status, "/v1/options/chain/");
  const stocksCandles = findEndpointStatus(status, "/v1/stocks/candles/");

  console.log(`Stocks Quotes: ${stocksQuotes ? (stocksQuotes.online ? "Online" : "Offline") : "Not found"}`);
  console.log(`Options Chain: ${optionsChain ? (optionsChain.online ? "Online" : "Offline") : "Not found"}`);
  console.log(`Stocks Candles: ${stocksCandles ? (stocksCandles.online ? "Online" : "Offline") : "Not found"}`);
} catch (error) {
  console.error("Error fetching API status:", error);
}

TypeScript

status.ts

import { MarketDataClient } from "@marketdata/sdk";
import type { ApiStatusResponse } from "@marketdata/sdk";

const client = new MarketDataClient();

// Look up the status of a specific endpoint in the API status response.
function findEndpointStatus(status: ApiStatusResponse, endpointPath: string) {
  const index = status.service.indexOf(endpointPath);
  if (index === -1) return null;
  return {
    online: status.online[index],
    status: status.status[index],
    uptime30d: status.uptimePct30d?.[index],
    uptime90d: status.uptimePct90d?.[index],
  };
}

try {
  const status: ApiStatusResponse = await client.utilities.status();

  const stocksQuotes = findEndpointStatus(status, "/v1/stocks/quotes/");
  const optionsChain = findEndpointStatus(status, "/v1/options/chain/");
  const stocksCandles = findEndpointStatus(status, "/v1/stocks/candles/");

  console.log(`Stocks Quotes: ${stocksQuotes ? (stocksQuotes.online ? "Online" : "Offline") : "Not found"}`);
  console.log(`Options Chain: ${optionsChain ? (optionsChain.online ? "Online" : "Offline") : "Not found"}`);
  console.log(`Stocks Candles: ${stocksCandles ? (stocksCandles.online ? "Online" : "Offline") : "Not found"}`);
} catch (error) {
  console.error("Error fetching API status:", error);
}

Python

status.py

# Importing the required library
import requests

# URL to the status endpoint
url = "https://api.marketdata.app/status/"
json_data = requests.get(url).json()

# Function to check the status of a specific endpoint
def check_endpoint_status(endpoint_path):
    try:
        index = json_data["service"].index(endpoint_path)
        return {
            "online": json_data["online"][index],
            "status": json_data["status"][index],
            "uptime30d": json_data["uptimePct30d"][index],
            "uptime90d": json_data["uptimePct90d"][index]
        }
    except ValueError:
        return None

# Checking the status of specific endpoints
stocks_quotes = check_endpoint_status("/v1/stocks/quotes/")
options_chain = check_endpoint_status("/v1/options/chain/")
stocks_candles = check_endpoint_status("/v1/stocks/candles/")

print(f"Stocks Quotes: {'Online' if stocks_quotes and stocks_quotes['online'] else 'Offline' if stocks_quotes else 'Not found'}")
print(f"Options Chain: {'Online' if options_chain and options_chain['online'] else 'Offline' if options_chain else 'Not found'}")
print(f"Stocks Candles: {'Online' if stocks_candles and stocks_candles['online'] else 'Offline' if stocks_candles else 'Not found'}")

What To Do During Downtime

It is not necessary to advise us of downtime or service outages. We monitor the status of our systems and we investigate and respond to all service outages. During Market Data service outages, we encourage you to switch your systems over to your back-up provider until our systems come back online.