開發者 API

行情、技術分析和新聞的 REST API — 與本站使用相同的資料。 OpenAPI 規範（JSON）

身份驗證

每個請求都需要在 Authorization 頭中攜帶 API 金鑰。

curl -H "Authorization: Bearer gcs_YOUR_KEY" \
  "https://getcoinsight.com/api/v1/markets?limit=10"

在你的個人資料中建立和管理金鑰

每日配額

Free	100 請求/天
Pro	10,000 請求/天
Trader+	100,000 請求/天

所有方案都包含 API 訪問，Free 也不例外。所有方案的 /analysis 皆返回即時 K 線；/fundamental 需要包含基本面分析的方案（Pro 及以上）。一個帳戶的所有金鑰共享同一個每日配額，突發上限為每分鐘 60 次請求。

響應包含 X-RateLimit-Limit 和 X-RateLimit-Remaining 頭。超出配額 → HTTP 429。

端點

GET /api/v1/markets?limit=100
按市值排名的頭部幣種：價格、市值、成交量、1h/24h/7d 漲跌。
GET /api/v1/candles?symbol=btc&id=bitcoin&interval=1h&limit=300
OHLCV K線（從最早開始，K線時間為 Unix 秒）— 與 /analysis 計算所用完全相同的序列，最長到你方案的歷史範圍。
GET /api/v1/analysis?symbol=btc&id=bitcoin&interval=1h
技術快照：價格、趨勢、RSI/ADX/ATR、TA 共識評級、市場狀態、綜合評分。週期：1m–1M。
GET /api/v1/fundamental?assetId=bitcoin
基本面評分：5 個類別的同類分位數 + 90 天曆史；不帶 assetId 時返回最新評分列表。需要包含基本面分析的方案。
GET /api/v1/news?limit=30
聚合加密貨幣頭條（CoinDesk、Cointelegraph、Decrypt、The Block、Bitcoin Magazine）。
GET /api/v1/presets
篩選器預設：ID、名稱、各自套用的篩選條件、交易方向，以及你的方案會捨棄哪些篩選條件。
GET /api/v1/funding?limit=100&sort=fundingAbs
永續合約資金費率（8 小時等值，Binance/Bybit），附 Bybit/OKX/Hyperliquid 比較、基差、未平倉量及其 1h/4h/24h 變化。排序：rank、funding、fundingAbs、oiUsd、oiChangePct。
GET /api/v1/screener?preset=oversold_reversal&interval=4h
執行篩選：在您方案的範圍內以 15m–1w 週期執行預設和/或篩選條件。回傳目前符合的結果，含評分、交易計畫價位與 TradingView 代號。

所有端點均返回 JSON：成功時 { "data": … }，否則 { "error": "code" }。CORS 開放。

每個已認證的回應還帶有 X-RateLimit-Reset（下次重置的 Unix 秒，00:00 UTC）。429 與 502 回應帶有 Retry-After（秒）— 請等待相應時間；不要原樣重試 4xx。未知代號回傳 404 unknown_symbol。在 v1 內欄位只會新增，不會刪除或改變型別。

篩選器 API

從程式碼執行任何篩選器預設或自訂條件 — 與網站相同的引擎、範圍與方案限制。每筆結果都附有交易計畫價位與 TradingView 代號，可直接用於機器人。

curl -H "Authorization: Bearer gcs_YOUR_KEY" \
  "https://getcoinsight.com/api/v1/screener?preset=strong_uptrend&interval=4h&universe=100&limit=10"

# explicit filters (override the preset's):
curl -G -H "Authorization: Bearer gcs_YOUR_KEY" \
  "https://getcoinsight.com/api/v1/screener" \
  --data-urlencode 'filters={"rsiMax":35,"sma200":"above"}' \
  --data-urlencode "interval=1h"

{ "data": { "preset": "strong_uptrend", "interval": "4h", "universe": 100,
  "scanned": 97, "matched": 7, "skippedYoung": 2, "errored": 1,
  "scannedAt": "2026-10-01T18:30:08.283Z", "results": [ {
    "id": "solana", "symbol": "SOL", "rank": 6, "price": 152.3, "compositeScore": 0.41,
    "rating": "buy", "regime": "trending_up", "rsi": 61.2, "adx": 27.4, "atrPct": 2.1,
    "tvTicker": "BINANCE:SOLUSDT.P",
    "venue": { "exchange": "binance", "market": "perp", "symbol": "SOLUSDT" },
    "setup": { "side": "long", "entry": 152.3, "stop": 146.9, "targets": [161.2, 168],
               "rr": 1.6, "rrNet": 1.4, "viable": true, "status": "idea", "watchReason": null } } ] } }

