API

交易研究 API，跟网站同一份数据

Q: 怎么申请、要多少钱？

在申请试用页填平台类型和用途（或写信到 support@borearis.com），我们先发 30 天试用密钥。正式价格依品种、用量和交付方式洽谈。

关键点位、短线与波段信号、公开成绩，用 JSON 直接接进你的平台。字段一律英文，文字可选中文或英文；每 30 分钟跟网站一起更新。其他数据商要预约示范才给看，我们把范例和字段说明全部公开在这页。

92个市场的关键点位
30分钟更新一次
6个端点，只要 GET
60次／分钟／密钥

快速开始

一行指令拿到黄金的关键点位

curl -H "X-API-Key: YOUR_KEY" https://borearis.com/zh-hans/api/v1/levels/xauusd?lang=zh

密钥放在 X-API-Key 标头（也可以用 ?api_key= 参数，但标头比较安全）。加 ?lang=zh 文字字段变中文，数值完全一样。

端点

可以拿到什么

端点	内容	更新
`GET /api/v1/instruments`	全部市场：id、代码、名称、类别、小数字	每 30 分钟
`GET /api/v1/levels`	全部市场的点位摘要：方向、转折位、目标 1～2、状态	每 30 分钟
`GET /api/v1/levels/{id}`	单一市场完整点位：盘中＋日线、支撑阻力 3 层、预期幅度、标题、偏好、替代情境、点评。{id} 用市场清单的 id 或代码都可以（xauusd、XAUUSD）	每 30 分钟
`GET /api/v1/signals/short`	短线信号（30 分钟）：进行中＋最近 100 则结束，含结果	K 线收盘后
`GET /api/v1/signals/swing`	波段信号（1 小时、4 小时）：进行中＋最近结束	K 线收盘后
`GET /api/v1/performance`	成绩：回测、实际报价回看，分类别、分月份	每天

范例 JSON

真实输出，不是假数据

以下是这一页产生当下 API 回传的内容（2026-10-28 17:04 UTC+8）；清单只留前几笔。

GET /api/v1/levels/xauusd?lang=zh

{
  "api_version": "1.0",
  "generated": "2026-10-28T17:04:30+08:00",
  "language": "zh",
  "disclaimer": "仅供参考，不构成投资建议。交易有风险。",
  "data": {
    "id": "xauusd",
    "symbol": "XAUUSD",
    "name": "黄金",
    "asset_class": "metal",
    "digits": 2,
    "price": 4052.52,
    "price_time": "2026-10-28T17:30:00+08:00",
    "market_open": true,
    "updated": "2026-10-28T17:03:01+08:00",
    "views": {
      "intraday": {
        "timeframe": "30m",
        "bias": "bearish",
        "state": "edge",
        "valid": true,
        "pivot": 4062.44,
        "target_1": 3991.32,
        "target_2": 3972.8,
        "opposite_1": 4093.62,
        "opposite_2": 4112.18,
        "resistance": [
          4062.44,
          4093.62,
          4112.18
        ],
        "support": [
          3991.32,
          3972.8,
          3954.29
        ],
        "expected_move": "1.97%",
        "headline": "逼近转折位",
        "preference": "压在 4,062.44 之下，看向 3,991.32。",
        "alternative": "升破 4,062.44，则看 4,093.62 和 4,112.18。",
        "comment": "价格正逼近转折位，处于关键位置，守不住就可能转向。 RSI 为 59，MACD 在信号线之上。"
      },
      "daily": {
        "timeframe": "1d",
        "bias": "bearish",
        "state": "ok",
        "valid": true,
        "pivot": 4446.08,
        "target_1": 3799.26,
        "target_2": 3636.17,
        "opposite_1": 4726.72,
        "opposite_2": 4893.77,
        "resistance": [
          4446.08,
          4726.72,
          4893.77
        ],
        "support": [
          3799.26,
          3636.17,
          3473.08
        ],
        "expected_move": "10.27%",
        "headline": "目标 1 附近可能出现回调",
        "preference": "压在 4,446.08 之下，看向 3,799.26。",
        "alternative": "升破 4,446.08，则看 4,726.72 和 4,893.77。",
        "comment": "价格已接近第一个目标 3,799.26，到这里可能先出现回调；明显跌破之后，下一个目标看 3,636.17。 RSI 为 41，MACD 在信号线之下。"
      }
    },
    "url": "https://borearis.com/zh-hans/analysis/xauusd/"
  }
}

