Market Snapshot
The market data request is not supported via Webull OpenAPI at the moment. Please keep tuned.Interface Description
Function description:
- Query the latest stock market snapshots in batches according to the stock code list.
Request URL: /market-data/snapshot
Request method: The interface provides the GRPC protocol for query.
Frequency limit: The calling frequency of each App ID is limited to one time per second.
Request Parameters
Parameter | Type | Required fields | Description |
---|---|---|---|
symbols | String | Yes | List of security codes; for example: single: AAPL multiple: AAPL,GOOG; For each request,up to 100 symbols can be subscribed |
category | String | Yes | Security type. Reference: Category, such as: US_STOCK |
Response Parameter
Field | Type | Description |
---|---|---|
symbol | String | Securities code |
price | String | Current price |
open | String | Opening price: the opening price during the market time in the U.S. market, excluding pre-market and post-market data. If there is no transaction on the day, there is no return value |
high | String | Today's highest price: the highest intraday price in the U.S. market, excluding pre-market and post-market data. If there is no transaction on the day, there is no return value |
low | String | Today's lowest price: the lowest intraday price in the U.S. market, excluding pre-market and post-market data. If there is no transaction on the day, there is no return value |
pre_close | String | Yesterday's closing price |
volume | String | Volume: if there is no transaction on the day, there is no return value |
change | String | The amount of change: if there is no transaction on the day, there is no return value |
change_ratio | String | Change: if there is no transaction on the day, there is no return value |
Request Example
- Python
- Java
from webullsdktrade.grpc_api import API
from webullsdkquotescore.grpc.grpc_client import GrpcApiClient
from webullsdkcore.common.region import Region
grpc_client = GrpcApiClient(your_app_key, your_app_secret, Region.US.value)
api = API(grpc_client)
response = api.market_data.get_snapshot(symbols, category)
if response.status_code == 200:
result = response.json()
try (QuotesApiClient quotesApiClient = QuotesApiClient.builder()
.appKey(Env.APP_KEY)
.appSecret(Env.APP_SECRET)
.regionId(Region.us.name())
.build()) {
List<Snapshot> quotes = quotesApiClient.getSnapshots(symbols, category);
}
Response Example
[
{
"symbol": "AAPL",
"price": "100",
"open": "100",
"high": "105",
"low": "99",
"pre_close": "101",
"volume": "1000",
"change": "1.0",
"change_ratio": "0.05"
}
]