Skip to main content

Data API — 数据面

数据查询面（2026-09-20 收口自 Open Query 数据面 + 看板聚合）。路径前缀 /v1/data/*。

Base URL 与鉴权​

Base URL : https://api.eurybia.xyz
Header   : X-API-Key: <your_key>

域清单（/v1/data/<domain>/*）​

域数据
twitter推文/情绪/KOL
news新闻/RSS/媒体
assetsSolana token 元数据/评级/黑名单
market行情 OHLCV
chain链上数据
indicators指标
factors情绪因子（见下）
tables白名单通用表（PG）
ch白名单 ClickHouse 表

Open Query → Data API 迁移映射​

旧 /api/open/query/* 已于 2026-09-20 退役（404）。数据端点全部迁入，参数、响应字段、分页协议不变：

旧路径新路径
/api/open/query/twitter/.../v1/data/twitter/...
/api/open/query/news/.../v1/data/news/...
/api/open/query/market/.../v1/data/market/...
/api/open/query/solana/.../v1/data/assets/...
/api/open/query/history/.../v1/data/chain/...、/v1/data/dex/...、/v1/data/stablecoins/...
# 之前
curl https://eurybia.xyz/api/open/query/twitter/hourly-summaries -H "X-API-Key: sk_..."
# 现在
curl https://api.eurybia.xyz/v1/data/twitter/hourly-summaries -H "X-API-Key: sk_..."

改动点：只换 base URL + 前缀。key、参数、响应全部不变。

防拖库护栏​

  • 时间窗 ≤ 30 天
  • 需资源过滤参数
  • 翻页上限

行为与旧 Open Query 服务一致。

因子（Factors）域​

2026-09-20 新上（原 api-quant 因子用 PG 源重写，属数据面、/v1/data 前缀授权）：

# 全局情绪比率时间序列（BTC 默认，小时级）
curl "https://api.eurybia.xyz/v1/data/factors/sentiment-ratio?symbol=BTC&hours=168" \
  -H "X-API-Key: sk_..."

# 情绪比率信号回测（资金曲线 + KPI）
curl -X POST https://api.eurybia.xyz/v1/data/factors/backtest \
  -H "X-API-Key: sk_..." \
  -d '{"symbol":"BTC","start_time":"2026-09-10T00:00:00","end_time":"2026-09-18T00:00:00"}'

区别：/v1/data/factors/* 是全局情绪数据面能力；/v1/quant/* 是 KOL 策略回测（需 quant 订阅），见 Quant API。

通用表查询（白名单域）​

  • /v1/data/tables/{domain}/{table}/rows：PG 白名单榜单/表格（industry/solana/dao/twitter/kyt/telegram/media 域）
  • /v1/data/ch/{table}、/v1/data/ch/{table}/rows：ClickHouse 白名单时序/榜单（链上数据）

完整白名单见 GET /v1/catalog；未列出的表返回 404。

看板聚合（frontend）​

/v1/data/frontend/* 为看板专用聚合（185 个 slice 的 34 个显式路由）。供 site-eurybia 前端经 BFF 调用，外部用户一般用不到。