GET /api/v1/levels?lang=zh

{
  "api_version": "1.0",
  "generated": "2026-10-28T17:04:30+08:00",
  "language": "zh",
  "disclaimer": "仅供参考，不构成投资建议。交易有风险。",
  "count": 92,
  "data": [
    {
      "id": "alibaba",
      "symbol": "BABA",
      "name": "阿里巴巴",
      "price": 100.12,
      "market_open": false,
      "intraday": {
        "bias": "bearish",
        "state": "ok",
        "pivot": 101.49,
        "target_1": 98.36,
        "target_2": 97.53,
        "valid": true
      },
      "daily": {
        "bias": "bearish",
        "state": "ok",
        "pivot": 105.04,
        "target_1": 92.46,
        "target_2": 89.03,
        "valid": true
      }
    },
    {
      "id": "alphabet",
      "symbol": "GOOGL",
      "name": "Google",
      "price": 320.54,
      "market_open": false,
      "intraday": {
        "bias": "bullish",
        "state": "ok",
        "pivot": 318.74,
        "target_1": 325.92,
        "target_2": 327.94,
        "valid": true
      },
      "daily": {
        "bias": "bearish",
        "state": "ok",
        "pivot": 334.93,
        "target_1": 304.32,
        "target_2": 296.44,
        "valid": true
      }
    },
    {
      "id": "amazon",
      "symbol": "AMZN",
      "name": "亚马逊",
      "price": 253.12,
      "market_open": false,
      "intraday": {
        "bias": "bullish",
        "state": "ok",
        "pivot": 248.82,
        "target_1": 255.87,
        "target_2": 257.77,
        "valid": true
      },
      "daily": {
        "bias": "bearish",
        "state": "ok",
        "pivot": 259.68,
        "target_1": 231.67,
        "target_2": 224.34,
        "valid": true
      }
    }
  ]
}

GET /api/v1/signals/short?lang=zh

{
  "api_version": "1.0",
  "generated": "2026-10-28T17:04:30+08:00",
  "language": "zh",
  "disclaimer": "仅供参考，不构成投资建议。交易有风险。",
  "count": 430,
  "open": [
    {
      "id": "dogeusdt-1793176200",
      "type": "short",
      "symbol": "DOGEUSD",
      "name": "狗狗币",
      "category": "crypto",
      "direction": "sell",
      "signal_time": "2026-10-28T16:30:00+08:00",
      "entry_type": "limit",
      "entry": 0.08073,
      "stop_loss": 0.08153,
      "take_half": 0.08032,
      "target": 0.0787,
      "risk_reward": "1:2.5",
      "exit_style": "scale_out",
      "status": "pending_order",
      "status_text": "挂单等待成交",
      "result_r": null,
      "result_points": null,
      "closed_time": null,
      "timeframe": "30m",
      "url": "https://borearis.com/zh-hans/analysis/dogecoin/",
      "tracking": "live"
    },
    {
      "id": "gbpjpy-1793174400",
      "type": "short",
      "symbol": "GBPJPY",
      "name": "英镑/日元",
      "category": "fx",
      "direction": "sell",
      "signal_time": "2026-10-28T16:00:00+08:00",
      "entry_type": "limit",
      "entry": 209.645,
      "stop_loss": 209.883,
      "take_half": null,
      "target": 208.931,
      "risk_reward": "1:3",
      "exit_style": "single_exit",
      "status": "open",
      "status_text": "持仓中",
      "result_r": null,
      "result_points": null,
      "closed_time": null,
      "timeframe": "30m",
      "url": "https://borearis.com/zh-hans/analysis/gbpjpy/",
      "tracking": "live"
    }
  ],
  "recent_closed": [
    {
      "id": "usdcad-1793095200",
      "type": "short",
      "symbol": "USDCAD",
      "name": "美元/加元",
      "category": "fx",
      "direction": "sell",
      "signal_time": "2026-10-27T18:00:00+08:00",
      "entry_type": "limit",
      "entry": 1.40158,
      "stop_loss": 1.40273,
      "take_half": null,
      "target": 1.39813,
      "risk_reward": "1:3",
      "exit_style": "single_exit",
      "status": "stopped_out",
      "status_text": "止损",
      "result_r": -1.16,
      "result_points": "−13.3 点",
      "closed_time": "2026-10-27T21:00:00+08:00",
      "timeframe": "30m",
      "url": "https://borearis.com/zh-hans/analysis/usdcad/",
      "tracking": "live"
    },
    {
      "id": "usdjpy-1793091600",
      "type": "short",
      "symbol": "USDJPY",
      "name": "美元/日元",
      "category": "fx",
      "direction": "sell",
      "signal_time": "2026-10-27T17:00:00+08:00",
      "entry_type": "limit",
      "entry": 157.692,
      "stop_loss": 157.875,
      "take_half": null,
      "target": 157.143,
      "risk_reward": "1:3",
      "exit_style": "single_exit",
      "status": "stopped_out",
      "status_text": "止损",
      "result_r": -1.08,
      "result_points": "−19.8 点",
      "closed_time": "2026-10-27T21:30:00+08:00",
      "timeframe": "30m",
      "url": "https://borearis.com/zh-hans/analysis/usdjpy/",
      "tracking": "live"
    }
  ]
}

