Back to Details

us-realtime-quote

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

US Realtime Quote — 美股实时行情

美股实时行情

所有接口均为 V2 版本（
/api/v2/...
）。
所有接口均为 V2 版本（
/api/v2/...
）。

Curl Setup

Curl 配置

bash
BASE="http://43.167.234.49:3101"
AUTH=(-H "X-API-Key: 123456" -H "Content-Type: application/json")
bash
BASE="http://43.167.234.49:3101"
AUTH=(-H "X-API-Key: 123456" -H "Content-Type: application/json")

代码格式规则

代码格式规则

规则值
参数名
codes
代码格式Ticker 符号
单次上限500 个代码
分隔符英文逗号
示例说明
AAPL
Apple Inc.
TSLA
Tesla
MSFT
Microsoft
美股使用标准 Ticker 符号，无后缀混淆风险。
规则值
参数名
codes
代码格式Ticker 符号
单次上限500 个代码
分隔符英文逗号
示例说明
AAPL
苹果公司
TSLA
特斯拉
MSFT
微软
美股使用标准 Ticker 符号，无后缀混淆风险。

端点详情

接口端点详情

GET /api/v2/usstock/securities

GET /api/v2/usstock/securities

批量查询美股实时报价。价格字段已按 power 动态换算，百分比字段已除以 100。
ParameterTypeRequiredDescription
codes
stringYesTicker 符号，逗号分隔（如 
AAPL,TSLA,MSFT
）
fields
stringNo指定返回字段，逗号分隔（不传返回全部）
批量查询美股实时报价。价格字段已按 power 动态换算，百分比字段已除以 100。
参数类型是否必填描述
codes
string是Ticker 符号，逗号分隔（如 
AAPL,TSLA,MSFT
）
fields
string否指定返回字段，逗号分隔（不传返回全部）

调用示例

调用示例

bash
undefined
bash
undefined

查询单只股票

查询单只股票

curl -sS "${AUTH[@]}" "$BASE/api/v2/usstock/securities?codes=AAPL"
curl -sS "${AUTH[@]}" "$BASE/api/v2/usstock/securities?codes=AAPL"

批量查询

批量查询

curl -sS "${AUTH[@]}" "$BASE/api/v2/usstock/securities?codes=AAPL,TSLA,MSFT"
curl -sS "${AUTH[@]}" "$BASE/api/v2/usstock/securities?codes=AAPL,TSLA,MSFT"

只查指定字段

只查指定字段

curl -sS "${AUTH[@]}" "$BASE/api/v2/usstock/securities?codes=AAPL&fields=price,chgPct,volume"
curl -sS "${AUTH[@]}" "$BASE/api/v2/usstock/securities?codes=AAPL&fields=price,chgPct,volume"

多股票并行

多股票并行

curl -sS "${AUTH[@]}" "$BASE/api/v2/usstock/securities?codes=AAPL" & curl -sS "${AUTH[@]}" "$BASE/api/v2/usstock/securities?codes=TSLA" & wait

**响应示例**：

```json
{
  "success": true,
  "data": {
    "AAPL": {
      "name": "Apple Inc.",
      "price": 178.50,
      "chgPct": 0.85,
      "volume": 52000000
    }
  },
  "timestamp": 1710865200000
}
curl -sS "${AUTH[@]}" "$BASE/api/v2/usstock/securities?codes=AAPL" & curl -sS "${AUTH[@]}" "$BASE/api/v2/usstock/securities?codes=TSLA" & wait

**响应示例**：

```json
{
  "success": true,
  "data": {
    "AAPL": {
      "name": "Apple Inc.",
      "price": 178.50,
      "chgPct": 0.85,
      "volume": 52000000
    }
  },
  "timestamp": 1710865200000
}

错误排查

错误排查

错误原因修复
返回空数据Ticker 符号错误检查大小写和拼写
400API key 无效联系管理员检查 API Key
错误原因修复方案
返回空数据Ticker 符号错误检查大小写和拼写
400API key 无效联系管理员检查 API Key