POSTfinance-us-shares-price
美股报价
美股报价
5 匠币/次
接入文档
接口简介
本接口提供美股市场的实时报价数据查询服务。通过传入股票交易代码(Symbol),可获取包括实时价格、开盘价、最高/最低价、成交量、市盈率(PE)、每股收益(EPS)、总市值以及盘后交易数据在内的多维度金融信息。数据覆盖主流美股标的,适用于需要集成美股行情展示的业务系统。
美股报价
5 匠币/次
本接口提供美股市场的实时报价数据查询服务。通过传入股票交易代码(Symbol),可获取包括实时价格、开盘价、最高/最低价、成交量、市盈率(PE)、每股收益(EPS)、总市值以及盘后交易数据在内的多维度金融信息。数据覆盖主流美股标的,适用于需要集成美股行情展示的业务系统。
请求方式:POST 请求参数:
symbol (必填):股票品种代码,支持单个或多个代码,多个代码间以英文逗号分隔(例如:INTC,AAPL)。返回结果: 成功响应时,data 字段将包含以股票代码为键的对象集合。每个对象包含以下核心字段:
price (实时价格), open (开盘价), high/low (当日高低点), preclose (昨收)。volume (成交量), volume_avg10 (10日均量), market_value (总市值)。pe (市盈率), eps (每股收益), dividend (股息率), shares (总股本)。after_price (盘后价), after_volume (盘后成交量), after_change (盘后涨跌额)。name (中文名称), trade_time (交易时间), (数据更新时间)。*注意:所有数值型字段在响应中均以字符串形式返回,前端使用时需自行转换为数字类型。*
code 字段(200表示成功),并妥善处理 msg 中的错误提示信息,确保在个别代码查询失败时不影响整体页面渲染。trade_time)通常为美东时间或UTC,展示给国内用户时建议进行时区转换处理。提供 Shell、Python、Go、Java、PHP 等常见接入示例,便于直接接到现有项目里。
{
"symbol": "品种代码,以英文逗号分割,如:INTC,AAPL"
}{
"msg": "成功",
"code": 200,
"taskNo": "200966658220607506216602",
"data": {
"AAPL": {
"after_price": "221.0800",
"volume_avg10": "86695457",
"market_value": "3397265867100",
"trade_time": "2024-07-04 01:00:00",
"change": "1.2800",
"eps": "6.46",
"after_volume": "1132411",
"volume": "37369801",
"shares": "15334082000",
"after_change": "-0.47",
"high": "221.5500",
"update_time": "2024-07-04 09:45:24",
"low": "219.0300",
"pe": "34.300000",
"price": "221.5500",
"name": "苹果",
"dividend": "0.25",
"52week_low": "163.8300",
"after_changeRate": "-0.21",
"changeRate": "0.58",
"preclose": "220.2700",
"open": "220.0000",
"52week_high": "221.5500",
"after_time": "2024-07-04 05:00:00"
}
}
}以下字段根据示例 JSON 自动提取,仅作接入参考。
| 字段路径 | 类型 | 示例值 |
|---|---|---|
| type | string | object |
| properties | object | {...} |
| properties.symbol | object | {...} |
| properties.symbol.type | string | string |
| properties.symbol.description | string | 品种代码,以英文逗号分割,如:INTC,AAPL |
| required | array | "symbol" |
| required[] | string | symbol |
以下字段根据示例 JSON 自动提取,仅作接入参考。
| 字段路径 | 类型 | 示例值 |
|---|---|---|
| type | string | object |
| properties | object | {...} |
| properties.msg | object | {...} |
| properties.msg.type | string | string |
| properties.msg.example | string | 成功 |
| properties.msg.description | string | 返回码对应描述 |
| properties.code | object | {...} |
update_timecurl --request POST \
--url 'https://openapi.toolkk.com/v1/finance-us-shares-price' \
--header 'Content-Type: application/json' \
--header 'X-API-Key: YOUR_API_KEY' \
--data '{\n "symbol": "品种代码,以英文逗号分割,如:INTC,AAPL"\n}'import os
import requests
url = "https://openapi.toolkk.com/v1/finance-us-shares-price"
payload = {
"symbol": "品种代码,以英文逗号分割,如:INTC,AAPL"
}
headers = {
"Content-Type": "application/json",
"X-API-Key": os.getenv("TOOLKK_API_KEY", "YOUR_API_KEY"),
}
response = requests.request("POST", url, headers=headers, json=payload, timeout=30)
response.raise_for_status()
print(response.json())package main
import (
"bytes"
"fmt"
"io"
"net/http"
)
func main() {
endpoint := "https://openapi.toolkk.com/v1/finance-us-shares-price"
payload := []byte("{\n \"symbol\": \"品种代码,以英文逗号分割,如:INTC,AAPL\"\n}")
req, err := http.NewRequest("POST", endpoint, bytes.NewBuffer(payload))
if err != nil {
panic(err)
}
req.Header.Set("Content-Type", "application/json")
req.Header.Set("X-API-Key", "YOUR_API_KEY")
resp, err := http.DefaultClient.Do(req)
if err != nil {
panic(err)
}
defer resp.Body.Close()
body, err := io.ReadAll(resp.Body)
if err != nil {
panic(err)
}
fmt.Println(string(body))
}import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
public class ToolkkExample {
public static void main(String[] args) throws Exception {
String payload = "{\n \"symbol\": \"品种代码,以英文逗号分割,如:INTC,AAPL\"\n}";
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create("https://openapi.toolkk.com/v1/finance-us-shares-price"))
.method("POST", HttpRequest.BodyPublishers.ofString(payload))
.header("Content-Type", "application/json")
.header("X-API-Key", "YOUR_API_KEY")
.build();
HttpResponse<String> response = HttpClient.newHttpClient()
.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());
}
}<?php
$endpoint = 'https://openapi.toolkk.com/v1/finance-us-shares-price';
$payload = "{\n \"symbol\": \"品种代码,以英文逗号分割,如:INTC,AAPL\"\n}";
$ch = curl_init($endpoint);
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_CUSTOMREQUEST => 'POST',
CURLOPT_HTTPHEADER => [
'Content-Type: application/json',
'X-API-Key: YOUR_API_KEY',
],
CURLOPT_POSTFIELDS => $payload,
]);
$response = curl_exec($ch);
if ($response === false) {
throw new RuntimeException(curl_error($ch));
}
curl_close($ch);
echo $response;| properties.code.type |
| string |
| number |
| properties.code.example | number | 200 |
| properties.code.description | string | 返回码,详见返回码说明 |
| properties.taskNo | object | {...} |
| properties.taskNo.type | string | string |
| properties.taskNo.example | string | 200966658220607506216602 |
| properties.taskNo.description | string | 本次请求号 |
| properties.data | object | {...} |
| properties.data.type | string | object |