nyse.com APInyse.com ↗
Access NYSE-listed company data, real-time quotes, trading halts, market movers, holidays, and regulatory notices via 10 structured endpoints.
curl -X GET 'https://api.parse.bot/scraper/125c86d7-ba54-42ab-9785-fbca70c01e03/get_listings?query=APPLE&page_number=0' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for NYSE-listed tickers and instruments. Returns tickers matching the query string against the NYSE quotes collection.
| Param | Type | Description |
|---|---|---|
| query | string | Search query for ticker or company name |
| page_number | integer | Page number for results (0-indexed) |
{
"type": "object",
"fields": {
"results": "array of quote objects with url, name, description, and score",
"totalHits": "integer total number of matching results"
},
"sample": {
"data": {
"results": [
{
"url": "https://www.nyse.com/quote/XNGS:AAPL",
"name": "APPLE INC",
"score": 166.70804,
"description": "APPLE INC"
}
],
"maxScore": 166.70804,
"totalHits": 4,
"pageNumber": 0,
"suggestions": [],
"aggregationsMapList": [
{
"label": "Content Type",
"aggregations": {
"Quote": 4
}
}
]
},
"status": "success"
}
}About the nyse.com API
The NYSE API covers 10 endpoints that surface data directly from nyse.com, including real-time quote details, trading halt records, market movers, and regulatory trader updates. The get_quote_details endpoint alone returns over a dozen fields per symbol — price, volume, dividend yield, beta, EPS, options chains, board members, and historical returns — making it useful for building stock research tools or compliance monitors without manual site navigation.
Quote and Listing Data
The get_listings endpoint accepts a query string and returns matching NYSE instruments as an array of objects with url, name, description, and a relevance score, plus a totalHits count. For deeper data, get_quote_details takes a single symbol parameter (e.g., IBM) and returns a quote object with real-time price, high/low, volume, dividend, yield, beta, and EPS; an options object containing callList and putList arrays; a boardMember object with company profile and directors; quoteHistory with historical prices; and totalReturns with return percentages across multiple time periods.
Trading Halts and Market Status
get_trading_halts_current returns all halts active on the current trading day — each entry includes the issuer name, halt reason, and timestamps — while get_trading_halts_historical adds symbol, halt_date_from, and halt_date_to filter parameters for searching past halt records. get_market_status surfaces historical system notifications (outages, technical issues, resolutions) as an array of objects with publishedDate, subject, body, and associated marketLinks. Pagination on both endpoints is controlled via page_size and page_number.
Market Movers, Holidays, and Trader Notices
get_market_movers returns gainers, losers, and volume leaders with per-symbol fields including lastPrice, change, pctchg, and volume. Filtering by the nyse category is supported. get_market_holidays requires no parameters and returns the full multi-year holiday schedule grouped by year. get_trader_updates delivers regulatory notices — new listings, options changes, self-help declarations — with publishedDate, subject, and body per entry.
Data Products and Site Search
get_data_products_catalog exposes NYSE's catalog of official data products with title, body, finalUrl, and tags per result, paginated via max and offset. search_site provides a global keyword search across NYSE CMS content, returning page-level hits with url, name, description, and score — useful for discovering regulatory documents or announcements not surfaced by the more specific endpoints.
- Screen NYSE-listed stocks by name or ticker using
get_listingsand pull full quote details including EPS and beta for financial modeling. - Monitor active and historical trading halts with
get_trading_halts_currentandget_trading_halts_historicalfor compliance or risk alert systems. - Track daily market movers — top gainers, losers, and volume leaders — using
get_market_moversfor end-of-day summary dashboards. - Fetch options chain data (calls and puts) via
get_quote_detailsto support derivatives research or spread analysis tools. - Retrieve board member and company profile data from
get_quote_detailsfor corporate governance databases. - Automate ingestion of NYSE trader update notices and market status alerts for regulatory monitoring workflows.
- Build an NYSE-aware trading calendar using
get_market_holidaysto skip non-trading days in scheduling logic.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does NYSE have an official developer API?+
What does `get_quote_details` return beyond a stock price?+
quote object, the endpoint returns an options object with full callList and putList arrays, a boardMember object with company profile and director names, quoteHistory with historical price data, and totalReturns with return percentages across multiple periods — all in a single call for a given symbol.How does historical trading halt filtering work?+
get_trading_halts_historical accepts an optional symbol to narrow results to a specific ticker, plus halt_date_from and halt_date_to in YYYY-MM-DD format to constrain the date range. Results are paginated with max_results (records per page) and page_number (1-indexed). The get_trading_halts_current endpoint, by contrast, returns only halts that are active on the current trading day and does not support date filtering.Does the API return pre-market or after-hours quote data?+
get_quote_details endpoint returns data as published on NYSE.com, which reflects regular session quotes. Pre-market and extended-hours data are not currently exposed as distinct fields. You can fork this API on Parse and revise it to add an endpoint targeting extended-hours data if that becomes available on the source.