API Referansı

Temel URL: https://api.n0brains.com · Tüm yanıtlar JSON'dur · Zaman damgaları Unix epoch (saniye) cinsindendir

Hızlı başlangıç

  1. Bir hesap oluştur — API anahtarınızı anında alın
  2. Her istekte X-API-Key başlığını ayarlayın
  3. GET /signals çağırın — bitti
curl -H "X-API-Key: intel_sk_your_key" https://api.n0brains.com/signals

Sinyallerin nasıl performans gösterdiğini görmek ister misiniz? Canlı forward-test'imiz şurada: /proof.

Ajanlar için

Acele mi var? Quickstart kopyala-yapıştır istemler içerir — ücretsiz katman için tek satırlık ve tam bir Pro/MCP ajanı. Ya da ayrıntılar için okumaya devam edin.

n0brains düz bir HTTP API'dir — SDK yok, kurulum adımı yok. Herhangi bir ajanı (Claude Code, OpenClaw, LangChain, özel bir orkestratör) temel URL ve anahtarınızı vererek ona yöneltin. Ajanın yönergelerine bir satır:

Use the n0brains API at https://api.n0brains.com with X-API-Key intel_sk_your_key

Gerçek anahtarınızı yerleştirin, entegrasyonun tamamı budur — ajan endpoint'leri API'nin biçiminden örtük olarak keşfeder (tam referans aşağıda). Temel URL https://api.n0brains.com, auth başlığı X-API-Key.

İsteğe bağlı: yapılandırılmış bir skill dosyası

Bazı runtime'lar tek satırlık bir yönerge yerine yapılandırılmış bir skill dosyasını tercih eder. n0brains-signals.md aynı şeyi paketler — frontmatter, örneklerle her araç, auth, hata işleme, davranış kuralları — bırakacağınız tek bir Markdown dosyası olarak. Tek satırlık da aynı derecede iyi çalışır; bu, onu kodlanmış istediğinizde içindir.

curl -O https://n0brains.com/openclaw/n0brains-signals.md

n0brains-signals.md indir ↓

RuntimeNereye giderAuth
OpenClawn0brains-signals.md dosyasını ajanınızın skills dizinine bırakınenv NB_API_KEY
Claude Code~/.claude/skills/n0brains-signals/SKILL.md konumuna kopyalayınenv NB_API_KEY
Özel orkestratör.md'yi sistem bağlamı olarak yükleyin veya tek satırlık yönergeyi kullanıngizli deponuz, anahtar n0brains_api_key
Doğrudan HTTP / TS istemcisiskill'i atlayın — aşağıdaki endpoint'leri kullanın veya n0brains-ts istemcibaşlık X-API-Key

Tipli çağrıları mı tercih ediyorsunuz? İsteğe bağlı TypeScript istemcisi n0brains-ts (@n0brains/client) her endpoint'i sarar. Veya CLI shell için ve MCP server Claude Desktop / Cursor / Cline için.

Planlar ve krediler

Ücretsiz ve Pro, iki abonelik katmanıdır (oran limitleri yukarıda). Katmanınıza dahil oranın ötesinde iki kullandıkça-öde seçeneğiniz var:

