{
  "openapi": "3.1.0",
  "info": {
    "title": "Stock Tickers API",
    "version": "1.0.0",
    "description": "Every US-listed symbol, 13,155 of them, with exchange, ETF flag and SEC CIK, refreshed nightly.\n\nThe complete directory of US-listed securities, refreshed nightly: 13,155 active symbols across Nasdaq (all three tiers), NYSE, NYSE American, NYSE Arca, Cboe BZX and IEX — 5,656 ETFs included — from Nasdaq Trader''s official symbol directories with the SEC CIK crosswalk joined in (7,128 symbols resolve to their EDGAR filer, AAPL to CIK 0000320193 with a ready EDGAR link). Search by symbol or company name with exact-symbol-first ranking; filter by exchange or ETF flag; pull per-exchange listing counts. Delistings actually disappear: the nightly sync upserts the full directory and prunes symbols that vanished, behind a safety valve that refuses any prune touching more than 20% of the table. Test issues are excluded and Nasdaq financial-status codes (Deficient, Delinquent, Bankrupt) arrive decoded. The reference layer every fintech product needs before it can do anything else: symbol validation, autocomplete, ETF screening, CIK resolution for filings pipelines. Pairs with our Company Financials API (10-K numbers for any of these CIKs).",
    "contact": {
      "name": "Data and APIs",
      "url": "https://dataandapis.com/contact"
    },
    "termsOfService": "https://dataandapis.com/terms-of-service",
    "license": {
      "name": "Data and APIs Terms of Service",
      "url": "https://dataandapis.com/terms-of-service"
    },
    "x-logo": {
      "url": "https://dataandapis.com/images/stock-tickers.webp"
    }
  },
  "externalDocs": {
    "description": "Documentation, live tester and pricing",
    "url": "https://dataandapis.com/apis/stock-tickers"
  },
  "servers": [
    {
      "url": "https://api-stock-tickers.dataandapis.com"
    }
  ],
  "tags": [
    {
      "name": "Finance",
      "description": "Stock Tickers API belongs to the Finance category of the Data and APIs catalog."
    }
  ],
  "paths": {
    "/v1/sources": {
      "get": {
        "operationId": "dataSources",
        "summary": "Data Sources",
        "description": "Data Sources endpoint of the Stock Tickers API. Costs 1 token per call.",
        "externalDocs": {
          "url": "https://dataandapis.com/apis/stock-tickers/data-sources"
        },
        "responses": {
          "200": {
            "description": "Successful response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "ok": true,
                  "count": 2,
                  "sources": [
                    {
                      "slug": "nasdaqtrader-symdir",
                      "name": "Nasdaq Trader symbol directories",
                      "publisher": "Nasdaq, Inc.",
                      "licence": "Free public reference data",
                      "source_url": "https://www.nasdaqtrader.com/trader.aspx?id=symboldirdefs",
                      "file_url": "https://www.nasdaqtrader.com/dynamic/SymDir/nasdaqlisted.txt",
                      "cadence": "nightly",
                      "record_count": 13155,
                      "retrieved_at": "2026-09-06"
                    },
                    {
                      "slug": "sec-company-tickers",
                      "name": "SEC company tickers (CIK crosswalk)",
                      "publisher": "US Securities and Exchange Commission",
                      "licence": "US Government work - public domain",
                      "source_url": "https://www.sec.gov/",
                      "file_url": "https://www.sec.gov/files/company_tickers.json",
                      "cadence": "daily",
                      "record_count": 7128,
                      "retrieved_at": "2026-09-06"
                    }
                  ]
                }
              }
            }
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "402": {
            "description": "Subscription past due; the response carries a payment_url"
          },
          "429": {
            "description": "Monthly token allowance exhausted"
          }
        },
        "security": [
          {
            "ApiKey": []
          }
        ]
      }
    },
    "/v1/tickers/{symbol}": {
      "get": {
        "operationId": "getTicker",
        "summary": "Get Ticker",
        "description": "Get Ticker endpoint of the Stock Tickers API. Costs 1 token per call.",
        "externalDocs": {
          "url": "https://dataandapis.com/apis/stock-tickers/get-ticker"
        },
        "parameters": [
          {
            "name": "symbol",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "example": "AAPL"
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "ok": true,
                  "ticker": {
                    "symbol": "AAPL",
                    "name": "Apple Inc. - Common Stock",
                    "exchange": "Nasdaq Global Select Market",
                    "exchange_code": "Q",
                    "etf": false,
                    "round_lot": 40,
                    "financial_status": "Normal",
                    "cik": "0000320193",
                    "sec_name": "Apple Inc.",
                    "edgar_url": "https://www.sec.gov/cgi-bin/browse-edgar?action=getcompany&CIK=0000320193"
                  }
                }
              }
            }
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "402": {
            "description": "Subscription past due; the response carries a payment_url"
          },
          "429": {
            "description": "Monthly token allowance exhausted"
          }
        },
        "security": [
          {
            "ApiKey": []
          }
        ]
      }
    },
    "/v1/tickers/stats": {
      "get": {
        "operationId": "listingStatistics",
        "summary": "Listing Statistics",
        "description": "Listing Statistics endpoint of the Stock Tickers API. Costs 1 token per call.",
        "externalDocs": {
          "url": "https://dataandapis.com/apis/stock-tickers/listing-statistics"
        },
        "responses": {
          "200": {
            "description": "Successful response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "ok": true,
                  "totals": {
                    "total": 13155,
                    "etfs": 5656,
                    "with_cik": 7128
                  },
                  "by_exchange": [
                    {
                      "exchange": "NYSE",
                      "exchange_code": "N",
                      "listings": 2923,
                      "etfs": 78
                    },
                    {
                      "exchange": "NYSE Arca",
                      "exchange_code": "P",
                      "listings": 2727,
                      "etfs": 2710
                    },
                    {
                      "exchange": "Nasdaq Global Market",
                      "exchange_code": "G",
                      "listings": 2470,
                      "etfs": 1258
                    },
                    {
                      "exchange": "Nasdaq Capital Market",
                      "exchange_code": "S",
                      "listings": 1667,
                      "etfs": 0
                    },
                    {
                      "exchange": "Cboe BZX",
                      "exchange_code": "Z",
                      "listings": 1614,
                      "etfs": 1610
                    },
                    {
                      "exchange": "Nasdaq Global Select Market",
                      "exchange_code": "Q",
                      "listings": 1447,
                      "etfs": 0
                    },
                    {
                      "exchange": "NYSE American",
                      "exchange_code": "A",
                      "listings": 307,
                      "etfs": 0
                    }
                  ]
                }
              }
            }
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "402": {
            "description": "Subscription past due; the response carries a payment_url"
          },
          "429": {
            "description": "Monthly token allowance exhausted"
          }
        },
        "security": [
          {
            "ApiKey": []
          }
        ]
      }
    },
    "/v1/tickers": {
      "get": {
        "operationId": "searchTickers",
        "summary": "Search Tickers",
        "description": "Search Tickers endpoint of the Stock Tickers API. Costs 1 token per call.",
        "externalDocs": {
          "url": "https://dataandapis.com/apis/stock-tickers/search-tickers"
        },
        "parameters": [
          {
            "name": "etf",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "exchange",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "example": "20"
          },
          {
            "name": "page",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "example": "1"
          },
          {
            "name": "q",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "example": "apple"
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "ok": true,
                  "total": 6,
                  "page": 1,
                  "limit": 20,
                  "count": 6,
                  "results": [
                    {
                      "symbol": "AAPL",
                      "name": "Apple Inc. - Common Stock",
                      "exchange": "Nasdaq Global Select Market",
                      "exchange_code": "Q",
                      "etf": false,
                      "round_lot": 40,
                      "financial_status": "Normal",
                      "cik": "0000320193",
                      "sec_name": "Apple Inc.",
                      "edgar_url": "https://www.sec.gov/cgi-bin/browse-edgar?action=getcompany&CIK=0000320193"
                    },
                    {
                      "symbol": "AAPX",
                      "name": "T-Rex 2X Long Apple Daily Target ETF",
                      "exchange": "Cboe BZX",
                      "exchange_code": "Z",
                      "etf": true,
                      "round_lot": 100,
                      "financial_status": null,
                      "cik": null,
                      "sec_name": null,
                      "edgar_url": null
                    },
                    {
                      "symbol": "AAPY",
                      "name": "Kurv Yield Premium Strategy Apple (AAPL) ETF",
                      "exchange": "Cboe BZX",
                      "exchange_code": "Z",
                      "etf": true,
                      "round_lot": 100,
                      "financial_status": null,
                      "cik": null,
                      "sec_name": null,
                      "edgar_url": null
                    },
                    {
                      "symbol": "APLE",
                      "name": "Apple Hospitality REIT, Inc. Common Shares",
                      "exchange": "NYSE",
                      "exchange_code": "N",
                      "etf": false,
                      "round_lot": 100,
                      "financial_status": null,
                      "cik": "0001418121",
                      "sec_name": "Apple Hospitality REIT, Inc.",
                      "edgar_url": "https://www.sec.gov/cgi-bin/browse-edgar?action=getcompany&CIK=0001418121"
                    },
                    {
                      "symbol": "MLP",
                      "name": "Maui Land & Pineapple Company, Inc. Common Stock",
                      "exchange": "NYSE",
                      "exchange_code": "N",
                      "etf": false,
                      "round_lot": 100,
                      "financial_status": null,
                      "cik": "0000063330",
                      "sec_name": "MAUI LAND & PINEAPPLE CO INC",
                      "edgar_url": "https://www.sec.gov/cgi-bin/browse-edgar?action=getcompany&CIK=0000063330"
                    },
                    {
                      "symbol": "PAPL",
                      "name": "Pineapple Financial Inc. Common Stock",
                      "exchange": "NYSE American",
                      "exchange_code": "A",
                      "etf": false,
                      "round_lot": 100,
                      "financial_status": null,
                      "cik": "0001938109",
                      "sec_name": "Pineapple Financial Inc.",
                      "edgar_url": "https://www.sec.gov/cgi-bin/browse-edgar?action=getcompany&CIK=0001938109"
                    }
                  ]
                }
              }
            }
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "402": {
            "description": "Subscription past due; the response carries a payment_url"
          },
          "429": {
            "description": "Monthly token allowance exhausted"
          }
        },
        "security": [
          {
            "ApiKey": []
          }
        ]
      }
    }
  },
  "components": {
    "securitySchemes": {
      "ApiKey": {
        "type": "apiKey",
        "in": "header",
        "name": "X-Api-Key",
        "description": "Create a free key at https://dataandapis.com/sign-up. 500 tokens a month on the Free plan; this API costs 1 token per call."
      }
    }
  },
  "security": [
    {
      "ApiKey": []
    }
  ]
}