Endpoint reference

# 免费端点：无需 API Key（匿名即可调用）
curl "https://api.ashareapi.com/v1/health"

import requests

r = requests.get(
    "https://api.ashareapi.com/v1/health",
    params={},
    timeout=30,
)
print(r.json())

const r = await fetch("https://api.ashareapi.com/v1/health");
console.log(await r.json());

# 免费端点：无需 API Key（匿名即可调用）
curl "https://api.ashareapi.com/v1/challenge?difficulty=0"

import requests

r = requests.get(
    "https://api.ashareapi.com/v1/challenge",
    params={},
    timeout=30,
)
print(r.json())

const r = await fetch("https://api.ashareapi.com/v1/challenge?difficulty=0");
console.log(await r.json());

# 免费端点：无需 API Key（匿名即可调用）
curl "https://api.ashareapi.com/v1/quote?code=sh600667"

import requests

r = requests.get(
    "https://api.ashareapi.com/v1/quote",
    params={"code": "sh600667"},
    timeout=30,
)
print(r.json())

const r = await fetch("https://api.ashareapi.com/v1/quote?code=sh600667");
console.log(await r.json());

# 免费端点：无需 API Key（匿名即可调用）
curl "https://api.ashareapi.com/v1/kline?code=sh600667&period=day"

import requests

r = requests.get(
    "https://api.ashareapi.com/v1/kline",
    params={"code": "sh600667"},
    timeout=30,
)
print(r.json())

const r = await fetch("https://api.ashareapi.com/v1/kline?code=sh600667&period=day");
console.log(await r.json());

# 免费端点：无需 API Key（匿名即可调用）
curl "https://api.ashareapi.com/v1/hot?limit=10"

import requests

r = requests.get(
    "https://api.ashareapi.com/v1/hot",
    params={},
    timeout=30,
)
print(r.json())

const r = await fetch("https://api.ashareapi.com/v1/hot?limit=10");
console.log(await r.json());

# 免费端点：无需 API Key（匿名即可调用）
curl "https://api.ashareapi.com/v1/market-overview?type=institution"

import requests

r = requests.get(
    "https://api.ashareapi.com/v1/market-overview",
    params={},
    timeout=30,
)
print(r.json())

const r = await fetch("https://api.ashareapi.com/v1/market-overview?type=institution");
console.log(await r.json());

# 免费端点：无需 API Key（匿名即可调用）
curl "https://api.ashareapi.com/v1/changedist"

import requests

r = requests.get(
    "https://api.ashareapi.com/v1/changedist",
    params={},
    timeout=30,
)
print(r.json())

const r = await fetch("https://api.ashareapi.com/v1/changedist");
console.log(await r.json());

# 推荐：Authorization 头（密钥不进日志）
curl -H "Authorization: Bearer YOUR_KEY" \
  "https://api.ashareapi.com/v1/finance?code=sh600667&num=4"

# 快速测试：直接浏览器打开（?key= 会留在日志/历史里，别用于生产）
curl "https://api.ashareapi.com/v1/finance?code=sh600667&num=4&key=YOUR_KEY"

import requests

r = requests.get(
    "https://api.ashareapi.com/v1/finance",
    headers={"Authorization": "Bearer YOUR_KEY"},
    params={"code": "sh600667"},
    timeout=30,
)
print(r.json())

const r = await fetch("https://api.ashareapi.com/v1/finance?code=sh600667&num=4", {
  headers: { Authorization: "Bearer YOUR_KEY" },
});
console.log(await r.json());

# 推荐：Authorization 头（密钥不进日志）
curl -H "Authorization: Bearer YOUR_KEY" \
  "https://api.ashareapi.com/v1/fund?code=sh600667"

# 快速测试：直接浏览器打开（?key= 会留在日志/历史里，别用于生产）
curl "https://api.ashareapi.com/v1/fund?code=sh600667&key=YOUR_KEY"

import requests

r = requests.get(
    "https://api.ashareapi.com/v1/fund",
    headers={"Authorization": "Bearer YOUR_KEY"},
    params={"code": "sh600667"},
    timeout=30,
)
print(r.json())

const r = await fetch("https://api.ashareapi.com/v1/fund?code=sh600667", {
  headers: { Authorization: "Bearer YOUR_KEY" },
});
console.log(await r.json());

# 推荐：Authorization 头（密钥不进日志）
curl -H "Authorization: Bearer YOUR_KEY" \
  "https://api.ashareapi.com/v1/technical?code=sh600667"

# 快速测试：直接浏览器打开（?key= 会留在日志/历史里，别用于生产）
curl "https://api.ashareapi.com/v1/technical?code=sh600667&key=YOUR_KEY"

