Skip to main content

Get Instruments

The market data request is not supported via Webull OpenAPI at the moment. Please keep tuned.

Interface Description

  • Function description: Query the underlying information according to the security symbol list and security type.

  • Request URL: /instrument/list

  • Request method: The interface provides HTTP and gRPC two protocols for the query. There is no difference between the data queried by the HTTP and gRPC interfaces. The HTTP interface only needs to obtain data through ordinary GET requests, and the gRPC needs to use the Webull SDK to establish a gRPC connection before it can be used.

  • Frequency limit: The calling frequency of each App ID is limited to 60 times per minute.

Request Parameters

ParameterTypeRequired fieldsDescription
symbolsStringYesSecurities symbol, such as: AAPL,GOOG. Multiple symbols should be separated by ",". A single query supports up to 100 symbols.
categoryStringYesSecurity type. Reference: Category,Currently only US_STOCK and US_ETF are supported.

Response Parameter

FieldTypeDescription
nameStringName
symbolStringSecurity symbol, such as AAPL
instrument_idStringUnique identifier for the security
exchange_codeStringExchange code, reference: ExchangeCode
currencyStringCurrency, reference: Currency

Request Example

HTTP

from webullsdktrade.api import API
from webullsdkcore.client import ApiClient
from webullsdkcore.common.region import Region

api_client = ApiClient(your_app_key, your_app_secret, Region.US.value)
api = API(api_client)
response = api.instrument.get_instrument(symbols, category)
if response.status_code == 200:
instruments = response.json()

gRPC

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.instrument.get_instrument(symbols, category)
if response.status_code == 200:
instruments = response.json()

Response Example

[
{
"name":"APPLE INC",
"symbol":"AAPL",
"instrument_id":"913256135",
"exchange_code":"NSQ",
"currency":"USD"
}
]