Skip to content

身份验证

如何获取密钥、应通过哪个请求头发送密钥,以及无需密钥的免费层级都覆盖哪些内容。

对 API 的每个请求都需要携带你的密钥。这里没有单独的 OAuth 流程,除了登录以创建密钥之外,也不需要额外填写注册表单。

获取密钥

打开控制台,使用 GitHub 或 Google 登录,然后创建一个密钥。密钥只会显示一次,请将它保存在安全的地方——此后控制台只会保存密钥的前缀。每个新密钥默认使用 Free 套餐。

发送密钥

REST 和 MCP 服务器都接受以 Bearer 令牌形式发送的密钥:

Authorization: Bearer sk_live_...

对于以原始请求头方式发送密钥的客户端,MCP 服务器也接受同一个密钥以这种方式传入:

X-API-Key: sk_live_...

无论使用哪个请求头,验证的都是同一个密钥、同一个套餐层级。MCP 和 REST 并没有各自独立的密钥类型。

没有免密钥层级

每个请求都需要密钥,包括 Free 套餐在内。api.dino.markets 不提供匿名或未经身份验证的访问。官网上的实时比赛页面是唯一的例外:它们无需任何密钥即可展示相同的匹配数据,但会有五分钟延迟,仅供浏览,而非用于程序化调用。

Free 套餐与限制

创建密钥不收取任何费用,也不需要提供支付方式。Free 套餐涵盖:

  • 通过 REST 获取匹配数据流与套利视图(GET /v2/marketsGET /v2/pairs/{market_id}GET /v2/leaguesGET /v2/coverage)
  • 每分钟 60 次请求
  • MCP 服务器的工具列表,以及全部只读工具(list_marketsfind_arbitrageget_marketlist_leaguesget_coveragereport_bad_arb)

实时 WebSocket 流(POST /v1/stream/token 以及 watch_markets MCP 工具)需要 Basic 或 Pro 套餐;Free 密钥在票据生成端点会收到 402。完整的套餐对比见定价,各套餐的速率限制见 REST API

错误

缺失或无效的密钥会返回 401。有效密钥超出其套餐的速率限制会返回 429。有效的 Free 密钥访问仅限 Basic/Pro 的路由(流票据)会返回 402