跳转到内容

策略列表

GET /api/v1/strategies 返回平台上公开可见的交易策略(signal)。返回的是策略卡片本身的内容 —— 标的、方向、入场价、目标价、止损价、止盈阶梯 —— 加上所属圈子与发布者的展示信息。

项 值
方法与路径 GET /api/v1/strategies
完整地址 https://ohmy.xin/api/v1/strategies
鉴权 需要 Bearer 密钥
请求体 无
响应 data 为策略对象数组,meta.pagination 为分页信息
分页 游标(cursor)分页,默认每页 20 条,上限 100 条
可见性 仅返回对公开访问者可见的策略
GET /api/v1/strategies HTTP/1.1
Host: ohmy.xin
Authorization: Bearer omx_live_xxxxxxxx_yyyyyyyy...
Accept: application/json

鉴权、限流与错误信封遵循统一的接口约定,本页只描述该接口特有的部分。

全部参数都是可选的;不传任何参数时返回默认排序下的第一页。

参数 类型 默认值 说明
limit 整数 20 每页条数,取值范围 1–100。超出范围返回 400。
cursor 字符串 — 上一页返回的 meta.pagination.next_cursor。不透明字符串,请原样回传。
sort 字符串 published_at:desc 排序方式,可选 published_at:desc(按发布时间倒序)或 updated_at:desc(按更新时间倒序)。
circle_number 字符串 — 按圈子筛选,填写圈子的 number(最长 32 字符)。
symbol 字符串 — 按交易标的筛选,不区分大小写(最长 32 字符),例如 BTC、btc 等价。
side 字符串 — 按方向筛选,可选 long(做多)或 short(做空)。
state 字符串 running,take_profit,stop_loss 按状态筛选,逗号分隔多个值。可选值:running、take_profit、stop_loss。
published_after ISO 8601 时间 — 发布时间下界(含)。
published_before ISO 8601 时间 — 发布时间上界(含)。
updated_after ISO 8601 时间 — 更新时间下界(含)。
终端窗口
curl -s "https://ohmy.xin/api/v1/strategies?limit=2&symbol=BTC&side=long&state=running" \
-H "Authorization: Bearer omx_live_xxxxxxxx_yyyyyyyy..."

data 是一个数组,每个元素代表一条策略。

字段 类型 可为 null 说明
id 整数 否 策略的记录 ID,可用于长期去重与幂等处理。
symbol 字符串 否 交易标的,按发布者录入的原样返回 —— 平台不统一大小写,请按大小写不敏感的方式匹配。
side 字符串 否 方向:long(做多)或 short(做空)。
state 字符串 否 状态:running(进行中)、take_profit(已止盈)、stop_loss(已止损)。
entry_price 字符串 否 入场价。
target_price 字符串 否 目标价。
stop_price 字符串 否 止损价。
exit_price 字符串 是 实际离场价;策略尚未结束时为 null。
target_stages 数组 否 止盈阶梯,逐级记录目标价与到达情况,见下表。
note 字符串 是 发布者附带的说明文字;没有时为 null。
source_name 字符串 是 信号来源的展示名称;没有时为 null。
external_url 字符串 是 原始信号的外部链接;没有时为 null。
published_at ISO 8601 时间 否 发布时间。
closed_at ISO 8601 时间 是 结束时间;策略仍在进行时为 null。
updated_at ISO 8601 时间 否 最近一次更新时间。
circle 对象 否 策略所属圈子,见下表。
author 对象 是 发布该策略的成员;无法取得时为 null。

所有价格字段都是字符串而非数字 —— 小数点后的零会被去掉(65000.00 返回为 "65000"),需要参与计算时请自行转换,避免浮点误差。

