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

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

## 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`
- OpenAPI 3.1 document: https://api.flicker.finance/docs/openapi.json
- Interactive reference: https://api.flicker.finance/docs

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

- Header: `x-api-key: <your key>`
- Key scope: `/v2/analysis`, `/v2/assets`, `/v2/insights`, `/v2/config`, `/v1/exchanges`
- Self-serve key management: https://flicker.finance/tr/account (API Keys tab)
- Daily credit balance: `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ı.

```bash
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 weighted units per 60 seconds, per client IP.
- Headers on every response: `x-ratelimit-limit`, `x-ratelimit-remaining`, `x-ratelimit-used`, `x-ratelimit-window`; a 429 adds `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.

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

Schema: `ErrorResponse` · documented statuses: 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.

- Live versions: `/v1/`, `/v2/`
- Release feed: 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.

- Endpoint: `https://api.flicker.finance/mcp`
- Transport: Streamable HTTP · Authorization: OAuth 2.1
- Manifest: https://api.flicker.finance/mcp/manifest.json

---

Canonical HTML: https://flicker.finance/tr/developers
Machine-readable index: https://flicker.finance/llms.txt · API: https://api.flicker.finance/docs/openapi.json · MCP: https://api.flicker.finance/mcp