US Stock Quotes

API Introduction

This API provides real-time quote data query service for the US stock market. By passing a stock trading symbol, you can obtain multi-dimensional financial information including real-time price, open price, high/low prices, trading volume, Price-to-Earnings ratio (PE), Earnings Per Share (EPS), total market capitalization, and after-hours trading data. The data covers mainstream US stock symbols and is suitable for business systems requiring integration of US stock market quotes.

Use Cases

• Financial News Applications: Display real-time trends and key financial indicators for individual US stocks in apps or on websites.
• Quantitative Trading Assistance: Provide fundamental price, trading volume, and historical high/low data references for strategy models.
• Portfolio Management: Monitor current market value, change amount, and 52-week price range of held stocks.
• Market Data Analysis: Analyze individual stock liquidity (trading volume) and valuation levels (PE ratio, dividend yield).

Request and Response Description

Request Method: POST Request Parameters:

• symbol (Required): Stock symbol, supports single or multiple codes, separated by English commas (e.g., INTC,AAPL).

Response Results: Upon successful response, the data field will contain a collection of objects keyed by stock symbol. Each object includes the following core fields:

• Price Information: price (real-time price), open (open price), high/low (day's high/low), preclose (previous close).
• Trading Data: volume (trading volume), volume_avg10 (10-day average volume), market_value (total market capitalization).
• Financial Indicators: pe (P/E ratio), eps (EPS), dividend (dividend yield), shares (total shares outstanding).
• After-Hours Data: after_price (after-hours price), after_volume (after-hours volume), after_change (after-hours change amount).

*Note: All numeric fields are returned as strings in the response. Frontend applications should convert them to numeric types as needed.*

Integration Suggestions

1. Batch Query Optimization: The API supports querying multiple symbols separated by commas. It is recommended to combine multiple stock requests on the same page into a single call to reduce network overhead and improve loading speed.
2. Data Refresh Frequency: Given the nature of real-time market data, please set a reasonable frontend polling interval according to business requirements to avoid excessive requests that could lead to resource waste or rate limiting.
3. Error Handling: Always check the code field in the response body (200 indicates success) and properly handle error messages in msg to ensure that individual symbol query failures do not affect overall page rendering.
4. Time Zone Consideration: Returned time fields (e.g., trade_time) are typically in US Eastern Time or UTC. It is recommended to perform time zone conversion when displaying to domestic users.