EyesOnAssets Public API

通过 API 密钥进行付费 B2B 访问，获取与网站用户所见相同的数据：实时选币器 （加密货币、外汇、股票的价格／涨跌幅／成交量）以及 Analytics 模块 （每个资产的技术面 + 基本面综合评分，范围 −100 至 +100）。无需注册网站账号 —— 只需一个密钥。

REST / JSON 基础 URL：/api/v1/public 认证方式：X-API-Key 请求头

身份验证

每个请求都必须携带包含您密钥的 X-API-Key 请求头。 密钥在双方就套餐／合同达成一致后手动发放 —— 本 API 不提供自助注册 （参见"如何获取访问权限"）。

请妥善保管您的密钥。 切勿将其嵌入客户端（浏览器／移动端）代码中 —— 只能在服务器端使用。一旦密钥泄露，可应要求立即吊销。

快速入门

# 查询当前套餐、限流规则及本月剩余配额
curl -H "X-API-Key: eoa_live_YOUR_KEY" \
  https://your-domain/api/v1/public/usage
# 获取加密货币市场所有资产的 Analytics 评分
curl -H "X-API-Key: eoa_live_YOUR_KEY" \
  https://your-domain/api/v1/public/analytics/crypto/list

定价

套餐价格市场速率限制月配额
Starter $250/月 可选 1 个（加密货币／外汇／股票） 30 次/分钟 20,000
Business $500/月 全部三个（选币器 + Analytics 组合） 120 次/分钟 150,000
Enterprise 定制报价 全部三个 + 优先支持 600 次/分钟 无限制

您可随时通过 GET /usage 查询当前套餐、市场限制和合同期限。

限流与配额

存在两个相互独立的限制：

类型统计对象超出后的表现
速率限制 每分钟请求数，取决于套餐 429 Too Many Requests，请稍后重试
月配额 自然月内的总请求数 429 月配额已用尽 —— 请升级套餐或等待下月
两项限制均按密钥计算（若您持有多个密钥，则按客户端计算）， 而非按 IP 地址计算 —— 您可以放心地在 NAT 后的多台服务器上调用本 API。

接口参考

GET/api/v1/public/usage

返回您当前的套餐、允许访问的市场、限流规则以及本月已使用的请求数。查询本身按普通请求计入月配额。

{
  "org_name": "Acme Trading LLC",
  "tier": "business",
  "status": "active",
  "allowed_markets": ["crypto", "forex", "stocks"],
  "rate_limit": "120/minute",
  "monthly_quota": 150000,
  "used_this_month": 4213,
  "contract_expires_at": null
}

GET/api/v1/public/screener/{market_type}/{exchange}/{instrument}

实时选币器数据：市场／交易所／类型组合下每个标的的价格、涨跌幅、成交量。

参数类型说明
market_typepathcrypto / forex / stocks
exchangepathbybit、binance、okx、moex、nasdaq 等 —— 取决于市场和部署区域
instrumentpathspot、perpetual、futures、stock、major 等
volume_min / volume_maxquery，可选成交量筛选
change_min / change_maxquery，可选涨跌幅筛选
 
# 示例
curl -H "X-API-Key: ..." \
  ".../api/v1/public/screener/crypto/bybit/spot?volume_min=1000000"

GET/api/v1/public/ohlcv/{market_type}/{exchange}/{symbol}/{timeframe}

指定标的的 OHLCV K 线数据。

参数类型说明
symbolpath例如 BTC_USDT 或 BTC/USDT
timeframepath1m、5m、15m、1h、4h、1d 等
limitquery，可选K 线数量，默认 200，最大 1000

GET/api/v1/public/analytics/{market}/list

某市场下所有已评分资产的 Analytics 评分：判定结果、综合评分、价格、涨跌幅、价格迷你图。

GET/api/v1/public/analytics/{market}/{symbol}

