Geliştirici API

Piyasalar, teknik analiz ve haberler için REST API — bu siteyi besleyen aynı veriler. OpenAPI şeması (JSON)

Kimlik doğrulama

Her istek Authorization başlığında bir API anahtarı gerektirir.

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

Anahtarları oluşturup yönetin: profiliniz

Günlük kotalar

Free	100 istek/gün
Radar	1.000 istek/gün
Pro	10.000 istek/gün
Trader+	100.000 istek/gün

Free dahil her plan API erişimi içerir. /analysis her planda gerçek zamanlı mumlar döndürür; /fundamental, temel analiz içeren bir plan gerektirir (Pro ve üzeri). Bir hesabın tüm anahtarları tek bir günlük kotayı paylaşır; ani yük sınırı dakikada 60 istektir.

Yanıtlar X-RateLimit-Limit ve X-RateLimit-Remaining başlıklarını içerir. Kota aşımı → HTTP 429.

Uç noktalar

GET /api/v1/markets?limit=100
Piyasa değerine göre en iyi coinler: fiyat, piyasa değeri, hacim, 1s/24s/7g değişim.
GET /api/v1/candles?symbol=btc&id=bitcoin&interval=1h&limit=300
OHLCV mumları (en eskiden başlayarak, bar zamanı unix saniye) — /analysis'in hesapladığı serinin aynısı, planınızın geçmiş penceresine kadar.
GET /api/v1/analysis?symbol=btc&id=bitcoin&interval=1h
Teknik anlık görüntü: fiyat, trend, RSI/ADX/ATR, TA konsensüsü, rejim, bileşik skor. Aralıklar: 1m–1M.
GET /api/v1/fundamental?assetId=bitcoin
Temel Skor: 5 kategoride emsal grubu yüzdelik dilimi + 90 günlük geçmiş; assetId olmadan — son skorlar listesi. Temel analiz içeren plan gerekir.
GET /api/v1/announcements?kind=listings&days=7
Borsaların listeleme / delist / uyarı duyuruları (Binance, Bybit, OKX, Upbit, Bithumb): yayın anındaki, 3 dakika sonraki ve radarımızın yakaladığı andaki fiyat ile 1 sa / 24 sa / 7 g hareketleri. Free anahtarlar bir satırı yakalamadan 10 dakika sonra ve son 30 gün için görür; Radar+ gecikmesiz ve 2021'den beri tüm arşivi.
GET /api/v1/news?limit=30
Toplanmış kripto haber başlıkları (CoinDesk, Cointelegraph, Decrypt, The Block, Bitcoin Magazine).
GET /api/v1/presets
Tarayıcı ön ayarları: kimlik, ad, her birinin uyguladığı filtreler, işlem yönü ve planınızın düşüreceği filtreler.
GET /api/v1/funding?limit=100&sort=fundingAbs
Perp funding (8 saatlik eşdeğer, Binance/Bybit), Bybit/OKX/Hyperliquid karşılaştırması, baz, açık pozisyon ve 1s/4s/24s değişimi. Sıralama: rank, funding, fundingAbs, oiUsd, oiChangePct.
GET /api/v1/screener?preset=oversold_reversal&interval=4h
Bir tarama çalıştırır: planınızın evreninde 15m–1w aralığında ön ayar ve/veya filtreler. Skor, setup seviyeleri ve TradingView sembolüyle güncel eşleşmeleri döndürür.

Tüm uç noktalar JSON döndürür: başarıda { "data": … }, aksi halde { "error": "code" }. CORS açık.

Kimliği doğrulanmış her yanıt ayrıca X-RateLimit-Reset (bir sonraki sıfırlamanın unix saniyesi, 00:00 UTC) taşır. 429 ve 502 yanıtları saniye cinsinden Retry-After taşır — o kadar bekleyin; bir 4xx'i asla değiştirmeden tekrarlamayın. Bilinmeyen sembol → 404 unknown_symbol. v1 içinde alanlar yalnızca eklenir, asla kaldırılmaz veya türü değişmez.

Tarayıcı ayrıca 503 busy (tüm tarama yuvaları dolu) veya 502 upstream_degraded (coinlerin çoğu okunamadı) yanıtı verebilir — ikisi de Retry-After içerir ve kotadan düşülmez. GET dışındaki her yöntem JSON 405 alır.

Bir bot için aşağıdaki duyuru webhook'u daha iyi bir kaynaktır: gönderilir ve yeniden denenir. Duyuruları yoklama: since=<ms cinsinden addedAt> gönderin, sonraki her çağrıda bir önceki yanıtın nextCursor değerini cursor olarak verin. Satırlar radarımızın eklediği sırayla gelir; geç yakalanan bir duyuru asla atlanmaz; tekrarları id ile ayıklayın. since olmadan satırlar en yeni yayımlanandan başlar — hasMore true olduğu sürece cursor ile eskilere geçin. Satır döndürmeyen bir yoklama, hesap başına 10 saniyede bir kota birimi harcamaz (quotaCharged: false); yani 10 saniyede bir yoklamak her plana sığar. Satır içeren bir yanıt her zamanki gibi sayılır.

# 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"

