Genesis Arbitrage

Genesis Arbitrage · · 阅读约 4 分钟

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,进行签名。

如何保管密钥

交易所密钥与 Genesis API 密钥

交易所密钥Genesis API 密钥
权限读取、交易、提现:取决于你开启了什么仅读取数据
泄露后暴露的是账户上的交易和提现你的调用额度
保护措施关闭提现、IP 白名单在个人资料中重新生成

Genesis API 密钥是只读的:不能下单,也不能提现。密钥相关的错误及代码见认证和错误两节。

另见:API、接口、限流、API 密钥:获取、保管、重新生成与撤销。

常见问题

可以创建多个 Genesis API 密钥吗?

不可以,一个账户只有一个密钥。“重新生成”会给你一个新密钥,并立即停用旧密钥。

在哪里获取 Genesis API 密钥?

购买 API 套餐后,在个人资料的 Genesis API 区块中获取。“获取密钥”按钮会打开“你的 API 密钥”窗口,其中有“复制”按钮。