GET /api/v1/signals/swing?lang=zh

{
  "api_version": "1.0",
  "generated": "2026-10-28T17:04:30+08:00",
  "language": "zh",
  "disclaimer": "仅供参考，不构成投资建议。交易有风险。",
  "count": 4,
  "open": [
    {
      "id": "usdcnh-1793145600",
      "type": "swing",
      "symbol": "USDCNH",
      "name": "美元/离岸人民币",
      "category": "fx",
      "direction": "buy",
      "signal_time": "2026-10-28T08:00:00+08:00",
      "entry_type": "market",
      "entry": 6.665,
      "stop_loss": 6.65443,
      "take_half": 6.67029,
      "target": 6.67782,
      "risk_reward": "1:1.2",
      "exit_style": "scale_out",
      "status": "open",
      "status_text": "持仓中",
      "result_r": null,
      "result_points": null,
      "closed_time": null,
      "strong": false,
      "timeframe": "4h",
      "url": "https://borearis.com/zh-hans/analysis/usdcnh/",
      "tracking": "live"
    },
    {
      "id": "cucusd-1793102400",
      "type": "swing",
      "symbol": "COPPER",
      "name": "铜",
      "category": "commodity",
      "direction": "buy",
      "signal_time": "2026-10-27T20:00:00+08:00",
      "entry_type": "limit",
      "entry": 6.4871,
      "stop_loss": 6.3632,
      "take_half": 6.5615,
      "target": 6.6111,
      "risk_reward": "1:1",
      "exit_style": "scale_out",
      "status": "pending_order",
      "status_text": "挂单等待成交",
      "result_r": null,
      "result_points": null,
      "closed_time": null,
      "strong": false,
      "timeframe": "4h",
      "url": "https://borearis.com/zh-hans/analysis/copper/",
      "tracking": "live"
    }
  ],
  "recent_closed": []
}

GET /api/v1/performance?lang=zh

