開発者API

マーケット・テクニカル分析・ニュースのREST API — このサイトと同じデータ。 OpenAPI仕様 (JSON)

認証

すべてのリクエストにAuthorizationヘッダーのAPIキーが必要です。

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

キーの作成と管理はプロフィール

日次クォータ

Free	100 リクエスト/日
Radar	1,000 リクエスト/日
Pro	10,000 リクエスト/日
Trader+	100,000 リクエスト/日

Freeを含むすべてのプランでAPIを利用できます。/analysis はすべてのプランでリアルタイムのローソク足を返します。/fundamental はファンダメンタル分析を含むプラン（Pro以上）が必要です。1アカウントのすべてのキーで1日のクォータを共有し、バースト上限は毎分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ローソク足（古い順、バー時刻は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/announcements?kind=listings&days=7
取引所の上場・上場廃止・注意指定のお知らせ（Binance、Bybit、OKX、Upbit、Bithumb）。公表時、その3分後、レーダー検知時の価格と、1時間・24時間・7日の値動きを含みます。Free キーは検知の10分後に、直近30日分のみ表示。Radar 以上は遅延なしで、2021年からの全アーカイブを取得できます。
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内ではフィールドは追加のみで、削除や型変更はしません。

スクリーナーは 503 busy（スキャン枠がすべて使用中）や 502 upstream_degraded（大半のコインを読み取れなかった）を返すこともあります — どちらも Retry-After 付きで、クォータは消費されません。GET 以外のメソッドには JSON の 405 が返ります。

ボットには下記のお知らせウェブフックが適しています：こちらから送信し、失敗時は再送します。お知らせのポーリング：since=<ミリ秒の addedAt> を渡し、以降の呼び出しでは前回のレスポンスの nextCursor を cursor として渡してください。行はレーダーが追加した順に届くため、遅れて検出されたお知らせも取りこぼしません。重複は id で除いてください。since なしでは公開が新しい順に並び、hasMore が true の間は cursor で古いページへ進めます。行が返らないポーリングは、アカウントごとに10秒に1回までクォータを消費しません（quotaCharged: false）。10秒ごとのポーリングはどのプランにも収まります。行を含むレスポンスは通常どおりカウントされます。

# first call: everything added in the last hour, oldest first
curl -H "Authorization: Bearer gcs_YOUR_KEY" \
  "https://getcoinsight.com/api/v1/announcements?since=$(( $(date +%s) * 1000 - 3600000 ))"
# every next call: the nextCursor of the previous response
curl -H "Authorization: Bearer gcs_YOUR_KEY" \
  "https://getcoinsight.com/api/v1/announcements?cursor=NEXT_CURSOR"

ティッカーごとの価格：priceAtAnnouncement と move1hPct / move24hPct / move7dPct は公表の分を起点とします — 互換性のため残していますが、速い上場では取引できる価格ではありません。priceAt3m と movesFrom3m（および BTC の値動きを差し引いた movesFrom3mVsBtc）は公表の3分後を起点とし、サイトの統計の基準です。priceAtDetection と movesFromDetection はレーダーが告知を検知した時点を起点とします。各期間の終点は共通の horizonsEndAt（公表の分 + 1時間 / 24時間 / 7日）です。+3分からの「1時間」は57分間で、検知時点で残りが75%未満の期間には検知からの値動きがありません。手数料・スリッページ・ファンディングは含みません。

ボット用フィールド（API と Webhook）：market（spot / perp / alpha / tradfi）、quotes（タイトルにある建値市場。例: KRW, BTC, USDT — 記載がなければ空）、tradingStartsAt（タイトルに時刻がある場合のみ。なければ null — 告知本文は解析しません）、detectedAt（当レーダーが最初に検知した時刻）、tradable — 取引用の市場コード：role notice = 告知対象の市場（INITUSDT, KRW-INIT, INIT-USD）、role reference = 価格を読む Binance/Bybit の市場。

スクリーナー 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。スキャンは1分あたり最大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, dip_weekly_uptrend, oi_build_flat, ema_cross_btc_up. 数値の短縮パラメーター： rsiMin, rsiMax, scoreMin, scoreMax, relVolumeMin, adxMin, adxMax, change24hMin, change24hMax, change7dMin, change7dMax, volumeMin.

トレードボット向け Webhook

