准备工作：注册账号并获取密钥

在开始之前，你需要一个 API 密钥（相当于一把钥匙，用来验证你的身份）。访问 Halal Terminal 官网，用邮箱注册一个账号，登录后在控制台找到 API 密钥并复制保存。免费版每月有 500 个 token（每次调用消耗少量 token），足够你练习。

安装 SDK：Python 和 JavaScript 任选其一

Halal Terminal 提供了两种官方 SDK，你只需要装一种。

• Python SDK：在终端（命令提示符）里运行 pip install halalterminal，这是 Python 的包管理工具，会自动下载安装。
• JavaScript SDK：如果你用 Node.js，在项目文件夹里运行 npm install @halalterminal/sdk。

安装失败？常见原因是网络问题，可以换用国内镜像源，或者检查 Python/Node 版本是否太旧。

编写你的第一段代码：检测股票是否合规

安装完成后，新建一个文件（比如 test.py 或 test.js），输入下面的代码，把 你的密钥 替换成刚才复制的 API 密钥。

Python 示例（检测单只股票）：

from halalterminal import HalalClient
client = HalalClient(api_key='你的密钥')
result = client.scan_symbol('AAPL')
print(result.is_compliant)  # 输出 True 或 False

JavaScript 示例（检测多只股票）：

const { HalalClient } = require('@halalterminal/sdk');
const client = new HalalClient({ apiKey: '你的密钥' });
client.scanPortfolio(['AAPL', 'MSFT']).then(res => {
  console.log(res.summary.compliant + ' 只合规，' + res.summary.non_compliant + ' 只不合规');
});

运行代码（Python 用 python test.py，JavaScript 用 node test.js），如果输出了合规与否的结果，恭喜你，已经跑通了第一个 API 调用！

常见坑与下一步

• 密钥不要泄露：不要把密钥提交到 Git 仓库，建议用环境变量存储。
• token 用量：每次调用会消耗约 5 个 token，500 个免费 token 大约能检测 100 次，够你测试了。
• 响应里的免责声明：每次返回都会附带一段文本，说明计算范围（比如不含某些特殊情况），建议在界面上展示给用户，避免法律风险。

下一步你可以尝试：扫描自己的股票组合、查看完整的合规报告，或者调用更多 API（如趋势数据）。官方文档和 GitHub 开源仓库有更详细的示例。