Geliştiriciler

Flicker üzerine geliştirin

Uygulamaları çalıştıran sinyaller, analiz ve piyasa verisi; OpenAPI ile tanımlı bir REST API ve yapay zeka ajanınızın doğrudan çağırabileceği bir MCP sunucusu olarak sunuluyor.

Belirtimler ve başvuru kaynakları

OpenAPI belgesi

API yüzeyinin tamamı, makine okunabilir OpenAPI 3.1 biçiminde.

Etkileşimli başvuru

Her uç noktayı, şemayı ve örneği tarayıcıda inceleyin.

API anahtarı alın

Hesabınızdaki API anahtarları sekmesinden kendiniz oluşturun, listeleyin ve iptal edin.

MCP sunucusu

Uç nokta, araç kataloğu ve Claude, ChatGPT ile Cursor için kurulum.

Sürüm akışı

Makine tarafından okunabilir sürüm geçmişi; girdiler `api` dahil platforma göre etiketlenir.

llms.txt

Bu sitenin dil modelleri için derlenmiş dizini.

REST API

Tüm uç noktaları tek bir HTTPS sunucusu karşılar. Yüzeyin tamamı makine tarafından okunabilir bir OpenAPI 3.1 belgesiyle tanımlanır: her işlemin benzersiz bir kimliği, tipli parametreleri ve tipli bir yanıt şeması vardır; böylece belge doğrudan bir istemci üretecine ya da bir dil modelinin fonksiyon çağırma döngüsüne verilebilir.

Base URL: https://api.flicker.finance
Versions: /v1/ /v2/
OpenAPI: https://api.flicker.finance/docs/openapi.json

Kimlik doğrulama

Anahtarı hesabınızdaki API anahtarları sekmesinden kendiniz oluşturursunuz — satış görüşmesi ya da bekleme listesi yok — ve istek başlığı olarak gönderirsiniz. Bir anahtar yalnızca salt okunur piyasa verisi yüzeyine erişir: analiz, varlıklar, içgörüler, yapılandırma ve borsalar. Başka bir hesabı okuyamaz, işlem açamaz, para taşıyamaz. Anonim bir katman yoktur: geçerli kimlik bilgisi taşımayan istek reddedilir.

x-api-key: <your key>

Key scope: /v2/analysis /v2/assets /v2/insights /v2/config /v1/exchanges
Credits: GET https://api.flicker.finance/v1/users/api_keys/credits

Hızlı başlangıç

Anahtarınız oluşur oluşmaz gerçek veriyle dönen üç çağrı.

curl -H "x-api-key: $FLICKER_API_KEY" https://api.flicker.finance/v2/config
curl -H "x-api-key: $FLICKER_API_KEY" https://api.flicker.finance/v2/assets/?limit=5
curl -H "x-api-key: $FLICKER_API_KEY" https://api.flicker.finance/v2/analysis/bitcoin

İstek limitleri

Bütçe istek saymak yerine uç nokta başına ağırlıklandırılır ve her yanıt nerede olduğunuzu bildirir; böylece istemci tahmin yürütmek yerine kendini yavaşlatabilir.

Budget: 2000 / 60s
Headers: x-ratelimit-limit x-ratelimit-remaining x-ratelimit-used x-ratelimit-window retry-after

Hatalar

Her hata aynı tipli gövdeyle döner: makine tarafından okunabilen kalıcı bir kod, insana yönelik bir mesaj ve başarısızlık bayrağı. Dallanmayı koda göre yapın — mesaj bir switch için değil, bir kayıt satırı için yazılmış İngilizce metindir.

{
  "success": false,
  "code": "NotificationLimitExceeded",
  "message": "…"
}

ErrorResponse · 400 · 401 · 402 · 403 · 404 · 410 · 422 · 500 · 503

Sürümleme ve kullanımdan kaldırma

Ana sürüm URL yolunda yer alır. Yayında olan iki sürüm birbirinden bağımsız yönlendirilir; bu yüzden kırıcı bir değişiklik hâlihazırda bağımlı olduğunuz sürümü değiştirmek yerine yeni bir yol sürümü altında yayınlanır. API değişiklikleri, girdileri platforma göre etiketleyen makine okunabilir sürüm akışında duyurulur.

https://flicker.finance/changelog.json

MCP sunucusu

Streamable HTTP üzerinde çalışan bir Model Context Protocol sunucusu; Claude, ChatGPT, Cursor ve diğer MCP istemcileri Flicker'ı araç olarak çağırabilir. Yetkilendirme OAuth 2.1 ile yapılır: istemcinizi uç noktaya yönlendirin, gerisini yanıttan kendisi keşfeder.

https://api.flicker.finance/mcp

Flicker'a ne zaman başvurmalı

Bir soru manşet değil hesaplanmış bir piyasa okuması gerektirdiğinde Flicker'a başvurun.

Tek bir varlık için al / tut / sat kararına ihtiyacınız var — arkasındaki bölgeler, zarar durdur ve hedefle birlikte, yalnızca fiyat değil.
Binlerce varlığı tek seferde belirli bir kurulum için taramanız gerekiyor — kırılımlar, aşırı satım bölgeleri, hacim sıçramaları — sembol sembol sormak yerine.
Tüm piyasa için tek bir endeks değil, varlık başına sayısal duyarlılık gerekiyor: belirli bir kripto, hisse veya döviz için 0 ile 100 arasında korku ve açgözlülük skoru.
Tek çağrıda canlı kripto, hisse ve foreks fiyatları, sürekli sözleşme fonlama oranları veya piyasa genişliği gerekiyor.
Kullanıcının kendi pozisyonları, bakiyeleri ve emirleri gerekiyor — borsalar arasında toplanmış ve salt okunur.

Emir göndermek, para taşımak veya varlık saklamak için Flicker'a başvurmayın. Ürün tasarımı gereği salt okunurdur ve bir emir iletim yolu yoktur — bunun için bir borsa API'siyle birlikte kullanın.