import requests

r = requests.get(
    "https://api.ashareapi.com/v1/technical",
    headers={"Authorization": "Bearer YOUR_KEY"},
    params={"code": "sh600667"},
    timeout=30,
)
print(r.json())

const r = await fetch("https://api.ashareapi.com/v1/technical?code=sh600667", {
  headers: { Authorization: "Bearer YOUR_KEY" },
});
console.log(await r.json());

# 推荐：Authorization 头（密钥不进日志）
curl -H "Authorization: Bearer YOUR_KEY" \
  "https://api.ashareapi.com/v1/shareholder?code=sh600667"

# 快速测试：直接浏览器打开（?key= 会留在日志/历史里，别用于生产）
curl "https://api.ashareapi.com/v1/shareholder?code=sh600667&key=YOUR_KEY"

import requests

r = requests.get(
    "https://api.ashareapi.com/v1/shareholder",
    headers={"Authorization": "Bearer YOUR_KEY"},
    params={"code": "sh600667"},
    timeout=30,
)
print(r.json())

const r = await fetch("https://api.ashareapi.com/v1/shareholder?code=sh600667", {
  headers: { Authorization: "Bearer YOUR_KEY" },
});
console.log(await r.json());

# 推荐：Authorization 头（密钥不进日志）
curl -H "Authorization: Bearer YOUR_KEY" \
  "https://api.ashareapi.com/v1/chip?code=sh600667"

# 快速测试：直接浏览器打开（?key= 会留在日志/历史里，别用于生产）
curl "https://api.ashareapi.com/v1/chip?code=sh600667&key=YOUR_KEY"

import requests

r = requests.get(
    "https://api.ashareapi.com/v1/chip",
    headers={"Authorization": "Bearer YOUR_KEY"},
    params={"code": "sh600667"},
    timeout=30,
)
print(r.json())

const r = await fetch("https://api.ashareapi.com/v1/chip?code=sh600667", {
  headers: { Authorization: "Bearer YOUR_KEY" },
});
console.log(await r.json());

# 推荐：Authorization 头（密钥不进日志）
curl -H "Authorization: Bearer YOUR_KEY" \
  "https://api.ashareapi.com/v1/orderbook?code=sh600667"

# 快速测试：直接浏览器打开（?key= 会留在日志/历史里，别用于生产）
curl "https://api.ashareapi.com/v1/orderbook?code=sh600667&key=YOUR_KEY"

import requests

r = requests.get(
    "https://api.ashareapi.com/v1/orderbook",
    headers={"Authorization": "Bearer YOUR_KEY"},
    params={"code": "sh600667"},
    timeout=30,
)
print(r.json())

const r = await fetch("https://api.ashareapi.com/v1/orderbook?code=sh600667", {
  headers: { Authorization: "Bearer YOUR_KEY" },
});
console.log(await r.json());

# 推荐：Authorization 头（密钥不进日志）
curl -H "Authorization: Bearer YOUR_KEY" \
  "https://api.ashareapi.com/v1/snapshot?code=sh600667"

# 快速测试：直接浏览器打开（?key= 会留在日志/历史里，别用于生产）
curl "https://api.ashareapi.com/v1/snapshot?code=sh600667&key=YOUR_KEY"

import requests

r = requests.get(
    "https://api.ashareapi.com/v1/snapshot",
    headers={"Authorization": "Bearer YOUR_KEY"},
    params={"code": "sh600667"},
    timeout=30,
)
print(r.json())

const r = await fetch("https://api.ashareapi.com/v1/snapshot?code=sh600667", {
  headers: { Authorization: "Bearer YOUR_KEY" },
});
console.log(await r.json());

# 推荐：Authorization 头（密钥不进日志）
curl -H "Authorization: Bearer YOUR_KEY" \
  "https://api.ashareapi.com/v1/events?code=sh600667"

# 快速测试：直接浏览器打开（?key= 会留在日志/历史里，别用于生产）
curl "https://api.ashareapi.com/v1/events?code=sh600667&key=YOUR_KEY"

import requests

r = requests.get(
    "https://api.ashareapi.com/v1/events",
    headers={"Authorization": "Bearer YOUR_KEY"},
    params={"code": "sh600667"},
    timeout=30,
)
print(r.json())

const r = await fetch("https://api.ashareapi.com/v1/events?code=sh600667", {
  headers: { Authorization: "Bearer YOUR_KEY" },
});
console.log(await r.json());

# 推荐：Authorization 头（密钥不进日志）
curl -H "Authorization: Bearer YOUR_KEY" \
  "https://api.ashareapi.com/v1/lhb?type=institution"

