AI 自然语言顾问

POST/api/v1/px/ai/ask公开

PX 发现与账户一律 E6 十进制字符串A | B

公开端点，不与账户关联，query 不落库。query 非空且 ≤ 200 字符。

两种降级都走 HTTP 200，不报错：enabled=false 表示功能未开启；advice=null 表示本次 LLM 调用或解析失败。调用方按这两个字段判定，不要依赖状态码。

请求体

querystring必填
自然语言问题，非空且不超过 200 字符

响应

200顾问回复（含两种降级态）

enabledboolean
功能是否开启
示例false
advicestring可为空
顾问回复。null 表示本次调用或解析失败，不是「没有建议」
picksobject(PxAiAskPick)[]
相关事件；可为空数组
eventIdstring
事件 id
示例"event_01K5H2M3N7"
slugstring
事件 slug
示例"btc-above-120k-2026-12-31"
titlestring
事件标题
示例"BTC above $12…c 31, 2026?"
endDateMsstring可为空
截止时刻，毫秒字符串
pctTextstring可为空
概率展示文本
actionstring可为空
建议动作
sizeHintstring可为空
建议仓位提示

在响应示例中切换状态码查看错误响应，完整错误码见错误码页。

请求

curl -X POST "$BASE_URL/api/v1/px/ai/ask" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "BTC 今晚会涨吗"
  }'

响应

顾问回复（含两种降级态）

{
  "enabled": false,
  "advice": null,
  "picks": [
    {
      "eventId": "event_01K5H2M3N7",
      "slug": "btc-above-120k-2026-12-31",
      "title": "BTC above $120,000 on Dec 31, 2026?",
      "endDateMs": null,
      "pctText": null,
      "action": null,
      "sizeHint": null
    }
  ]
}

请求体

querystring必填
自然语言问题，非空且不超过 200 字符

响应

200顾问回复（含两种降级态）

enabledboolean
功能是否开启
示例false
advicestring可为空
顾问回复。null 表示本次调用或解析失败，不是「没有建议」
picksobject(PxAiAskPick)[]
相关事件；可为空数组
eventIdstring
事件 id
示例"event_01K5H2M3N7"
slugstring
事件 slug
示例"btc-above-120k-2026-12-31"
titlestring
事件标题
示例"BTC above $12…c 31, 2026?"
endDateMsstring可为空
截止时刻，毫秒字符串
pctTextstring可为空
概率展示文本
actionstring可为空
建议动作
sizeHintstring可为空
建议仓位提示

在响应示例中切换状态码查看错误响应，完整错误码见错误码页。