Binance USDⓈ-M Futures 行情网关,给上游 Hermes 量化分析引擎提供单一聚合 接口 /v1/market/context(K 线 + funding + OI + 多空比 + taker volume)。 只读公共行情,不下单、不接私钥、不查账户。 ## v1 实现范围(Milestone 1-5) - Clean Architecture 4 层(controller/usecase/repo/entity),接口边界在 internal/usecase/ports.go - Binance Futures REST client(K 线 / ticker24h / funding / OI / 多空比 / taker volume 共 9 个接口),全链路 string 价格避免 float64 精度问题 - TimescaleDB 5 张 hypertable(market_klines / funding_rates / open_interest / long_short_ratio / taker_buy_sell_volume),主键含 时间维度,UpsertMany 幂等 - robfig/cron 定时采集(15m/1h/4h/1d/1w 多周期 K 线 + 衍生品 15 分钟 落库),未收线 K 线 (close_time > now) 由 mapper/repo 双重过滤 - pkg/httpclient 统一限流(默认 20 req/s, burst 40)+ 重试,避免触发 Binance 2400 weight/min IP 上限 - /v1/market/context 聚合接口:errgroup 并发拉 snapshot/funding/OI,DB K 线不足 200 根回源 Binance 异步补 - cmd/backfill CLI 支持指定 from/to 大段回填(Binance 历史 OI / 多空比 官方只保留 30 天,必须自己存) - Docker Compose + Makefile + golang-migrate,本地一键启 技术指标(support/resistance/Vegas/箱体)留待 v2,技术段返回空对象 + warning 占位。 ## Harness 工程文档 - AGENTS.md — AI agent 工作速查(10 个章节) - ai/project-map.md — 仓库结构、扩展点、控制流 - ai/risk-guardrails.md — G1-G10 守卫规则(每条带可机械验证命令) - ai/adr/0001-architecture-foundations.md — 9 条架构基础决策 - ai/task-templates.md — 6 种任务契约模板 - ai/harness-health.md — 当前 harness 健康度评估 3 个 grep 守卫已验证通过:controller / usecase 无具体实现依赖,全项目 无私钥/签名字段。
153 lines
4.5 KiB
Go
153 lines
4.5 KiB
Go
package worker
|
|
|
|
import (
|
|
"context"
|
|
"log/slog"
|
|
|
|
"cryptoHermes/internal/entity"
|
|
"cryptoHermes/internal/usecase"
|
|
)
|
|
|
|
type Deps struct {
|
|
MarketData usecase.MarketDataProvider
|
|
Derivatives usecase.DerivativesProvider
|
|
|
|
KlineRepo usecase.KlineRepository
|
|
FundingRepo usecase.FundingRepository
|
|
OIRepo usecase.OpenInterestRepository
|
|
LSRepo usecase.LongShortRatioRepository
|
|
TakerRepo usecase.TakerVolumeRepository
|
|
|
|
Symbols []string
|
|
Intervals []string
|
|
Limit int
|
|
Logger *slog.Logger
|
|
}
|
|
|
|
type Collector struct {
|
|
d Deps
|
|
}
|
|
|
|
func NewCollector(d Deps) *Collector {
|
|
if d.Limit <= 0 {
|
|
d.Limit = 500
|
|
}
|
|
return &Collector{d: d}
|
|
}
|
|
|
|
func (c *Collector) Symbols() []string { return c.d.Symbols }
|
|
func (c *Collector) Intervals() []string { return c.d.Intervals }
|
|
|
|
func (c *Collector) CollectKlines(ctx context.Context, interval string) error {
|
|
for _, sym := range c.d.Symbols {
|
|
ks, err := c.d.MarketData.GetKlines(ctx, sym, interval, c.d.Limit)
|
|
if err != nil {
|
|
c.d.Logger.Error("collect_klines_failed", "symbol", sym, "interval", interval, "err", err)
|
|
continue
|
|
}
|
|
closed := make([]entity.Kline, 0, len(ks))
|
|
for _, k := range ks {
|
|
if k.IsClosed {
|
|
closed = append(closed, k)
|
|
}
|
|
}
|
|
if err := c.d.KlineRepo.UpsertMany(ctx, closed); err != nil {
|
|
c.d.Logger.Error("upsert_klines_failed", "symbol", sym, "interval", interval, "err", err)
|
|
continue
|
|
}
|
|
c.d.Logger.Info("collect_klines_ok", "symbol", sym, "interval", interval, "rows", len(closed))
|
|
}
|
|
return nil
|
|
}
|
|
|
|
func (c *Collector) CollectAllKlines(ctx context.Context) error {
|
|
for _, iv := range c.d.Intervals {
|
|
_ = c.CollectKlines(ctx, iv)
|
|
}
|
|
return nil
|
|
}
|
|
|
|
func (c *Collector) CollectFunding(ctx context.Context) error {
|
|
for _, sym := range c.d.Symbols {
|
|
hist, err := c.d.Derivatives.GetFundingHistory(ctx, sym, 100)
|
|
if err != nil {
|
|
c.d.Logger.Error("collect_funding_failed", "symbol", sym, "err", err)
|
|
continue
|
|
}
|
|
if err := c.d.FundingRepo.UpsertMany(ctx, hist); err != nil {
|
|
c.d.Logger.Error("upsert_funding_failed", "symbol", sym, "err", err)
|
|
continue
|
|
}
|
|
c.d.Logger.Info("collect_funding_ok", "symbol", sym, "rows", len(hist))
|
|
}
|
|
return nil
|
|
}
|
|
|
|
func (c *Collector) CollectOpenInterest(ctx context.Context) error {
|
|
periods := []string{"5m", "15m", "1h", "4h", "1d"}
|
|
for _, sym := range c.d.Symbols {
|
|
for _, p := range periods {
|
|
hist, err := c.d.Derivatives.GetOpenInterestHistory(ctx, sym, p, 500)
|
|
if err != nil {
|
|
c.d.Logger.Error("collect_oi_failed", "symbol", sym, "period", p, "err", err)
|
|
continue
|
|
}
|
|
if err := c.d.OIRepo.UpsertMany(ctx, hist); err != nil {
|
|
c.d.Logger.Error("upsert_oi_failed", "symbol", sym, "period", p, "err", err)
|
|
continue
|
|
}
|
|
c.d.Logger.Info("collect_oi_ok", "symbol", sym, "period", p, "rows", len(hist))
|
|
}
|
|
}
|
|
return nil
|
|
}
|
|
|
|
func (c *Collector) CollectLongShortRatio(ctx context.Context) error {
|
|
periods := []string{"5m", "15m", "1h", "4h", "1d"}
|
|
for _, sym := range c.d.Symbols {
|
|
for _, p := range periods {
|
|
g, err := c.d.Derivatives.GetGlobalLongShortRatio(ctx, sym, p, 500)
|
|
if err == nil {
|
|
if err := c.d.LSRepo.UpsertMany(ctx, g); err != nil {
|
|
c.d.Logger.Error("upsert_global_ls_failed", "symbol", sym, "period", p, "err", err)
|
|
} else {
|
|
c.d.Logger.Info("collect_global_ls_ok", "symbol", sym, "period", p, "rows", len(g))
|
|
}
|
|
} else {
|
|
c.d.Logger.Error("collect_global_ls_failed", "symbol", sym, "period", p, "err", err)
|
|
}
|
|
|
|
t, err := c.d.Derivatives.GetTopTraderPositionRatio(ctx, sym, p, 500)
|
|
if err == nil {
|
|
if err := c.d.LSRepo.UpsertMany(ctx, t); err != nil {
|
|
c.d.Logger.Error("upsert_top_ls_failed", "symbol", sym, "period", p, "err", err)
|
|
} else {
|
|
c.d.Logger.Info("collect_top_ls_ok", "symbol", sym, "period", p, "rows", len(t))
|
|
}
|
|
} else {
|
|
c.d.Logger.Error("collect_top_ls_failed", "symbol", sym, "period", p, "err", err)
|
|
}
|
|
}
|
|
}
|
|
return nil
|
|
}
|
|
|
|
func (c *Collector) CollectTakerVolume(ctx context.Context) error {
|
|
periods := []string{"5m", "15m", "1h", "4h", "1d"}
|
|
for _, sym := range c.d.Symbols {
|
|
for _, p := range periods {
|
|
items, err := c.d.Derivatives.GetTakerBuySellVolume(ctx, sym, p, 500)
|
|
if err != nil {
|
|
c.d.Logger.Error("collect_taker_failed", "symbol", sym, "period", p, "err", err)
|
|
continue
|
|
}
|
|
if err := c.d.TakerRepo.UpsertMany(ctx, items); err != nil {
|
|
c.d.Logger.Error("upsert_taker_failed", "symbol", sym, "period", p, "err", err)
|
|
continue
|
|
}
|
|
c.d.Logger.Info("collect_taker_ok", "symbol", sym, "period", p, "rows", len(items))
|
|
}
|
|
}
|
|
return nil
|
|
}
|