# 快速测试：直接浏览器打开（?key= 会留在日志/历史里，别用于生产）
curl "https://api.ashareapi.com/v1/lhb?type=institution&key=YOUR_KEY"

import requests

r = requests.get(
    "https://api.ashareapi.com/v1/lhb",
    headers={"Authorization": "Bearer YOUR_KEY"},
    params={},
    timeout=30,
)
print(r.json())

const r = await fetch("https://api.ashareapi.com/v1/lhb?type=institution", {
  headers: { Authorization: "Bearer YOUR_KEY" },
});
console.log(await r.json());

# 注：expr 的值已做 URL 编码（含 [ ] 空格 等）
# 推荐：Authorization 头（密钥不进日志）
curl -H "Authorization: Bearer YOUR_KEY" \
  "https://api.ashareapi.com/v1/screen?expr=intersect(%5BPE_TTM%20%3E%200%2C%20PE_TTM%20%3C%2020%2C%20ROETTM%20%3E%2015%5D)"

# 快速测试：直接浏览器打开（?key= 会留在日志/历史里，别用于生产）
curl "https://api.ashareapi.com/v1/screen?expr=intersect(%5BPE_TTM%20%3E%200%2C%20PE_TTM%20%3C%2020%2C%20ROETTM%20%3E%2015%5D)&key=YOUR_KEY"

import requests

r = requests.get(
    "https://api.ashareapi.com/v1/screen",
    headers={"Authorization": "Bearer YOUR_KEY"},
    params={},
    timeout=30,
)
print(r.json())

const r = await fetch("https://api.ashareapi.com/v1/screen?expr=intersect(%5BPE_TTM%20%3E%200%2C%20PE_TTM%20%3C%2020%2C%20ROETTM%20%3E%2015%5D)", {
  headers: { Authorization: "Bearer YOUR_KEY" },
});
console.log(await r.json());

# 推荐：Authorization 头（密钥不进日志）
curl -H "Authorization: Bearer YOUR_KEY" \
  "https://api.ashareapi.com/v1/sector"

# 快速测试：直接浏览器打开（?key= 会留在日志/历史里，别用于生产）
curl "https://api.ashareapi.com/v1/sector?key=YOUR_KEY"

import requests

r = requests.get(
    "https://api.ashareapi.com/v1/sector",
    headers={"Authorization": "Bearer YOUR_KEY"},
    params={},
    timeout=30,
)
print(r.json())

const r = await fetch("https://api.ashareapi.com/v1/sector", {
  headers: { Authorization: "Bearer YOUR_KEY" },
});
console.log(await r.json());

# 推荐：Authorization 头（密钥不进日志）
curl -H "Authorization: Bearer YOUR_KEY" \
  "https://api.ashareapi.com/v1/industry-chain?mode=list"

# 快速测试：直接浏览器打开（?key= 会留在日志/历史里，别用于生产）
curl "https://api.ashareapi.com/v1/industry-chain?mode=list&key=YOUR_KEY"

import requests

r = requests.get(
    "https://api.ashareapi.com/v1/industry-chain",
    headers={"Authorization": "Bearer YOUR_KEY"},
    params={},
    timeout=30,
)
print(r.json())

const r = await fetch("https://api.ashareapi.com/v1/industry-chain?mode=list", {
  headers: { Authorization: "Bearer YOUR_KEY" },
});
console.log(await r.json());

# 推荐：Authorization 头（密钥不进日志）
curl -H "Authorization: Bearer YOUR_KEY" \
  "https://api.ashareapi.com/v1/sector-valuation?code=sh600667"

# 快速测试：直接浏览器打开（?key= 会留在日志/历史里，别用于生产）
curl "https://api.ashareapi.com/v1/sector-valuation?code=sh600667&key=YOUR_KEY"

import requests

r = requests.get(
    "https://api.ashareapi.com/v1/sector-valuation",
    headers={"Authorization": "Bearer YOUR_KEY"},
    params={"code": "sh600667"},
    timeout=30,
)
print(r.json())

const r = await fetch("https://api.ashareapi.com/v1/sector-valuation?code=sh600667", {
  headers: { Authorization: "Bearer YOUR_KEY" },
});
console.log(await r.json());

# 推荐：Authorization 头（密钥不进日志）
curl -H "Authorization: Bearer YOUR_KEY" \
  "https://api.ashareapi.com/v1/macro?region=cn"

# 快速测试：直接浏览器打开（?key= 会留在日志/历史里，别用于生产）
curl "https://api.ashareapi.com/v1/macro?region=cn&key=YOUR_KEY"

import requests