參數：preset、filters（JSON）、interval（15m、1h、4h、1d、1w）、universe（受方案限制）、limit。每分鐘最多 6 次掃描。 preset: oversold_reversal, overbought_rejection, volume_spike, volume_dump, breakout, breakdown, strong_uptrend, strong_downtrend, trend_pullback, downtrend_rally, bearish_breakdown, overbought, deep_drawdown, momentum_7d, accumulation, bb_squeeze, mean_reversion, relative_strength, deriv_squeeze, short_squeeze, smart_money, multi_pillar, strong_shorts, range_long, range_short. 數值簡寫： rsiMin, rsiMax, scoreMin, scoreMax, relVolumeMin, adxMin, adxMax, change24hMin, change24hMax, change7dMin, change7dMax, volumeMin.

交易機器人 Webhook

提醒、已儲存篩選的新符合項目與每日交易想法都可以 POST 到您自己的 https 網址。在個人檔案 → 通知中選擇訊息格式。

JSON — 每則通知一個請求，含結構化欄位（事件類型、代號、各交易所的 TradingView 代號、方向、價格、週期、提醒 id、進場/停損/目標），以及原有的 subject/text/url 欄位。
3Commas — 每個訊號一個請求，採用 3Commas 訊號機器人格式；把機器人的 secret 與 bot_uuid 貼到範本中。
Cornix — 每個事件一則 Cornix 風格純文字訊號（交易對、交易所、方向、進場、停利、停損）。
Custom — 使用雙大括號預留位置的自訂範本；也支援 TradingView 風格的名稱，如 ticker、exchange、close、interval。

{ "event": "notification", "type": "price_alert", "version": 2,
  "subject": "…", "text": "…", "url": "https://getcoinsight.com/…", "timestamp": "2026-01-01T12:00:00.000Z",
  "symbol": "BTC", "base": "BTC", "quote": "USDT", "coinId": "bitcoin",
  "exchange": "binance", "market": "perp", "venueSymbol": "BTCUSDT", "ticker": "BINANCE:BTCUSDT.P",
  "tickers": { "binance": "BINANCE:BTCUSDT.P", "bybit": "BYBIT:BTCUSDT.P", "okx": "OKX:BTCUSDT.P" },
  "side": "long", "direction": "above", "price": 65000, "timeframe": "1h",
  "alertId": "clx…", "alertType": "price_above", "threshold": 65000,
  "entry": 65000, "stop": 63500, "targets": [67500, 70000], "rr": 1.7,
  "assetUrl": "https://getcoinsight.com/coin/bitcoin?symbol=btc&interval=1h",
  "signals": [ { "event": "price_alert", "symbol": "BTC", … } ] }

3Commas 訊號機器人範本：

{
  "secret": "PASTE_3COMMAS_SECRET",
  "max_lag": "300",
  "timestamp": "{{timenow}}",
  "trigger_price": "{{close}}",
  "tv_exchange": "{{exchange}}",
  "tv_instrument": "{{ticker}}",
  "action": "{{action}}",
  "bot_uuid": "PASTE_BOT_UUID"
}

預留位置： {{event}} {{kind}} {{symbol}} {{base}} {{quote}} {{coin_id}} {{tv_symbol}} {{ticker}} {{exchange}} {{tv_exchange}} {{tv_instrument}} {{venue}} {{market}} {{venue_symbol}} {{pair}} {{pair_3commas}} {{side}} {{direction}} {{action}} {{exit_action}} {{intent}} {{price}} {{close}} {{timeframe}} {{interval}} {{alert_id}} {{alert_type}} {{threshold}} {{screen_id}} {{screen_name}} {{entry}} {{stop}} {{target1}} {{target2}} {{targets}} {{rr}} {{url}} {{timestamp}} {{timenow}} {{subject}} {{text}} {{signal_id}} {{test}} {{leverage}} {{disclaimer}}

僅當您為機器人交易開啟了某則訊號時，action 預留位置才為 enter_long / enter_short：提醒的機器人選項（做多、做空或跟隨交易計畫方向）、已儲存篩選器的「傳送給機器人」（僅限已收盤 K 線確認的交易計畫），或每日觀點開關。價格穿越本身絕不代表方向。其他內容僅供參考，永遠不會傳送到 3Commas 或 Cornix。每則訊號帶有 signal_id 與原始時間戳；絕不重送，絕不延遲超過 5 分鐘傳送，且每 24 小時最多傳送您的每日機器人上限（≤ 10）。

括號提醒：價格觸及進場位時傳送 enter_long / enter_short，並附帶該括號的停損與目標；停損（或移動後的停損）與最後一個目標傳送 exit_long / exit_short——僅傳給收到過我們進場訊號的機器人。Cornix 收到帶停損與目標的進場訊號後自行平倉。沒有經過驗證的交易所市場的幣、傳給 3Commas / Cornix 的股票、現貨市場上的做空，或與訊號自身價位相矛盾的方向，都不會作為交易傳送。

每個請求都附簽章：X-GCS-Signature: sha256=HMAC(內文, 您的密鑰)。機器人格式每則通知最多傳送 10 個訊號。

在個人檔案 → 通知中設定 Webhook →