# Bangun di atas Flicker

Sinyal, analisis, dan data pasar yang sama yang menjalankan aplikasi kami, tersedia sebagai REST API berdeskripsi OpenAPI dan sebagai MCP server yang bisa dipanggil langsung oleh AI agent Anda.

## Kapan memakai Flicker

Pakai Flicker ketika sebuah pertanyaan butuh pembacaan pasar yang dihitung, bukan sekadar judul berita.

- Anda butuh verdict buy / hold / sell untuk satu aset, lengkap dengan zone, stop loss, dan target di baliknya — bukan cuma harga.
- Anda butuh menyaring ribuan aset sekaligus untuk satu setup — breakout, oversold zone, lonjakan volume — alih-alih bertanya satu per satu.
- Anda butuh sentimen berupa angka per aset, bukan satu indeks untuk seluruh pasar: skor Fear & Greed 0 sampai 100 untuk coin, saham, atau mata uang tertentu.
- Anda butuh harga live crypto, saham, dan forex, funding rate perpetual, atau market breadth dalam satu panggilan.
- Anda butuh posisi, saldo, dan order milik pengguna sendiri, tergabung lintas exchange dan bersifat read-only.

Jangan pakai Flicker untuk mengirim order, memindahkan dana, atau menyimpan aset. Produknya read-only secara rancangan dan tidak punya jalur eksekusi — pasangkan dengan API exchange untuk itu.

## REST API

Satu host HTTPS melayani semua endpoint. Seluruh permukaannya dideskripsikan dokumen OpenAPI 3.1 yang bisa dibaca mesin — setiap operasi punya operation id unik, parameter bertipe, dan response schema bertipe, jadi bisa langsung masuk ke generator client atau ke loop function calling sebuah LLM.

- Base URL: `https://api.flicker.finance`
- OpenAPI 3.1 document: https://api.flicker.finance/docs/openapi.json
- Interactive reference: https://api.flicker.finance/docs

## Autentikasi

Buat key sendiri di tab API Keys pada akun Anda — tanpa panggilan sales, tanpa daftar tunggu — lalu kirim sebagai header permintaan. Sebuah key hanya menjangkau permukaan data pasar yang read-only: analisis, aset, insight, config, dan exchange. Key tidak bisa membaca akun lain, membuka posisi, atau memindahkan dana. Tidak ada tier anonim: permintaan tanpa kredensial yang sah akan ditolak.

- 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/id/account (API Keys tab)
- Daily credit balance: `GET https://api.flicker.finance/v1/users/api_keys/credits`

## Quickstart

Tiga panggilan yang langsung menjawab dengan data asli begitu key Anda ada.

```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
```

## Rate limit

Kuotanya diberi bobot per endpoint, bukan dihitung per permintaan, dan setiap respons melaporkan posisi Anda — jadi client bisa mengerem sendiri alih-alih menebak.

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

## Error

Setiap kegagalan menjawab dengan body bertipe yang sama: kode stabil yang bisa dibaca mesin, pesan untuk manusia, dan penanda gagal. Bercabanglah pada kodenya — pesannya adalah teks bahasa Inggris untuk log, bukan untuk statement switch.

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

Schema: `ErrorResponse` · documented statuses: 400, 401, 402, 403, 404, 410, 422, 500, 503.

## Versioning dan deprecation

Versi mayor berada di path URL. Kedua versi yang aktif dirutekan secara terpisah, jadi breaking change dirilis di bawah versi path baru alih-alih mengubah versi yang sudah Anda pakai. Perubahan API diumumkan di feed rilis yang bisa dibaca mesin, yang menandai tiap entri berdasarkan platform.

- Live versions: `/v1/`, `/v2/`
- Release feed: https://flicker.finance/changelog.json

## MCP server

Server Model Context Protocol di atas Streamable HTTP, sehingga Claude, ChatGPT, Cursor, dan MCP client lain bisa memanggil Flicker sebagai tools. Otorisasinya OAuth 2.1: arahkan client Anda ke endpoint, sisanya ditemukan sendiri dari respons servernya.

- 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/id/developers
Machine-readable index: https://flicker.finance/llms.txt · API: https://api.flicker.finance/docs/openapi.json · MCP: https://api.flicker.finance/mcp