SeçenekNasıl çalışırHesap?
Çağrı-başına-ödeme kredileri Tek seferlik paketler ($5'ten). Bir kredi yalnızca planınızın dahil oran limitinin ötesinde yapılan bir veri çağrısında harcanır — oranınız dahilinde çağrılar ücretsiz kalır. Bunları şuradan satın alın ve takip edin: hesap. Evet — Stripe ile kart
x402 Base üzerinde USDC ile istek başına ödeyin, kayıt yok. Bkz. /docs/x402. Hayır — cüzdansız

Kredileriniz bittiğinde ve oran limitinizi aştığınızda, veri endpoint'leri daha fazla satın almak için bir bağlantıyla 402 döndürür. Oran limitiniz dahilinde hiçbir ücret alınmaz.

Kimlik doğrulama

Tüm kimlik doğrulamalı endpoint'ler X-API-Key başlığı üzerinden bir API anahtarı gerektirir. Anahtarlar kayıtta üretilir ve POST /auth/api-keys ile döndürülebilir.

Giriş ayrıca Authorization: Bearer ile kullanılabilir bir JWT token döndürür.

MetotBaşlıkÖrnek
API KeyX-API-Keyintel_sk_a1b2c3...
JWT TokenAuthorizationBearer eyJhbGci...

Oran limitleri

Katmanİstek/dkSinyal gecikmesiErişim
Ücretsiz6015 dakikaYalnızca REST API, sınırlı alanlar. Katalog keşfi için MCP tools/list açık.
Pro600Gerçek zamanlıREST + WebSocket + Webhooks + MCP sunucusu, tam alanlar

Oran limiti aşıldığında, yükseltme sayfasına işaret eden bir mesajla 429 döner.

Endpoint'ler

MetotYolAuthAçıklama
GET/healthYokCanlılık kontrolü
GET/signalsAPI KeyAktif sinyalleri listeler. Kripto veya tokenize hisse senedi piyasasına daraltmak için ?asset=, ?signal_type=, ?urgency=, ?direction= ve ?asset_class= (crypto · stock · metal · commodity · index) ile filtreleyin
GET/signals/{id}API KeyTek sinyal detayı
GET/signals/similarProAnlamsal en-yakın-komşu araması
GET/narrative/{coin}ProVarlık için anlatı ısı haritası
GET/manipulation/{coin}ProVarlık için manipülasyon puanı
GET/trust/{coin}ProToken için güven ve dolandırıcılık puanı
GET/levels/{coin}API KeyHyperliquid'den S/R seviyeleri
GET/indicators/{coin}API KeyTeknik göstergeler — RSI, MACD, SMA/EMA (20/50/200 + 200-hafta), Stochastic, Fibonacci, trend/momentum okuması
GET/state/{coin}/briefProLLM tarafından yazılmış düz metin analizi — güncel okuma, kilit + yapısal seviyeler, makro/on-chain, teknikler, görünüm. /state üzerindeki anlatı katmanı, yalnızca verimize dayalı
GET/liquidation-map/{coin}API KeyCEX tahmini likidasyon-kümesi bölgeleri (OI + kaldıraç kademelerinden modellenmiş)
GET/liqmap/{coin}API KeyDEX gerçek on-chain likidasyon haritası — tam likidasyon fiyatlarıyla gerçek pozisyonlar. Kripto (Hyperliquid + GMX) ve Hyperliquid HIP-3 üzerinden tokenize hisse senedi piyasası (/liqmap/SP500, /liqmap/NVDA, /liqmap/GOLD, …)
GET/liquidation-heatmap/{coin}API KeyCEX likidasyon ısı haritası — fiyat×zaman yoğunluk ızgarası. ?days= (1–180), ?rows=, ?cols=
GET/liq-heatmap/{coin}API KeyDEX gerçek-pozisyon likidasyon ısı haritası — fiyat×zaman ızgarası (BTC/ETH)
GET/charts/options-walls/{symbol}YokListelenmiş-opsiyon açık-pozisyon duvarları + toplam max pain (CBOE, gecikmeli) bir hisse/endeks için — likidasyon kümelerinin hisse-piyasası karşılığı. Strike duvarları vade sonuna doğru mıknatıs/çivi gibi davranır.
GET/charts/stock-candles/{symbol}YokTokenize bir varlığın dayanak varlığı için gerçek-borsa seans mumları (Yahoo, gecikmeli) — 7/24 tokenize fiyata karşı bindirin. ?days=
GET/charts/hip3-estimate-heatmap/{symbol}YokTokenize bir hisse/metal/endeks için modellenmiş likidasyon-yoğunluğu ısı haritası — canlı Hyperliquid HIP-3 açık pozisyonundan gerçek fiyat yoluna kaldıraç-kademesi projeksiyonu (ince on-chain defterin seyrek olduğu yerde Coinglass-tarzı yoğunluk). ?days=
GET/correlationAPI KeyVarlıklar-arası getiri-korelasyon matrisi (7g). ?vs=BTC, ?coins=…
GET/correlation/{coin}API KeyBir coin'in BTC/ETH + eşlerle korelasyonu + beta'sı
GET/rotationAPI KeyAltseason/rotasyon okuması — into_alts / into_btc / neutral
GET/options/{coin}API KeyOpsiyon analitiği (BTC/ETH): ATM IV, skew, vade yapısı, max-pain
GET/sentiment/{coin}API KeyToplu duygu — net eğilim, hacim, hız (seçilmiş kaynaklar)
GET/mindshareAPI KeyDikkat payı sıralaması — her varlığın payı + hızı (yükselen/düşen)
GET/mindshare/{coin}API KeyBir coin'in mindshare payı, sırası, hızı
GET/market-opensAPI KeySeans açılış fiyatları
GET/price/{coin}YokBir coin için güncel spot/orta fiyat (Hyperliquid)
GET/prices?coins=BTC,ETH,SOLYokTek çağrıda toplu güncel fiyatlar
GET/market-state/{coin}ProCoin başına kanıtlanmış-sinyal konsensüsü — yön, güven, rejim, başlıca sürücüler
GET/stateProBirleşik piyasa durumu — rejim + bileşik, makro paket, kanıtlanmış türler, tek çağrıda coin başına özet
GET/state/{coin}ProTek çağrıda coin başına görünüm — fiyat, market-state, rejim + bileşik, seviyeler, teknik göstergeler, liqmap hedefi
GET/plan/{coin}ProDerlenmiş işlem planı — yön, giriş, en güçlü hedef (yakınlık değil güce göre ağırlıklı), stop, risk/ödül, boyutlandırma ipucu, opsiyon bağlamı (put/call + skew) ve uyarılar (işlemin aleyhine max-pain zamanlaması, bir likidasyon kümesine yakın giriş). /state + /levels + /options üzerindeki sentez katmanı
GET/rank?coins=BTC,ETH,SOLProVarlıklar-arası sıralama — verilen coin'ler için derlenmiş işlem planları, setup_score'a göre sıralı (en iyisi önce). «Şu an hangi coin daha iyi bir işlem?» sorusunu yanıtlar.
POST/checkAPI KeyÖnce n0brains'e sorun — işlem-öncesi kontrol. Bir işlem gönderin (asset, side, isteğe bağlı entry/stop/target/leverage/horizon_hours) → her gerekçeyle birlikte A–F derecelendirilmiş bir koşul değerlendirmesi: kalabalıklaşma, olay riski, volatiliteye karşı likidasyon mesafesi, momentum uzaması, konumlanma ve yapısal bir ölümcül-stop kontrolü. grade, score, engine_version, asset_class, flags, supports, falsifiers, terrain, unchecked döndürür. Kripto ve tokenize hisse senedi piyasası (NVDA, SP500, XYZ100, GOLD…) için çalışır. Her karar kalıcı olarak günlüklenir ve ufkunda çözülür. Dereceler-arası performans, dağıtılmış kalibrasyon kapısı biriktikçe tutulur. Ücretsiz 3/gün, Pro sınırsız. Markalı bir PNG için "chart": true geçin.
POST/check/anonYokIP başına günde bir anonim işlem-öncesi kontrol (Turnstile kapılı). /check ile aynı derecelendirilmiş yanıt.
GET/checks/historyAPI KeyGeçmiş kontrolleriniz + çözülmüş sonuçlar (ufukta tarafa-göre-ayarlanmış getiri veya önce vurulduysa stop).
GET/check/assetsYokKontrol edilebilir varlık evreni — kripto perp'ler + tokenize hisse/metal/endeksler.
POST/check/chart-parseAPI KeyBir grafik ekran görüntüsünden ticker + zaman dilimini okur (görü), böylece bir ajan bir kontrole ham görüntü verebilir. Yalnızca kimlik — asla piksellerden fiyat.
POST/check/levelsAPI KeyKendi çizdiğiniz yatay seviyeleri S/R bölgelerimiz + on-chain likidasyon kümelerimize karşı derecelendirin (çizgide mıknatıs / çizgi ötesinde fitil riski).
GET/macroAPI KeyGünlük makro koşullar/rejim; mevcut olduğunda varlık başına eğilim
GET/macro?history=NProMacro Pulse tarihsel anlık görüntüleri (son N rapor, maks 30)
GET/regimeAPI KeyPiyasa genelinde risk iştahı — risk-on / risk-off / squeeze + işaretli bir risk puanı ve yönlü bir market_bias, makro bileşik, kesitsel genişlik, funding rejimi ve volatiliteden harmanlanmış. «Koşullar şu an riski destekliyor mu?» sorusunu yanıtlar. Betimsel, aday.
GET/liquidityAPI KeyNet varlıklar-arası likidite haritası — Fed net likiditesi, çoklu-zincir stablecoin kuru-barutu (DefiLlama), toplam perp OI, venue'lar-arası kaldıraç yoğunlaşması (çağlayan-kırılganlığı), likidasyon baskısı, net taker akışı. «Likidite nerede?» sorusunu yanıtlar.
GET/flowsAPI KeyVarlıklar-arası akışlar — kripto rotasyonu, varlık sınıfına göre kripto-vs-tradfi OI ayrımı ve kurumsal duruş (ETF / COT / 13F, betimsel). «Para nereye gidiyor ve piyasa kriptodan başka bir şey mi alıyor?» sorusunu yanıtlar.
GET/market-mapAPI KeyTek çağrıda /regime + /liquidity + /flows bileşimi — tam varlıklar-arası piyasa tablosu.
GET/discoveryAPI KeyBeliren-edge keşfi — gölge ledger'dan çıkarılan doğrulama sınıf-kombinasyonlarının gerçekleşen ileri-getirilerle karşılaştırılması, ölçülen edge'e göre sıralı (dürüstlük kapılı). Kimsenin elle kodlamadığı desenleri açığa çıkarır. Ledger dolana kadar status=accruing.
GET/performanceYokGenel kazanma oranı / PnL istatistikleri
GET/proofYokİleri-getiri skor tablosu — tür başına kazanma oranı, BTC'ye karşı fazlalık, GA, kanıtlanmış bayrağı (şunu besler: /proof)
GET/proof/equityYokKanıtlanmış-tür sinyaller üzerinde edge-birikim equity eğrisi
GET/public/feedYokGenel gecikmeli sinyal beslemesi (ücretsiz katmanın 15 dk gecikmeli akışı)
GET/status/uptimeYokHizmet çalışma süresi / durum anlık görüntüsü
POST/auth/registerYokHesap oluştur
POST/auth/loginYokGiriş yap
GET/auth/meAPI KeyKullanıcı profili
POST/auth/api-keysAPI KeyYeni API anahtarı oluştur
DEL/auth/api-keys/{id}API KeyAPI anahtarını iptal et
POST/billing/checkoutAPI KeyStripe abonelik ödemesi (Pro)
POST/billing/buy-creditsAPI KeyBir kredi paketi için Stripe tek seferlik ödeme
GET/billing/credit-packsAPI KeySatın alınabilir kredi paketlerini listeler
GET/creditsAPI KeyKredi bakiyesi + işlem geçmişi
POST/billing/portalAPI KeyStripe müşteri portalı
POST/webhooksProWebhook kaydet
DEL/webhooks/{id}ProWebhook kaldır
WS/streamProGerçek zamanlı sinyal akışı
POST/mcp/Pro (tools/call); open (tools/list)MCP sunucusu — Claude Desktop, Cursor, Cline için salt-okunur araçlar. Bkz. /docs/mcp.

Komut satırını mı tercih ediyorsunuz? n0brains CLI her endpoint'i JSON yazdıran, bağımlılığı olmayan bir komut olarak sarar — işlem ajanları ve shell pipeline'ları için yapıldı. Hesabı olmayan ajanlar da şunu yapabilir: Base üzerinde USDC ile çağrı başına öde (x402) — anahtar yok, kayıt yok.

GET /signals

Aktif sinyalleri, isteğe bağlı filtrelenmiş olarak döndürür. Ücretsiz katman sinyalleri 15 dakika gecikmeyle alır.

Sorgu parametreleri

ParamTürAçıklama
assetstringTicker'a göre filtrele (ör. BTC)
signal_typestringregulatory, whale, whale_position, sentiment, price, hack, listing, macro, macro_flow, macro_pulse, liquidation, funding, deleverage, unlock, research, other.
directionstringbullish, bearish, neutral
urgencystringhigh, medium, low
limitint1-200 (default 50)
offsetintSayfalama ofseti (varsayılan 0)
include_opensboolPiyasa açılış fiyatlarını dahil et (varsayılan true)
min_confidencefloatMinimum güven puanı (0.0–1.0, varsayılan 0.0)
min_scorefloatMinimum sinyal puanı (varsayılan 0.0)
bandstringİşlem kalitesi bandına göre filtrele: A+, A, B, C, D
min_trade_qualityfloatMinimum işlem kalitesi puanı (0.0–1.0, varsayılan 0.0)
proven_onlyboolYalnızca BTC'yi geçtiği (alpha) ve yön başına kârlı olduğu kanıtlanmış sinyal türleri (varsayılan false)
tradeable_onlyboolYalnızca conviction=strong sinyalleri (varsayılan false)

Yanıt - Ücretsiz katman

{
  "count": 3,
  "signals": [
    {
      "id": 195,
      "asset": null,
      "signal_type": "regulatory",
      "direction": "neutral",
      "urgency": "medium",
      "summary": "Senate Banking Committee scheduled to vote on the Clarity Act crypto bill.",
      "confidence": 0.15,
      "conviction": "watch",
      "action_hint": "monitor",
      "corroborated": false,
      "score": 0.27,
      "trade_quality_score": 0.61,
      "trade_quality_band": "B",
      "expected_move_pct": null,
      "regime_at_signal": "risk-off",
      "timestamp": 1778555605,
      "expires_at": 1778570005,
      "type_performance": {
        "excess_pct": 0.3,
        "hit_rate": 0.08,
        "proven": false,
        "n": 398
      },
      "disclaimer": "Analytical data only. Not financial advice."
    },
    {
      "id": 196,
      "asset": "ETH",
      "signal_type": "sentiment",
      "direction": "bearish",
      "urgency": "high",
      "summary": "Sharp negative social shift on ETH as funding flips and large holders trim.",
      "confidence": 0.71,
      "conviction": "strong",
      "action_hint": "trade_signal",
      "corroborated": true,
      "score": 1.38,
      "trade_quality_score": 0.74,
      "trade_quality_band": "A",
      "regime_at_signal": "risk-off",
      "timestamp": 1778555800,
      "expires_at": 1778570200,
      "reference_price": 3210,
      "invalidation_level": 3274.2,
      "target_level": 3081.6,
      "levels_basis": "model",
      "type_performance": {
        "excess_pct": 4.96,
        "hit_rate": 0.61,
        "proven": true,
        "n": 1016
      },
      "historical_edge": {
        "cell": "sentiment|bearish|risk-off",
        "sample_n": 36,
        "win_rate": 0.97,
        "avg_pnl_pct": 7.19,
        "median_pnl_pct": 6.9,
        "as_of": "2026-05-27T02:09:02+00:00"
      },
      "disclaimer": "Analytical reference levels for informational purposes only. Not a recommendation to buy or sell, and not financial advice."
    },
    {
      "id": 197,
      "asset": "BTC",
      "signal_type": "regulatory",
      "direction": "bullish",
      "urgency": "medium",
      "summary": "Industry group endorses ETF approval extension; broader institutional access expected.",
      "confidence": 0.45,
      "conviction": "notable",
      "action_hint": "alert",
      "corroborated": true,
      "score": 0.81,
      "trade_quality_score": 0.52,
      "trade_quality_band": "C",
      "regime_at_signal": "squeeze",
      "timestamp": 1778556100,
      "expires_at": 1778570500,
      "type_performance": {
        "excess_pct": -2.1,
        "hit_rate": 0.04,
        "proven": false,
        "n": 352
      },
      "historical_edge": {
        "cell": "regulatory|bullish|squeeze",
        "sample_n": 128,
        "win_rate": 0,
        "avg_pnl_pct": -4.91,
        "median_pnl_pct": -4.65,
        "as_of": "2026-05-27T02:09:02+00:00"
      },
      "paired_inverse": {
        "direction": "bearish",
        "basis": "historical_anti_predictive_cell",
        "implied_avg_pnl_pct": 4.91,
        "flipped_cell_stats": {
          "n": 14,
          "win_rate": 0.93,
          "avg_pnl_pct": 3.92
        },
        "advisory_text": "Historical 0% win rate (128 samples) on bullish regulatory in squeeze regime suggests fade. Not a recommendation — informational only.",
        "citation": "De Bondt & Thaler 1985 JoF; Tetlock 2007 JoF; Chan 2003. Short-term overreaction to dramatic news reverses on horizon of days–weeks. Crypto: PLOS One 2024."
      },
      "disclaimer": "Analytical data only. Not financial advice."
    }
  ],
  "market_opens": {
    "tokyo": {
      "BTC": 81150,
      "ETH": 3200.5,
      "SOL": 96.3,
      "timestamp": 1778539200
    },
    "london": {
      "BTC": 81201.5,
      "ETH": 3205,
      "SOL": 96.48,
      "timestamp": 1778553600
    },
    "new_york": {
      "BTC": 81262.5,
      "ETH": 3210,
      "SOL": 96.55,
      "timestamp": 1778560800
    }
  }
}

Pro Katman Eklentileri

Her sinyal nesnesi şu ek alanları içerir:

{
  "sources": [
    "news",
    "whale"
  ],
  "source": "news",
  "channel": "google_crypto"
}

Sinyal alanları

AlanTürAçıklama
idintBenzersiz sinyal ID'si
assetstring|nullTicker sembolü veya piyasa geneliyse null
signal_typestringregulatory, whale, whale_position, sentiment, price, hack, listing, unlock, research, macro, macro_flow, macro_pulse, liquidation, funding, deleverage, other
directionstringbullish, bearish, neutral
urgencystringhigh, medium, low
summarystringEn fazla 100 karakter açıklama
confidencefloat0.0-1.0, kalibre edilmiş P(kazanç) — kapanmış işlem sonuçlarından türetilen, sinyal türüne göre kutulanmış ampirik kazanma oranı (ham LLM puanı değil). Haftalık güncellenir.
convictionstringstrong, notable, watch, none — bir sinyalin gücüne dair analitik değerlendirmemiz (işlem talimatı değil). strong veriye dayalıdır: yalnızca ölçülen ileri-getiri kaydı istatistiksel çıtamızı aşan sinyal türlerine (bkz. /proof), o türün puan dağılımının en üstünde ve yalnızca beklenen hareket gidiş-dönüş işlem maliyetini aştığında uygulanır (ücret + slippage'i aşamayacak kadar küçük bir hareket notable'a düşürülür). Bu alanı kullanın.
action_hintstringKullanımdan kaldırıldıconviction'ın önceki adı (trade_signal↔strong, alert↔notable, monitor↔watch, ignore↔none). Geriye dönük uyumluluk için bu sürümde hâlâ yayınlanıyor; kaldırılacak. conviction'a geçin.
corroboratedboolBirden fazla kaynak varlığı doğruladığında VE son okumalar yönü net olarak çelişmediğinde true (yön-farkında — bullish bir çağrı, aynı coin hakkındaki bearish gevezelikle doğrulanmaz)
scorefloatIC-ağırlıklı bileşik: source_weight x urgency x calibrated_confidence x sinyal-türü bilgi katsayısı
timestampintUnix epoch (saniye)
expires_atintBu sinyalin ne zaman sona ereceği
sourcesarrayYalnızca Pro - Katkıda bulunan kaynak adları
sourcestringYalnızca Pro - Birincil kaynak adı
channelstringYalnızca Pro - Belirli kanal/besleme
trade_quality_scorefloat0.0–1.0 bileşik sinyal kalitesi (rejim + güven + doğrulama)
trade_quality_bandstringA+/A/B/C/D kalite bandı — A+ ≥ 0.85, A ≥ 0.70, B ≥ 0.55, C ≥ 0.40
expected_move_pctfloat|nullTahmini hareket boyutu, en yakın S/R deltası + ATR'ye göre fiyatın %'si olarak
type_performanceobjectBu sinyal türünün ölçülen geçmiş performansı: {excess_pct, hit_rate, proven, n} — 1 saatte BTC'ye karşı ileri getiri (alpha), isabet oranı, kanıtlanmış bayrağı, örneklem boyutu
reference_pricefloatyalnızca trade_signal — algoritmik referans fiyat (analitik, bir giriş tavsiyesi değil)
invalidation_levelfloatyalnızca trade_signal — sinyalin tezini yanlışlayacak fiyat
target_levelfloatyalnızca trade_signal — sinyalin yönündeki en yakın analitik hedef
levels_basisstringyalnızca trade_signal — sr_touches (emir-defteri S/R) veya model (türetilmiş)
resistance_low / resistance_highfloatDirenç seviyesinin bölge bandı (S/R bir çizgi değil, bir alandır) — dokunma kümesinin fiyat aralığı. Orta noktayı değil, bölge kenarını hedefleyin.
support_low / support_highfloatDestek seviyesinin bölge bandı — destek tarafında aynı fikir.
resistance_flipped / support_flippedboolPolarite tersine dönüşü: bu seviye başlangıçta ters role sahipken fiyat o zamandan beri onu kırıp geçtiğinde true (eski bir destek şimdi direnç olarak davranıyor veya tersi). Tersine dönmüş bir seviye gerçektir ama biraz daha düşük bir güç ağırlığı taşır.
regime_at_signalstringSinyal üretildiğinde piyasa rejimi: risk-on, risk-off, range, squeeze
manipulation_scorefloatsinyal oluşturma anında 0.0–1.0 koordinasyon/manipülasyon olasılığı
wallet_typestring|nullYalnızca balina sinyali — vc_institutional, smart_whale, market_maker, mev_arb, sniper, vb.
smart_money_scorefloat|nullYalnızca balina sinyali — kaynak cüzdanın güvenilirliği (0.0–1.0)
trust_scorefloat|nullLaunchpad/token sinyalleri — bileşik sözleşme güveni (0.0–1.0)
rug_probabilityfloat|nullLaunchpad/token sinyalleri — tahmini rug/dolandırıcılık olasılığı (0.0–1.0)
is_honeypotbool|nullLaunchpad/token sinyalleri — GoPlus honeypot bayrağı
historical_edgeobject|nullBu sinyalin (signal_type × direction × regime_at_signal) hücresi için, ölçülen sinyal ileri-getirilerinden betimsel istatistikler. Nesne: {cell, sample_n, win_rate, avg_pnl_pct, median_pnl_pct, as_of}. Haftalık yenilenir. Rejim veya tür eksikse null.
paired_inverseobject|nullTers-yön uyarısı. Yalnızca tarihsel hücre ampirik olarak anti-tahmin edici olduğunda bulunur (n ≥ 30, win_rate ≤ 30%, avg_pnl ≤ -2%). Nesne: {direction, basis, implied_avg_pnl_pct, flipped_cell_stats, advisory_text, citation}. Hakemli kısa vadeli tersine dönüş literatürünü alıntılar (De Bondt & Thaler 1985, Tetlock 2007, Chan 2003, PLOS One 2024). Bilgilendirme amaçlı; asla işlem tavsiyesi değil.

Tarihsel edge ve eşleştirilmiş ters

Her sinyal, aynı (signal_type × direction × regime_at_signal) hücresindeki geçmiş sinyallerin ölçülen ileri getirilerini tanımlayan bir historical_edge nesnesi taşır. İstatistikler haftalık yenilenir. Alanlar betimseldir — kapı, boyutlandırma veya tavsiye yapmazlar.

Bir hücre ampirik olarak anti-tahmin edici olduğunda (n ≥ 30 kapanmış işlem, kazanma oranı ≤ 30%, ortalama PnL ≤ -2%), sinyal ayrıca bir paired_inverse nesnesi taşır. Aynı olayın ters-yön okumasını, hakemli kısa vadeli tersine dönüş literatürüne bir atıfla birlikte açığa çıkarır (De Bondt & Thaler 1985, Tetlock 2007, Chan 2003, PLOS One 2024). Tavsiye değil, veri olarak sunulur: flipped_cell_stats alanı, ters-yön hücresinin geçmişte gerçekte nasıl performans gösterdiğini gösterir; bu, saf-tersine-çevirme terimleriyle implied_avg_pnl_pct'nin öne süreceğinden çoğu zaman daha zayıftır.

Sinyal kalitesini bağlamda yorumlamak için bu alanları kullanın. Güçlü bir historical_edge'e (yüksek win_rate, büyük avg_pnl_pct, büyük sample_n) sahip bir sinyal, edge'in zayıf veya ters olduğu bir hücredeki aynı sinyalden daha güvenilirdir. Hücre istatistikleri ve herhangi bir eşleştirilmiş-ters uyarı kendi analiziniz içindir — bunlar işlem tavsiyesi değildir ve pozisyon boyutu ya da kaldıraç önermeyiz.

GET /levels/{coin}

Hyperliquid emir defterinden en yakın destek/direnci döndürür — bölgeler olarak (her seviye fiyat bandını taşır), polarite-tersine-dönüş takibiyle (kırılan bir destek direnç olarak gösterilir ve tersi).

{
  "coin": "BTC",
  "current_price": 81262.5,
  "nearest_resistance": 81450,
  "nearest_support": 80871,
  "all_resistance": [
    81450,
    81800,
    82200,
    82500,
    83000
  ],
  "all_support": [
    80871,
    80500,
    80000,
    79500,
    79000
  ]
}

GET /market-opens

Her büyük işlem seansında BTC, ETH ve SOL açılış fiyatları.

{
  "market_opens": {
    "tokyo": {
      "BTC": 81150,
      "ETH": 3200.5,
      "SOL": 96.3,
      "timestamp": 1778539200
    },
    "shanghai": {
      "BTC": 81180,
      "ETH": 3202,
      "SOL": 96.35,
      "timestamp": 1778542800
    },
    "hong_kong": {
      "BTC": 81190,
      "ETH": 3203.5,
      "SOL": 96.4,
      "timestamp": 1778542800
    },
    "london": {
      "BTC": 81201.5,
      "ETH": 3205,
      "SOL": 96.48,
      "timestamp": 1778553600
    },
    "new_york": {
      "BTC": 81262.5,
      "ETH": 3210,
      "SOL": 96.55,
      "timestamp": 1778560800
    }
  }
}

GET /macro

Makro koşullar — net likidite (Fed bilançosu − TGA − RRP), dolar endeksi, reel getiriler, 2s10s eğrisi, M2 ve VIX'in günlük deterministik bir bileşiği, yaklaşan yüksek-etkili takvim ve son istihbaratla birleştirilmiş. /macro yanıtı her zaman bileşiği ve sürücüleri taşır; varlık başına eğilim yalnızca destekleyen modeli mevcut olduğunda dahil edilir, aksi halde açıkça tutulur.

Üst düzey current nesnesi en son raporu içerir. Önceki anlık görüntüleri dahil etmek için ?history=N (Pro, maks 30) ekleyin; ücretsiz hesaplar yalnızca güncel raporu alır. Bias ve conviction null olabilir ve destekleyen veri yetersiz olduğunda açıkça tutulur.

{
  "current": {
    "generated_at": "2026-07-16T07:00:00+00:00",
    "window_days": 7,
    "horizon": "week",
    "regime": "range",
    "calibration": "uncalibrated",
    "btc": {
      "bias": null,
      "conviction": null,
      "status": "insufficient data",
      "sample_size": 3,
      "sufficient_data": false,
      "reason": "Per-asset directional bias withheld until live sample coverage is sufficient."
    },
    "eth": {
      "bias": null,
      "conviction": null,
      "status": "insufficient data",
      "sample_size": 2,
      "sufficient_data": false,
      "reason": "Per-asset directional bias withheld until live sample coverage is sufficient."
    },
    "calendar_risks": [],
    "disclaimer": "AI-generated macro commentary; directional conviction is not calibrated. Not financial advice."
  }
}

Alan referansı

AlanTürAçıklama
regimestringrisk-on, risk-off, range, squeeze
regime_reasonstring≤120 karakter gerekçe
current.btc.bias / current.eth.biasstring | nullbullish, bearish, neutral veya yetersiz veri nedeniyle tutulduğunda null
current.btc.conviction / current.eth.convictionfloat | nullModel tarafından belirtilen 0.0–1.0 güven veya tutulduğunda null; kalibre edilmiş gerçekleşen olasılık değil
btc.reason / eth.reasonstringBaşlıca sürücü, ≤140 karakter
btc.key_levels / eth.key_levelsstringİlgili makro pivotlar
btc.invalidation / eth.invalidationstringÇağrıyı ne geçersiz kılar
calendar_risksarrayEğilimi tersine çevirebilecek yaklaşan başlıca 1–3 olay
window_daysintGeri-bakış penceresi (7 günlük / 30 haftalık)
horizonstringİleri ufuk etiketi (ör. «week», «next two weeks»)
generated_atstringISO-8601 UTC. 36 saat sonra bayat — istemciler yeniden çekmelidir.

Kimlik doğrulama endpoint'leri

POST /auth/register

Yeni bir hesap oluşturur. Hemen bir API anahtarı döndürür.

{
  "api_key": "intel_sk_a1b2c3d4e5f6...",
  "key_prefix": "intel_sk",
  "tier": "free",
  "message": "Save your API key - it will not be shown again."
}

POST /auth/login

{
  "token": "eyJhbGciOiJIUzI1NiIs...",
  "tier": "free",
  "api_keys": [
    {
      "id": 1,
      "prefix": "intel_sk_a1b2",
      "name": "default",
      "created_at": 1778555605
    }
  ]
}

WebSocket /stream

Yalnızca Pro katman. Sinyalleri gerçek zamanlı almak için bağlanın.

wss://api.n0brains.com/stream?api_key=intel_sk_...

Signal received:
{"type": "signal", "data": {"id": 195, "asset": "BTC", "signal_type": "whale", "direction": "bullish", "urgency": "high", "summary": "Strategy buys 535 BTC for $43M", "confidence": 0.95, "score": 1.42, "trade_quality_band": "A", "regime_at_signal": "risk-on"}}

Ping/pong:
send: "ping"
recv: {"type": "pong", "timestamp": 1778555605}

Webhooks

Yalnızca Pro katman. Yeni sinyaller için POST teslimatları almak üzere bir URL kaydedin.

POST /webhooks

{
  "id": 1,
  "url": "https://your-server.com/hooks/n0brains",
  "secret": "a1b2c3d4...",
  "events": "signal.created",
  "note": "Use X-Intel-Signature header to verify deliveries. Secret is shown only once."
}

Teslim biçimi

URL'nize X-Intel-Signature başlığıyla POST yapın:

{
  "event": "signal.created",
  "timestamp": 1778555605,
  "data": {
    "id": 195,
    "asset": "BTC",
    "signal_type": "whale",
    "direction": "bullish",
    "urgency": "high",
    "summary": "Strategy buys 535 BTC for $43M",
    "confidence": 0.95,
    "score": 1.42,
    "trade_quality_band": "A",
    "regime_at_signal": "risk-on"
  }
}

Veri kaynakları ve puanlama

Pipeline, aşağıda listelenen izleyicilerden veri alır. Her kaynak, nihai sinyal puanına çarpan bir ağırlık taşır — yani okuduğunuz şey ham bir besleme dökümü değil, tek bir doğrulanmış, sıralanmış sayıdır.

score = source_weight × urgency_weight × confidence_decayed

Aciliyet ağırlıkları: low: 1.0, medium: 2.0, high: 3.0

Güven bozunumu: güven yaşla üstel olarak bozunur. confidence_decayed = confidence₀ × exp(−age / τ) burada τ = yarı-ömür / ln(2), sinyal türüne göre (liquidation: ~43dk, hack/sentiment/listing: ~2.9s, whale/price/funding: ~8.7s, regulatory: ~5.8s, macro: ~11.5s, macro_pulse: ~34.6s). Bayat bir sinyal, aynı kalitedeki taze bir sinyalden daha düşük puana sahiptir.

Kaynak ağırlığı öz-ayarı: ağırlıklar, izlenen sonuç kazanma oranlarından günlük EMA ile ayarlanır. Doğru tetiklenen kaynaklar 1.4×'e kadar yükseltilir; düşük performans gösterenler 0.6×'e kısılır. Ayarlamadan önce minimum 10 sonuç.

Aktif izleyiciler

  1. Telegram - WatcherGuru, ZachXBT Investigations, yoyodexhaber, sondakikav
  2. News RSS - 15 besleme (Reuters, AP, BBC, CNBC, Bloomberg, CoinDesk, CoinTelegraph, Decrypt, Google News, vb.)
  3. Government RSS - 11 besleme (White House, SEC, CFTC, Fed, Kremlin, Xinhua, TASS, EU, vb.)
  4. CoinMarketCap - Fiyat uyarıları, trend olan coin'ler
  5. Macro - Fear and Greed Index, DeFi TVL
  6. Derivatives - Çoklu-venue funding/açık-pozisyon konumlanması ve OKX genel likidasyon baskıları
  7. Market Opens - Tokyo, Şanghay, Hong Kong, Londra, NY seans açılışlarında BTC/ETH/SOL fiyatları
  8. Exchange Listings - Gerçek CEX listeleme katalizörleri: Binance & Bybit launchpad/launchpool, ayrıca Binance, Upbit (Kore / kimchi premium) ve OKX'te yeni spot-piyasa tespiti (sembol-listesi farkı). Pump.fun / Raydium memecoin lansmanları kaldırıldı — eski listeleme beslemesinin ~%98'iydi ve işlem yapılabilir edge yoktu.
  9. ETF Flows - SoSoValue üzerinden ABD spot BTC + ETH + SOL ETF günlük net akışları (ücretsiz genel API). Bağlam olarak yayınlanır (macro_flow, yönsüz): bir backtest, ETF net girişinin ileri getirileri öngörmediğini buldu — eş-zamanlı/gecikmeli bir talep baskısıdır (SOL girişleri terstiydi).
  10. Stablecoin Flows - USDT/USDC Hazine deploy/geri-alım + borsa cüzdanlarına hazırlanan net giriş, ayrıca toplam stablecoin arz trendi (DeFiLlama). Öncü bir likidite okuması (verimizde stablecoin'in borsalara girişi kısa-ufuklu BTC/ETH getirilerini önceler); toplam arz kuru-barut bağlamıdır.
  11. On-Chain Valuation - Coin Metrics (ücretsiz): MVRV, borsa giriş/çıkışları + rezervler, aktif adresler (BTC + ETH). Net borsa ÇIKIŞI / düşen rezervler = öz-saklama birikimi; MVRV döngü kâr/köpüğünü haritalar. Macro Pulse bileşiğinin on-chain ayağını besler; bağlam olarak yayınlanır.
  12. Token Unlocks - DeFiLlama emisyon takvimi (ücretsiz). İşlem yapılabilir token'larda önemli kısa-vadeli kilit açılışları (içeriden/yatırımcı uçurumları) = satıcıların önden koştuğu planlı arz → unlock sinyali, bearish. İleri-getiri kapısıyla kendini kanıtlar.
  13. TradFi & CME - Yahoo Finance (ücretsiz): CME BTC/ETH vadeli işlem gap'i (hafta sonu gap'leri dolma eğilimindedir — yinelenen bir seviye okuması) artı SPX/altın varlıklar-arası korelasyon bağlamı.
  14. Smart Money - 408 seçilmiş cüzdanda Alchemy ETH WebSocket (alchemy_pendingTransactions) + Etherscan V2 onaylı-işlem yedeği. 700+ doğrulanmış etiketli adres (CEX hot/cold, market maker, kurumsal, akıllı yatırımcı) Etherscan etiket bulutu + Alchemy en-yüksek-hacim taramasından haftalık otomatik yenilenir. MEV botları filtrelenir.
  15. Stealth Accumulation - Arka plan tarayıcısı, izlenen her cüzdan için her 30 dk'da Etherscan V2 tokentx çeker. 24 saat içinde aynı ERC20'yi toplam ≥$500K tutarında ≥3 parçalı alımda alan cüzdanı işaretler — balina-uyarı beslemelerinden önce sessiz birikimi yakalar.
  16. On-Chain Whale Tracking - Alchemy WebSocket üzerinden borsalara/borsalardan büyük ETH transferleri, ayrıca en iyi yatırımcılardan Hyperliquid lider tablosu konsensüsü.
  17. L/S Ratios - Bybit, Binance, Gate.io konumlanma verisi
  18. S/R Levels - Hyperliquid emir defterinden gerçek zamanlı destek/direnç
  19. Macro Conditions - Günlük deterministik FRED makro bileşiği ve yüksek-etkili takvim bağlamı; varlık başına eğilim yalnızca mevcut olduğunda.
  20. X (Twitter) API - Resmi X API v2 üzerinden doğrulanmış canlı lane'ler: on-chain araştırma (@lookonchain, @spotonchain, @arkham), resmi borsa duyuruları (@binance, @coinbase, @CoinbaseAssets, @upbit_global) ve aktif makro/haber bağlamı (@DBdaily). Kaldırılmış veya sessiz hesaplar sağlık beklentilerinden ve genel kaynak iddialarından hariç tutulur. Retweet'ler ve yanıtlar filtrelenir.

Kaynak ağırlıkları

KaynakAğırlıkGerekçe
gov_news1.3Piyasayı hareket ettiren düzenleyici/politika olayları
smart_money1.2On-chain adres takibi (Alchemy + Etherscan, 408 cüzdan)
stealth_accumulation1.4Parçalı sessiz alımlar (≥3 tx, ≥$500K, 24s pencere)
whale_eth1.1Büyük ETH transferleri (Alchemy WS, ≥1000 ETH)
telegram:investigations1.2Yüksek-sinyalli hack/exploit istihbaratı
x:lookonchain1.5İşlem hash'leriyle on-chain cüzdan hareketleri — öncü gösterge
x:binance / x:coinbase1.5Resmi borsa listeleme duyuruları
x:spotonchain / x:arkham1.4On-chain analitik, etiketli cüzdanlar
x:CoinbaseAssets1.4Coinbase listeleme yol haritası sızıntıları
x:upbit_global1.3Kore listelemeleri, kimchi premium katalizörü
x:DBdaily0.9Kurumsal benimseme takibi
binance_funding1.0Birincil borsa verisi
liquidation1.0Çoklu-venue likidasyon verisi
cmc_price0.9CoinMarketCap fiyat uyarıları
telegram:WatcherGuru0.9Hızlı son dakika haberleri
rss:trumpstruth0.9Piyasayı hareket ettiren ama gürültülü
rss:coindesk0.8Köklü yayın organı
cex_listing0.8Gerçek borsa listelemeleri (Binance/Bybit/Upbit/OKX)
rss:cointelegraph0.7Genel kripto haberleri
rss:decrypt0.7Genel kripto haberleri
market_open0.6Seans açılış fiyatları
macro_fearGreed0.6Duygu endeksi
rss:reddit_crypto0.5r/CryptoCurrency topluluk sinyali
rss:reddit_btc0.5r/Bitcoin topluluk sinyali
dexscreener0.2Yalnızca zenginleştirme
Varsayılan (listelenmemiş)0.5-

GET /signals/similar

Yalnızca Pro katman. BGE-M3 vektör gömmeleri kullanılarak tüm sinyaller genelinde anlamsal en-yakın-komşu araması. Sinyalleri yalnızca anahtar kelime eşleşmesiyle değil, anlamla ilişkili olarak bulun.

Sorgu parametreleri

ParamTürAçıklama
coinstringİsteğe bağlı — sonuçları bu varlık ticker'ına göre filtrele
qstringSerbest-metin sorgusu (atlanırsa varsayılan olarak coin adı)
kintSonuç sayısı (varsayılan 5, maks 20)
[
  {
    "id": 182,
    "similarity": 0.97,
    "summary": "BTC whale | bullish | high | Strategy loads 420 BTC at open",
    "metadata": {
      "asset": "BTC",
      "signal_type": "whale",
      "direction": "bullish",
      "urgency": "high",
      "score": 1.38,
      "timestamp": 1778551200
    }
  },
  {
    "id": 178,
    "similarity": 0.94,
    "summary": "BTC whale | bullish | medium | Institutional wallet accumulates 310 BTC",
    "metadata": {
      "asset": "BTC",
      "signal_type": "whale",
      "direction": "bullish",
      "urgency": "medium",
      "score": 1.1,
      "timestamp": 1778548800
    }
  }
]

GET /narrative/{coin}

Yalnızca Pro katman. Bir varlık için sürekli anlatı momentumu — kaç sinyal tetiklendi, hangi hızda, kaç bağımsız kaynaktan ve bir koordinasyon deseni algılanıp algılanmadığı.

{
  "coin": "BTC",
  "narrative_strength": 0.74,
  "narrative_velocity": 3.2,
  "narrative_decay_rate": 0.18,
  "manipulation_probability": 0.12,
  "dominant_direction": "bullish",
  "direction_conviction": 0.81,
  "source_diversity": 4,
  "signal_count_1h": 7,
  "signal_count_4h": 19,
  "signal_count_24h": 42,
  "disclaimer": "Analytical data only. Not financial advice."
}

Alan referansı

AlanTürAçıklama
narrative_strengthfloat24 saatte 0.0–1.0 ağırlıklı sinyal hacmi
narrative_velocityfloat1 saatlik pencerede saat başına yeni sinyal oranı
narrative_decay_ratefloatSinyal hacminin ne kadar hızlı düştüğü (0 = büyüyor, 1 = soğuk)
manipulation_probabilityfloat0.0–1.0. 5 dk içinde ≥3 bağımsız kaynak türü aynı yönde tetiklenirse yükselir
dominant_directionstringbullish, bearish veya neutral (pencere genelinde çoğunluk oyu)
direction_convictionfloatBaskın yönle eşleşen sinyallerin oranı
source_diversityint1 saatlik pencerede farklı kaynak türü sayısı
signal_count_1h / 4h / 24hintKayan pencere başına ham sinyal sayısı

GET /manipulation/{coin}

Yalnızca Pro katman. Bir varlık için bileşik manipülasyon puanı. Sosyal patlama, koordineli pump ve likidasyon çağlayanı alt-puanlarını birleştirir.

{
  "coin": "ETH",
  "manipulation_score": 0.34,
  "social_burst_score": 0.2,
  "coordinated_pump_score": 0.5,
  "liquidation_cascade_score": 0.1,
  "flags": [
    "coordinated_pump"
  ],
  "disclaimer": "Analytical data only. Not financial advice."
}

Alan referansı

AlanTürAçıklama
manipulation_scorefloatBileşik: social_burst×0.30 + coordinated_pump×0.45 + liq_cascade×0.25
social_burst_scorefloatSosyal sinyal sayısı 10 dk taban çizgisinin ≥5× katıysa yükselir
coordinated_pump_scorefloat10 dk içinde ≥4 farklı kaynak öneki aynı yönde tetiklenirse yükselir
liquidation_cascade_scorefloat15 dk içinde coin için ≥3 likidasyon sinyali varsa yükselir
flagsarrayAktif bayraklar: social_burst, coordinated_pump, liquidation_cascade

GET /trust/{coin}

Yalnızca Pro katman. Bir token ticker'ı için güven ve dolandırıcılık puanlaması. Ticker'ı DexScreener üzerinden bir sözleşme adresine çözer, ardından sözleşme bayrakları için GoPlus Security'yi kontrol eder. Sonuçlar token adresi başına 6 saat önbelleğe alınır.

{
  "asset": "PEPE",
  "address": "0x6982508145454ce325ddbe47a25d4ec3d2311933",
  "chain_id": "1",
  "trust_score": 0.82,
  "rug_probability": 0.18,
  "contract_risk": 0.1,
  "insider_pct": 0.04,
  "is_honeypot": false,
  "is_mintable": false,
  "sell_tax": 0,
  "low_liquidity": false,
  "liquidity_usd": 4820000,
  "flags": [],
  "data_source": "goplus",
  "computed_at": 1778555605,
  "disclaimer": "Analytical data only. Not financial advice."
}

Alan referansı

AlanTürAçıklama
trust_scorefloat1.0 − rug_probability. Yüksek = daha güvenli.
rug_probabilityfloatBileşik: contract_risk×0.60 + liquidity_risk×0.20 + vol_liq_risk×0.10 + signal_history_risk×0.10
contract_riskfloatGoPlus'tan türetilmiş. Toplam: honeypot (+0.50), mintable (+0.20), owner_can_change_balance (+0.25), upgradeable_proxy (+0.10), high_sell_tax, insider_pct
insider_pctfloatOluşturucu + sahibin birleşik token tutma yüzdesi
is_honeypotboolGoPlus honeypot bayrağı — token satılamıyor
is_mintableboolSözleşme sınırsız yeni arz basabilir
sell_taxfloatSatış işlemi vergisi (0.10 = %10)
low_liquidityboolliquidity_usd < $50,000 ise true
flagsarrayGoPlus'tan aktif sözleşme risk bayrakları
data_sourcestringgoplus, dexscreener, signal_history_only, or none

Hata yanıtları

// 401 Unauthorized
{"detail": "Invalid API key"}

// 429 Rate Limited
{"detail": "Rate limit exceeded (60 req/min for free tier). Upgrade at https://n0brains.com"}

// 404 Not Found
{"detail": "Signal not found"}

// 403 Forbidden
{"detail": "WebSocket requires Pro tier"}