单个资产的完整报告：每个因子（技术面 + 基本面）及其权重和解释、技术面／基本面／综合评分，以及文字总结。

{
  "market": "crypto", "symbol": "BTC",
  "overall_score": 16, "verdict": "neutral",
  "factors": [
    { "name": "rsi", "value": "54.1", "sentiment": "neutral", "explanation": "RSI 54 —— 处于正常区间" }
    // ...
  ]
}

GET/api/v1/public/analytics/top-setups

返回当前因子失衡程度最大的一批标的，而非单一资产的详细拆解 —— 按 |overall_score| 排序，可限定单一市场，或涵盖您套餐允许的所有市场。

参数类型说明
marketquery，可选crypto/forex/stocks —— 省略则为您套餐允许的所有市场
verdictquery，可选growth/decline —— 省略则两者都包含
limitquery，可选默认 10，最大 100

GET/api/v1/public/analytics/{market}/stats

该市场判定结果的历史表现：按周期（1／5／21／30 天）统计的胜率与平均收益率， 附带 95% Wilson 置信区间。win_rate: null 表示目前数据量不足以给出具体数值 —— 并不代表胜率为 0。 

[
  { "verdict": "growth", "horizon_days": 21, "sample_size": 142,
    "is_significant": true, "win_rate": 0.61,
    "win_rate_ci_low": 0.54, "win_rate_ci_high": 0.68,
    "avg_return_pct": 3.2, "source": "backfill" }
]

GET/api/v1/public/analytics/{market}/{symbol}/history

单个资产的历史评分／判定快照 —— 供您在自己的系统上运行回测。

参数类型说明
limitquery，可选默认 90，最大 1000（最新优先）

Webhooks —— 推送而非轮询

无需定期轮询 /analytics/{market}/{symbol}， 您可以订阅通知，在判定结果发生变化时（growth ↔ decline ↔ neutral）自动收到推送。 

POST /api/v1/public/webhooks
{ "callback_url": "https://your-server/hook", "market": "crypto" }
// 响应中包含 "secret" —— 仅显示一次，请妥善保存

GET /api/v1/public/webhooks       // 查看您的订阅列表
DELETE /api/v1/public/webhooks/{id} // 取消订阅

每次推送都是向您的 callback_url 发起的 POST 请求，并携带 X-Webhook-Signature 请求头 （使用您的密钥对请求体进行 HMAC-SHA256 签名 —— 请验证签名以确认请求来自我们而非伪造）。 callback_url 必须使用 https://。连续 10 次推送失败后，订阅将自动禁用。 

{
  "event": "verdict_changed", "market": "crypto", "symbol": "BTC",
  "old_verdict": "neutral", "new_verdict": "growth",
  "overall_score": 24, "timestamp": "2026-07-26T04:00:00+00:00"
}

错误代码

代码原因
400market_type 无效（仅允许 crypto/forex/stocks）
401密钥缺失、无效或已被吊销
403客户账号已暂停／合同已到期，或该市场不在您的套餐范围内
404该标的尚未计算出 Analytics 数据
429速率限制或月配额已超出
502数据提供方（交易所／行情源）出现临时错误 —— 请稍后重试
503数据服务尚未初始化（服务器刚重启后）

支持的市场与交易所

本 API 覆盖加密货币、外汇和股票（暂不支持债券，未包含在当前方案中）。 某个 exchange／instrument 组合下具体可用的交易所取决于服务器的部署区域；如果不确定哪些交易所可用， 可在我们发放密钥时向我们询问，或从所有区域均可用的 crypto/bybit/spot 开始。

如何获取访问权限

访问权限在双方就套餐达成一致后手动发放 —— 请写信告诉我们您的使用场景和预计请求量， 我们会协助您选择合适的套餐并发放密钥。本站有意不提供自助注册或即时发放密钥的功能 —— 这既是为了保护您（获得一对一的引导），也是为了让我们对数据使用保持可控。