{
  "api_version": "1.0",
  "generated": "2026-10-28T17:04:30+08:00",
  "language": "zh",
  "disclaimer": "仅供参考，不构成投资建议。交易有风险。",
  "data": {
    "short": {
      "backtest": {
        "signals": 2501,
        "win_rate": 65.1,
        "avg_r": 0.197,
        "from": "2024-10",
        "to": "2026-10"
      },
      "price_replay": {
        "signals": 378,
        "win_rate": 65.1,
        "avg_r": 0.193
      },
      "by_category": {
        "gold": {
          "signals": 780,
          "win_rate": 71.2,
          "avg_r": 0.15
        },
        "fx": {
          "signals": 759,
          "win_rate": 47.6,
          "avg_r": 0.242
        },
        "crypto": {
          "signals": 962,
          "win_rate": 73.9,
          "avg_r": 0.2
        }
      },
      "monthly": [
        {
          "month": "2024-11",
          "sum_r": 7.3,
          "signals": 32
        },
        {
          "month": "2024-12",
          "sum_r": 11.7,
          "signals": 106
        },
        {
          "month": "2025-01",
          "sum_r": 26.2,
          "signals": 143
        },
        {
          "month": "2025-02",
          "sum_r": 51.3,
          "signals": 126
        },
        {
          "month": "2025-03",
          "sum_r": 21.1,
          "signals": 99
        },
        {
          "month": "2025-04",
          "sum_r": 11.3,
          "signals": 86
        },
        {
          "month": "2025-05",
          "sum_r": 2.5,
          "signals": 95
        },
        {
          "month": "2025-06",
          "sum_r": -4.5,
          "signals": 80
        },
        {
          "month": "2025-07",
          "sum_r": 43.4,
          "signals": 129
        },
        {
          "month": "2025-08",
          "sum_r": 9.2,
          "signals": 99
        },
        {
          "month": "2025-09",
          "sum_r": 27.5,
          "signals": 136
        },
        {
          "month": "2025-10",
          "sum_r": 19.8,
          "signals": 186
        },
        {
          "month": "2025-11",
          "sum_r": 28.4,
          "signals": 92
        },
        {
          "month": "2025-12",
          "sum_r": 22.5,
          "signals": 84
        },
        {
          "month": "2026-01",
          "sum_r": 33.7,
          "signals": 173
        },
        {
          "month": "2026-02",
          "sum_r": 23.6,
          "signals": 111
        },
        {
          "month": "2026-03",
          "sum_r": -2.7,
          "signals": 67
        },
        {
          "month": "2026-04",
          "sum_r": 22.3,
          "signals": 71
        },
        {
          "month": "2026-05",
          "sum_r": 22.2,
          "signals": 108
        },
        {
          "month": "2026-06",
          "sum_r": 37.4,
          "signals": 125
        },
        {
          "month": "2026-07",
          "sum_r": 15.3,
          "signals": 53
        },
        {
          "month": "2026-08",
          "sum_r": 46.6,
          "signals": 140
        },
        {
          "month": "2026-09",
          "sum_r": 14.6,
          "signals": 93
        },
        {
          "month": "2026-10",
          "sum_r": 2.4,
          "signals": 67
        }
      ]
    },
    "swing": {
      "backtest": {
        "signals": 1668,
        "win_rate": 73.2,
        "avg_r": 0.171,
        "from": "2024-03",
        "to": "2026-10"
      },
      "price_replay": {
        "signals": 515,
        "win_rate": 72.0,
        "avg_r": 0.114
      },
      "by_category": {
        "gold": {
          "signals": 849,
          "win_rate": 73.3,
          "avg_r": 0.152
        },
        "crypto": {
          "signals": 146,
          "win_rate": 74.0,
          "avg_r": 0.172
        },
        "fx": {
          "signals": 326,
          "win_rate": 75.2,
          "avg_r": 0.143
        },
        "index": {
          "signals": 81,
          "win_rate": 69.1,
          "avg_r": 0.149
        },
        "commodity": {
          "signals": 76,
          "win_rate": 69.7,
          "avg_r": 0.217
        },
        "stock": {
          "signals": 190,
          "win_rate": 72.1,
          "avg_r": 0.297
        }
      },
      "monthly": [
        {
          "month": "2024-03",
          "signals": 1,
          "wins": 1,
          "sum_r": 0.5
        },
        {
          "month": "2024-04",
          "signals": 2,
          "wins": 2,
          "sum_r": 0.53
        },
        {
          "month": "2024-06",
          "signals": 2,
          "wins": 1,
          "sum_r": 0.33
        },
        {
          "month": "2024-07",
          "signals": 1,
          "wins": 1,
          "sum_r": 0.27
        },
        {
          "month": "2024-08",
          "signals": 5,
          "wins": 4,
          "sum_r": 0.83
        },
        {
          "month": "2024-09",
          "signals": 15,
          "wins": 11,
          "sum_r": 2.42
        },
        {
          "month": "2024-10",
          "signals": 22,
          "wins": 19,
          "sum_r": 7.74
        },
        {
          "month": "2024-11",
          "signals": 18,
          "wins": 16,
          "sum_r": 4.56
        },
        {
          "month": "2024-12",
          "signals": 20,
          "wins": 12,
          "sum_r": -2.57
        },
        {
          "month": "2025-01",
          "signals": 38,
          "wins": 24,
          "sum_r": 2.74
        },
        {
          "month": "2025-02",
          "signals": 50,
          "wins": 36,
          "sum_r": 1.49
        },
        {
          "month": "2025-03",
          "signals": 62,
          "wins": 48,
          "sum_r": 20.19
        },
        {
          "month": "2025-04",
          "signals": 93,
          "wins": 64,
          "sum_r": 12.6
        },
        {
          "month": "2025-05",
          "signals": 31,
          "wins": 23,
          "sum_r": 5.92
        },
        {
          "month": "2025-06",
          "signals": 45,
          "wins": 30,
          "sum_r": -1.73
        },
        {
          "month": "2025-07",
          "signals": 62,
          "wins": 50,
          "sum_r": 14.36
        },
        {
          "month": "2025-08",
          "signals": 55,
          "wins": 41,
          "sum_r": 11.09
        },
        {
          "month": "2025-09",
          "signals": 109,
          "wins": 82,
          "sum_r": 25.87
        },
        {
          "month": "2025-10",
          "signals": 141,
          "wins": 104,
          "sum_r": 20.05
        },
        {
          "month": "2025-11",
          "signals": 76,
          "wins": 56,
          "sum_r": 15.13
        },
        {
          "month": "2025-12",
          "signals": 82,
          "wins": 61,
          "sum_r": 6.19
        },
        {
          "month": "2026-01",
          "signals": 157,
          "wins": 125,
          "sum_r": 57.1
        },
        {
          "month": "2026-02",
          "signals": 108,
          "wins": 72,
          "sum_r": 1.4
        },
        {
          "month": "2026-03",
          "signals": 64,
          "wins": 49,
          "sum_r": 18.22
        },
        {
          "month": "2026-04",
          "signals": 40,
          "wins": 26,
          "sum_r": 4.61
        },
        {
          "month": "2026-05",
          "signals": 54,
          "wins": 37,
          "sum_r": 1.24
        },
        {
          "month": "2026-06",
          "signals": 94,
          "wins": 73,
          "sum_r": 26.95
        },
        {
          "month": "2026-07",
          "signals": 63,
          "wins": 41,
          "sum_r": 4.57
        },
        {
          "month": "2026-08",
          "signals": 60,
          "wins": 45,
          "sum_r": 17.1
        },
        {
          "month": "2026-09",
          "signals": 59,
          "wins": 37,
          "sum_r": -4.12
        },
        {
          "month": "2026-10",
          "signals": 39,
          "wins": 30,
          "sum_r": 10.45
        }
      ]
    },
    "notes": {
      "win_rate": "percent of signals that closed with a profit (after spreads)",
      "avg_r": "average result in R; 1R = the distance from entry to stop loss",
      "backtest": "historical simulation",
      "price_replay": "replayed on real broker prices",
      "live": "signals published after launch are listed one by one in /signals/*"
    }
  }
}