r = requests.get(
    "https://api.ashareapi.com/v1/macro",
    headers={"Authorization": "Bearer YOUR_KEY"},
    params={},
    timeout=30,
)
print(r.json())

const r = await fetch("https://api.ashareapi.com/v1/macro?region=cn", {
  headers: { Authorization: "Bearer YOUR_KEY" },
});
console.log(await r.json());

# 推荐：Authorization 头（密钥不进日志）
curl -H "Authorization: Bearer YOUR_KEY" \
  "https://api.ashareapi.com/v1/bond?code=sh600667"

# 快速测试：直接浏览器打开（?key= 会留在日志/历史里，别用于生产）
curl "https://api.ashareapi.com/v1/bond?code=sh600667&key=YOUR_KEY"

import requests

r = requests.get(
    "https://api.ashareapi.com/v1/bond",
    headers={"Authorization": "Bearer YOUR_KEY"},
    params={"code": "sh600667"},
    timeout=30,
)
print(r.json())

const r = await fetch("https://api.ashareapi.com/v1/bond?code=sh600667", {
  headers: { Authorization: "Bearer YOUR_KEY" },
});
console.log(await r.json());

# 推荐：Authorization 头（密钥不进日志）
curl -H "Authorization: Bearer YOUR_KEY" \
  "https://api.ashareapi.com/v1/etf?code=sh600667"

# 快速测试：直接浏览器打开（?key= 会留在日志/历史里，别用于生产）
curl "https://api.ashareapi.com/v1/etf?code=sh600667&key=YOUR_KEY"

import requests

r = requests.get(
    "https://api.ashareapi.com/v1/etf",
    headers={"Authorization": "Bearer YOUR_KEY"},
    params={"code": "sh600667"},
    timeout=30,
)
print(r.json())

const r = await fetch("https://api.ashareapi.com/v1/etf?code=sh600667", {
  headers: { Authorization: "Bearer YOUR_KEY" },
});
console.log(await r.json());

# 推荐：Authorization 头（密钥不进日志）
curl -H "Authorization: Bearer YOUR_KEY" \
  "https://api.ashareapi.com/v1/ipo?days=15"

# 快速测试：直接浏览器打开（?key= 会留在日志/历史里，别用于生产）
curl "https://api.ashareapi.com/v1/ipo?days=15&key=YOUR_KEY"

import requests

r = requests.get(
    "https://api.ashareapi.com/v1/ipo",
    headers={"Authorization": "Bearer YOUR_KEY"},
    params={},
    timeout=30,
)
print(r.json())

const r = await fetch("https://api.ashareapi.com/v1/ipo?days=15", {
  headers: { Authorization: "Bearer YOUR_KEY" },
});
console.log(await r.json());

# 推荐：Authorization 头（密钥不进日志）
curl -H "Authorization: Bearer YOUR_KEY" \
  "https://api.ashareapi.com/v1/dividend?code=sh600667&years=3"

# 快速测试：直接浏览器打开（?key= 会留在日志/历史里，别用于生产）
curl "https://api.ashareapi.com/v1/dividend?code=sh600667&years=3&key=YOUR_KEY"

import requests

r = requests.get(
    "https://api.ashareapi.com/v1/dividend",
    headers={"Authorization": "Bearer YOUR_KEY"},
    params={"code": "sh600667"},
    timeout=30,
)
print(r.json())

const r = await fetch("https://api.ashareapi.com/v1/dividend?code=sh600667&years=3", {
  headers: { Authorization: "Bearer YOUR_KEY" },
});
console.log(await r.json());

# 推荐：Authorization 头（密钥不进日志）
curl -H "Authorization: Bearer YOUR_KEY" \
  "https://api.ashareapi.com/v1/dehydrated?mode=list"

# 快速测试：直接浏览器打开（?key= 会留在日志/历史里，别用于生产）
curl "https://api.ashareapi.com/v1/dehydrated?mode=list&key=YOUR_KEY"

import requests

r = requests.get(
    "https://api.ashareapi.com/v1/dehydrated",
    headers={"Authorization": "Bearer YOUR_KEY"},
    params={},
    timeout=30,
)
print(r.json())

const r = await fetch("https://api.ashareapi.com/v1/dehydrated?mode=list", {
  headers: { Authorization: "Bearer YOUR_KEY" },
});
console.log(await r.json());

# 推荐：Authorization 头（密钥不进日志）
curl -H "Authorization: Bearer YOUR_KEY" \
  "https://api.ashareapi.com/v1/profile?code=sh600667"

# 快速测试：直接浏览器打开（?key= 会留在日志/历史里，别用于生产）
curl "https://api.ashareapi.com/v1/profile?code=sh600667&key=YOUR_KEY"

