API 密钥
API 密钥是一长串随机字符,服务用它判断请求来自谁:属于哪个账户、使用哪个套餐、可以获取哪些数据。对程序来说,密钥就像密码:谁知道这串字符,谁就能以所有者的身份行事。
密钥如何发送
密钥放在每个请求的请求头中,筛选条件则写在 URL 里。在 Genesis API 中,请求头是 X-API-Key,密钥形如 gns_live_…。下面的示例请求 AI Signals 中评级为 alpha 的信号:
import os
import requests
key = os.environ.get("GENESIS_API_KEY")
if not key:
raise SystemExit("set GENESIS_API_KEY on the server")
r = requests.get(
"https://api.genesisarbitrage.com/v1/ai/signals",
headers={"X-API-Key": key}, # 密钥只放在请求头中
params={"category": "alpha"}, # 筛选条件放在 URL 中
timeout=10,
)
if r.status_code == 401:
# 密钥缺失、无效或已被吊销
print(r.json()["error"]["code"]) # invalid_key
elif r.ok:
print("alpha signals:", r.json()["meta"]["count"])
之所以用请求头,是因为请求 URL(包括查询字符串)会留在 Web 服务器和代理的日志里,如果有人在浏览器中打开,还会留在浏览器历史中。Genesis API 文档说得很明确:切勿通过查询参数传递密钥,切勿嵌入网站或应用代码,只从你自己的服务器发起请求。交易所的做法类似:Binance 在 X-MBX-APIKEY 请求头中接收密钥,账户类请求还要用第二个密钥,即 API secret,进行签名。
如何保管密钥
- 把密钥存放在服务器的环境变量或
.env文件中,并把.env加入.gitignore。 - 切勿把密钥粘贴到网站代码、手机应用、聊天或截图中。
- Genesis API 只显示一次密钥,且只存储其哈希:丢失的密钥无法找回,只能重新签发。
- 如果密钥泄露,在个人资料中点击“重新生成”,旧密钥会立即失效。“撤销”则停用密钥且不提供替代。
交易所密钥与 Genesis API 密钥
| 交易所密钥 | Genesis API 密钥 | |
|---|---|---|
| 权限 | 读取、交易、提现:取决于你开启了什么 | 仅读取数据 |
| 泄露后暴露的是 | 账户上的交易和提现 | 你的调用额度 |
| 保护措施 | 关闭提现、IP 白名单 | 在个人资料中重新生成 |
Genesis API 密钥是只读的:不能下单,也不能提现。密钥相关的错误及代码见认证和错误两节。
另见:API、接口、限流、API 密钥:获取、保管、重新生成与撤销。
常见问题
可以创建多个 Genesis API 密钥吗?
不可以,一个账户只有一个密钥。“重新生成”会给你一个新密钥,并立即停用旧密钥。
在哪里获取 Genesis API 密钥?
购买 API 套餐后,在个人资料的 Genesis API 区块中获取。“获取密钥”按钮会打开“你的 API 密钥”窗口,其中有“复制”按钮。