---
title: Service Outages
sidebar_position: 6
---

import Tabs from "@theme/Tabs";
import TabItem from "@theme/TabItem";

Market Data, as stated in our [terms of service](https://www.marketdata.app/terms/), 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.

:::tip 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](https://www.marketdata.app/status/) to view the current status of all Market Data API endpoints, including historical uptime statistics.

- Status Page: [https://www.marketdata.app/status/](https://www.marketdata.app/status/)

### Confirm Downtime Programmatically

Use the [/utilities/status/ endpoint](/api/utilities/status) 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.
:::

<Tabs>
<TabItem value="NodeJS" label="NodeJS">

```js title="status.js"
// Importing the required library
const axios = require('axios');

// URL to the status endpoint
const url = "https://api.marketdata.app/status/";

// Function to check the status of a specific endpoint
async function checkEndpointStatus(endpointPath) {
    try {
        const response = await axios.get(url);
        const jsonData = response.data;
        const index = jsonData.service.indexOf(endpointPath);

        if (index !== -1) {
            return {
                online: jsonData.online[index],
                status: jsonData.status[index],
                uptime30d: jsonData.uptimePct30d[index],
                uptime90d: jsonData.uptimePct90d[index]
            };
        } else {
            return null;
        }
    } catch (error) {
        console.error("Error fetching API status:", error);
        return null;
    }
}

// Checking the status of specific endpoints
async function checkStatuses() {
    const stocksQuotes = await checkEndpointStatus("/v1/stocks/quotes/");
    const optionsChain = await checkEndpointStatus("/v1/options/chain/");
    const stocksCandles = await checkEndpointStatus("/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"}`);
}

checkStatuses();
```

</TabItem>
<TabItem value="Python" label="Python">

```python title="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'}")
```

</TabItem>
</Tabs>

## 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.