Ticker başına fiyatlar: priceAtAnnouncement ve move1hPct / move24hPct / move7dPct yayın dakikasından başlar — uyumluluk için korunur, hızlı bir listelemede işlem yapılabilecek bir fiyat değildir. priceAt3m ile movesFrom3m (ve BTC hareketi düşülmüş movesFrom3mVsBtc) yayından 3 dakika sonra başlar — sitedeki istatistiklerin temeli; priceAtDetection ile movesFromDetection radarımızın duyuruyu yakaladığı anda başlar. Her ufuk aynı anda biter, horizonsEndAt (yayın dakikası + 1 sa / 24 sa / 7 g): +3 dk'dan "1 sa" 57 dakikadır ve yakaladığımızda %75'ten azı kalan bir ufkun yakalamadan hareketi yoktur. Komisyon, kayma ve funding dahil değildir.

Bot alanları (API ve webhook): market (spot / perp / alpha / tradfi), quotes (başlıkta geçen kotasyon piyasaları, ör. KRW, BTC, USDT — belirtilmemişse boş), tradingStartsAt (yalnızca başlık bir saat belirtiyorsa; aksi hâlde null — duyuru metni ayrıştırılmaz), detectedAt (radarımızın ilk gördüğü an) ve tradable — işlem için piyasa kodları: role notice = duyurunun konusu olan piyasa (INITUSDT, KRW-INIT, INIT-USD), role reference = fiyatlarımızı okuduğumuz Binance/Bybit piyasası.

Tarayıcı API'si

Herhangi bir tarayıcı ön ayarını veya kendi filtrelerinizi koddan çalıştırın — sitedekiyle aynı motor, evren ve plan sınırları. Her sonuç setup seviyelerini ve bir TradingView sembolünü içerir, bota hazırdır.

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 } } ] } }

Parametreler: preset, filters (JSON), interval (15m, 1h, 4h, 1d, 1w), universe (planınızla sınırlı), limit. Dakikada en fazla 6 tarama. 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. Sayısal kısaltmalar: rsiMin, rsiMax, scoreMin, scoreMax, relVolumeMin, adxMin, adxMax, change24hMin, change24hMax, change7dMin, change7dMax, volumeMin.

Alım satım botları için webhook'lar

Alarmlar, kayıtlı taramaların yeni eşleşmeleri ve günün fikirleri kendi https URL'nize POST ile gönderilebilir. Biçimi Profil → Bildirimler bölümünden seçin.

JSON — bildirim başına bir istek; yapılandırılmış alanlar (olay türü, sembol, borsa başına TradingView sembolü, yön, fiyat, zaman dilimi, alarm id'si, giriş/stop/hedefler) ve orijinal subject/text/url alanları.
3Commas — 3Commas sinyal botu biçiminde sinyal başına bir istek; botunuzun secret ve bot_uuid değerlerini şablona yapıştırın.
Cornix — olay başına Cornix tarzı bir düz metin sinyali (parite, borsa, yön, giriş, kâr al hedefleri, stop).
Custom — çift süslü parantezli yer tutucularla kendi şablonunuz; ticker, exchange, close ve interval gibi TradingView tarzı adlar da çalışır.

{ "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 sinyal botu şablonu:

{
  "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"
}

Yer tutucular: {{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 yer tutucusu YALNIZCA bot işlemi için onayladığınız sinyallerde enter_long / enter_short olur: bir alarmın Bot seçimi (long, short veya setup yönünü izle), kayıtlı taramanın “Bota gönder” seçeneği (yalnızca kapanmış mumda onaylı setup'lar) veya günün fikirleri anahtarı. Fiyatın bir seviyeyi geçmesi tek başına asla yön belirtmez. Diğer her şey bilgi amaçlıdır ve 3Commas'a ya da Cornix'e asla ulaşmaz. Her sinyal signal_id ve orijinal zaman damgasını taşır; asla yeniden gönderilmez, 5 dakikadan geç gönderilmez ve 24 saatte en fazla günlük bot limitiniz (≤ 10) kadar gönderilir.

Bracket alarmları: girişe dokunulması, bracket'in stop ve hedefleriyle enter_long / enter_short gönderir; stop (veya iz süren stop) ve son hedef exit_long / exit_short gönderir — yalnızca girişimizi almış bir bota. Cornix girişi stop ve hedefleriyle alır ve işlemi kendisi kapatır. Doğrulanmış borsa piyasası olmayan bir coin, 3Commas / Cornix'e giden bir hisse, spot piyasada short ya da sinyalin kendi seviyeleriyle çelişen bir yön asla işlem olarak gönderilmez.

Her istek imzalıdır: X-GCS-Signature: sha256=HMAC(gövde, gizli anahtarınız). Bot biçimleri bildirim başına en fazla 10 sinyal gönderir.

Duyuru webhook'u (Radar ve üstü)

Duyuru ayarlarınıza uyan her listeleme, delist veya uyarı duyurusu, radarımız yakaladığında JSON olarak (event "announcement") POST edilir — yalnızca JSON biçimi. Her denemenin 8 saniyelik süresi vardır ve yönlendirmeler izlenmez: hızlıca 2xx yanıtlayın. Başarısız bir deneme, 30 dakikaya kadar artan aralıklarla yaklaşık 2 saat içinde en fazla 9 kez yeniden denenir; yani bir teslimat gecikmeli gelebilir. Tekrarları eventId ile ayıklayın (X-Getcoinsight-Delivery başlığı da odur; attempt ve X-Getcoinsight-Attempt deneme sayısıdır) ve tazeliği announcement.detectedAt veya firstAttemptAt ile değerlendirin — timestamp o denemenin gönderim zamanıdır. Kaçırılanları /api/v1/announcements?since=… ile tamamlayın. Art arda 20 başarısız teslimattan sonra webhook kapatılır ve zil simgesinde bir bildirim alırsınız.

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'unuzu Profil → Bildirimler bölümünden kurun →