import requests

r = requests.get(
    "https://api.ashareapi.com/v1/profile",
    headers={"Authorization": "Bearer YOUR_KEY"},
    params={"code": "sh600667"},
    timeout=30,
)
print(r.json())

const r = await fetch("https://api.ashareapi.com/v1/profile?code=sh600667", {
  headers: { Authorization: "Bearer YOUR_KEY" },
});
console.log(await r.json());

# 注：q 的值已做 URL 编码（含 [ ] 空格 等）
# 推荐：Authorization 头（密钥不进日志）
curl -H "Authorization: Bearer YOUR_KEY" \
  "https://api.ashareapi.com/v1/search?q=%E5%A4%AA%E6%9E%81%E5%AE%9E%E4%B8%9A"

# 快速测试：直接浏览器打开（?key= 会留在日志/历史里，别用于生产）
curl "https://api.ashareapi.com/v1/search?q=%E5%A4%AA%E6%9E%81%E5%AE%9E%E4%B8%9A&key=YOUR_KEY"

import requests

r = requests.get(
    "https://api.ashareapi.com/v1/search",
    headers={"Authorization": "Bearer YOUR_KEY"},
    params={"q": "太极实业"},
    timeout=30,
)
print(r.json())

const r = await fetch("https://api.ashareapi.com/v1/search?q=%E5%A4%AA%E6%9E%81%E5%AE%9E%E4%B8%9A", {
  headers: { Authorization: "Bearer YOUR_KEY" },
});
console.log(await r.json());

# 推荐：Authorization 头（密钥不进日志）
curl -H "Authorization: Bearer YOUR_KEY" \
  "https://api.ashareapi.com/v1/calendar?date=2026-09-16"

# 快速测试：直接浏览器打开（?key= 会留在日志/历史里，别用于生产）
curl "https://api.ashareapi.com/v1/calendar?date=2026-09-16&key=YOUR_KEY"

import requests

r = requests.get(
    "https://api.ashareapi.com/v1/calendar",
    headers={"Authorization": "Bearer YOUR_KEY"},
    params={},
    timeout=30,
)
print(r.json())

const r = await fetch("https://api.ashareapi.com/v1/calendar?date=2026-09-16", {
  headers: { Authorization: "Bearer YOUR_KEY" },
});
console.log(await r.json());

# 推荐：Authorization 头（密钥不进日志）
curl -H "Authorization: Bearer YOUR_KEY" \
  "https://api.ashareapi.com/v1/margin-trade?code=sh600667"

# 快速测试：直接浏览器打开（?key= 会留在日志/历史里，别用于生产）
curl "https://api.ashareapi.com/v1/margin-trade?code=sh600667&key=YOUR_KEY"

import requests

r = requests.get(
    "https://api.ashareapi.com/v1/margin-trade",
    headers={"Authorization": "Bearer YOUR_KEY"},
    params={},
    timeout=30,
)
print(r.json())

const r = await fetch("https://api.ashareapi.com/v1/margin-trade?code=sh600667", {
  headers: { Authorization: "Bearer YOUR_KEY" },
});
console.log(await r.json());

# 推荐：Authorization 头（密钥不进日志）
curl -H "Authorization: Bearer YOUR_KEY" \
  "https://api.ashareapi.com/v1/block-trade?code=sh600667"

# 快速测试：直接浏览器打开（?key= 会留在日志/历史里，别用于生产）
curl "https://api.ashareapi.com/v1/block-trade?code=sh600667&key=YOUR_KEY"

import requests

r = requests.get(
    "https://api.ashareapi.com/v1/block-trade",
    headers={"Authorization": "Bearer YOUR_KEY"},
    params={},
    timeout=30,
)
print(r.json())

const r = await fetch("https://api.ashareapi.com/v1/block-trade?code=sh600667", {
  headers: { Authorization: "Bearer YOUR_KEY" },
});
console.log(await r.json());

# 推荐：Authorization 头（密钥不进日志）
curl -H "Authorization: Bearer YOUR_KEY" \
  "https://api.ashareapi.com/v1/usage"

# 快速测试：直接浏览器打开（?key= 会留在日志/历史里，别用于生产）
curl "https://api.ashareapi.com/v1/usage?key=YOUR_KEY"

import requests

r = requests.get(
    "https://api.ashareapi.com/v1/usage",
    headers={"Authorization": "Bearer YOUR_KEY"},
    params={},
    timeout=30,
)
print(r.json())

const r = await fetch("https://api.ashareapi.com/v1/usage", {
  headers: { Authorization: "Bearer YOUR_KEY" },
});
console.log(await r.json());