アラート、保存したスクリーンの新しい該当銘柄、今日のアイデアを自分の https URL に POST できます。形式はプロフィール → 通知で選択します。

JSON — 通知ごとに1リクエスト。構造化フィールド（イベント種別、シンボル、取引所ごとの TradingView ティッカー、方向、価格、時間足、アラート id、エントリー／ストップ／ターゲット）と従来の subject/text/url フィールド。
3Commas — 3Commas シグナルボット形式でシグナルごとに1リクエスト。ボットの secret と bot_uuid をテンプレートに貼り付けてください。
Cornix — イベントごとに Cornix 形式のテキストシグナルを1件（ペア、取引所、方向、エントリー、利確、ストップ）。
Custom — 二重の波括弧のプレースホルダーを使った独自テンプレート。ticker、exchange、close、interval など TradingView 形式の名前も使えます。

{ "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 になるのは、ボット取引を許可したシグナルだけです：アラートのボット設定（ロング・ショート・セットアップ方向に従う）、保存スクリーンの「ボットに送信」（確定足のセットアップのみ）、今日のアイデアのスイッチ。価格の交差だけで方向が決まることはありません。それ以外は情報のみで、3Commas や Cornix には届きません。各シグナルには signal_id と元のタイムスタンプが付き、再送されず、5分を超えて遅れて送られることもなく、24時間あたり日次上限（≤ 10）までしか送られません。

ブラケットアラート：エントリーに到達すると、ブラケットのストップとターゲット付きで enter_long / enter_short を送信します。ストップ（またはトレーリングで引き上げたストップ）と最後のターゲットでは exit_long / exit_short を送信します（当サイトのエントリーを受け取ったボットにのみ）。Cornix はストップとターゲット付きのエントリーを受け取り、自身で決済します。取引所の市場が確認できないコイン、3Commas / Cornix 向けの株式、現物市場でのショート、シグナル自身の水準と矛盾する方向は、取引として送信されません。

すべてのリクエストに署名があります：X-GCS-Signature: sha256=HMAC(本文, あなたのシークレット)。ボット形式は1通知につき最大10シグナルを送信します。

お知らせ Webhook（Radar 以上）

お知らせ設定に合う上場・上場廃止・注意指定の告知は、レーダーが検知した時点で JSON（event "announcement"）として POST されます — JSON 形式のみ。各試行の期限は8秒で、リダイレクトはたどりません。すぐに 2xx を返してください。失敗した試行は最大30分まで間隔を広げながら再送され、約2時間で最大9回試行します。そのため配信が遅れて届くことがあります。eventId（X-Getcoinsight-Delivery ヘッダーと同じ。attempt と X-Getcoinsight-Attempt は試行回数）で重複を除き、鮮度は announcement.detectedAt または firstAttemptAt で判断してください — timestamp はその試行の送信時刻です。取りこぼしは /api/v1/announcements?since=… で補完できます。20回連続で配信に失敗するとウェブフックはオフになり、ベルに通知が届きます。

POST <your https URL>
Content-Type: application/json
X-GCS-Signature: sha256=<hex HMAC-SHA256 of the raw body, your secret>
X-Getcoinsight-Delivery: announcement:binance:1234567
X-Getcoinsight-Attempt: 1

{ "event": "announcement", "type": "announcement", "version": 2,
  "subject": "…", "text": "…", "url": "https://getcoinsight.com/…", "timestamp": "2026-10-26T09:00:04.120Z",
  "eventId": "announcement:binance:1234567", "attempt": 1, "firstAttemptAt": "2026-10-26T09:00:04.100Z",
  "disclaimer": "…", "signals": [],
  "announcement": { "id": "binance:1234567", "exchange": "binance", "kind": "listing",
    "title": "Binance Will List X (X)", "symbols": ["X"],
    "publishedAt": "2026-10-26T09:00:00.000Z", "noticeUrl": "https://www.binance.com/…",
    "market": "spot", "quotes": ["USDT"], "tradingStartsAt": null, "detectedAt": "2026-10-26T09:00:03.900Z",
    "tradable": [ { "base": "X", "venue": "binance", "type": "spot", "symbol": "XUSDT", "role": "notice" } ],
    "eventId": "announcement:binance:1234567", "attempt": 1, "firstAttemptAt": "2026-10-26T09:00:04.100Z" } }

Webhook はプロフィール → 通知で設定 →