策略列表
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.1Host: ohmy.xinAuthorization: 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[] 字段
Section titled “data[] 字段”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"),需要参与计算时请自行转换,避免浮点误差。
target_stages[] 字段
Section titled “target_stages[] 字段”| 字段 | 类型 | 可为 null | 说明 |
|---|---|---|---|
level |
整数 | 否 | 阶梯序号,从 1 开始递增。 |
price |
字符串 | 否 | 该级的目标价。 |
reached_at |
ISO 8601 时间 | 是 | 到达该级的时间;尚未到达时为 null。 |
reached_price |
字符串 | 是 | 到达该级时的实际价格;尚未到达时为 null。 |
circle 字段
Section titled “circle 字段”| 字段 | 类型 | 可为 null | 说明 |
|---|---|---|---|
number |
字符串 | 否 | 圈子编号,可直接用于筛选参数 circle_number。 |
name |
字符串 | 否 | 圈子名称。 |
url |
字符串 | 否 | 圈子主页地址,策略频道视图。 |
avatar_url |
字符串 | 是 | 圈子头像地址。 |
author 字段
Section titled “author 字段”| 字段 | 类型 | 可为 null | 说明 |
|---|---|---|---|
name |
字符串 | 否 | 发布者昵称。 |
avatar_url |
字符串 | 是 | 发布者头像地址。 |
meta.pagination 字段
Section titled “meta.pagination 字段”| 字段 | 类型 | 可为 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..."一条策略出现在列表里,需要同时满足:
- 策略状态为
running、take_profit或stop_loss之一; - 策略已发布(
published_at非空); - 策略没有设置成员档位门槛,且受众为公开(
everyone); - 所属圈子满足:已绑定 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)的含义见接口约定。
- 接口约定 —— 鉴权、限流、响应信封与错误码
- 快速开始 —— 创建账号、生成密钥、完成第一次调用
- 直播列表 —— 另一个列表接口
- OpenAPI 规范 —— 本接口的机器可读描述(OpenAPI 3.1)