导入
实时报价
来看看我们如何获取证券的实时报价。
实时报价显示了某一证券在当前时刻的实际价格。这些报价通常会附带额外信息,例如当日最低价、当日最高价以及该证券在交易所的交易量。这类报价对交易者非常有用。
| 参数 | 分类 | 类型 | 描述 |
|---|---|---|---|
| symbols | 必需 | 字符串 | 这是要搜索的证券代码。附录中的表格列出了部分重要证券的代码。 |
| lang | 可选 | 字符串 | 该参数表示希望获取信息的语言;可选值包括 en(英语)、es(西班牙语)、de(德语)、fr(法语)、it(意大利语)和 zh(中文)。附录表格中列出了各语言代码对应的语种。 |
| region | 可选 | 字符串 | 该参数表示希望获取信息的地区;可能的取值包括 AU(澳大利亚)、CA(加拿大)、DE(德国)、ES(西班牙)、FR(法国)、GB(英国)、HK(中国香港)、IN(印度)、IT(意大利)和 US(美国)。附录表格中列出了各地区代码对应的区域。 |
1const endpointUrl = new URL('https://yfapi.net/v6/finance/quote'); 2 3const queryParameters = new URLSearchParams({ 4 lang: 'en', 5 region: 'US', 6 symbols: 'AAPL' // AAPL 是苹果公司(Apple Inc.)的股票代码 7}); 8 9const headerParameters = { 10 'X-API-KEY': '{{API_KEY}}' 11}; 12 13const options = { 14 method: 'GET', 15 headers: headerParameters 16}; 17 18async function fetchQuotes() { 19 try { 20 endpointUrl.search = queryParameters; 21 const response = await fetch(endpointUrl, options); 22 printResponse(response); 23 } catch (error) { 24 printError(error); 25 } 26} 27 28fetchQuotes();
| 响应字段 | 描述 |
|---|---|
| longName | 证券发行方的名称。 |
| quoteType | 所选代码对应的证券类型,例如股票(equity)、ETF、基金等。 |
| bid | 交易者愿意为该证券支付的最高价格。 |
| ask | 交易者愿意出售该证券的最低价格。 |
| bidSize | 愿意以报价中的买入价购买该证券的人数。 |
| askSize | 愿意以报价中的卖出价出售该证券的人数。 |