GET /api/v1/instruments?lang=zh

{
  "api_version": "1.0",
  "generated": "2026-10-28T17:04:30+08:00",
  "language": "zh",
  "disclaimer": "仅供参考，不构成投资建议。交易有风险。",
  "count": 92,
  "data": [
    {
      "id": "alibaba",
      "symbol": "BABA",
      "name": "阿里巴巴",
      "asset_class": "stock",
      "digits": 2,
      "url": "https://borearis.com/zh-hans/analysis/alibaba/"
    },
    {
      "id": "alphabet",
      "symbol": "GOOGL",
      "name": "Google",
      "asset_class": "stock",
      "digits": 2,
      "url": "https://borearis.com/zh-hans/analysis/alphabet/"
    },
    {
      "id": "amazon",
      "symbol": "AMZN",
      "name": "亚马逊",
      "asset_class": "stock",
      "digits": 2,
      "url": "https://borearis.com/zh-hans/analysis/amazon/"
    },
    {
      "id": "apple",
      "symbol": "AAPL",
      "name": "苹果",
      "asset_class": "stock",
      "digits": 2,
      "url": "https://borearis.com/zh-hans/analysis/apple/"
    }
  ]
}

字段说明

每个字段是什么意思

`views.intraday／views.daily`	盘中（30 分钟）和短期（日线）两组观点
`bias`	bullish 看涨／bearish 看跌
`pivot`	转折位：观点的分界线，收盘越过就失效、换新的一组点位
`target_1、target_2`	顺着方向的第一、第二目标
`opposite_1、opposite_2`	转折位失守后，反方向会看的两个价位
`resistance／support`	三层阻力与支撑（由近到远）
`state`	ok 有效／edge 逼近转折位／reached 已到目标 1／broken 转折位已失守
`valid`	false＝目标离现价太远（例如刚大幅波动），建议先不显示
`expected_move`	预期幅度：外汇是到目标 1～2 的点数，其他是到目标 2 的百分比
`headline、preference、alternative、comment`	标题、偏好、替代情境、点评（依 lang 中文或英文）
`market_open`	false＝报价超过 3 小时没更新（休市）

