API

交易研究 API，跟網站同一份資料

Q: 怎麼申請、要多少錢？

在申請試用頁填平台類型和用途（或寫信到 support@borearis.com），我們先發 30 天試用金鑰。正式價格依品種、用量和交付方式洽談。

關鍵點位、短線與波段訊號、公開成績，用 JSON 直接接進你的平台。欄位一律英文，文字可選中文或英文；每 30 分鐘跟網站一起更新。其他資料商要預約示範才給看，我們把範例和欄位說明全部公開在這頁。

92個市場的關鍵點位
30分鐘更新一次
6個端點，只要 GET
60次／分鐘／金鑰

快速開始

一行指令拿到黃金的關鍵點位

curl -H "X-API-Key: YOUR_KEY" https://borearis.com/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/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/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/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/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/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/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/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/analysis/alibaba/"
    },
    {
      "id": "alphabet",
      "symbol": "GOOGL",
      "name": "Google",
      "asset_class": "stock",
      "digits": 2,
      "url": "https://borearis.com/analysis/alphabet/"
    },
    {
      "id": "amazon",
      "symbol": "AMZN",
      "name": "亞馬遜",
      "asset_class": "stock",
      "digits": 2,
      "url": "https://borearis.com/analysis/amazon/"
    },
    {
      "id": "apple",
      "symbol": "AAPL",
      "name": "蘋果",
      "asset_class": "stock",
      "digits": 2,
      "url": "https://borearis.com/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 聯絡你申請金鑰

所有資料僅供參考，不構成投資建議。交易有風險。