字段 类型 可为 null 说明
level 整数 否 阶梯序号,从 1 开始递增。
price 字符串 否 该级的目标价。
reached_at ISO 8601 时间 是 到达该级的时间;尚未到达时为 null。
reached_price 字符串 是 到达该级时的实际价格;尚未到达时为 null。
字段 类型 可为 null 说明
number 字符串 否 圈子编号,可直接用于筛选参数 circle_number。
name 字符串 否 圈子名称。
url 字符串 否 圈子主页地址,策略频道视图。
avatar_url 字符串 是 圈子头像地址。
字段 类型 可为 null 说明
name 字符串 否 发布者昵称。
avatar_url 字符串 是 发布者头像地址。
字段 类型 可为 null 说明
limit 整数 否 本次实际生效的每页条数。
has_more 布尔 否 是否还有下一页。
next_cursor 字符串 是 下一页游标;has_more 为 false 时为 null。
{
"data": [
{
"id": 4821,
"symbol": "BTC",
"side": "long",
"state": "running",
"entry_price": "65000",
"target_price": "70000",
"stop_price": "62000",
"exit_price": null,
"target_stages": [
{
"level": 1,
"price": "67000",
"reached_at": "2024-01-15T04:00:00+08:00",
"reached_price": "67050.5"
},
{
"level": 2,
"price": "68500",
"reached_at": null,
"reached_price": null
}
],
"note": "日线级别突破,回踩不破则继续持有。",
"source_name": "BTC 趋势跟踪",
"external_url": "https://example.com/signals/btc-4821",
"published_at": "2024-01-15T10:00:00+08:00",
"closed_at": null,
"updated_at": "2024-01-16T09:30:00+08:00",
"circle": {
"number": "7000101526",
"name": "Crypto Lab",
"url": "https://ohmy.xin/circles/7000101526?channel=strategy",
"avatar_url": "https://cdn.ohmy.xin/circles/7000101526/avatar.webp"
},
"author": {
"name": "Alice",
"avatar_url": "https://cdn.ohmy.xin/users/a1b2c3/avatar.webp"
}
}
],
"meta": {
"pagination": {
"limit": 20,
"has_more": true,
"next_cursor": "eyJzIjoidXB1bGlzaGVkX2F0OmRlc2MiLCJjIjpbIjIwMjQtMDEtMTVUMDI6MDA6MDBaIiw0ODIxIl19"
},
"request_id": "9f4f2d1e-7c3b-4c68-9f9f-0a1b2c3d4e5f"
}
}

游标分页:先取第一页,拿到 meta.pagination.next_cursor,把它原样作为下一页的 cursor 参数,直到 has_more 为 false。

终端窗口
# 第一页
curl -s "https://ohmy.xin/api/v1/strategies?limit=2" \
-H "Authorization: Bearer omx_live_xxxxxxxx_yyyyyyyy..."
# 下一页 —— 把上一步返回的 next_cursor 原样带上
curl -s "https://ohmy.xin/api/v1/strategies?limit=2&cursor=eyJzIjoidXB1bGlzaGVkX2F0OmRlc2MiLCJjIjpbIjIwMjQtMDEtMTVUMDI6MDA6MDBaIiw0ODIxIl19" \
-H "Authorization: Bearer omx_live_xxxxxxxx_yyyyyyyy..."

一条策略出现在列表里,需要同时满足:

  1. 策略状态为 running、take_profit 或 stop_loss 之一;
  2. 策略已发布(published_at 非空);
  3. 策略没有设置成员档位门槛,且受众为公开(everyone);
  4. 所属圈子满足:已绑定 Mixin、未休眠、圈子状态为公开,且免费或以「预告」模式浏览。

第 4 条意味着:付费且关闭浏览的圈子,其策略不会出现在公开 API 中。若某个圈子号查不到策略,先确认它是否属于这一类。

该接口在统一的错误信封之外,只多一种情况:

HTTP 状态 error.code 触发条件
400 invalid_parameter 查询参数不合法:limit 越界、sort/state/side 取值非法、时间格式错误、时间窗口颠倒,或游标无效。

400 的 error.details 会逐条列出出错的参数:

{
"error": {
"code": "invalid_parameter",
"message": "Invalid query parameter: limit must be an integer between 1 and 100.",
"details": [
{ "param": "limit", "reason": "must be an integer between 1 and 100" }
]
},
"meta": {
"request_id": "9f4f2d1e-7c3b-4c68-9f9f-0a1b2c3d4e5f"
}
}

其余状态码(401、429、503、500)的含义见接口约定。