`type`	short 短线（30 分钟）／swing 波段（1 小时、4 小时）
`direction`	buy／sell
`entry_type`	market 市价进场／limit 挂单（价格到了才成交）
`entry、stop_loss、take_half、target`	进场、止损、先平半仓价、目标；突破型没有 take_half（null）
`risk_reward`	盈亏比，例 1:3（目标距离÷止损距离）
`exit_style`	scale_out 分批止盈／single_exit 一次出场
`status`	waiting_for_open、pending_order、open、half_closed、target_hit、stopped_out、break_even、expired
`result_r`	结果，以 R 表示（1R＝进场到止损的距离），已扣点差；进行中为 null
`result_points`	结果换成点数或美元（外汇点、价差点、美元）
`tracking`	live 上线后即时追踪／replay 上线前用实际报价回看
`strong`	波段强信号

密钥、流量、错误

接之前要知道的事

密钥

每个平台一把密钥，放在 X-API-Key 标头。密钥只给服务器用，不要放进网页或 App 的前端程序。

流量

每把密钥每分钟 60 次，瞬间可多 20 次。数据每 30 分钟才更新，建议自己缓存，每 5～10 分钟拉一次就够。需要更高用量可以洽谈。

错误

`401`	没带密钥或密钥无效、已停用
`404`	端点或市场 id 不存在
`429`	超过流量限制，稍后再试

错误一样回 JSON：{"error": "invalid_key"}

不包含的东西

只给结果，不给算法：没有公式、规则、过滤条件，进行中的信号也不给浮动盈亏。财经日历等第三方数据暂不提供。

常见问题

API 的数据跟网站一样吗？

一样。网站上的关键点位卡、信号页和 API 是同一次计算的输出，数字不会对不上；这页的范例就是建站当下的真实数据。

多久更新一次？

关键点位每 30 分钟；短线信号在 30 分钟 K 线收盘后产生；波段信号在 1 小时、4 小时 K 线收盘后产生，API 跟网站同步更新。

会给算法或规则吗？

不会。对外只给结果：价位、方向、状态、成绩。不提供公式、过滤条件或规则内容。

怎么申请、要多少钱？

在申请试用页填平台类型和用途（或写信到 [email protected]），我们先发 30 天试用密钥。正式价格依品种、用量和交付方式洽谈。

先拿试用密钥，接一个市场看看填一下平台类型与用途，我们用 email 联系你申请密钥

所有数据仅供参考，不构成投资建议。交易有风险。